akamai/eaa

Akamai EAA CLI 镜像文档

镜像概述

本镜像包含 Akamai Enterprise Application Access (EAA) 的官方命令行工具（CLI），用于通过命令行界面管理和配置 Akamai EAA 服务。EAA 是 Akamai 提供的企业级应用访问解决方案，帮助企业安全地发布和管理内部应用。该镜像封装了 cli-eaa 工具，可直接通过 Docker 容器运行，无需在主机系统中单独安装依赖。

项目主页：https://github.com/akamai/cli-eaa

核心功能

• 服务管理：创建、更新、删除 EAA 应用程序和服务
• 配置操作：管理身份提供商、访问策略、用户组和权限设置
• 状态监控：查询 EAA 服务状态、应用程序可用性和连接信息
• 批量操作：支持通过命令行脚本实现配置的批量导入/导出和自动化部署
• 版本兼容：与 Akamai EAA 服务 API 保持版本同步，确保功能兼容性

使用场景

• 企业管理员通过命令行自动化管理 EAA 服务配置
• 在 CI/CD 流水线中集成 EAA 配置部署流程
• 无图形界面环境（如服务器、容器平台）中操作 EAA 服务
• 需要批量处理 EAA 应用配置或生成配置报告的场景

使用方法

前提条件

• 已安装 Docker 引擎（20.10+ 版本推荐）
• 拥有 Akamai EAA 服务的访问凭证（API 密钥、客户端令牌等）

镜像获取

从 Docker 仓库拉取镜像（假设镜像名称为 akamai/cli-eaa，实际名称请以官方发布为准）：

bash
docker pull akamai/cli-eaa:latest

基本使用示例

1. 查看 CLI 版本

bash
docker run --rm akamai/cli-eaa:latest eaa --version

2. 执行基本命令

运行容器并执行 EAA CLI 命令（如查看应用列表）：

bash
docker run --rm \
  -e AKAMAI_EDGERC=/edgerc \
  -v /path/to/local/edgerc:/edgerc \
  akamai/cli-eaa:latest \
  eaa app list

说明：-v /path/to/local/edgerc:/edgerc 挂载本地 Akamai 配置文件（通常为 ~/.edgerc），包含 API 访问凭证；-e AKAMAI_EDGERC 指定配置文件路径。

配置说明

EAA CLI 依赖 Akamai 凭证进行身份验证，推荐通过以下方式之一配置：

1. 挂载配置文件（推荐）

将本地 ~/.edgerc 文件挂载到容器中，文件格式示例：

ini
[default]
client_secret = <your-client-secret>
host = eaa-api.akamai.com
access_token = <your-access-token>
client_token = <your-client-token>

2. 环境变量配置

通过环境变量传递凭证（不推荐用于生产环境，存在凭证泄露风险）：

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> \
  -e AKAMAI_HOST=eaa-api.akamai.com \
  akamai/cli-eaa:latest \
  eaa app list

常用命令参考

• eaa app list：列出所有 EAA 应用程序
• eaa app show <app-id>：查看指定应用程序详情
• eaa app create -f <config-file.json>：通过 JSON 文件创建应用程序
• eaa service status：检查 EAA 服务状态
• eaa policy list：列出访问策略

注意事项

• 容器默认以非 root 用户运行，确保挂载的本地文件具有适当权限（如 ~/.edgerc 权限设置为 600）
• 定期更新镜像以获取最新功能和安全修复：docker pull akamai/cli-eaa:latest
• 详细命令文档请参考官方 GitHub 仓库：https://github.com/akamai/cli-eaa