25 lines
1.1 KiB
Markdown
25 lines
1.1 KiB
Markdown
# How to run tests
|
|
|
|
To run them, use:
|
|
```
|
|
TFE_TOKEN=<token> TFE_HOSTNAME=<hostname> TF_ACC=1 go test ./internal/cloud/e2e/... -ldflags "-X \"github.com/hashicorp/terraform/version.Prerelease=<PRE-RELEASE>\""
|
|
```
|
|
|
|
Required flags
|
|
* `TF_ACC=1`. This variable is used as part of terraform for tests that make
|
|
external network calls. This is needed to run these tests. Without it, the
|
|
tests do not run.
|
|
* `TFE_TOKEN=<admin token>` and `TFE_HOSTNAME=<hostname>`. The helpers
|
|
for these tests require admin access to a TFC/TFE instance.
|
|
* `-timeout=30m`. Some of these tests take longer than the default 10m timeout for `go test`.
|
|
|
|
### Flags
|
|
|
|
* Use the `-v` flag for normal verbose mode.
|
|
* Use the `-tfoutput` flag to print the terraform output to standard out.
|
|
* Use `-ldflags` to change the version Prerelease to match a version
|
|
available remotely. Some behaviors rely on the exact local version Terraform
|
|
being available in TFC/TFE, and manipulating the Prerelease during build is
|
|
often the only way to ensure this.
|
|
[(More on `-ldflags`.)](https://www.digitalocean.com/community/tutorials/using-ldflags-to-set-version-information-for-go-applications)
|