準備 GKE 周邊網路

本頁面說明如何在新叢集或現有叢集啟用周邊網路、註冊命名空間和工作負載以啟用周邊流量重新導向,以及設定 mTLS 和授權政策。

如要進一步瞭解周邊網路架構、優點和功能,請參閱「周邊網路總覽」。

必要條件和限制

設定周邊網路前,請先詳閱下列功能限制、版本需求和範圍限制:

  • GKE 版本:必須使用 GKE 1.36.4-gke.1391000 以上版本。
  • Google Cloud CLI 版本:必須使用 Google Cloud CLI 592.0.0 以上版本。
  • 區域支援:叢集必須建立在區域 Cloud Service Mesh 支援的區域。
  • 工作負載互通性:註冊周邊網路的工作負載無法與加入邊車容器的工作負載或無 Proxy gRPC 互通。
  • 不支援的功能:
    • Kubernetes Service trafficDistribution 欄位。
    • 無頭 Service。
    • GKE Sandbox (gVisor)。
  • 安全性注意事項:如果節點上的 gke-ambient-nriplugin 元件無法使用,系統可能會略過傳入流量驗證和授權強制執行。

事前準備

在 Cloud de Confiance by S3NS中完成下列必要設定步驟:

  1. 建立或選取專案。
  2. 啟用必要的 API:

    gcloud services enable \
        privateca.googleapis.com \
        gkehub.googleapis.com \
        compute.googleapis.com \
        container.googleapis.com \
        trafficdirector.googleapis.com \
        networkservices.googleapis.com \
        networksecurity.googleapis.com \
        telemetry.googleapis.com \
        monitoring.googleapis.com \
        logging.googleapis.com
    
  3. 設定 GKE 的代管工作負載身分驗證。

在新叢集啟用周邊網路

執行下列指令,建立已啟用周邊網路的新 GKE 叢集:

  1. 建立啟用周邊網路的 GKE 叢集

    gcloud container clusters create CLUSTER_NAME \
        --machine-type=e2-standard-4 \
        --enable-ambient-networking \
        --enable-dataplane-v2 \
        --enable-fleet \
        --gateway-api=standard \
        --location=CLUSTER_LOCATION \
        --release-channel=rapid \
        --workload-pool=PROJECT_ID.s3ns.svc.id.goog
    

    現在有兩個 DaemonSet 在 gke-managed-ambient 命名空間中執行。

為現有叢集啟用周邊網路

請按照下列步驟,在現有的 GKE 叢集上啟用 ambient mesh:

  1. 確認叢集符合下列需求:

    • 1.36.4-gke.1391000 以上版本。
    • 已啟用 GKE Dataplane V2。
    • 機器類型必須是 e2-standard-4 以上。
    • 叢集必須新增至機群。
    • 叢集必須啟用 Gateway API 和 Workload Identity。
  2. 為現有叢集啟用周邊網路:

    gcloud container clusters update CLUSTER_NAME \
        --enable-ambient-networking \
        --location=CLUSTER_LOCATION \
        --enable-fleet
    

    現在有兩個 DaemonSet 在 gke-managed-ambient 命名空間中執行。

  3. 如要驗證,請將 CLI 指向叢集:

    gcloud container clusters get-credentials CLUSTER_NAME \
        --location=CLUSTER_LOCATION
    
  4. 取得 gke-managed-ambient 命名空間中的 DaemonSet:

    kubectl get daemonset -n gke-managed-ambient
    

    輸出內容大致如下:

    NAME                    DESIRED   CURRENT   READY   UP-TO-DATE   AVAILABLE   AGE
    gke-ambient-nriplugin   9         9         9       9            9           4d1h
    gke-ambient-proxy       9         9         9       9            9           4d1h
    

為周邊網路註冊命名空間

