commit | 9ca483a88d6ba5559b241db5b537ad7eaaa417a1 | [log] [tgz] |
---|---|---|
author | Tony Carmichael <1105554+aicarmic@users.noreply.github.com> | Mon Dec 07 12:30:39 2020 -0700 |
committer | GitHub <noreply@github.com> | Mon Dec 07 12:30:39 2020 -0700 |
tree | 75026aca95fae5dea0805b036786e81fa9152a4c | |
parent | 6d87f9c7c758a243d3ff0c2d0cd399aecc0c70d9 [diff] |
Update README.md Add archive notice
Please note: This Terraform provider is archived, per our provider archiving process. What does this mean?
If anyone from the community or an interested third party is willing to maintain it, they can fork the repository and publish it to the Terraform Registry. If you are interested in maintaining this provider, please reach out to the Terraform Provider Development Program at terraform-provider-dev@hashicorp.com.
Clone repository to: $GOPATH/src/github.com/terraform-providers/terraform-provider-cloudstack
$ mkdir -p $GOPATH/src/github.com/terraform-providers; cd $GOPATH/src/github.com/terraform-providers $ git clone git@github.com:terraform-providers/terraform-provider-cloudstack
Enter the provider directory and build the provider
$ cd $GOPATH/src/github.com/terraform-providers/terraform-provider-cloudstack $ make build
If you wish to work on the provider, you‘ll first need Go installed on your machine (version 1.8+ is required). You’ll also need to correctly setup a GOPATH, as well as adding $GOPATH/bin
to your $PATH
.
To compile the provider, run make build
. This will build the provider and put the provider binary in the $GOPATH/bin
directory.
$ make bin ... $ $GOPATH/bin/terraform-provider-cloudstack ...
In order to test the provider, you can simply run make test
.
$ 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:
$ docker pull svanharmelen/simulator:4.12.0.0 $ docker run -d -p 8080:8080 --name cloudstack svanharmelen/simulator:4.12.0.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.
Once the login page is shown and you can login, you need to provision a simulated data-center:
$ docker exec -ti cloudstack python /root/tools/marvin/marvin/deployDataCenter.py -i /root/setup/dev/advanced.cfg
If you refresh the client or login again, you will now get passed the initial welcome screen and be able to go to your account details and retrieve the API key and secret. Export those together with the URL:
$ export CLOUDSTACK_API_URL=http://localhost:8080/client/api $ export CLOUDSTACK_API_KEY=r_gszj7e0ttr_C6CP5QU_1IV82EIOtK4o_K9i_AltVztfO68wpXihKs2Tms6tCMDY4HDmbqHc-DtTamG5x112w $ export CLOUDSTACK_SECRET_KEY=tsfMDShFe94f4JkJfEh6_tZZ--w5jqEW7vGL2tkZGQgcdbnxNoq9fRmwAtU5MEGGXOrDlNA6tfvGK14fk_MB6w
In order for all the tests to pass, you will need to create a new (empty) project in the UI called terraform
. When the project is created you can run the Acceptance tests against the CloudStack Simulator by simply runnning:
$ make testacc