Some general information about this provider.
Requirements
- Terraform
v0.13.x
+
- Go 1.16 (to build the provider plugin)
Usage
provider "split" {
version = "~> 0.1.0"
}
This provider is not compatible with terraform v0.12
and below.
Development
If you wish to work on the provider, you'll first need Go installed on your machine (version 1.14+ is required).
Build the Provider
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-split
...
Using the Provider
To use the dev provider with local Terraform, copy the freshly built plugin into Terraform's local plugins directory:
cp $GOPATH/bin/terraform-provider-split ~/.terraform.d/plugins/
Set the split provider without a version constraint:
provider "split" {}
Then, initialize Terraform:
terraform init
Testing
Please see the TESTING guide for detailed instructions on running tests.
Updating or adding dependencies
This project uses Go Modules for dependency management.
This example will fetch a module at the release tag and record it in your project's go.mod
and go.sum
files.
It's a good idea to run go mod tidy
afterward and then go mod vendor
to copy the dependencies into a vendor/
directory.
If a module does not have release tags, then module@SHA
can be used instead.