Repository files navigation

• Website:https://www.terraform.io
• 
• Mailing list:Google Groups

• Terraform 1.4.x
• Go 1.21 (to build the provider plugin)

Clone the repository:

$ mkdir -p$GOPATH/src/github.com/terraform-providers;cd"$_"$ git clone https://github.com/spotinst/terraform-provider-spotinst.git

Choose your build method:

If you don't mind installing the development version of the provider globally,you can usemake build in the provider directory which will build and link thebinary into your$GOPATH/bin directory.

$cd$GOPATH/src/github.com/spotinst/terraform-provider-spotinst$ make build

If you would rather install the provider locally and not impact the stableversion you already have installed, you can use the~/.terraformrc file to tellTerraform where your provider is. You do this by building the provider using Go.

$cd$GOPATH/src/github.com/spotinst/terraform-provider-spotinst$ go build -o terraform-provider-spotinst

Then, update your~/.terraformrc file to point at the location you've built it.

providers {spotinst="${GOPATH}/src/github.com/spotinst/terraform-provider-spotinst/terraform-provider-spotinst"}

A caveat with this approach is that you will need to runterraform initwhenever the provider is rebuilt. You'll also need to remember to commentit/remove it when it's not in use to avoid tripping yourself up.

If you wish to work on the provider, you'll first needGoinstalled on your machine (version 1.15+ isrequired). You'll also need tocorrectly setup aGOPATH, as wellas adding$GOPATH/bin to your$PATH.

See above for which option suits your workflow for building the provider.

In order to test the provider, you can simply runmake test.

$ maketest

In order to run the full suite of Acceptance tests, runmake testacc.

Note: Acceptance tests create real resources, and often cost money to run.

$ make testacc

Terraform providers useGo modulesto manage the dependencies. To add or update a dependency, you would run thefollowing (v1.2.3 offoo is a new package we want to add):

$ go get foo@v1.2.3$ go mod tidy

Stepping through the above commands:

• go get foo@v1.2.3 fetches versionv1.2.3 from the source (if needed) andadds it to thego.mod file for use.
• go mod tidy cleans up any dangling dependencies or references that aren'tdefined in your module file.

If you wish to remove a dependency, you can remove the reference fromgo.modand use the same commands above but omit the initialgo get.