Requirements
Building The Provider
- Clone the repository
- Enter the repository directory
- Build the provider using the Go
install
command:
go install
Adding Dependencies
This provider uses Go modules.
Please see the Go documentation for the most up to date information about using Go modules.
To add a new dependency github.com/author/dependency
to your Terraform provider:
go get github.com/author/dependency
go mod tidy
Then commit the changes to go.mod
and go.sum
.
Using the provider
Provider configuration
terraform {
required_providers {
replicated = {
source = "registry.terraform.io/replicated/replicated"
}
}
}
provider "replicated" {
api_token = "your api token"
}
Resource configuration
resource "replicated_cluster" "tf_cluster" {
distribution = "kind"
wait_duration = "10m"
ttl = "30m"
instance_type = "r1.large"
}
Developing the Provider
If you wish to work on the provider, you'll first need Go installed on your machine (see Requirements above).
To compile the provider, run go install
. This will build the provider and put the provider binary in the $GOPATH/bin
directory.
To generate or update documentation, run go generate
.
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.
make testacc