跳到主要内容

生产部署

生产部署意味着可工作的网关开始成为真实流量路径的一部分。在扩大流量前，请确认部署模式、依赖位置、监听器暴露、就绪检查和关闭行为。

选择部署模式​

规划其余部署前，请先选择运行模式。部署选项比较开源自托管网关、AISIX Cloud 和 AISIX Cloud On-Premises。

对于自托管网关，请规划私有 Admin API 路径和可达的 etcd 配置存储。你通过该本地路径管理服务提供方密钥、模型别名、调用方 API Key 和策略资源。

对于 AISIX Cloud 或 AISIX Cloud On-Premises，请规划托管 mTLS 连接、证书包和控制面可达性。控制面将资源投射到网关；本地 Admin 监听器和本地 playground 不会暴露。

后续生产检查应始终使用所选模式。不要将托管配置路径与自托管 Admin API 假设混用。

准备运行时依赖​

请将配置存储运行在网关进程之外。在自托管部署中，etcd 是网关控制面的一部分，因此应仅对 AISIX 和管理网关配置的系统开放。

接入生产流量前，请规划 etcd 持久化、备份和访问控制。自托管 etcd 会存储动态资源，包括敏感的服务提供方凭证和策略配置。

除非多个网关实例必须共享缓存响应，否则可以先使用内存缓存策略。当缓存策略选择 Redis 时，请为所选的 single、cluster 或 Sentinel 拓扑配置 cache.redis；Redis 不可用时，该策略不会静默回退到内存。

限流计数器默认使用本地进程内存。对于多实例部署，如果请求、Token 或并发上限需要作用于整个网关组，请配置 ratelimit.backend: redis，并让每个实例指向同一个 Redis 后端。

启动配置只应用于进程级设置。服务提供方密钥、模型别名、调用方 API Key、安全护栏、缓存策略和可观测性导出器等动态资源应来自配置存储。

设置监听器基线​

代理监听器只应暴露给预期调用方，或暴露给调用方流量前置的入口层。

对于自托管部署，请将 Admin 监听器保留在 loopback、私有子网或仅管理员可访问的网络中。不要将 Admin 或 OpenAPI 端点暴露到公网。

Prometheus 指标不做认证，并通过专用监听器提供。请保持该监听器私有，只允许可信监控基础设施抓取，并验证启动配置设置的地址和路径。

当代理或 Admin 流量离开可信本地边界时，请启用监听器 TLS。当配置存储要求加密且双向认证的连接时，请配置 etcd mTLS。

在托管部署中，排查更高层级配置投射前，请先验证证书包和控制面 URL。

路由流量前验证​

存活检查是必要的，但并不足够。进程可以存活，但调用方认证、模型解析、服务提供方凭证或上游网络访问仍可能出错。

设置代理 URL；对于自托管网关，还要设置 Admin URL 和 Key：

PROXY_URL="https://gateway.example.com"
ADMIN_URL="https://admin.internal.example.com"
AISIX_ADMIN_KEY="YOUR_ADMIN_KEY"

在代理监听器上检查代理存活状态：

curl -i "${PROXY_URL}/livez"

对于自托管部署，还需要在私有 Admin 监听器上检查 Admin 存活状态：

curl -i "${ADMIN_URL}/livez"

在自托管部署中，请检查 Admin 健康状态，以确认模型健康状态和配置新鲜度：

curl -sS "${ADMIN_URL}/admin/v1/health" \
  -H "Authorization: Bearer ${AISIX_ADMIN_KEY}"

然后验证真实请求链路：

  • 使用应用将要使用的同一个调用方 API Key 调用 GET /v1/models。
  • 对计划暴露的每个端点族发送一次真实代理请求。
  • 能够显示冒烟测试请求的日志、指标、响应头、用量事件或导出器输出。
  • 使用无效或未授权调用方 API Key 发送一次应被拒绝的请求，以便在扩大流量前确认访问控制有效。

关闭行为​

AISIX 会在收到 SIGINT 和 SIGTERM 时执行优雅关闭。关闭期间，服务器会停止接受新任务，协调监听器与后台任务关闭，并将存活状态标记为失败。

在主动流量排空期间，AISIX 会将 /livez 标记为失败，以便负载均衡器或编排探针将实例移出服务。GET /livez 是存活信号，不是完整的就绪或流量排空契约。

扩大流量前检查​

广泛暴露生产流量前，请确认以下条件：

  • 启动配置与预期部署模式匹配。
  • 代理监听器只能通过预期网络路径访问。
  • 自托管部署中的 Admin 监听器是私有的。
  • 配置存储是私有的，并且网关可以访问。
  • TLS、mTLS 和证书文件路径对使用它们的传输链路有效。
  • 已至少创建一个服务提供方密钥、模型别名和调用方 API Key。
  • 模型别名能通过面向调用方的代理路径看到。
  • 真实服务提供方后端请求能够通过网关成功。
  • 运维信号能显示冒烟测试请求。

如果进程已经启动但真实请求失败，请将其视为请求链路问题。扩大流量前，请检查模型可见性、配置传播、调用方 API Key 访问权限、服务提供方凭证和上游连接。

下一步​

你已经了解将 AISIX 接入真实流量前的生产基线。接下来阅读网络与安全了解监听器和密钥处理，阅读 TLS 与 mTLS了解传输安全，阅读健康检查了解就绪检查。