本页面介绍了如何在新的或现有集群上启用 Ambient Networking、注册命名空间和工作负载以启用 Ambient 流量重定向,以及配置 mTLS 和授权政策。
如需详细了解 Ambient Networking 架构、优势和功能,请参阅 Ambient Networking 概览。
前提条件和限制
在设置 Ambient Networking 之前,请先查看以下功能限制、版本要求和范围限制:
- GKE 版本:需要 GKE 1.36.4-gke.1391000 版或更高版本。
- Google Cloud CLI 版本:需要 Google Cloud CLI 592.0.0 版或更高版本。
- 区域支持:必须在区域级 Cloud Service Mesh 支持的区域中创建集群。
- 工作负载互操作性:已加入 Ambient Networking 的工作负载无法与注入了 Sidecar 的工作负载或无代理 gRPC 互操作。
- 不支持的功能:
- Kubernetes Service
trafficDistribution字段。 - 无头服务。
- 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
在新集群上启用 Ambient Networking
运行以下命令,创建一个启用了 Ambient Networking 的新 GKE 集群:
创建启用了 Ambient Networking 的 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现在,
gke-managed-ambient命名空间中运行着两个 DaemonSet。
在现有集群上启用 Ambient Networking
请按照以下步骤在现有 GKE 集群上启用 Ambient Mesh:
验证您的集群是否满足以下要求:
1.36.4-gke.1391000版或更高版本。- GKE Dataplane V2 已启用。
- 机器类型必须为 e2-standard-4 或更大。
- 集群必须添加到舰队中。
- 集群必须已启用 Gateway API 和 Workload Identity。
在现有集群上启用 Ambient Networking:
gcloud container clusters update CLUSTER_NAME \ --enable-ambient-networking \ --location=CLUSTER_LOCATION \ --enable-fleet现在,
gke-managed-ambient命名空间中运行着两个 DaemonSet。如需进行验证,请将 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 Networking
请按照以下步骤部署示例应用,并在其命名空间中启用环境流量重定向:
部署示例应用:
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 代理进行的流量重定向: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此政策会将已注册的客户端配置为向服务器 Service 发起 mTLS 流量。您可能需要等待至少两分钟,然后才能继续执行下一步。
验证控制器已接受该政策:
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从已加入 Ambient Networking 的 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 的任何明文流量都将被拒绝。
如需验证明文流量现在是否被拒绝,请从“未”注册到 Ambient Networking 的客户端向服务器服务发送流量:
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 的来源的流量。通过从客户端服务账号发送示例请求,验证是否允许强制执行政策。
kubectl exec -it deploy/client -n ambient-test -- \ /bin/curl -fsLS server.ambient-test.svc.cluster.local通过从服务器服务账号发送示例请求,验证不允许强制执行政策。
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标签且流量在已注册的工作负载之间流动后,第 4 层指标便会在 Cloud Monitoring 中提供。您可以使用网络服务监控来查看和分析这些指标。在 Cloud de Confiance by S3NS 控制台中,前往网络服务监控页面。
如需了解详情,请参阅查看指标和 Network Services Monitoring 指标参考文档。