kong/deck 封装 decK 工具，读取 kong.yaml 执行 diff、sync、validate 操作，保持 Kong 运行时与版本库一致。典型集成于 CI/CD 在 merge 后自动推送网关配置，与 Konga GUI 手工改配置相比可审计、可回滚。定位为 docker run --rm CLI，需网络可达 Kong Admin API；非常驻服务，K8s 场景使用 Job 触发同步。

快速启动

docker run --rm \
  -v $(pwd)/kong.yaml:/kong.yaml:ro \
  docker.io/kong/deck:latest \
  sync -s /kong.yaml --kong-addr http://kong:8001

推荐实践

docker run --rm \
  -v $(pwd)/kong.yaml:/kong.yaml:ro \
  -e DECK_KONG_ADDR=http://kong-admin.internal:8001 \
  docker.io/kong/deck:v1.40.0 \
  diff -s /kong.yaml --select-tag prod

核心参数说明

• -v .../kong.yaml:... — 声明式网关配置
• --kong-addr — Kong Admin API 地址
• sync / diff — 推送或预览配置差异
• --select-tag — 按 tag 过滤同步范围
• 定位 — CI --rm CLI 任务
• 固定 tag — 与 Kong Gateway 版本兼容 pin