Envoy AI Gateway CRDs 镜像文档

镜像概述

该镜像包含Envoy AI Gateway运行所需的Kubernetes自定义资源定义（CRDs），用于在Kubernetes集群中扩展API，定义和管理与AI网关相关的自定义资源，如网关配置、路由规则、流量策略等，是部署和运行Envoy AI Gateway的基础组件。

核心功能

• 提供AI网关专用CRDs：包含Envoy AI Gateway运行必需的自定义资源定义，如Gateway、Route、TrafficPolicy等，用于描述AI网关的拓扑结构、请求路由规则及流量管理策略。
• 扩展Kubernetes API：通过CRDs将AI网关资源纳入Kubernetes管理体系，支持使用kubectl等原生工具进行资源的创建、查询、更新和删除。
• 版本化管理：包含多版本CRDs，支持资源定义的平滑升级和兼容性保障。

使用场景

• Kubernetes集群中部署和运行Envoy AI Gateway的前置依赖组件。
• 需通过Kubernetes原生API管理AI网关配置、路由规则及流量策略的场景。
• AI服务网格环境中，需要自定义AI网关资源类型以满足特定业务需求的场景。

使用方法

前提条件

• Kubernetes集群版本 ≥ 1.19（支持CRD v1版本）。
• 已安装kubectl命令行工具并配置集群访问权限。

安装CRDs到集群

可通过以下命令将镜像中的CRDs部署到Kubernetes集群：

bash
# 从镜像中提取CRD清单并应用（假设镜像名为 envoy-ai-gateway-crds:latest）
docker run --rm envoy-ai-gateway-crds:latest cat /crds/*.yaml | kubectl apply -f -

验证CRDs安装

安装完成后，通过以下命令验证CRDs是否成功注册：

bash
kubectl get crds | grep envoy-ai-gateway

预期输出示例：

gateways.envoy.ai-gateway.io          2024-01-01T00:00:00Z
routes.envoy.ai-gateway.io            2024-01-01T00:00:00Z
trafficpolicies.envoy.ai-gateway.io   2024-01-01T00:00:00Z

配置示例

创建AI网关资源示例

以下为使用该镜像提供的Gateway CRD创建AI网关实例的配置示例（ai-gateway.yaml）：

yaml
apiVersion: envoy.ai-gateway.io/v1alpha1
kind: Gateway
metadata:
  name: ai-gateway-example
  namespace: ai-gateway
spec:
  selector:
    app: envoy-ai-gateway
  listeners:
    - port: 8080
      protocol: HTTP
      name: http-listener

应用配置：

bash
kubectl apply -f ai-gateway.yaml -n ai-gateway

版本兼容性

• 支持Kubernetes 1.19+集群环境。
• CRD版本遵循语义化版本控制，主版本号变更可能引入不兼容更新，使用前请查阅对应版本的变更日志。

注意事项

• 该镜像仅包含CRD定义，需配合Envoy AI Gateway核心组件使用。
• 升级CRDs时需确保与Envoy AI Gateway核心组件版本匹配，避免版本不兼容导致功能异常。
• 删除CRDs将同时删除集群中所有基于该CRD创建的自定义资源，请谨慎操作。