請按照下列步驟部署範例應用程式,並在命名空間啟用 Ambient 流量重新導向功能:

  1. 部署範例應用程式:

    kubectl apply -f - <<EOF
    apiVersion: v1
    kind: Namespace
    metadata:
      name: ambient-test
    ---
    apiVersion: v1
    kind: ServiceAccount
    metadata:
      name: client
      namespace: ambient-test
    ---
    apiVersion: v1
    kind: ServiceAccount
    metadata:
      name: server
      namespace: ambient-test
    ---
    apiVersion: v1
    kind: Service
    metadata:
      name: server
      namespace: ambient-test
      labels:
        app: server
    spec:
      ports:
      - port: 80
        protocol: TCP
      selector:
        app: server
    ---
    apiVersion: apps/v1
    kind: Deployment
    metadata:
      name: client
      namespace: ambient-test
      labels:
        app: client
    spec:
      replicas: 1
      selector:
        matchLabels:
          app: client
      template:
        metadata:
          labels:
            app: client
        spec:
          serviceAccountName: client
          containers:
          - name: nginx
            image: nginx:1.29.6
    ---
    apiVersion: apps/v1
    kind: Deployment
    metadata:
      name: server
      namespace: ambient-test
      labels:
        app: server
    spec:
      replicas: 2
      selector:
        matchLabels:
          app: server
      template:
        metadata:
          labels:
            app: server
        spec:
          serviceAccountName: server
          containers:
          - name: nginx
            image: nginx:1.29.6
            readinessProbe:
              httpGet:
                path: /
                port: 80
    EOF
    
  2. 為 ambient-test 命名空間加上標籤,以便透過 GKE Ambient Proxy 重新導向流量:

    kubectl label namespace ambient-test networking.gke.io/dataplane-mode=ambient
    
  3. 確認命名空間中的個別 Pod 已設定流量重新導向:

    kubectl get pods -n ambient-test -o yaml | grep redirection
    

    輸出內容大致如下:

    ambient.networking.gke.io/redirection: enabled
    ambient.networking.gke.io/redirection: enabled
    
  4. 測試用戶端到伺服器的流量:

    kubectl exec -it deploy/client -n ambient-test -- \
        /bin/curl -fsLS server.ambient-test.svc.cluster.local
    
  5. 如要確認明文流量是否通過 gke-ambient-proxy,請在Logs Explorer中查看存取記錄,並搜尋 gke-ambient-node-proxy-accesslog 記錄名稱:

    前往「Logs Explorer」頁面

為服務啟用 mTLS

