akamai/cps

Akamai CPS CLI 镜像文档

镜像概述

该镜像包含 Akamai Certificate Provisioning System (CPS) 的命令行界面工具，旨在简化SSL/TLS证书的全生命周期管理。通过与Akamai API深度集成，提供直观的命令行操作，支持证书的创建、更新、删除、部署及状态监控，适用于需要自动化证书管理的开发与运维场景。

核心功能与特性

• 证书生命周期管理：支持证书的创建、更新、删除及版本控制，覆盖从申请到吊销的完整流程。
• 部署控制：可将证书部署至Akamai Edge服务器或第三方CDN，并支持部署状态实时追踪。
• 状态监控：实时查询证书状态（如待审核、已部署、即将过期等），支持过期预警。
• 配置管理：提供证书配置的导出与导入功能，便于环境迁移和配置备份。
• API集成：与Akamai Identity and Access Management (IAM) 无缝集成，通过API凭证实现安全认证。

使用场景与适用范围

• DevOps自动化流程：集成至CI/CD流水线，实现证书的自动创建、更新和部署。
• 大规模证书管理：适用于管理大量域名证书的企业级环境，简化批量操作。
• 证书监控与预警：定期检查证书状态，避免因证书过期导致服务中断。
• 多环境一致性：通过配置导出/导入，确保开发、测试、生产环境证书配置一致。

使用方法与配置说明

前提条件

• 已获取Akamai API访问凭证（包含CLIENT_TOKEN、CLIENT_SECRET和ACCESS_TOKEN），且凭证需具备CPS操作权限。
• 本地已安装并运行Docker环境。

镜像拉取与基础运行

拉取镜像

bash
docker pull docker.xuanyuan.run/akamai/cli-cps:latest

基础运行命令

通过环境变量传入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> \
  docker.xuanyuan.run/akamai/cli-cps <command>

常用命令示例

1. 查看证书列表

bash
docker run --rm \
  -e AKAMAI_CLIENT_TOKEN=<token> \
  -e AKAMAI_CLIENT_SECRET=<secret> \
  -e AKAMAI_ACCESS_TOKEN=<access_token> \
  docker.xuanyuan.run/akamai/cli-cps list-certificates

2. 创建新证书

bash
docker run --rm \
  -e AKAMAI_CLIENT_TOKEN=<token> \
  -e AKAMAI_CLIENT_SECRET=<secret> \
  -e AKAMAI_ACCESS_TOKEN=<access_token> \
  docker.xuanyuan.run/akamai/cli-cps create-certificate --domain example.com --type ssl --validity 365

3. 部署证书至Edge节点

bash
docker run --rm \
  -e AKAMAI_CLIENT_TOKEN=<token> \
  -e AKAMAI_CLIENT_SECRET=<secret> \
  -e AKAMAI_ACCESS_TOKEN=<access_token> \
  docker.xuanyuan.run/akamai/cli-cps deploy-certificate --id <certificate_id> --network production

4. 查看证书详情

bash
docker run --rm \
  -e AKAMAI_CLIENT_TOKEN=<token> \
  -e AKAMAI_CLIENT_SECRET=<secret> \
  -e AKAMAI_ACCESS_TOKEN=<access_token> \
  docker.xuanyuan.run/akamai/cli-cps get-certificate --id <certificate_id>

配置参数说明

通过环境变量进行认证与环境配置，关键参数如下：

注意事项

• API凭证需妥善保管，建议通过Docker secrets或环境变量文件传递，避免在命令行中明文指定。
• 完整命令列表及参数说明可通过docker run --rm akamai/cli-cps help查看帮助文档。
• 执行批量操作前建议先通过--dry-run参数验证命令效果，避免误操作。