Container Service for Kubernetes：使用Gateway with Inference Extension訪問服務

在ACK Edge叢集中，Envoy Gateway的部署方式與標準ACK叢集有所不同：

當前部署配置了節點池打散策略，可通過組件管理調節副本數，確保每個節點池至少運行一個控制面副本。

步驟一：建立測試應用

將下方樣本儲存到backend.yaml，執行 kubectl apply -f backend.yaml，建立測試應用backend和backend-2。

ACK Edge情境需要佈建服務拓撲。在Service中需添加 openyurt.io/topologyKeys: openyurt.io/nodepool 註解，確保流量只會轉寄到同一節點池內的Pod。詳情參見節點池服務拓撲管理。

apiVersion: v1
kind: ServiceAccount
metadata:
  name: backend
---
apiVersion: v1
kind: Service
metadata:
  name: backend
  annotations:
    openyurt.io/topologyKeys: openyurt.io/nodepool # 配置節點池拓撲
  labels:
    app: backend
    service: backend
spec:
  ports:
    - name: http
      port: 3000
      targetPort: 3000
  selector:
    app: backend
---
apiVersion: apps/v1
kind: Deployment
metadata:
  name: backend
spec:
  replicas: 1
  selector:
    matchLabels:
      app: backend
      version: v1
  template:
    metadata:
      labels:
        app: backend
        version: v1
    spec:
      serviceAccountName: backend
      containers:
        - image: registry-cn-hangzhou.ack.aliyuncs.com/ack-demo/envoygateway-echo-basic:v20231214-v1.0.0-140-gf544a46e
          imagePullPolicy: IfNotPresent
          name: backend
          ports:
            - containerPort: 3000
          env:
            - name: POD_NAME
              valueFrom:
                fieldRef:
                  fieldPath: metadata.name
            - name: NAMESPACE
              valueFrom:
                fieldRef:
                  fieldPath: metadata.namespace
---
apiVersion: v1
kind: ServiceAccount
metadata:
  name: backend-2
---
apiVersion: v1
kind: Service
metadata:
  name: backend-2
  annotations:
    openyurt.io/topologyKeys: openyurt.io/nodepool # 配置節點池拓撲
  labels:
    app: backend-2
    service: backend-2
spec:
  ports:
    - name: http
      port: 3000
      targetPort: 3000
  selector:
    app: backend-2
---
apiVersion: apps/v1
kind: Deployment
metadata:
  name: backend-2
spec:
  replicas: 1
  selector:
    matchLabels:
      app: backend-2
      version: v1
  template:
    metadata:
      labels:
        app: backend-2
        version: v1
    spec:
      serviceAccountName: backend-2
      containers:
        - image: registry-cn-hangzhou.ack.aliyuncs.com/ack-demo/envoygateway-echo-basic:v20231214-v1.0.0-140-gf544a46e
          imagePullPolicy: IfNotPresent
          name: backend-2
          ports:
            - containerPort: 3000
          env:
            - name: POD_NAME
              valueFrom:
                fieldRef:
                  fieldPath: metadata.name
            - name: NAMESPACE
              valueFrom:
                fieldRef:
                  fieldPath: metadata.namespace

步驟二：確認GatewayClass

安裝Gateway with Inference Extension組件後會預設建立GatewayClass。執行以下命令確認：

kubectl get gatewayclass

預期輸出：

NAME          CONTROLLER                                      ACCEPTED   AGE
ack-gateway   gateway.envoyproxy.io/gatewayclass-controller   True       2m31s

如果未發現 GatewayClass資源，需手動建立。將下方樣本儲存到gatewayclass.yaml，執行 kubectl apply -f gatewayclass.yaml建立。

apiVersion: gateway.networking.k8s.io/v1
kind: GatewayClass
metadata:
  name: ack-gateway
spec:
  controllerName: gateway.envoyproxy.io/gatewayclass-controller

步驟三：建立自訂EnvoyProxy配置

在ACK Edge叢集中，需要為每個節點池建立自訂 EnvoyProxy 配置，指定資料面 Pod 的調度節點池和服務暴露方式。

將下方樣本中的 NPXXX 替換為實際的節點池ID，然後儲存到gateway-config.yaml，執行 kubectl apply -f gateway-config.yaml。

可在ACK控制台的節點管理 > 節點池頁面查看節點池 ID。

apiVersion: gateway.envoyproxy.io/v1alpha1
kind: EnvoyProxy
metadata:
  name: custom-proxy-config
spec:
  provider:
    type: Kubernetes
    kubernetes:
      envoyDeployment:
        pod:
          nodeSelector:
            alibabacloud.com/nodepool-id: NPXXX  # 替換為實際的節點池 ID
      envoyService:
        annotations:
          openyurt.io/topologyKeys: openyurt.io/nodepool  # 佈建服務拓撲
        type: NodePort  # ACK Edge 使用 NodePort 暴露服務

該配置包含三個ACK Edge情境的關鍵設定：

步驟四：建立Gateway資源

將下方樣本儲存到gateway.yaml，執行 kubectl apply -f gateway.yaml。

組件控制面會根據Gateway資源自動建立EnvoyProxy Deployment和NodePort類型的Service，並在節點上指定連接埠開啟監聽。

apiVersion: gateway.networking.k8s.io/v1
kind: Gateway
metadata:
  name: ack-gateway
spec:
  gatewayClassName: ack-gateway
  listeners:
    - name: http
      protocol: HTTP
      port: 80
  infrastructure:
    parametersRef:
      group: gateway.envoyproxy.io
      kind: EnvoyProxy
      name: custom-proxy-config  # 關聯步驟三建立的自訂配置

步驟五：擷取網關地址

網關服務採用NodePort方式暴露，對應的服務地址為節點池內任一節點IP和服務的連接埠。

1. 查詢Service連接埠。

   kubectl get service -n kube-system -l gateway.envoyproxy.io/owning-gateway-name=ack-gateway

   預期輸出：

   NAME                                 TYPE       CLUSTER-IP       EXTERNAL-IP   PORT(S)        AGE
   envoy-default-ack-gateway-7452df7d   NodePort   192.168.86.174   <none>        80:30364/TCP   19m

2. 設定網關地址環境變數。將NODEIP替換為節點池內任一節點的IP地址，NODEPORT替換為上一步查詢到的連接埠號碼。

   export GATEWAY_HOST=NODEIP:NODEPORT