From ea87939e50da78cf9fff35eea71b12cf0727c14a Mon Sep 17 00:00:00 2001 From: kiranchavala Date: Fri, 4 Aug 2023 21:41:56 +0530 Subject: [PATCH] Added correct docker and terraform configuration command (#53) * Added correct docker and terraform configuration commands * Update README.md Co-authored-by: David Jumani * Update README.md Co-authored-by: David Jumani --------- Co-authored-by: Rohit Yadav Co-authored-by: David Jumani --- README.md | 28 +++++++++++++++++++++------- 1 file changed, 21 insertions(+), 7 deletions(-) diff --git a/README.md b/README.md index 794ff18c..57ac409b 100644 --- a/README.md +++ b/README.md @@ -48,9 +48,14 @@ $ make build $ ls $GOPATH/bin/terraform-provider-cloudstack ``` Once the build is ready, you have to copy the binary into Terraform locally (version appended). -On Linux this path is at ~/.terraform.d/plugins, and on Windows at %APPDATA%\terraform.d\plugins. + +On Linux and Mac this path is at ~/.terraform.d/plugins, +On Windows at %APPDATA%\terraform.d\plugins, + ```sh -$ ls ~/.terraform.d/plugins/registry.terraform.io/cloudstack/cloudstack/0.4.0/linux_amd64/terraform-provider-cloudstack_v0.4.0 +$ cd ~ +$ mkdir -p ~/.terraform.d/plugins/localdomain/provider/cloudstack/0.4.0/linux_amd64 +$ cp $GOPATH/bin/terraform-provider-cloudstack ~/.terraform.d/plugins/localdomain/provider/cloudstack/0.4.0/linux_amd64 ``` Testing the Provider @@ -65,8 +70,17 @@ $ make test In order to run the full suite of Acceptance tests you will need to run the CloudStack Simulator. Please follow these steps to prepare an environment for running the Acceptance tests: ```sh -$ docker pull cloudstack/simulator -$ docker run --name simulator -p 8080:5050 -d cloudstack/simulator +docker pull apache/cloudstack-simulator + +or pull it with a particular build tag + +docker pull apache/cloudstack-simulator:4.17.2.0 + +docker run --name simulator -p 8080:5050 -d apache/cloudstack-simulator + +or + +docker run --name simulator -p 8080:5050 -d apache/cloudstack-simulator:4.17.2.0 ``` When Docker started the container you can go to http://localhost:8080/client and login to the CloudStack UI as user `admin` with password `password`. It can take a few minutes for the container is fully ready, so you probably need to wait and refresh the page for a few minutes before the login page is shown. @@ -91,8 +105,8 @@ In order for all the tests to pass, you will need to create a new (empty) projec $ make testacc ``` -Sample Terraform configuration ------------------------------- +Sample Terraform configuration when testing locally +------------------------------------------------------------ Below is an example configuration to initialize provider and create a Virtual Machine instance ```sh @@ -100,7 +114,7 @@ $ cat provider.tf terraform { required_providers { cloudstack = { - source = "cloudstack/cloudstack" + source = "localdomain/provider/cloudstack" version = "0.4.0" } }