akamai/cli

Akamai CLI Docker 镜像文档

镜像概述和主要用途

Akamai CLI Docker 镜像是 Akamai CLI（命令行工具）的容器化版本，旨在提供一种无需本地安装即可从命令行管理和配置 Akamai 服务的便捷方式。该镜像封装了 Akamai CLI 及其依赖环境，支持跨平台运行，适用于需要通过命令行高效操作 Akamai 服务（如 CDN、边缘计算、安全产品等）的场景。

核心功能和特性

核心功能

• 从命令行管理 Akamai 服务，包括 CDN 配置、边缘工作器部署、安全策略管理等。
• 支持 Akamai 各产品线的 CLI 插件扩展，如 akamai cdn, akamai edgeworkers, akamai waf 等。
• 与 Akamai API 无缝集成，通过命令行执行各类服务操作。

镜像特性

• 环境隔离：容器化运行，避免本地环境依赖冲突。
• 版本控制：可指定 CLI 版本，确保工具版本一致性。
• 跨平台兼容：支持任何运行 Docker 的操作系统（Linux、macOS、Windows）。
• 即开即用：无需手动安装依赖，拉取镜像后可直接运行。

使用场景和适用范围

适用场景

• 开发者通过命令行自动化 Akamai 服务配置与部署流程。
• 运维人员在容器化环境中快速部署 Akamai CLI，执行日常运维操作。
• CI/CD 流水线中集成 Akamai 服务管理步骤（如自动更新 CDN 配置）。
• 需要临时使用 Akamai CLI 而不想在本地安装的场景。

适用人群

• 负责 Akamai 服务管理的开发者、运维工程师。
• 需通过命令行与 Akamai API 交互的自动化脚本编写者。
• 容器化环境下的 Akamai 服务操作人员。

使用方法和配置说明

前提条件

• 已安装 Docker 引擎（参考 Docker 官方安装文档）。
• 已获取 Akamai API 凭证（client_token、client_secret、access_token、host），并配置到 ~/.edgerc 文件中（Akamai API 凭证获取指南）。

镜像拉取

Akamai CLI Docker 镜像托管在 Docker Hub，可通过以下命令拉取最新版本：

bash
docker pull akamai/cli

如需指定版本，可添加标签（如 akamai/cli:1.5.0，版本列表参考 https://hub.docker.com/r/akamai/cli/tags%EF%BC%89%E3%80%82

基本使用方法

1. 交互式终端模式

通过交互式终端运行镜像，直接使用 Akamai CLI 命令：

bash
docker run -it -v ~/.edgerc:/root/.edgerc akamai/cli

• -it：启用交互式终端，支持命令行输入。
• -v ~/.edgerc:/root/.edgerc：将本地 Akamai 配置文件（~/.edgerc）挂载到容器内的 /root/.edgerc（容器内默认配置文件路径），用于身份验证。

进入容器后，可直接执行 Akamai CLI 命令，例如：

bash
akamai --version  # 查看 CLI 版本
akamai list        # 列出已安装插件
akamai help        # 获取帮助信息

2. 直接执行命令模式

无需进入容器，直接在宿主机执行 Akamai CLI 命令：

bash
docker run -v ~/.edgerc:/root/.edgerc akamai/cli <command>

示例：查看已安装的 Akamai CLI 插件

bash
docker run -v ~/.edgerc:/root/.edgerc akamai/cli list

配置说明

配置文件（.edgerc）

Akamai CLI 通过 ~/.edgerc 文件存储 API 凭证，格式如下（需替换为实际凭证）：

ini
[default]
client_secret = <your-client-secret>
host = <your-host>
access_token = <your-access-token>
client_token = <your-client-token>

容器内默认读取 /root/.edgerc，因此需通过 -v 参数将宿主机的 ~/.edgerc 挂载到该路径。

环境变量（可选）

如需自定义配置文件路径，可通过 AKAMAI_EDGERC_PATH 环境变量指定：

bash
docker run -e AKAMAI_EDGERC_PATH=/custom/path/.edgerc -v /local/path/.edgerc:/custom/path/.edgerc akamai/cli

插件安装

Akamai CLI 支持通过 install 命令安装插件，例如安装 CDN 管理插件：

bash
docker run -it -v ~/.edgerc:/root/.edgerc akamai/cli install cdn

安装后即可使用 akamai cdn 命令管理 CDN 配置。

Docker Compose 配置示例

如需在容器化项目中集成 Akamai CLI，可使用 docker-compose.yml 简化部署：

yaml
version: '3'
services:
  akamai-cli:
    image: akamai/cli
    volumes:
      - ~/.edgerc:/root/.edgerc  # 挂载本地配置文件
    tty: true  # 启用终端交互
    command: akamai help  # 默认命令（可替换为实际需要执行的命令）

启动服务：

bash
docker-compose up

进入容器终端（如需交互式操作）：

bash
docker-compose exec akamai-cli sh

注意事项

• 确保 ~/.edgerc 文件权限正确（建议设置为 600，避免敏感信息泄露）。
• 如需持久化插件或配置，可额外挂载容器内的 /root/.akamai-cli 目录（插件安装路径）。
• 镜像版本需与 Akamai API 版本兼容，建议使用最新稳定版。