From 96597281b882ad57fac9e3879e5fb07e5291a1f4 Mon Sep 17 00:00:00 2001 From: Paulo Borges Date: Wed, 6 Aug 2025 17:19:59 -0300 Subject: [PATCH 1/2] docs: add notice about the terraform provider --- modules/manage/pages/terraform-provider.adoc | 28 ++++++++++++++++++++ 1 file changed, 28 insertions(+) diff --git a/modules/manage/pages/terraform-provider.adoc b/modules/manage/pages/terraform-provider.adoc index 24a7959cf..4fe32fd15 100644 --- a/modules/manage/pages/terraform-provider.adoc +++ b/modules/manage/pages/terraform-provider.adoc @@ -97,6 +97,34 @@ The following functionality is supported in the Cloud API but not in the Redpand == Prerequisites +[IMPORTANT] +==== +*Redpanda Terraform Provider - Windows Support Notice* + +The Redpanda Terraform provider is not supported on Windows systems. If you're using Windows, you must use Windows Subsystem for Linux 2 (WSL2) to run the Redpanda Terraform provider. + +To use WSL2 with the Redpanda Terraform provider: + +. Open your WSL2 Linux distribution (e.g., Ubuntu) from the Start menu or by running `wsl` in PowerShell. +. Navigate to your project directory within WSL2. +. Run all Terraform commands from within your WSL2 environment: ++ +```bash +# Initialize Terraform and download the Redpanda provider +terraform init + +# Plan your Redpanda infrastructure changes +terraform plan + +# Apply the configuration to create Redpanda resources +terraform apply + +# View created resources +terraform show +``` + +==== + . Install at least version 1.0.0 of Terraform using the https://learn.hashicorp.com/tutorials/terraform/install-cli[official guide^]. . Create a service account in Redpanda Cloud: .. Log in to https://cloud.redpanda.com[Redpanda Cloud^]. From e2aae26f24bf1192e0e65493346184595f628e88 Mon Sep 17 00:00:00 2001 From: Paulo Borges Date: Wed, 6 Aug 2025 18:24:09 -0300 Subject: [PATCH 2/2] add install instructions --- modules/manage/pages/terraform-provider.adoc | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/modules/manage/pages/terraform-provider.adoc b/modules/manage/pages/terraform-provider.adoc index 4fe32fd15..71d0fe3cd 100644 --- a/modules/manage/pages/terraform-provider.adoc +++ b/modules/manage/pages/terraform-provider.adoc @@ -105,6 +105,14 @@ The Redpanda Terraform provider is not supported on Windows systems. If you're u To use WSL2 with the Redpanda Terraform provider: +. If WSL2 is not already installed, install it by running the following command in PowerShell as Administrator: ++ +```powershell +wsl --install +``` ++ +Then restart your computer. + . Open your WSL2 Linux distribution (e.g., Ubuntu) from the Start menu or by running `wsl` in PowerShell. . Navigate to your project directory within WSL2. . Run all Terraform commands from within your WSL2 environment: