- Website: https://www.terraform.io
- Mailing list: Google Groups
Clone repository to: $GOPATH/src/github.com/fastly/terraform-provider-fastly
$ mkdir -p $GOPATH/src/github.com/fastly; cd $GOPATH/src/github.com/fastly
$ git clone git@github.com:fastly/terraform-provider-fastly
Enter the provider directory and build the provider
$ cd $GOPATH/src/github.com/fastly/terraform-provider-fastly
$ make build
If you wish to work on the provider, you'll first need Go installed on your machine (version 1.14+ is required).
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-fastly
...
In order to test the provider, you can simply run make test
.
$ make test
In order to run the full suite of Acceptance tests, run make testacc
.
Note: Acceptance tests create real resources, and often cost money to run. You should expect that the full acceptance test suite will take hours to run.
$ make testacc
In order to run an individual acceptance test, the '-run' flag can be used together with a regular expression. The following example uses a regular expression matching single test called 'TestAccFastlyServiceV1_basic'.
$ make testacc TESTARGS='-run=TestAccFastlyServiceV1_basic'
The following example uses a regular expression to execute a grouping of basic acceptance tests.
$ make testacc TESTARGS='-run=TestAccFastlyServiceV1_.*_basic'
The documentation is built from components (go templates) stored in the website_src
folder.
Building the documentation copies the full markdown into the website
folder, ready for deployment to Hashicorp.
With the repository cloned to: $GOPATH/src/github.com/fastly/terraform-provider-fastly
:
-
To build the documentation:
go run scripts/website/parse-templates.go
-
To build and preview the documentation online:
make website
Refer to CONTRIBUTING.md