xtruder/deployer

deployer镜像说明

镜像概述

deployer镜像旨在自动应用Terraform资源，通过挂载tf或tf.json文件到指定目录，实现资源配置的自动检测与部署，适用于需要自动化管理基础设施即代码（IaC）的场景。

核心功能

1. 自动检测并应用指定目录下的*.tf和*.tf.json文件变化
2. 支持etcd v3作为Terraform状态存储后端
3. 可通过环境变量配置错误或成功后的行为（退出或重试）
4. 适配Kubernetes环境，支持ConfigMap卷挂载配置

使用场景

• 自动化部署Terraform管理的基础设施资源
• Kubernetes集群中通过ConfigMap管理Terraform配置文件的场景
• 需要持续监控并自动应用Terraform配置变化的场景

配置说明

依赖环境

• etcd v3
• Docker
• Kubernetes（可选）

环境变量

• EXIT_ON_ERROR: 设置为非空值时，应用出错则退出；否则会重试直到成功
• EXIT_ON_SUCCESS: 设置为非空值时，应用成功则退出；否则会在配置变化时重试

挂载要求

将Terraform配置文件所在目录挂载到容器内的/usr/local/deployer/inputs/路径

部署示例

Docker Compose示例

执行以下命令部署（需提前准备docker-compose.yaml和./inputs目录下的配置文件）：

bash
docker-compose up --build

Kubernetes ConfigMap示例

以下是使用ConfigMap挂载Terraform配置的示例：

json
{
  "mysql": {
    "apiVersion": "v1",
    "kind": "ConfigMap",
    "data": {
      "main.tf.json": "{\"provider\":{\"mysql\":{\"endpoint\":\"mysql:3306\",\"password\":\"example\",\"username\":\"root\"}},\"resource\":{\"mysql_database\":{\"database1\":{\"lifecycle\":{\"prevent_destroy\":true},\"name\":\"database1\"}}},\"terraform\":{\"backend\":{\"etcdv3\":{\"endpoints\":[\"[***]\"],\"prefix\":\"terraform-tfstate/\"}}}}"
    },
    "metadata": {
      "name": "mysql",
      "namespace": "default"
    }
  }
}