NOTICE: Due to strategic changes at Citrix, this project is no longer maintained. |
---|
- Website: https://www.terraform.io
- Mailing list: Google Groups
This project is maintained by the developers at Cedexis (now part of Citrix®).
- Requirements
- Building The Provider
- OSX Setup With HomeBrew
- Using The Provider
- Where To Go Next
- Contributing
- Terraform 0.11+
- Go 1.11+ (to build the provider plugin)
- A Citrix ITM account with API access (see below)
To build the provider, make sure you have a working Go 1.11+ installation.
Clone the terraform-provider-citrixitm
repo. Since there is a mod.go file and we're using Go 1.11+, this can be anywhere on your system, not necessarily under $GOPATH. Then change to the repo directory and build the provider by running make build
.
$ git clone git@github.com:cedexis/terraform-provider-citrixitm.git
$ cd terraform-provider-citrixitm
$ make build
The build
target does a couple of things. First it executes scripts/gofmtcheck.sh
, which makes sure that all of the code files in the repository conform to Go formatting standards. Assuming the formatting check passes, it then executes go install
, which builds the plugin binary and places it within $GOPATH/bin
.
This section assumes you already have HomeBrew installed.
$ brew install golang
$ cd ~/Documents
$ git clone git@github.com:cedexis/terraform-provider-citrixitm.git
$ cd terraform-provider-citrixitm
$ make build
You should now be ready to start using the provider.
Using the provider requires a Citrix ITM account with access to the API. You can # by visiting the Citrix ITM Portal.
To find out if your account has access to the API, navigate to My Account > API > Oauth Configuration
. If you don't see these options then you'll need to send an email to Citrix ITM Support and request API access.
The Citrix ITM provider is a third party plugin and must be installed manually. This is simply a matter of taking the executable that you built in the previous section and copying it into the $HOME/.terraform.d/plugins
directory.
Example:
$ mkdir -p $HOME/.terraform.d/plugins
$ cp $GOPATH/bin/terraform-provider-citrixitm $HOME/.terraform.d/plugins/
The Citrix ITM provider is now available for use in any Terraform configurations referencing it.
Why not head over to the Custom App From File example and give it a try?
Contributions are welcome. Please see Contributing.