為命名空間中的工作負載啟用流量重新導向後,請套用政策,強制執行加密、驗證和授權。

  1. 在伺服器端工作負載上設定寬鬆的 mTLS 政策:

    kubectl apply -f - <<EOF
    apiVersion: networking.gke.io/v1
    kind: GCPServerTLSPolicy
    metadata:
      name: server
      namespace: ambient-test
    spec:
      mtlsMode: Permissive
      targetRefs:
      - group: ""
        kind: Pod
        selector:
          matchLabels:
            app: server
    EOF
    

    這項政策會讓 Pod 同時接受 mTLS 和明文流量。請注意,寬鬆 mTLS 會使用流量探測功能,偵測流量是 mTLS 還是純文字。這會中斷使用自有 TLS 或「伺服器優先」通訊協定 (例如 MySQL) 的應用程式流量。

  2. 確認控制器已接受政策:

    kubectl describe gcpservertlspolicies -n ambient-test server | grep -A50 Status
    

    輸出內容大致如下:

    [...]
    
        Conditions:
        Last Transition Time:  2026-03-25T17:47:30Z
        Message:
        Reason:                Accepted
        Status:                True
        Type:                  Accepted
        Controller Name:         networking.gke.io/dpv2-1n
    Events:
    Type    Reason  Age                   From                   Message
    ----    ------  ----                  ----                   -------
    Normal  Sync    108s (x2 over 2m20s)  sc-dpv2-1n-controller  Sync on Mesh dpv2-1n-fqtx-mesh succeeded
    

    控制器接受政策後,最多可能需要三分鐘才能完成政策傳播。請等待三分鐘,再繼續操作。

  3. 設定用戶端 mTLS 政策,指定服務:

    kubectl apply -f - <<EOF
    apiVersion: networking.gke.io/v1
    kind: GCPClientTLSPolicy
    metadata:
      name: server-mtls
      namespace: ambient-test
    spec:
      targetRefs:
      - group: ""
        kind: Service
        name: server
      subjectAltNames:
      - uri: spiffe://PROJECT_ID.s3ns.svc.id.goog/ns/ambient-test/sa/server
    EOF
    

    這項政策會設定已註冊的用戶端,將 mTLS 流量傳送至伺服器 Service。您可能需要等待至少兩分鐘,才能繼續進行下一個步驟。

  4. 確認控制器已接受政策:

    kubectl describe gcpclienttlspolicies -n ambient-test server-mtls | grep -A50 Status
    

    輸出內容大致如下:

    [...]
    Status:
    Conditions:
        Last Transition Time:  2024-10-13T01:15:03Z
        Message:
        Observed Generation:   1
        Reason:                Accepted
        Status:                True
        Type:                  Accepted
    
  5. 測試用戶端到伺服器的流量:

    kubectl exec -it deploy/client -n ambient-test -- \
        /bin/curl -fsLS server.ambient-test.svc.cluster.local
    

    從已註冊周邊網路的 Pod 傳送至 ambient-test 命名空間中伺服器服務的流量,現在應會使用 mTLS。

  6. 如要確認連線是否使用 mTLS,請查看Logs Explorer中的存取記錄,並搜尋 gke-ambient-node-proxy-accesslog 記錄名稱:

    前往「Logs Explorer」頁面

  7. 更新現有的 GCPServerTLSPolicy,將伺服器服務上的 mode 從「Permissive」變更為「Strict」,讓工作負載 Pod 不再接受明文流量:

    kubectl apply -f - <<EOF
    apiVersion: networking.gke.io/v1
    kind: GCPServerTLSPolicy
    metadata:
      name: server
      namespace: ambient-test
    spec:
      mtlsMode: Strict
      targetRefs:
      - group: ""
        kind: Pod
        selector:
          matchLabels:
            app: server
    EOF
    
  8. 確認政策已接受:

    kubectl describe gcpservertlspolicies -n ambient-test server | grep -A50 Status
    

    輸出內容大致如下:

    Name:         server
    
    <...>
    
    UID:                 e4f2a7a3-69aa-4528-8ea6-6f1bf2142011
    Spec:
    Mtls Mode:  Strict
    Target Refs:
    Group:
    Kind:   Pod
    Selector:
      Match Labels:
        App:  server
    Status:
    Ancestors:
        Ancestor Ref:
        Group:
        Kind:   Pod
        Name:   app=server
        Conditions:
        Last Transition Time:  2026-03-25T22:33:54Z
        Message:
        Reason:                Accepted
        Status:                True
        Type:                  Accepted
        Controller Name:         networking.gke.io/dpv2-1n
    Events:
    Type    Reason  Age                  From                   Message
    ----    ------  ----                 ----                   -------
    Normal  Sync    43s (x5 over 4m57s)  sc-dpv2-1n-controller  Sync on Mesh dpv2-1n-2cdi-mesh succeeded
    

    現在,任何傳送至伺服器 Service 的明文流量都會遭到拒絕。

  9. 如要確認明文流量現在是否遭到拒絕,請從「未」註冊周邊網路的用戶端,將流量傳送至伺服器服務:

    kubectl create namespace noambient-test && \
    kubectl run -it -n noambient-test --rm curl --image=nginx -- \
        /bin/curl -fsLSv http://server.ambient-test.svc.cluster.local
    

    這項連線應該會失敗,並顯示類似下列的訊息:

    * Request completely sent off
    * Empty reply from server
    * shutting down connection #0
    curl: (52) Empty reply from server
    

