Kong Dev Docker 镜像
Kong OSS开发用镜像,包含夜间构建版本和拉取请求相关镜像。
下载次数: 0状态:社区镜像维护者:kong仓库类型:镜像最近更新:
Kong OSS 开发版、夜间构建版与 PR 镜像文档
1. 镜像概述
Kong OSS(Open Source Software)开发版、夜间构建版与 PR 镜像均为 Kong 开源 API 网关的特殊构建版本,旨在支持开发者与集成测试场景。三者基于 Kong OSS 核心架构(Nginx 驱动的高性能 API 网关),但定位与更新机制不同:
- 开发版(Development Images):基于 Kong OSS 最新开发分支(如
next或main)构建,包含未正式发布的新功能与改进,供开发者提前体验与测试。 - 夜间构建版(Nightly Images):每日从主分支(
main)自动构建,集成最新代码提交与 bug 修复,用于持续验证主分支稳定性。 - PR 镜像(PR Images):针对 Kong OSS 代码仓库的每个 Pull Request(PR)构建,用于验证特定 PR 的功能正确性与兼容性。
2. 核心功能与特性
2.1 基础功能(所有版本共享)
- 兼容 Kong OSS 核心能力:API 路由、负载均衡、流量控制、认证鉴权(JWT、OAuth2 等)、监控与日志。
- 支持插件扩展:可加载 Kong 官方插件(如
rate-limiting、cors)及自定义插件。 - 轻量级架构:基于 Nginx,高性能、低延迟,支持水平扩展。
- 多数据库支持:兼容 PostgreSQL、Cassandra 作为配置存储后端。
2.2 版本特有特性
| 版本类型 | 核心特性 |
|---|---|
| 开发版 | 包含最新开发中功能(如未发布的插件、协议支持);API 可能随开发迭代变化。 |
| 夜间构建版 | 每日自动更新,反映主分支最新状态;包含最新 bug 修复,适合早期问题验证。 |
| PR 镜像 | 与特定 PR 强绑定,仅包含该 PR 的代码变更;用于验证 PR 功能/修复的有效性。 |
3. 使用场景与适用范围
| 版本类型 | 适用场景 | 目标用户 |
|---|---|---|
| 开发版 | 新功能预研、插件开发适配、兼容性测试。 | Kong 插件开发者、API 网关集成测试团队。 |
| 夜间构建版 | 持续集成(CI)流程、主分支每日稳定性验证、提前发现潜在回归问题。 | Kong 核心开发团队、依赖 Kong 的下游项目。 |
| PR 镜像 | PR 提交者验证代码功能、Reviewer 确认 PR 修复效果、自动化测试流程集成。 | Kong 代码贡献者、代码审核者。 |
注意:所有版本均为非生产环境设计,稳定性与兼容性未经过正式发布流程验证,请勿用于生产部署。
4. 使用方法与配置说明
4.1 获取镜像
开发版
bash# 拉取最新开发版(默认基于 main 分支) docker pull docker.xuanyuan.run/kong/kong:dev # 拉取指定开发分支(如 feature/new-plugin) docker pull docker.xuanyuan.run/kong/kong:dev-feature-new-plugin
夜间构建版
bash# 拉取最新夜间构建版(每日更新) docker pull docker.xuanyuan.run/kong/kong:nightly
PR 镜像
bash# 拉取指定 PR 的镜像(PR 编号为 1234) docker pull docker.xuanyuan.run/kong/kong:pr-1234
4.2 基本运行命令(Docker Run)
开发版(独立模式,无数据库)
bashdocker run -d \ --name kong-dev \ -p 8000:8000 # 代理端口(HTTP) \ -p 8443:8443 # 代理端口(HTTPS) \ -p 8001:8001 # Admin API 端口 \ -e KONG_DATABASE=off \ # 独立模式(无需数据库) -e KONG_PROXY_LISTEN=0.0.0.0:8000,0.0.0.0:8443 ssl \ -e KONG_ADMIN_LISTEN=0.0.0.0:8001 \ kong/kong:dev
夜间构建版(连接 PostgreSQL 数据库)
bash# 1. 启动 PostgreSQL(需提前创建数据库 `kong`) docker run -d \ --name kong-db \ -e POSTGRES_DB=kong \ -e POSTGRES_USER=kong \ -e POSTGRES_PASSWORD=kong \ -p 5432:5432 \ docker.xuanyuan.run/postgres:14-alpine # 2. 启动夜间版 Kong,连接数据库 docker run -d \ --name kong-nightly \ --link kong-db:db \ # 关联数据库容器 -p 8000:8000 \ -p 8443:8443 \ -p 8001:8001 \ -e KONG_DATABASE=postgres \ -e KONG_PG_HOST=db \ -e KONG_PG_USER=kong \ -e KONG_PG_PASSWORD=kong \ -e KONG_PG_DATABASE=kong \ kong/kong:nightly kong migrations bootstrap # 初始化数据库迁移
4.3 核心环境变量配置
| 环境变量 | 用途说明 | 默认值 |
|---|---|---|
KONG_DATABASE | 数据库类型,可选 postgres、cassandra 或 off(独立模式)。 | postgres |
KONG_PROXY_LISTEN | 代理服务监听地址与端口,支持 TCP/UDP/SSL。 | 0.0.0.0:8000, 0.0.0.0:8443 ssl |
KONG_ADMIN_LISTEN | Admin API 监听地址与端口,用于配置管理。 | 0.0.0.0:8001 |
KONG_LOG_LEVEL | 日志级别,可选 debug、info、warn、error。 | info |
KONG_PLUGINS | 启用的插件列表(逗号分隔),如 bundled,my-custom-plugin。 | bundled(官方插件) |
KONG_PG_HOST | PostgreSQL 主机地址(当 KONG_DATABASE=postgres 时)。 | localhost |
KONG_CASSANDRA_CONTACT_POINTS | Cassandra 节点地址(当 KONG_DATABASE=cassandra 时)。 | localhost |
4.4 Docker Compose 配置示例(夜间构建版 + PostgreSQL)
yamlversion: '3.8' services: kong-db: image: docker.xuanyuan.run/postgres:14-alpine container_name: kong-nightly-db environment: POSTGRES_DB: kong POSTGRES_USER: kong POSTGRES_PASSWORD: kong volumes: - kong-db-data:/var/lib/postgresql/data # 持久化数据库数据 ports: - "5432:5432" healthcheck: test: ["CMD-SHELL", "pg_isready -U kong"] interval: 5s timeout: 5s retries: 5 kong: image: docker.xuanyuan.run/kong/kong:nightly container_name: kong-nightly depends_on: kong-db: condition: service_healthy environment: KONG_DATABASE: postgres KONG_PG_HOST: kong-db KONG_PG_USER: kong KONG_PG_PASSWORD: kong KONG_PG_DATABASE: kong KONG_PROXY_LISTEN: 0.0.0.0:8000, 0.0.0.0:8443 ssl KONG_ADMIN_LISTEN: 0.0.0.0:8001 KONG_LOG_LEVEL: debug # 夜间版建议开启 debug 日志便于问题排查 ports: - "8000:8000" # 代理 HTTP - "8443:8443" # 代理 HTTPS - "8001:8001" # Admin API command: kong migrations bootstrap && kong start # 初始化迁移并启动 volumes: kong-db-data: # 持久化卷定义
5. 注意事项
- 稳定性风险:开发版、夜间版与 PR 镜像可能包含未测试的功能或 bug,请勿用于生产环境。
- API 兼容性:开发版与夜间版的 Admin API 或插件接口可能随代码迭代变化,需关注 Kong 官方开发文档的变更说明。
- PR 镜像生命周期:PR 镜像仅在对应 PR 存在期间保留,合并或关闭后可能被清理,建议仅临时使用。
- 资源需求:开发环境建议分配至少 2GB 内存,避免因资源不足导致启动失败或性能问题。
- 数据清理:测试完成后,通过
docker rm -f <容器名>及docker volume rm <卷名>清理临时容器与数据,避免残留影响。
kong 命名空间的其他可用镜像:
kong/kong-gateway
Kong API 网关,企业级配置,适合微服务架构和 API 管理
kong/kong
Kong API 网关,官方标准版本,适合微服务架构和 API 管理
kong/kubernetes-ingress-controller
Kong K8s Ingress Controller,适合 API 网关与流量路由
kong/kong-event-gateway-dev
Kong Event Gateway Dev 容器镜像,适合 kong 维护的 Kong Event Gateway Dev 工作负载部署
kong/httpbin
Httpbin 容器镜像,适合 kong 维护的 Httpbin 工作负载部署
kong/cloudtrail-integration
Cloudtrail Integration 容器镜像,适合 kong 维护的 Cloudtrail Integration 工作负载部署
镜像拉取方式
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本,请访问 标签列表页面。
DockerHub 原生拉取命令
docker pull kong/kong-dev:<标签>
用户好评
来自真实用户的反馈,见证轩辕镜像的优质服务