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

• Terraform 0.10.x
• Go 1.11 (to build the provider plugin)

Clone repository to: $GOPATH/src/github.com/terraform-providers/terraform-provider-tfe

$ mkdir -p $GOPATH/src/github.com/terraform-providers; cd $GOPATH/src/github.com/terraform-providers
$ git clone [email protected]:terraform-providers/terraform-provider-tfe

Enter the provider directory and build the provider

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

If you're building the provider, follow the instructions to install it as a plugin. After placing it into your plugins directory, run terraform init to initialize it.

If you wish to work on the provider, you'll first need Go installed on your machine (version 1.11+ 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 build
...
$ $GOPATH/bin/terraform-provider-tfe
...

If you are planning to run the full suite of tests or work on policy sets, you'll need to set up a policy set repository in GitHub.

Your policy set repository will need the following:

1. A policy set stored in a subdirectory
2. A branch other than master

To run all tests, you will need to set the following environment variables:

A hostname and token must be provided in order to run the acceptance tests. By default, these are loaded from the the credentials in the CLI config file. You can override these values with the environment variables specified below:

1. TFE_HOSTNAME - URL of a Terraform Cloud or Terraform Enterprise instance to be used for testing, without the scheme. Example: tfe.local
2. TFE_TOKEN - A user API token for an administrator account on the Terraform Cloud or Terraform Enterprise instance being used for testing.

1. TFE_USER1 and TFE_USER2: The usernames of two pre-existing users on the Terraform Cloud or Terraform Enterprise instance being used for testing. Required for running team membership tests.
2. GITHUB_TOKEN - GitHub personal access token. Used to establish a VCS provider connection.
3. GITHUB_POLICY_SET_IDENTIFIER - GitHub policy set repository identifier in the format username/repository. Required for running policy set tests.
4. GITHUB_POLICY_SET_BRANCH: A GitHub branch for the repository specified by GITHUB_POLICY_SET_IDENTIFIER. Required for running policy set tests.
5. GITHUB_POLICY_SET_PATH: A GitHub subdirectory for the repository specified by GITHUB_POLICY_SET_IDENTIFIER. Required for running policy set tests.

You can set your environment variables up however you prefer. The following are instructions for setting up environment variables using envchain.

1. Make sure you have envchain installed. Instructions for this can be found in the envchain README.

2. Pick a namespace for storing your environment variables. I suggest terraform-provider-tfe or something similar.

3. For each environment variable you need to set, run the following command:

   envchain --set YOUR_NAMESPACE_HERE ENVIRONMENT_VARIABLE_HERE

   OR

   Set all of the environment variables at once with the following command:

   envchain --set YOUR_NAMESPACE_HERE TFE_HOSTNAME TFE_TOKEN TFE_USER1 TFE_USER2 GITHUB_TOKEN GITHUB_POLICY_SET_IDENTIFIER GITHUB_POLICY_SET_BRANCH GITHUB_POLICY_SET_PATH

$ envchain YOUR_NAMESPACE_HERE make test

$ make test

$ envchain YOUR_NAMESPACE_HERE make testacc

$ make testacc

The commands below use notification configurations as an example.

$ TESTARGS="-run TestAccTFENotificationConfiguration" envchain YOUR_NAMESPACE_HERE make testacc

$ TESTARGS="-run TestAccTFENotificationConfiguration" make testacc

You may want to run tests against a local version of go-tfe. Add the following line to go.mod above the require statement, using your local path to go-tfe.

replace github.com/hashicorp/go-tfe => /path-to-local-repo/go-tfe

Only update the Unreleased section. Please use the template below when updating the changelog:

<change category>:
* **New Resource:** `name_of_new_resource` ([#123](link-to-PR))
* r/tfe_resource: description of change or bug fix ([#124](link-to-PR))

BREAKING CHANGES: Use this for any changes that aren't backwards compatible. Include details on how to handle these changes. FEATURES: Use this for any larger new features added ENHANCEMENTS: Use this for smaller new features added BUG FIXES: Use this for any bugs that were fixed NOTES: Use this section if you need to include any additional notes on things like upgrading, upcoming deprecations, or any other information you might want to highlight.