hashicorp/consul-terraform-sync

Consul-Terraform-Sync

Consul-Terraform-Sync (CTS) 扩展Consul功能，通过Terraform实现网络基础设施自动化。CTS监控L7网络层变化并使用Terraform动态更新基础设施，您可以通过定义Terraform模块自定义自动化以满足团队的基础设施需求。

• 文档：consul.io/docs/nia
• GitHub：https://github.com/hashicorp/consul-terraform-sync
• 社区门户：discuss.hashicorp.com

如何使用此镜像

Docker镜像 https://hub.docker.com/r/hashicorp/consul-terraform-sync 可用于在调度环境中运行Consul-Terraform-Sync。

运行要求

• 运行中的Consul代理，供Consul-Terraform-Sync连接
• Consul-Terraform-Sync的配置文件

以守护进程模式运行Consul-Terraform-Sync

启动Consul-Terraform-Sync实例：

$ docker run --name cts -d --rm \
  -v $(pwd):/consul-terraform-sync/config \
  hashicorp/consul-terraform-sync

必需配置

使用Docker -v标志设置配置文件：

-v标志将当前工作目录作为卷挂载到容器预期加载配置文件的路径/consul-terraform-sync/config。如果配置文件位于其他位置，请将$(pwd)替换为绝对路径。

Terraform状态文件

重启容器后，CTS任务的快照由相应的Terraform状态文件管理。网络驱动程序和配置的Terraform后端决定状态文件的存储位置，如Consul KV或Terraform Cloud。

注意：在生产环境中以Docker容器部署Consul-Terraform-Sync时，请勿使用本地后端。容器停止后，Terraform状态文件将不会保留。

执行Consul-Terraform-Sync CLI

Consul-Terraform-Sync提供客户端CLI，可通过docker exec使用。

以下示例通过Docker在名为cts的容器中运行CLI启用任务：

$ docker exec -t cts consul-terraform-sync task enable task_a
==> 检查启用'task_a'后对资源的更改...

    生成Consul Terraform Sync将使用Terraform执行的计划

无变更。您的基础设施与配置匹配。

Terraform已将实际基础设施与配置进行比较，未发现差异，因此无需进行任何更改。

==> 'task_a' 启用完成！

环境变量

Docker镜像支持配置文档中提到的所有环境变量，可通过Docker -e标志传递给容器：

$ docker run --name cts -d --rm \
  -v $(pwd):/consul-terraform-sync/config \
  -e "CONSUL_HTTP_ADDR=consul.example.com" \
  hashicorp/consul-terraform-sync