akamai/cli-dns Docker镜像文档

镜像概述和主要用途

akamai/cli-dns Docker镜像是Akamai DNS CLI工具的容器化封装，基于akamai/cli-dns项目构建。该镜像提供轻量级、隔离的环境，用于通过命令行管理Akamai DNS服务，无需在本地系统安装依赖（如Node.js、API客户端等）。适用于需要快速部署、环境隔离或自动化DNS管理流程的场景。

核心功能和特性

核心功能

• 管理DNS区域：创建、删除、列出及查询区域详情
• 管理DNS记录：添加、修改、删除A/AAAA/CNAME等各类DNS记录
• 批量操作：支持通过CSV文件导入/导出DNS记录，实现批量更新
• 元数据管理：查询区域状态、TTL配置、名称服务器信息
• API集成：与Akamai DNS API v2深度集成，支持最新功能

特性

• 轻量级：基于Alpine基础镜像，镜像体积小（<100MB）
• 环境隔离：容器化运行，避免本地依赖冲突
• 安全认证：支持Akamai标准认证机制（.edgerc文件或环境变量）
• 跨平台：兼容任何支持Docker的操作系统（Linux/macOS/Windows）
• 版本同步：定期更新以同步上游CLI工具及API版本

使用场景和适用范围

典型场景

• DevOps自动化：CI/CD流程中集成DNS记录更新（如部署时自动指向新服务器IP）
• 批量管理：系统管理员批量迁移或修改DNS记录（如域名更换、服务器迁移）
• 开发环境配置：快速搭建隔离的DNS测试环境，避免影响生产配置
• 临时操作：无需本地安装工具，临时执行单次DNS查询或修改

适用范围

• 使用Akamai DNS服务的企业/个人用户
• 依赖命令行工具进行DNS管理的技术人员（如DevOps工程师、系统管理员）
• 需要容器化部署或环境隔离的场景
• 自动化脚本或流水线（如Jenkins、GitHub Actions）中集成DNS操作

使用方法和配置说明

前提条件

• 已安装Docker Engine（20.10+）或Docker Desktop
• 拥有Akamai API访问凭证（需包含DNS管理权限），并配置在.edgerc文件中（获取方法）

获取镜像

从Docker Hub或私有仓库拉取镜像：

bash
docker pull akamai/cli-dns:latest  # 拉取最新版本  
# 或指定版本（如v3.0.0）  
docker pull akamai/cli-dns:v3.0.0  

基本使用方法

命令格式

bash
docker run --rm [选项] akamai/cli-dns dns <子命令> [参数]  

• --rm：容器退出后自动清理
• [选项]：挂载文件、环境变量等配置
• dns <子命令>：CLI核心命令（如list-zones、add-record）

认证配置

Akamai CLI通过.edgerc文件或环境变量进行API认证，推荐使用.edgerc文件（更安全）：

方法1：挂载.edgerc文件（推荐）

将本地.edgerc文件挂载到容器内默认路径（/root/.edgerc）：

bash
# 示例：列出所有DNS区域  
docker run --rm -v $(pwd)/.edgerc:/root/.edgerc akamai/cli-dns dns list-zones  

方法2：环境变量认证

通过环境变量传递API凭证（适用于无法挂载文件的场景）：

bash
docker run --rm \
  -e AKAMAI_CLIENT_TOKEN="your-client-token" \
  -e AKAMAI_CLIENT_SECRET="your-client-secret" \
  -e AKAMAI_ACCESS_TOKEN="your-access-token" \
  akamai/cli-dns dns list-zones  

常用命令示例

1. 列出所有DNS区域

bash
docker run --rm -v $(pwd)/.edgerc:/root/.edgerc akamai/cli-dns dns list-zones  

2. 查询指定区域详情

bash
docker run --rm -v $(pwd)/.edgerc:/root/.edgerc akamai/cli-dns dns get-zone --zone example.com  

3. 添加A记录

bash
docker run --rm -v $(pwd)/.edgerc:/root/.edgerc akamai/cli-dns dns add-record \
  --zone example.com \
  --type A \
  --name www \
  --target 192.168.1.1 \
  --ttl 300  

4. 批量导入记录（从CSV）

bash
docker run --rm \
  -v $(pwd)/.edgerc:/root/.edgerc \
  -v $(pwd)/records.csv:/data/records.csv \
  akamai/cli-dns dns import-records --zone example.com --input /data/records.csv  

Docker部署示例

docker run 完整示例（管理单条记录）

bash
# 添加CNAME记录并验证  
docker run --rm -v $(pwd)/.edgerc:/root/.edgerc akamai/cli-dns dns add-record \
  --zone example.com \
  --type CNAME \
  --name blog \
  --target cdn.example.com \
  --ttl 600 && \
echo "记录添加成功，查询结果：" && \
docker run --rm -v $(pwd)/.edgerc:/root/.edgerc akamai/cli-dns dns get-record \
  --zone example.com \
  --name blog \
  --type CNAME  

docker-compose 配置示例（用于CI/CD集成）

创建docker-compose.yml：

yaml
version: '3'
services:
  akamai-dns-cli:
    image: akamai/cli-dns:latest
    volumes:
      - ./.edgerc:/root/.edgerc  # 挂载认证文件
      - ./dns-scripts:/scripts   # 挂载自定义脚本（如批量操作脚本）
    environment:
      - EDGERC_SECTION=dns       # 指定.edgerc中的配置节（默认：dns）
    command: /scripts/batch-update.sh  # 执行自定义批量更新脚本

运行：

bash
docker-compose up

配置参数与环境变量

环境变量

挂载文件

注意事项

1. 权限要求：.edgerc文件中的API凭证需具备DNS Write权限（管理记录）或DNS Read权限（查询）。
2. 版本兼容性：确保镜像版本与Akamai DNS API版本兼容（推荐使用latest标签获取最新兼容版本）。
3. 文件权限：挂载的.edgerc文件需设置权限为600（仅所有者可读），避免容器内权限错误。
4. 日志输出：添加-e DEBUG=true环境变量可启用详细API日志，用于故障排查。