このページでは、新規または既存のクラスタでアンビエント ネットワーキングを有効にする方法、名前空間とワークロードを登録してアンビエント トラフィック リダイレクトを有効にする方法、mTLS と認可ポリシーを構成する方法について説明します。
アンビエント ネットワーキングのネットワークのアーキテクチャ、メリット、機能の詳細については、アンビエント ネットワーキングの概要をご覧ください。
前提条件と制限事項
アンビエント ネットワーキングを設定する前に、次の機能制限、バージョン要件、スコープ制限を確認してください。
- GKE バージョン: GKE バージョン 1.36.4-gke.1391000 以降が必要です。
- Google Cloud CLI のバージョン: Google Cloud CLI バージョン 592.0.0 以降が必要です。
- リージョン サポート: クラスタは、リージョン Cloud Service Mesh でサポートされているリージョンに作成する必要があります。
- ワークロードの相互運用性: アンビエント ネットワーキングに登録されたワークロードは、サイドカー インジェクションされたワークロードやプロキシレス gRPC と相互運用できません。
- サポートされていない機能:
- Kubernetes Service の
trafficDistributionフィールド。 - Headless 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.googgke-managed-ambientNamespace で 2 つの DaemonSet が実行されるようになりました。
既存のクラスタでアンビエント ネットワーキングを有効にする
既存の GKE クラスタでアンビエント メッシュを有効にする手順は次のとおりです。
クラスタが次の要件を満たしていることを確認します。
- バージョン
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-fleetgke-managed-ambientNamespace で 2 つの DaemonSet が実行されるようになりました。確認するには、CLI でクラスタを指定します。
gcloud container clusters get-credentials CLUSTER_NAME \ --location=CLUSTER_LOCATIONgke-managed-ambientNamespace の 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
アンビエント ネットワーキングに Namespace を登録する
次の手順に沿ってサンプル アプリケーションをデプロイし、その Namespace でアンビエント トラフィック リダイレクトを有効にします。
サンプル アプリケーションをデプロイします。
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 EOFambient-test名前空間にラベルを付けて、GKE アンビエント プロキシを介したトラフィック リダイレクトを有効にします。kubectl label namespace ambient-test networking.gke.io/dataplane-mode=ambientNamespace 内の個々の 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を通過していることを確認するには、ログ エクスプローラでアクセスログを確認し、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ポリシーの反映には、コントローラが承認してから最大 3 分かかることがあります。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 トラフィックを送信するように構成します。次のステップに進む前に、2 分以上待つことが必要になる場合があります。
ポリシーがコントローラによって承認されていることを確認します。
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 が使用されていることを確認するには、ログ エクスプローラでアクセスログを確認し、
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サーバー サービスへの平文トラフィックはすべて拒否されるようになります。
平文のトラフィックが拒否されていることを確認するには、アンビエント ネットワーキングに登録されていないクライアントからサーバー サービスにトラフィックを送信します。
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 認可ポリシーを設定する
ID ベースの認可を適用するには、ワークロードのオーナーがポリシー セレクタで Pod ラベルを指定します。Namespace のオーナーは、セレクタを使用せずに Namespace 全体にポリシーを適用します。
次のポリシーを適用して、クライアントのみがサーバーと通信できるようにします。
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-testNamespace 内のサーバー Pod へのトラフィックに適用されます。これにより、SPIFFE ID が 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ログ エクスプローラを使用して、認可の適用ロギングを表示できます。 Cloud de Confiance コンソールで、[ログ エクスプローラ] ページに移動し、
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 指標を有効にする
必要に応じて、登録済みの Namespace のワークロードに対してレイヤ 4 指標の生成を有効にできます。
レイヤ 4 指標の生成を有効にする前に、telemetry.googleapis.com と monitoring.googleapis.com が有効になっていること、および networking.gke.io/dataplane-mode=ambient が Namespace に適用されていることを確認します。
名前空間内のワークロードに対してレイヤ 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=ambientnetworking.gke.io/ambient-network-metrics=enabledラベルを適用し、登録されたワークロード間でトラフィックが流れると、Cloud Monitoring でレイヤ 4 指標を使用できるようになります。ネットワーク サービスのモニタリングを使用して、これらの指標を表示して分析できます。Cloud de Confiance by S3NS コンソールで、[ネットワーク サービスのモニタリング] ページに移動します。
詳細については、指標を表示すると Network Services Monitoring の指標リファレンスをご覧ください。