feat(agentgateway): add Agentgateway service with configuration files and documentation

2026-02-07 20:45:43 +08:00
parent c03771751c
commit 1ba0401d90
7 changed files with 180 additions and 0 deletions
--- a/README.md
+++ b/README.md
@@ -28,6 +28,7 @@ These services require building custom Docker images from source.
 | [Apache Kafka](./src/kafka)                                    | 7.8.0               |
 | [Apache Pulsar](./src/pulsar)                                  | 4.0.7               |
 | [Apache RocketMQ](./src/rocketmq)                              | 5.3.1               |
+| [Agentgateway](./src/agentgateway)                             | 0.11.2              |
 | [Bifrost Gateway](./src/bifrost-gateway)                       | v1.3.63             |
 | [Bolt.diy](./apps/bolt-diy)                                    | latest              |
 | [Budibase](./src/budibase)                                     | 3.23.0              |
--- a/README.zh.md
+++ b/README.zh.md
@@ -28,6 +28,7 @@ Compose Anything 通过提供一组高质量的 Docker Compose 配置文件，
 | [Apache Kafka](./src/kafka)                                    | 7.8.0               |
 | [Apache Pulsar](./src/pulsar)                                  | 4.0.7               |
 | [Apache RocketMQ](./src/rocketmq)                              | 5.3.1               |
+| [Agentgateway](./src/agentgateway)                             | 0.11.2              |
 | [Bifrost Gateway](./src/bifrost-gateway)                       | v1.3.63             |
 | [Bolt.diy](./apps/bolt-diy)                                    | latest              |
 | [Budibase](./src/budibase)                                     | 3.23.0              |
