本頁面說明如何在新叢集或現有叢集啟用周邊網路、註冊命名空間和工作負載以啟用周邊流量重新導向,以及設定 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)。
- Kubernetes Service
- 安全性注意事項:如果節點上的
gke-ambient-nriplugin元件無法使用,系統可能會略過傳入流量驗證和授權強制執行。
事前準備
在 Cloud de Confiance by S3NS中完成下列必要設定步驟:
- 建立或選取專案。
啟用必要的 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
在新叢集啟用周邊網路
執行下列指令,建立已啟用周邊網路的新 GKE 叢集:
建立啟用周邊網路的 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.36.4-gke.1391000以上版本。- 已啟用 GKE Dataplane V2。
- 機器類型必須是 e2-standard-4 以上。
- 叢集必須新增至機群。
- 叢集必須啟用 Gateway API 和 Workload Identity。
為現有叢集啟用周邊網路:
gcloud container clusters update CLUSTER_NAME \ --enable-ambient-networking \ --location=CLUSTER_LOCATION \ --enable-fleet現在有兩個 DaemonSet 在
gke-managed-ambient命名空間中執行。如要驗證,請將 CLI 指向叢集:
gcloud container clusters get-credentials CLUSTER_NAME \ --location=CLUSTER_LOCATION取得
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 流量重新導向功能:
部署範例應用程式:
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為
ambient-test命名空間加上標籤,以便透過 GKE Ambient Proxy 重新導向流量:kubectl label namespace ambient-test networking.gke.io/dataplane-mode=ambient確認命名空間中的個別 Pod 已設定流量重新導向:
kubectl get pods -n ambient-test -o yaml | grep redirection輸出內容大致如下:
ambient.networking.gke.io/redirection: enabled ambient.networking.gke.io/redirection: enabled測試用戶端到伺服器的流量:
kubectl exec -it deploy/client -n ambient-test -- \ /bin/curl -fsLS server.ambient-test.svc.cluster.local如要確認明文流量是否通過
gke-ambient-proxy,請在Logs Explorer中查看存取記錄,並搜尋gke-ambient-node-proxy-accesslog記錄名稱:
為服務啟用 mTLS
為命名空間中的工作負載啟用流量重新導向後,請套用政策,強制執行加密、驗證和授權。
在伺服器端工作負載上設定寬鬆的 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) 的應用程式流量。
確認控制器已接受政策:
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控制器接受政策後,最多可能需要三分鐘才能完成政策傳播。請等待三分鐘,再繼續操作。
設定用戶端 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。您可能需要等待至少兩分鐘,才能繼續進行下一個步驟。
確認控制器已接受政策:
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測試用戶端到伺服器的流量:
kubectl exec -it deploy/client -n ambient-test -- \ /bin/curl -fsLS server.ambient-test.svc.cluster.local從已註冊周邊網路的 Pod 傳送至 ambient-test 命名空間中伺服器服務的流量,現在應會使用 mTLS。
如要確認連線是否使用 mTLS,請查看Logs Explorer中的存取記錄,並搜尋
gke-ambient-node-proxy-accesslog記錄名稱:更新現有的 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確認政策已接受:
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 的明文流量都會遭到拒絕。
如要確認明文流量現在是否遭到拒絕,請從「未」註冊周邊網路的用戶端,將流量傳送至伺服器服務:
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 標籤。命名空間擁有者可在整個命名空間套用政策,不需使用選取器。
套用下列政策,強制規定只有用戶端可以與伺服器通訊:
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 的來源流量。從 client 服務帳戶傳送範例要求,確認政策強制執行狀態為「allowed」。
kubectl exec -it deploy/client -n ambient-test -- \ /bin/curl -fsLS server.ambient-test.svc.cluster.local從「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您可以使用 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"
啟用第 4 層指標
您可以選擇為已註冊命名空間中的工作負載啟用第 4 層指標生成功能。
啟用第 4 層指標生成功能之前,請確認您已啟用 telemetry.googleapis.com 和 monitoring.googleapis.com,並已將 networking.gke.io/dataplane-mode=ambient 套用至命名空間。
為命名空間中的工作負載啟用第 4 層指標生成功能:
kubectl label namespace ambient-test networking.gke.io/ambient-network-metrics=enabled確認已啟用第 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 層指標。您可以使用網路服務監控功能查看及分析這些指標。前往 Cloud de Confiance by S3NS 控制台的「Network Services Monitoring」(網路服務監控) 頁面。
前往「Network Services Monitoring」(網路服務監控)
詳情請參閱「查看指標」和「Network Services Monitoring 指標參考資料」。