Install Consul-Terraform-Sync
Refer to the introduction tutorial for details about installing, configuring, and running Consul-Terraform-Sync on your local machine with the Terraform driver.
Installing Consul-Terraform-Sync
To install Consul-Terraform-Sync, find the appropriate package for your system and download it as a zip archive. Unzip the package to extract the binary named consul-terraform-sync. Move the consul-terraform-sync binary to a location available on your PATH.
You can also install Consul-Terraform-Sync as a Docker container or build the binary from source.
Once installed, verify the installation works by prompting the help option.
Connect your Consul Cluster
Consul-Terraform-Sync connects with your Consul cluster in order to monitor the Consul catalog for service changes. These service changes lead to downstream updates to your network devices. You can configure your Consul cluster in Consul-Terraform-Sync with the Consul block. Below is an example:
Connect your Network Device
Consul-Terraform-Sync interacts with your network device through a network driver. For the Terraform network driver, Consul-Terraform-Sync uses Terraform providers to make changes to your network infrastructure resources. You can reference existing provider docs on the Terraform Registry to configure each provider or create a new Terraform provider.
Once you have identified a Terraform provider for all of your network devices, you can configure them in Consul-Terraform-Sync with a terraform_provider
block for each network device. Below is an example:
This provider is then used by task(s) to execute a Terraform module that will update the related network device.
Multiple Instances per Provider
You might have multiple instances of the same type of network device; for example, multiple instances of a firewall or load balancer. You can configure each instance with its own provider block and distinguish it by the alias
meta-argument. See multiple provider configurations for more details and an example of the configuration.