Skip to content

Commit

Permalink
docs: add note about acceptance tests (#11475)
Browse files Browse the repository at this point in the history
  • Loading branch information
wyardley authored Aug 30, 2024
1 parent 68282ea commit eee25d3
Showing 1 changed file with 4 additions and 6 deletions.
10 changes: 4 additions & 6 deletions docs/content/develop/test/run-tests.md
Original file line number Diff line number Diff line change
Expand Up @@ -62,7 +62,8 @@ aliases:
make testacc TEST=./google/services/container TESTARGS='-run=TestAccContainerNodePool'
```
> [!NOTE]
> Acceptance tests create actual infrastructure which can incur costs. Acceptance tests may not clean up after themselves if interrupted, so you may want to check for stray resources and / or billing charges.
1. Optional: Save verbose test output (including API requests and responses) to a file for analysis.
Expand All @@ -89,14 +90,13 @@ aliases:
make lint
```
1. Run acceptance tests for only modified resources. (Full test runs can take over 9 hours.) See [Go's documentation](https://pkg.go.dev/cmd/go#hdr-Testing_flags) for more information about `-run` and other flags.

```bash
make testacc TEST=./google-beta/services/container TESTARGS='-run=TestAccContainerNodePool'
```


> [!NOTE]
> Acceptance tests create actual infrastructure which can incur costs. Acceptance tests may not clean up after themselves if interrupted, so you may want to check for stray resources and / or billing charges.

1. Optional: Save verbose test output to a file for analysis.

Expand Down Expand Up @@ -238,7 +238,6 @@ Configure Terraform to use locally-built binaries for `google` and `google-beta`

### Run manual tests


1. [Generate the provider(s) you want to test]({{< ref "/get-started/generate-providers" >}})
2. Build the provider(s) you want to test

Expand Down Expand Up @@ -291,6 +290,5 @@ To stop using developer overrides, stop setting `TF_CLI_CONFIG_FILE` in the comm

Terraform will resume its normal behaviour of pulling published provider versions from the public Registry. Any version constraints in your Terraform configuration will come back into effect. Also, you may need to run `terraform init` to download the required version of the provider into your project directory if you haven't already.
## What's next?
- [Create a pull request]({{< ref "/contribute/create-pr" >}})

0 comments on commit eee25d3

Please sign in to comment.