akamai/cloudlets

Cloudlets CLI Docker镜像文档

镜像概述和主要用途

本镜像封装了Akamai Cloudlets CLI工具（https://github.com/akamai/cli-cloudlets%EF%BC%89%EF%BC%8C%E6%8F%90%E4%BE%9B%E8%BD%BB%E9%87%8F%E7%BA%A7%E3%80%81%E5%8F%AF%E7%A7%BB%E6%A4%8D%E7%9A%84%E5%91%BD%E4%BB%A4%E8%A1%8C%E7%8E%AF%E5%A2%83%EF%BC%8C%E7%94%A8%E4%BA%8E%E4%B8%8EAkamai Cloudlets服务进行交互。通过Docker容器化部署，可快速获取Cloudlets CLI执行环境，避免本地依赖管理，适用于自动化脚本、CI/CD管道及跨平台一致化操作场景，核心用途是简化Cloudlets策略配置、版本管理及服务交互流程。

核心功能和特性

• 命令行交互：支持完整的Cloudlets CLI命令集，可执行策略创建、更新、删除、查询等操作
• 环境隔离：容器化运行环境确保CLI版本及依赖一致性，避免系统环境冲突
• 凭证安全：支持通过挂载本地配置文件（如.edgerc）实现Akamai API认证，无需在镜像内硬编码凭证
• 轻量级设计：基于精简基础镜像构建，减少资源占用，提升启动速度
• 版本可控：可通过Docker标签指定CLI版本，便于版本管理和回滚

使用场景和适用范围

• DevOps自动化：集成到Shell/Python等自动化脚本中，实现Cloudlets配置的批量操作
• CI/CD流水线：在CI/CD流程中嵌入Cloudlets CLI命令，实现策略自动部署与验证
• 多环境管理：通过容器参数区分开发/测试/生产环境，确保配置操作环境隔离
• 临时操作需求：无需本地安装CLI及依赖，通过临时容器快速执行Cloudlets命令
• 团队协作标准化：统一团队使用的CLI版本和运行环境，减少因环境差异导致的操作问题

使用方法和配置说明

前提条件

• 已安装Docker引擎（版本18.09及以上）
• 已获取Akamai API凭证（包含client_token、client_secret、access_token等信息），并已配置到本地.edgerc文件中（默认路径：~/.edgerc）

基本使用命令

通过Docker容器执行Cloudlets CLI命令的基本格式如下：

bash
docker run --rm -v <本地edgerc路径>:/root/.edgerc akamai/cli-cloudlets <cloudlets-command> [options]

参数说明：

• --rm：容器退出后自动删除，避免残留临时容器
• -v <本地edgerc路径>:/root/.edgerc：挂载本地Akamai凭证文件到容器内默认路径，供CLI认证使用
• <cloudlets-command>：需执行的Cloudlets CLI命令（如list、create、update等）
• [options]：对应Cloudlets命令的参数选项

常用命令示例

1. 查看CLI版本信息

bash
docker run --rm -v ~/.edgerc:/root/.edgerc akamai/cli-cloudlets --version

2. 列出所有Cloudlets策略

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

3. 获取指定策略详情

bash
docker run --rm -v ~/.edgerc:/root/.edgerc akamai/cli-cloudlets cloudlets get --policy-id <policy-id>

4. 创建新的Cloudlets策略

bash
docker run --rm -v ~/.edgerc:/root/.edgerc -v <本地策略配置文件路径>:/tmp/policy.json akamai/cli-cloudlets cloudlets create --file /tmp/policy.json

配置自定义凭证文件路径

若本地.edgerc文件路径非默认路径，可通过-e EDGERC_PATH环境变量指定容器内凭证文件路径：

bash
docker run --rm -e EDGERC_PATH=/custom/path/.edgerc -v /local/custom/.edgerc:/custom/path/.edgerc akamai/cli-cloudlets cloudlets list

交互式使用模式

如需进入容器内交互式执行多个命令，可使用-it参数启动交互式终端：

bash
docker run --rm -it -v ~/.edgerc:/root/.edgerc akamai/cli-cloudlets sh
# 进入容器后可直接执行cloudlets命令
/cloudlets-cli cloudlets list

查看完整命令帮助

通过以下命令查看Cloudlets CLI支持的所有命令及详细说明：

bash
docker run --rm akamai/cli-cloudlets help

或查看特定命令的帮助信息：

bash
docker run --rm akamai/cli-cloudlets cloudlets --help

版本指定

如需使用特定版本的Cloudlets CLI，可通过Docker镜像标签指定（标签格式为v<version>）：

bash
docker run --rm -v ~/.edgerc:/root/.edgerc akamai/cli-cloudlets:v1.2.0 cloudlets --version

注意事项

• 凭证文件安全：确保本地.edgerc文件权限设置为600（仅所有者可读写），避免凭证泄露
• 命令输出处理：如需保存命令输出到本地文件，可通过重定向实现，例如：

  bash
  docker run --rm -v ~/.edgerc:/root/.edgerc akamai/cli-cloudlets cloudlets list > cloudlets-policies.txt
  

• 网络要求：容器需能访问Akamai API服务（api.akamai.com），确保网络环境允许 outbound HTTPS (443端口) 连接