From 5b2829d1252908a8d02729270f068c2ee7452abd Mon Sep 17 00:00:00 2001 From: Rohit Yadav Date: Thu, 11 Apr 2024 13:02:08 +0530 Subject: [PATCH 1/3] Update README.md --- README.md | 68 +++++++++++++++++++++++++++++++++++++++++++++++++++---- 1 file changed, 63 insertions(+), 5 deletions(-) diff --git a/README.md b/README.md index 3236f201..74537a24 100644 --- a/README.md +++ b/README.md @@ -5,17 +5,69 @@ Requirements ------------ - [Terraform](https://www.terraform.io/downloads.html) 1.0.x -- [Go](https://golang.org/doc/install) 1.16+ (to build the provider plugin) +- [Go](https://golang.org/doc/install) 1.20+ (to build the provider plugin) -Using the Provider from Terraform registry ------------------------------------------- +See wiki: https://github.com/apache/cloudstack-terraform-provider/wiki + +Installing from Github Release +------------------------------ + +User can install the CloudStack Terraform Provider using the [Github Releases](https://github.com/apache/cloudstack-terraform-provider/releases) with the installation steps below. + +Replace the `RELEASE` version with the version you're trying to install and use. + +The valid `ARCH` options are: + +- linux_amd64 +- linux_386 +- linux_arm64 +- linux_arm +- darwin_amd64 +- darwin_arm64 +- freebsd_amd64 +- freebsd_386 +- freebsd_arm64 +- freebsd_arm + +Steps for installation: + +``` +RELEASE=0.5.0 +ARCH=darwin_arm64 +mkdir -p ~/.terraform.d/plugins/local/cloudstack/cloudstack/${RELEASE}/${ARCH} +wget "https://github.com/apache/cloudstack-terraform-provider/releases/download/v${RELEASE}/cloudstack-terraform-provider_${RELEASE}_${ARCH}.zip" +unzip cloudstack-terraform-provider_${RELEASE}_${ARCH}.zip -d cloudstack-terraform-provider_${RELEASE} +mv cloudstack-terraform-provider_${RELEASE}/cloudstack-terraform-provider_v${RELEASE} ~/.terraform.d/plugins/local/cloudstack/cloudstack/${RELEASE}/${ARCH}/terraform-provider-cloudstack_v${RELEASE} +``` + +To use the locally installed provider, please use the following in your main.tf etc, and then run `terraform init`: + +``` +terraform { + required_providers { + cloudstack = { + source = "local/cloudstack/cloudstack" + version = "0.5.0" + } + } +} + +provider "cloudstack" { + # Configuration options +} +``` + +Note: this can be used when users are not able to install using the Terraform registry. + +Installing from Terrafrom registry +---------------------------------- To install the CloudStack provider, copy and paste the below code into your Terraform configuration. Then, run terraform init. ```sh terraform { required_providers { cloudstack = { source = "cloudstack/cloudstack" - version = "0.4.0" + version = "0.5.0" } } } @@ -24,7 +76,13 @@ provider "cloudstack" { # Configuration options } ``` -For more details on how to install and use the provider, click [here](website/) or visit https://registry.terraform.io/providers/cloudstack/cloudstack/latest/docs + +User hitting installation issue using registry can install using the local install method. + +Documentation +------------- + +For more details on how to use the provider, visit https://registry.terraform.io/providers/cloudstack/cloudstack/latest/docs Developing the Provider --------------------------- From 845e9962c4c7ff8c781a99bc9ce2cc5c89531c48 Mon Sep 17 00:00:00 2001 From: CodeBleu <400979+CodeBleu@users.noreply.github.com> Date: Fri, 12 Apr 2024 14:26:31 -0400 Subject: [PATCH 2/3] Update README.md (#110) --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 74537a24..d7baa427 100644 --- a/README.md +++ b/README.md @@ -82,7 +82,7 @@ User hitting installation issue using registry can install using the local insta Documentation ------------- -For more details on how to use the provider, visit https://registry.terraform.io/providers/cloudstack/cloudstack/latest/docs +For more details on how to use the provider, click [here](website/) or visit https://registry.terraform.io/providers/cloudstack/cloudstack/latest/docs Developing the Provider --------------------------- From 77b6e811fdec5858cd11c7d7ce1ddffb04816977 Mon Sep 17 00:00:00 2001 From: Rohit Yadav Date: Tue, 16 Apr 2024 11:58:08 +0530 Subject: [PATCH 3/3] .terraform-registry: remove v0.5.0 request Signed-off-by: Rohit Yadav --- .terraform-registry | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/.terraform-registry b/.terraform-registry index 6c304e4f..18217cbf 100644 --- a/.terraform-registry +++ b/.terraform-registry @@ -1,4 +1,4 @@ -Request: change owner to Github user rohityadavcloud +Request: remove version v0.5.0 from the registry Registry Link: https://registry.terraform.io/providers/cloudstack/cloudstack/latest Request by: rohit.yadav@shapeblue.com, rohit@apache.org -Request number: 143448 +Request number: 146118