設定第 4 層授權政策

如要強制執行以身分為基礎的授權,工作負載擁有者必須在政策選取器中指定 Pod 標籤。命名空間擁有者可在整個命名空間套用政策,不需使用選取器。

  1. 套用下列政策,強制規定只有用戶端可以與伺服器通訊:

    kubectl apply -f - <<EOF
    apiVersion: networking.gke.io/v1
    kind: GCPAuthzPolicy
    metadata:
      name: allow-client
      namespace: ambient-test
    spec:
      action: ALLOW
      enforcementLevel: L4
      targetRefs:
      - group: ""
        kind: Pod
        selector:
          matchLabels:
            app: server
      rules:
      - from:
          sources:
          - principals:
            - principalSelector: CLIENT_CERT_URI_SAN
              principal:
                type: Exact
                value: spiffe://PROJECT_ID.s3ns.svc.id.goog/ns/ambient-test/sa/client
    EOF
    

    這項政策會強制套用至傳送至 ambient-test 命名空間中伺服器 Pod 的流量。這項政策可確保系統只允許 SPIFFE 身分為 spiffe://PROJECT_ID.s3ns.svc.id.goog/ns/ambient-test/sa/client 的來源流量。

  2. 從 client 服務帳戶傳送範例要求,確認政策強制執行狀態為「allowed」。

    kubectl exec -it deploy/client -n ambient-test -- \
        /bin/curl -fsLS server.ambient-test.svc.cluster.local
    
  3. 從「server」服務帳戶傳送範例要求,確認不允許強制執行政策。

    kubectl exec -it deploy/server -n ambient-test -- \
        /bin/curl -fsLS server.ambient-test.svc.cluster.local
    

    輸出內容大致如下:

    curl: (52) Empty reply from server
    command terminated with exit code 52
    
  4. 您可以使用 Logs Explorer 查看授權強制執行記錄。在 Cloud de Confiance 控制台中,前往「Logs Explorer」頁面,並使用 gke-ambient-node-proxy-accesslog 記錄檔名稱搜尋遭拒的要求:

    resource.type="k8s_container"
    logName="projects/PROJECT_ID/logs/gke-ambient-node-proxy-accesslog"
    jsonPayload.error_details=~"rbac_access_denied"
    

    前往「Logs Explorer」頁面

啟用第 4 層指標

您可以選擇為已註冊命名空間中的工作負載啟用第 4 層指標生成功能。

啟用第 4 層指標生成功能之前,請確認您已啟用 telemetry.googleapis.com 和 monitoring.googleapis.com,並已將 networking.gke.io/dataplane-mode=ambient 套用至命名空間。

  1. 為命名空間中的工作負載啟用第 4 層指標生成功能:

    kubectl label namespace ambient-test networking.gke.io/ambient-network-metrics=enabled
    
  2. 確認已啟用第 4 層指標生成功能:

    kubectl get namespace ambient-test --show-labels
    

    輸出結果會與下列內容相似:

    NAME           STATUS   AGE   LABELS
    ambient-test   Active   15m   kubernetes.io/metadata.name=ambient-test,networking.gke.io/ambient-network-metrics=enabled,networking.gke.io/dataplane-mode=ambient
    

    套用 networking.gke.io/ambient-network-metrics=enabled 標籤,且流量在已註冊的工作負載之間流動後,Cloud Monitoring 就會提供第 4 層指標。您可以使用網路服務監控功能查看及分析這些指標。

  3. 前往 Cloud de Confiance by S3NS 控制台的「Network Services Monitoring」(網路服務監控) 頁面。

    前往「Network Services Monitoring」(網路服務監控)

    詳情請參閱「查看指標」和「Network Services Monitoring 指標參考資料」。