tfc-agent Docker 镜像下载 - 轩辕镜像

Terraform Cloud Agent（含额外依赖）镜像文档

概述

本镜像基于官方Terraform Cloud Agent构建，额外集成常用工具、云提供商CLI及依赖组件，旨在解决原生Agent在复杂场景下依赖不足的问题。通过扩展依赖库，支持在私有网络环境中执行包含特定工具链需求的Terraform运行，适用于企业级基础设施即代码（IaC）部署与管理。

核心功能与特性

• 扩展依赖支持：集成常用工具（如curl、jq、git）、主流云厂商CLI（AWS CLI、Azure CLI、GCP SDK）及特定运行时（Python、Node.js基础环境），满足多样化Terraform配置需求。
• 原生功能保留：完整继承Terraform Cloud Agent核心能力，包括与Terraform Cloud/Enterprise的通信、任务执行、状态管理等原生功能。
• 环境兼容性：支持在隔离网络环境（无公网直接访问权限）中运行，通过私有镜像仓库分发，符合企业安全规范。
• 灵活配置：支持通过环境变量、数据卷挂载自定义依赖或配置文件，适配不同业务场景。

使用场景

• 私有网络部署：企业内网环境中执行Terraform计划与应用，无需公网访问外部依赖源。
• 工具链增强需求：Terraform配置中涉及自定义脚本（如Bash/Python）、云资源API调用（需云厂商CLI）或第三方工具集成（如Vault、Consul）的场景。
• CI/CD流水线集成：作为Jenkins、GitLab CI等持续集成工具的执行节点，提供一站式IaC部署能力。
• 多云管理场景：在混合云或多云环境中，通过预安装的多厂商CLI简化跨平台资源管理。

使用方法与配置说明

基本部署（Docker Run）

通过以下命令启动镜像，需替换环境变量为实际值：

docker run -d \
  --name terraform-cloud-agent-extended \
  -e TFE_AGENT_TOKEN="your-agent-token" \
  -e TFE_ADDRESS="[***]" \
  -e AGENT_NAME="extended-agent-01" \
  -v /path/to/custom-tools:/opt/custom-tools \  # 可选：挂载自定义工具目录
  your-registry/terraform-cloud-agent-extended:latest

核心环境变量

Docker Compose配置示例

version: '3.8'
services:
  terraform-agent:
    image: your-registry/terraform-cloud-agent-extended:latest
    container_name: tfe-agent-extended
    environment:
      - TFE_AGENT_TOKEN=your-agent-token
      - TFE_ADDRESS=[***]
      - AGENT_NAME=prod-agent-01
      - TFE_AGENT_LOG_LEVEL=INFO
    volumes:
      - agent-data:/home/terraform/.terraform.d  # 持久化Agent状态数据
      - /var/run/docker.sock:/var/run/docker.sock  # 可选：如需在Agent内使用Docker
    restart: unless-stopped

volumes:
  agent-data:  # 持久化卷，保存Agent配置与缓存

自定义配置

• 添加工具：通过CUSTOM_DEPENDENCIES环境变量指定启动时安装的工具（如"awscli kubectl"），或挂载/opt/custom-tools目录放置预编译工具。
• 持久化数据：挂载/home/terraform/.terraform.d卷以保存插件缓存、状态文件，加速后续运行。
• 网络代理：设置HTTP_PROXY、HTTPS_PROXY环境变量配置代理，适应内网网络策略。

验证与监控

• 查看Agent日志：docker logs -f terraform-cloud-agent-extended
• 在Terraform Cloud控制台的「Agents」页面确认Agent状态为「在线」
• 执行测试运行：通过Terraform Cloud触发计划，检查Agent是否成功接收并执行任务

注意事项

• 镜像需定期更新以同步官方Terraform Cloud Agent版本及依赖安全补丁。
• TFE_AGENT_TOKEN为敏感信息，建议通过容器编排平台的密钥管理功能注入（如Kubernetes Secrets）。
• 自定义依赖可能增加镜像体积，生产环境建议按需精简依赖以优化资源占用。