--- a/src/agentgateway/.env.example
+++ b/src/agentgateway/.env.example
@@ -0,0 +1,18 @@
+# Agentgateway image version
+AGENTGATEWAY_VERSION=0.11.2
+
+# Timezone
+TZ=UTC
+
+# Admin UI bind address inside the container
+AGENTGATEWAY_ADMIN_ADDR=0.0.0.0:15000
+
+# Port overrides (optional)
+# AGENTGATEWAY_PORT_OVERRIDE=3000
+# AGENTGATEWAY_ADMIN_PORT_OVERRIDE=15000
+
+# Resource limits
+# AGENTGATEWAY_CPU_LIMIT=0.50
+# AGENTGATEWAY_CPU_RESERVATION=0.25
+# AGENTGATEWAY_MEMORY_LIMIT=256M
+# AGENTGATEWAY_MEMORY_RESERVATION=128M
--- a/src/agentgateway/README.md
+++ b/src/agentgateway/README.md
@@ -0,0 +1,52 @@
+# Agentgateway
+
+[English](./README.md) | [中文](./README.zh.md)
+
+Agentgateway is an open source data plane for agentic AI connectivity. This compose setup runs the official Docker image with a local configuration file.
+
+## Services
+
+- `agentgateway`: The Agentgateway data plane (ports 3000 and 15000)
+
+## Quick Start
+
+```bash
+docker compose up -d
+```
+
+Agentgateway listens on port 3000. The admin UI is available on <http://localhost:15000/ui>.
+
+## Configuration
+
+The default configuration file is [config.yaml](./config.yaml). It is based on the official quickstart example and starts the MCP test server `@modelcontextprotocol/server-everything` via `npx`.
+
+If you want to use a different backend, update `config.yaml` and restart the service.
+
+## Environment Variables
+
+| Variable Name                      | Description                                       | Default Value   |
+| ---------------------------------- | ------------------------------------------------- | --------------- |
+| `GLOBAL_REGISTRY`                  | Global registry prefix for all images             | `""`            |
+| `AGENTGATEWAY_VERSION`             | Agentgateway image version                        | `0.11.2`        |
+| `AGENTGATEWAY_PORT_OVERRIDE`       | Host port mapping for data plane (container 3000) | `3000`          |
+| `AGENTGATEWAY_ADMIN_PORT_OVERRIDE` | Host port mapping for admin UI (container 15000)  | `15000`         |
+| `AGENTGATEWAY_ADMIN_ADDR`          | Admin UI bind address inside container            | `0.0.0.0:15000` |
+| `TZ`                               | Timezone                                          | `UTC`           |
+| `AGENTGATEWAY_CPU_LIMIT`           | CPU limit                                         | `0.50`          |
+| `AGENTGATEWAY_CPU_RESERVATION`     | CPU reservation                                   | `0.25`          |
+| `AGENTGATEWAY_MEMORY_LIMIT`        | Memory limit                                      | `256M`          |
+| `AGENTGATEWAY_MEMORY_RESERVATION`  | Memory reservation                                | `128M`          |
+
+## Ports
+
+- `3000`: Data plane listener
+- `15000`: Admin UI
+
+## Security Notes
+
+- The admin UI is bound to localhost on the host by default. Change the port mapping if you need remote access.
+- Review and harden CORS and backend settings before using in production.
+
+## License
+
+Agentgateway is open source and licensed under the Apache 2.0 License. See the upstream project for details.
--- a/src/agentgateway/README.zh.md
+++ b/src/agentgateway/README.zh.md
@@ -0,0 +1,52 @@
+# Agentgateway
+
+[English](./README.md) | [中文](./README.zh.md)
+
+Agentgateway 是一个面向智能体 AI 连接的开源数据平面。本 Compose 配置运行官方 Docker 镜像，并使用本地配置文件。
+
+## 服务
+
+- `agentgateway`：Agentgateway 数据平面（端口 3000 与 15000）
+
+## 快速开始
+
+```bash
+docker compose up -d
+```
+
+Agentgateway 监听端口 3000。管理界面可通过 <http://localhost:15000/ui> 访问。
+
+## 配置说明
+
+默认配置文件为 [config.yaml](./config.yaml)。该文件基于官方 Quickstart 示例，并通过 `npx` 启动 MCP 测试服务器 `@modelcontextprotocol/server-everything`。
+
+如需使用其他后端，请修改 `config.yaml` 并重启服务。
+
+## 环境变量
+
+| 变量名                             | 说明                           | 默认值          |
+| ---------------------------------- | ------------------------------ | --------------- |
+| `GLOBAL_REGISTRY`                  | 全局镜像仓库前缀               | `""`            |
+| `AGENTGATEWAY_VERSION`             | Agentgateway 镜像版本          | `0.11.2`        |
+| `AGENTGATEWAY_PORT_OVERRIDE`       | 数据平面端口映射（容器 3000）  | `3000`          |
+| `AGENTGATEWAY_ADMIN_PORT_OVERRIDE` | 管理界面端口映射（容器 15000） | `15000`         |
+| `AGENTGATEWAY_ADMIN_ADDR`          | 容器内管理界面绑定地址         | `0.0.0.0:15000` |
+| `TZ`                               | 时区                           | `UTC`           |
+| `AGENTGATEWAY_CPU_LIMIT`           | CPU 限制                       | `0.50`          |
+| `AGENTGATEWAY_CPU_RESERVATION`     | CPU 预留                       | `0.25`          |
+| `AGENTGATEWAY_MEMORY_LIMIT`        | 内存限制                       | `256M`          |
+| `AGENTGATEWAY_MEMORY_RESERVATION`  | 内存预留                       | `128M`          |
+
+## 端口
+
+- `3000`：数据平面监听
+- `15000`：管理界面
+
+## 安全说明
+
+- 默认仅在宿主机本地暴露管理界面。如需远程访问，请调整端口映射。
+- 在生产环境中，请根据实际需求收紧 CORS 与后端配置。
+
+## 许可证
+
+Agentgateway 采用 Apache 2.0 许可证，详情请参考上游项目。
--- a/src/agentgateway/config.yaml
+++ b/src/agentgateway/config.yaml
@@ -0,0 +1,21 @@
+binds:
+  - port: 3000
+    listeners:
+      - routes:
+          - policies:
+              cors:
+                allowOrigins:
+                  - "*"
+                allowHeaders:
+                  - mcp-protocol-version
+                  - content-type
+                  - cache-control
+                exposeHeaders:
+                  - "Mcp-Session-Id"
+            backends:
+              - mcp:
+                  targets:
+                    - name: everything
+                      stdio:
+                        cmd: npx
+                        args: ["@modelcontextprotocol/server-everything"]
--- a/src/agentgateway/docker-compose.yaml
+++ b/src/agentgateway/docker-compose.yaml
@@ -0,0 +1,35 @@
+x-defaults: &defaults
+  restart: unless-stopped
+  logging:
+    driver: json-file
+    options:
+      max-size: 100m
+      max-file: "3"
+
+services:
+  agentgateway:
+    <<: *defaults
+    image: ${GLOBAL_REGISTRY:-}cr.agentgateway.dev/agentgateway:${AGENTGATEWAY_VERSION:-0.11.2}
+    ports:
+      - "${AGENTGATEWAY_PORT_OVERRIDE:-3000}:3000"
+      - "127.0.0.1:${AGENTGATEWAY_ADMIN_PORT_OVERRIDE:-15000}:15000"
+    volumes:
+      - ./config.yaml:/config.yaml:ro
+    environment:
+      - TZ=${TZ:-UTC}
+      - ADMIN_ADDR=${AGENTGATEWAY_ADMIN_ADDR:-0.0.0.0:15000}
+    command: ["-f", "/config.yaml"]
+    healthcheck:
+      test: ["CMD", "agentgateway", "--version"]
+      interval: 30s
+      timeout: 10s
+      retries: 3
+      start_period: 10s
+    deploy:
+      resources:
+        limits:
+          cpus: ${AGENTGATEWAY_CPU_LIMIT:-0.50}
+          memory: ${AGENTGATEWAY_MEMORY_LIMIT:-256M}
+        reservations:
+          cpus: ${AGENTGATEWAY_CPU_RESERVATION:-0.25}
+          memory: ${AGENTGATEWAY_MEMORY_RESERVATION:-128M}