Akamai CLI 预安装版 Docker 镜像文档

1. 镜像概述

本镜像基于 Akamai CLI 构建，预安装了大多数常用 Akamai CLI 功能包及第三方实用工具（如 HTTPie、Terraform），旨在提供开箱即用的 Akamai 服务管理环境，简化 Akamai 相关操作的配置与执行流程。

2. 核心功能与特性

2.1 预安装组件

• Akamai CLI 核心包：包含 property、dns、edgeworkers、iam、gtm 等常用服务管理模块
• 第三方工具：
  • HTTPie：命令行 HTTP 客户端，用于 API 调试与测试
  • Terraform：基础设施即代码（IaC）工具，支持 Akamai 资源编排

2.2 镜像特性

• 环境隔离：独立运行环境，避免主机系统依赖冲突
• 即开即用：无需手动安装 CLI 包及依赖，节省环境配置时间
• 版本一致性：固定工具版本，确保团队内操作环境统一
• 轻量级：基于 Alpine 或 Debian slim 基础镜像，优化镜像体积

3. 使用场景

3.1 日常管理场景

• Akamai 边缘服务（如 CDN、DNS、WAF）的配置查询、更新与部署
• 批量操作执行（如多域名配置同步、证书轮换）

3.2 自动化流程集成

• CI/CD 流水线：嵌入 Jenkins、GitLab CI 等平台，实现 Akamai 资源自动化部署
• 定时任务：通过 Cron 或 Kubernetes CronJob 执行周期性配置检查与更新

3.3 多环境协作

• 开发/测试/生产环境配置隔离，通过挂载不同配置文件快速切换环境
• 团队共享统一操作工具链，降低协作成本

4. 使用方法

4.1 获取镜像

从 Docker 仓库拉取镜像（假设镜像名称为 akamai/cli:preinstalled）：

docker pull akamai/cli:preinstalled

4.2 基本运行命令

4.2.1 交互式运行

启动容器并进入交互式终端，直接执行 Akamai CLI 命令：

docker run -it --rm akamai/cli:preinstalled sh

进入容器后验证 CLI 可用性：

akamai --version  # 查看 Akamai CLI 版本
akamai property --help  # 查看 property 模块帮助
http --version  # 验证 HTTPie 安装
terraform --version  # 验证 Terraform 安装

4.2.2 直接执行命令

无需进入容器，直接在主机执行 CLI 命令（适用于脚本或自动化场景）：

# 示例：查询 Akamai Property 配置
docker run --rm akamai/cli:preinstalled akamai property get --propertyId 12345 --version 1

4.3 环境变量配置

通过环境变量注入 Akamai API 凭证及运行时配置，避免敏感信息硬编码。

配置示例

通过环境变量传递 edgerc 凭证：

# 1. 将本地 edgerc 文件编码为 Base64
EDGERC_BASE64=$(base64 -w 0 ~/.edgerc)

# 2. 运行容器时注入环境变量
docker run --rm \
  -e AKAMAI_EDGERC="${EDGERC_BASE64}" \
  -e AKAMAI_EDGERC_SECTION="production" \
  akamai/cli:preinstalled \
  akamai dns zone list

4.4 挂载本地文件

通过挂载主机目录或文件，实现配置持久化或本地脚本/资源复用：

# 挂载本地 edgerc 文件到容器默认路径（推荐，避免 Base64 编码）
docker run -it --rm \
  -v ~/.edgerc:/root/.edgerc:ro \  # 只读挂载本地凭证文件
  -v $(pwd)/scripts:/scripts \     # 挂载本地脚本目录
  akamai/cli:preinstalled \
  sh -c "cd /scripts && ./deploy-akamai.sh"  # 执行本地脚本

4.5 Docker Compose 集成

创建 docker-compose.yml 配置文件，整合 Akamai CLI 到多容器应用：

version: '3.8'

services:
  akamai-cli:
    image: akamai/cli:preinstalled
    environment:
      - AKAMAI_EDGERC_SECTION=staging
    volumes:
      - ~/.edgerc:/root/.edgerc:ro  # 挂载本地凭证
      - ./terraform:/terraform      # 挂载 Terraform 配置目录
    working_dir: /terraform
    command: ["terraform", "apply"]  # 启动时执行 Terraform 部署

启动服务：

docker-compose up

5. 注意事项

• 敏感信息安全：edgerc 文件包含 API 密钥，建议通过挂载文件（而非环境变量）传递，并设置文件权限为只读（ro）。
• 版本控制：生产环境建议指定镜像标签（如 :v1.2.3），避免自动更新导致兼容性问题。
• 资源清理：使用 --rm 参数确保临时容器退出后自动删除，避免磁盘空间占用。