mintel/tfc-agent

tfc-agent Docker镜像文档

镜像概述

tfc-agent是基于Terraform Cloud Agent构建的Docker镜像，额外集成了模块所需的软件组件。该镜像旨在提供开箱即用的环境，支持在私有网络或特定环境中执行Terraform Cloud作业，确保与项目模块依赖的软件完全兼容。

核心功能和特性

• 兼容性保障：基于官方Terraform Cloud Agent构建，保持与Terraform Cloud服务的原生兼容性
• 预置软件支持：预安装模块运行所需的额外软件，减少部署时的环境配置步骤
• 环境适应性：支持在私有网络、隔离环境中运行，满足企业安全与网络隔离需求
• 轻量化设计：在满足功能需求的前提下保持镜像精简，优化资源占用

使用场景和适用范围

• 企业内部部署：需在企业私有环境中执行Terraform Cloud作业的场景
• 模块依赖管理：项目模块依赖特定软件，需要预配置运行环境的场景
• 网络隔离环境：无法直接访问公共服务，需在隔离网络中运行Terraform代理的场景
• 标准化部署：需要统一Terraform运行环境，确保团队协作一致性的场景

使用方法和配置说明

基本运行命令

bash
docker run -e TFC_AGENT_TOKEN="your-agent-token" tfc-agent

环境变量配置

高级配置示例

自定义代理名称与日志级别

bash
docker run \
  -e TFC_AGENT_TOKEN="your-agent-token" \
  -e TFC_AGENT_NAME="production-agent-01" \
  -e TFC_AGENT_LOG_LEVEL="debug" \
  tfc-agent

持久化数据与配置

挂载本地目录以持久化代理配置和缓存数据：

bash
docker run \
  -e TFC_AGENT_TOKEN="your-agent-token" \
  -v /path/to/local/config:/agent/config \
  -v /path/to/local/cache:/agent/cache \
  tfc-agent

Docker Compose配置

创建docker-compose.yml文件：

yaml
version: '3'
services:
  tfc-agent:
    image: tfc-agent
    environment:
      - TFC_AGENT_TOKEN=your-agent-token
      - TFC_AGENT_NAME=compose-agent
      - TFC_AGENT_LOG_LEVEL=info
    volumes:
      - ./agent-config:/agent/config
      - ./agent-cache:/agent/cache
    restart: unless-stopped

启动服务：

bash
docker-compose up -d