Update CONTRIBUTING.md (#2407)

New documentation to address #2403.
This commit is contained in:
Nathan McKinley 2018-11-05 15:54:41 -08:00
parent e5e1c1e97f
commit 8b352cc374

View File

@ -43,6 +43,8 @@ GOOGLE_ORG
GOOGLE_BILLING_ACCOUNT
```
The only region we support running tests in right now is `us-central1` - some products that are tested here are only available in a few regions, and the only region that all products are available in is `us-central1`.
To run a specific test, use a command such as:
```
make testacc TEST=./google TESTARGS='-run=TestAccContainerNodePool_basic'
@ -50,6 +52,8 @@ make testacc TEST=./google TESTARGS='-run=TestAccContainerNodePool_basic'
The `TESTARGS` variable is regexp-like, so multiple tests can be run in parallel by specifying a common substring of those tests (for example, `TestAccContainerNodePool` to run all node pool tests).
To run all tests, you can simply omit the `TESTARGS` argument - but please keep in mind that that is quite a few tests and will take quite a long time and create some fairly expensive resources. It usually is not advisable to run all tests.
### Writing Tests
Tests should confirm that a resource can be created, and that the resulting Terraform state has the correct values, as well as the created GCP resource.