akamai/terraform-cli

Akamai Terraform CLI 镜像文档

镜像概述

Akamai Terraform CLI镜像包含Terraform命令行工具及Akamai Provider插件，提供容器化运行环境，用于通过Terraform管理Akamai云服务资源（如CDN、边缘计算、安全产品等）。镜像封装了依赖组件，可直接在容器环境中执行Akamai资源的配置、部署、更新与销毁操作，无需本地安装Terraform及Akamai Provider。

核心功能与特性

• Akamai资源管理：支持通过Terraform HCL配置文件定义Akamai资源（如属性、规则、证书等），实现基础设施即代码(IaC)。
• 完整Terraform命令支持：兼容Terraform标准工作流命令，包括init（初始化配置）、plan（预览变更）、apply（应用配置）、destroy（销毁资源）等。
• Akamai API集成：内置Akamai API认证机制，支持通过环境变量或配置文件注入API凭证（Client Token、Client Secret、Access Token）。
• 跨平台兼容性：容器化设计，可在Linux、macOS、Windows等支持Docker的系统中运行，确保开发、测试、生产环境一致性。
• 版本控制：提供多版本镜像标签，可指定Terraform及Akamai Provider版本，满足不同项目兼容性需求。

使用场景与适用范围

• 开发环境：开发者本地快速验证Akamai Terraform配置，无需手动安装依赖。
• CI/CD流水线：集成到Jenkins、GitHub Actions等CI/CD工具，实现Akamai资源的自动化部署与测试。
• 多环境管理：通过容器隔离不同环境（开发、测试、生产）的Terraform状态文件，避免配置冲突。
• 团队协作：统一团队使用的Terraform及Provider版本，减少"本地环境不一致"导致的问题。

使用方法与配置说明

前提条件

• 已安装Docker Engine（20.10+推荐）。
• 已获取Akamai API凭证（需联系Akamai管理员创建，包含AKAMAI_CLIENT_TOKEN、AKAMAI_CLIENT_SECRET、AKAMAI_ACCESS_TOKEN）。
• 本地准备好Akamai Terraform配置文件（通常为main.tf、variables.tf、terraform.tfvars等）。

Docker Run命令示例

基本用法（执行Terraform init）

bash
docker run --rm \
  -v $(pwd):/workspace \
  -e AKAMAI_CLIENT_TOKEN="your-client-token" \
  -e AKAMAI_CLIENT_SECRET="your-client-secret" \
  -e AKAMAI_ACCESS_TOKEN="your-access-token" \
  docker.xuanyuan.run/akamai/cli-terraform:latest \
  terraform init /workspace

预览资源变更（执行Terraform plan）

bash
docker run --rm \
  -v $(pwd):/workspace \
  -e AKAMAI_CLIENT_TOKEN="your-client-token" \
  -e AKAMAI_CLIENT_SECRET="your-client-secret" \
  -e AKAMAI_ACCESS_TOKEN="your-access-token" \
  docker.xuanyuan.run/akamai/cli-terraform:latest \
  terraform plan -var-file=/workspace/terraform.tfvars /workspace

应用资源配置（执行Terraform apply）

bash
docker run --rm \
  -v $(pwd):/workspace \
  -e AKAMAI_CLIENT_TOKEN="your-client-token" \
  -e AKAMAI_CLIENT_SECRET="your-client-secret" \
  -e AKAMAI_ACCESS_TOKEN="your-access-token" \
  docker.xuanyuan.run/akamai/cli-terraform:latest \
  terraform apply -auto-approve /workspace

Docker Compose配置示例

创建docker-compose.yml文件，简化多命令执行：

yaml
version: '3'
services:
  akamai-terraform:
    image: docker.xuanyuan.run/akamai/cli-terraform:latest
    volumes:
      - ./terraform:/workspace  # 挂载本地Terraform配置目录
    environment:
      - AKAMAI_CLIENT_TOKEN=${AKAMAI_CLIENT_TOKEN}  # 从系统环境变量读取凭证
      - AKAMAI_CLIENT_SECRET=${AKAMAI_CLIENT_SECRET}
      - AKAMAI_ACCESS_TOKEN=${AKAMAI_ACCESS_TOKEN}
    working_dir: /workspace  # 设置工作目录为挂载的配置目录

使用时，通过docker-compose run执行命令：

bash
# 初始化配置
docker-compose run --rm akamai-terraform terraform init

# 预览变更
docker-compose run --rm akamai-terraform terraform plan

# 应用配置
docker-compose run --rm akamai-terraform terraform apply -auto-approve

配置参数说明

环境变量

挂载卷

• 推荐将本地Terraform配置目录挂载到容器内/workspace目录，确保配置文件可被容器访问。
• 如需持久化Terraform状态文件，可单独挂载状态文件目录（如-v ./tfstate:/workspace/.terraform/）。

注意事项

• 敏感凭证（如API密钥）建议通过环境变量注入，避免硬编码到配置文件或镜像中。
• 生产环境使用时，建议指定具体镜像标签（如akamai/cli-terraform:1.2.3）而非latest，确保版本稳定性。
• 执行terraform destroy命令前，务必通过terraform plan确认变更范围，避免误删资源。
• 详细使用文档及配置示例可参考官方GitHub仓库：https://github.com/akamai/cli-terraform。