The VastData Terrafrom provider is a provider to manage VastData clusters resources.
Table of Contents
- Terraform Provider Vastdata
Configuring Provider to be downloaded from Terraform Registry
In order to configure the provider to be used directly from Terraform registry, use the following provider defenition.
terraform {
required_providers {
vastdata = {
source = "vast-data/vastdata"
}
}
}
Now when running terraform init
it will download the VastData provider from the Terraform Registry
In order to build the provider you can simpy use go install
$ go install github.com/vast-data/terraform-provider-vastdata
To install a specfic tag/branch version use the following syntax
$ go install github.com/vast-data/terraform-provider-vastdata@<branch/tag>
Check you go GOBIN path for the compiled file named terraform-provider-vastdata
In order to build the provider locally you will need to first clone the repo.
$ git clone https://github.com/vast-data/terraform-provider-vastdata.git
$ cd terraform-provider-vastdata
If you wish to checkout a specific tag check out the tag.
$ git checkout <tag name>
In order to build the code locally you need to have GNU Make installed
To build the code ru the following command
make build
This will build the provider binary with the name terraform-provider-vastdata directly into the build directory.
In order to build to a differant directory other than build , specify BUILD_DEST=<build directory>
make build BUILD_DEST=some/other/directory
dev_overrides is a terraform configuration that will allow to overrides any other method of obtaining the terrafrom plugin binary and forces terrafrom to obtain the provider binary from a specific path locally.
This file is being scanned every time you run terrafrom if you dont want to create/edit it you can specify the environment vasriable TF_CLI_CONFIG_FILE=path/to/configuration/file
add the following configurations to the configuration file.
provider_installation {
dev_overrides {
"vastdata/vastdata" = "/some/directory/where/the/binary/is/stored"
}
direct {}
}
When creating a terrafrom configration specify the following at the file
terraform {
required_providers {
vastdata = {
source = "vastdata/vastdata"
}
}
}
Now you can define providers.
provider vastdata {
username = "<username>"
port = <port>
password = "<password>"
host = "<address>"
skip_ssl_verify = true
version_validation_mode = "warn"
}
While it is common to submit Bugs/Feature Requests using github issues, we would rather if you open a Bug/Feature Request to Vast Data support at [email protected]