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，版本列表参考 Docker Hub 镜像标签）。

基本使用方法

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  # 默认命令（可替换为实际需要执行的命令）

启动服务：