akamai/purge

Akamai Purge Docker镜像文档

镜像概述

akamai/purge:v2.3.2是包含Akamai Fast Purge CLI工具的Docker镜像，集成了Akamai CLI核心组件(v1.2.1)和Akamai purge CLI功能包(v1.0.1)。该镜像提供容器化的Fast Purge工具，旨在简化Akamai CDN缓存的快速清除操作，确保环境一致性和部署便捷性。

核心功能与特性

• 组件集成：预安装Akamai CLI核心(v1.2.1)和purge CLI包(v1.0.1)，无需手动配置依赖
• Fast Purge功能：支持通过命令行快速清除Akamai CDN缓存，包括URL、CPcode、标签等多种清除方式
• 容器化部署：基于Docker封装，可在任何支持Docker的环境中运行，避免系统依赖冲突
• 版本固定：镜像标签v2.3.2对应固定版本组件，确保操作一致性和可追溯性

使用场景

• 开发/测试环境：开发人员在本地或CI/CD流程中快速清除测试环境CDN缓存
• 生产运维：运维人员执行生产环境CDN缓存紧急清除任务
• 自动化流程：集成到自动化脚本或调度任务中，实现定期或触发式缓存清除
• 多环境管理：在不同环境（开发、预发、生产）中保持统一的缓存清除工具版本

使用方法

前提条件

• 已安装Docker引擎（20.10+推荐）
• 拥有Akamai API访问凭证（需配置在.edgerc文件中）

基本使用命令

查看帮助信息

bash
docker run --rm docker.xuanyuan.run/akamai/purge:v2.3.2 purge --help

挂载配置文件执行清除操作

将本地.edgerc文件（位于~/.edgerc）挂载到容器内/root/.edgerc路径，执行具体清除命令：

bash
# 清除单个URL缓存
docker run --rm -v ~/.edgerc:/root/.edgerc docker.xuanyuan.run/akamai/purge:v2.3.2 purge url -u "https://example.com/static/asset.js"

# 清除多个URL缓存（通过文件）
docker run --rm -v ~/.edgerc:/root/.edgerc -v $(pwd)/urls.txt:/urls.txt docker.xuanyuan.run/akamai/purge:v2.3.2 purge url -i /urls.txt

常用命令参数

purge命令核心参数说明：

• --help：显示帮助信息
• url：清除URL类型缓存
  • -u：指定单个URL
  • -i：指定包含URL列表的文件路径
• cpcode：清除CPcode类型缓存
• tag：清除标签类型缓存
• --network：指定网络（staging/production，默认production）

配置说明

Akamai CLI依赖.edgerc配置文件进行API认证，文件格式示例：

ini
[default]
client_secret = your_client_secret
host = akab-xxxx.luna.akamaiapis.net
access_token = akab-xxxx
client_token = akab-xxxx

通过Docker volume挂载该文件到容器内/root/.edgerc即可使用：

bash
docker run --rm -v /path/to/local/.edgerc:/root/.edgerc docker.xuanyuan.run/akamai/purge:v2.3.2 [command]

参考链接

• 官方GitHub仓库：https://github.com/akamai/cli-purge
• Akamai CLI文档：Akamai CLI Documentation