openeuler/kong

Kong | openEuler Docker镜像文档

镜像概述

本镜像为基于openEuler构建的Kong官方Docker镜像，由openEuler CloudNative SIG维护。Kong（Kong API Gateway）是一款云原生、平台无关、可扩展的API网关，以高性能和通过插件实现的可扩展性为特色，同时提供支持多LLM的高级AI能力。

核心功能与特性

• 云原生架构：专为云环境设计，支持容器化部署和动态扩展
• 高性能：优化的请求处理机制，适合高并发API场景
• 可扩展性：通过插件系统扩展功能，支持自定义插件开发
• 多LLM支持：集成高级AI能力，支持多种大型语言模型
• 灵活配置：支持数据库存储配置（带数据库模式）或内存存储配置（DB-less模式）
• 平台无关：可在amd64和arm64架构上运行

支持的标签及Dockerfile链接

每个kong镜像标签由Kong版本和基础镜像版本组成，具体如下：

使用场景

• API生命周期管理与监控
• 微服务架构中的流量控制与路由
• 云原生应用的API网关层构建
• 需要AI能力集成的API服务
• 多架构环境下的API统一管理

使用方法

安装路径选择

• 带数据库模式：使用数据库存储Kong实体配置，可通过Admin API或声明式配置文件进行配置管理
• 无数据库模式（DB-less）：配置存储在节点内存中，Admin API为只读模式，需通过声明式配置管理

带数据库模式部署步骤

1. 准备数据库

创建Docker网络：

bash
docker network create kong-net

（网络名称可自定义，本指南以kong-net为例）

启动PostgreSQL容器：

bash
docker run -d --name kong-database \
--network=kong-net \
-p 5432:5432 \
-e "POSTGRES_USER=kong" \
-e "POSTGRES_DB=kong" \
-e "POSTGRES_PASSWORD=kongpass" \
openeuler/postgres:{Tag}

• POSTGRES_USER和POSTGRES_DB：需设置为kong（Kong的默认期望值）
• POSTGRES_PASSWORD：可设置为任意密码字符串

初始化Kong数据库：

bash
docker run --rm --network=kong-net \
-e "KONG_DATABASE=postgres" \
-e "KONG_PG_HOST=kong-database" \
-e "KONG_PG_PASSWORD=kongpass" \
openeuler/kong:{Tag} kong migrations bootstrap

• KONG_DATABASE：指定数据库类型（此处为postgres）
• KONG_PG_HOST：PostgreSQL容器名称（通过kong-net网络通信）
• KONG_PG_PASSWORD：PostgreSQL容器设置的密码
• {Tag}：需替换为实际使用的Kong镜像标签

2. 启动Kong Gateway

重要：以下设置仅适用于非生产环境，因为它们覆盖了默认的admin_listen设置以监听来自任何来源的请求。不要在直接暴露于互联网的环境中使用这些设置。如果需要在生产环境中暴露admin_listen端口，请通过身份验证确保其安全。

bash
docker run -d --name kong-gateway \
--network=kong-net \
-e "KONG_DATABASE=postgres" \
-e "KONG_PG_HOST=kong-database" \
-e "KONG_PG_USER=kong" \
-e "KONG_PG_PASSWORD=kongpass" \
-e "KONG_PROXY_ACCESS_LOG=/dev/stdout" \
-e "KONG_ADMIN_ACCESS_LOG=/dev/stdout" \
-e "KONG_PROXY_ERROR_LOG=/dev/stderr" \
-e "KONG_ADMIN_ERROR_LOG=/dev/stderr" \
-e "KONG_ADMIN_LISTEN=0.0.0.0:8001, 0.0.0.0:8444 ssl" \
-e "KONG_ADMIN_GUI_URL=http://localhost:8002" \
-p 8000:8000 \
-p 8443:8443 \
-p 127.0.0.1:8001:8001 \
-p 127.0.0.1:8002:8002 \
-p 127.0.0.1:8444:8444 \
openeuler/kong:${Tag}

参数说明：

• --name和--network：容器名称和通信网络
• KONG_DATABASE：数据库类型（postgres）
• KONG_PG_HOST：PostgreSQL容器名称（通过kong-net网络通信）
• KONG_PG_USER和KONG_PG_PASSWORD：PostgreSQL登录信息
• 日志参数（*_LOG）：日志输出路径设置，示例中输出到标准输出/错误流
• KONG_ADMIN_LISTEN：Admin API监听端口
• KONG_ADMIN_GUI_URL：Kong Manager访问URL（需包含协议，如[***]
• 端口映射：8000(代理HTTP)、8443(代理HTTPS)、8001(Admin API)、8002(Kong Manager)、8444(Admin API HTTPS)

3. 验证安装

验证Admin API：

bash
curl -i -X GET --url http://localhost:8001/services

应返回200状态码

验证Kong Manager： 通过KONG_ADMIN_GUI_URL访问Kong管理界面：

http://localhost:8002

问题与支持

如有任何问题或需使用特殊功能，请在openeuler-docker-images提交issue或pull request。