hashicorp/consul-terraform-sync

Consul-Terraform-Sync

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

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

如何使用此镜像

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

运行要求

• 运行中的Consul代理，供Consul-Terraform-Sync连接
• Consul-Terraform-Sync的https://www.consul.io/docs/nia/configuration

以守护进程模式运行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状态文件管理。网络驱动程序和配置的https://www.consul.io/docs/nia/configuration#backend%E5%86%B3%E5%AE%9A%E7%8A%B6%E6%80%81%E6%96%87%E4%BB%B6%E7%9A%84%E5%AD%98%E5%82%A8%E4%BD%8D%E7%BD%AE%EF%BC%8C%E5%A6%82Consul KV或Terraform Cloud。

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

执行Consul-Terraform-Sync CLI

Consul-Terraform-Sync提供https://www.consul.io/docs/nia/cli/task%EF%BC%8C%E5%8F%AF%E9%80%9A%E8%BF%87%60docker 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镜像支持https://www.consul.io/docs/nia/configuration%E4%B8%AD%E6%8F%90%E5%88%B0%E7%9A%84%E6%89%80%E6%9C%89%E7%8E%AF%E5%A2%83%E5%8F%98%E9%87%8F%EF%BC%8C%E5%8F%AF%E9%80%9A%E8%BF%87Docker -e标志传递给容器：

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