1
1
# Contributing
2
2
3
- Before you begin, read through some of the Terraform documentation on [ Extending
3
+ Before you begin, read through the Terraform documentation on [ Extending
4
4
Terraform] ( https://www.terraform.io/docs/extend/index.html ) and [ Writing Custom
5
5
Providers] ( https://learn.hashicorp.com/collections/terraform/providers ) .
6
6
7
- Finally the [ HashiCorp Provider Design
7
+ Finally, the [ HashiCorp Provider Design
8
8
Principles] ( https://www.terraform.io/docs/extend/hashicorp-provider-design-principles.html )
9
9
explore the underlying principles for the design choices of this provider.
10
10
11
+ ## Prerequisites
12
+
13
+ - [ Go 1.13+] ( https://go.dev/ )
14
+ - [ Docker] ( https://docs.docker.com/get-docker/ ) - used for running acceptance tests.
15
+ - [ Docker-Compose] ( https://docs.docker.com/compose/install/ ) - used for running acceptance tests.
16
+
11
17
## Getting started
12
18
13
19
To work on the provider, you'll need [ Go] ( http://www.golang.org ) installed on
14
- your machine (version 1.10 + is * required* ). You'll also need to correctly setup
20
+ your machine (version 1.13 + is * required* ). You'll also need to correctly set up
15
21
a [ GOPATH] ( http://golang.org/doc/code.html#GOPATH ) , as well as adding
16
22
` $GOPATH/bin ` to your ` $PATH ` .
17
23
@@ -43,9 +49,8 @@ AUTH0_CLIENT_SECRET=<your-auth0-client-secret>
43
49
Then, run ` make testacc ` .
44
50
45
51
** Note:** The acceptance tests make calls to a real Auth0 tenant, and create
46
- real resources. Certain tests, for example for custom domains
47
- (` TestAccCustomDomain ` ), also require a paid Auth0 subscription to be able to
48
- run successfully.
52
+ real resources. Certain tests also require a paid Auth0 subscription to be able to
53
+ run successfully, e.g. ` TestAccCustomDomain ` and the ones starting with ` TestAccLogStream* ` .
49
54
50
55
** Note:** At the time of writing, the following configuration steps are also
51
56
required for the test tenant:
@@ -56,7 +61,7 @@ required for the test tenant:
56
61
## Documentation
57
62
58
63
To make it easier to document new resources a handy script is available. The
59
- script can output documentation of a resource in markdown format, using the
64
+ script can output documentation of a resource in Markdown format, using the
60
65
schema of the resource itself.
61
66
62
67
``` sh
@@ -80,4 +85,4 @@ git push origin vX.Y.Z
80
85
81
86
This will trigger the
82
87
[ Release] ( https://github.com/alexkappa/terraform-provider-auth0/actions/workflows/release.yml )
83
- GitHub Action which creates a new release.
88
+ GitHub Action which creates a new release.
0 commit comments