GKE アンビエント ネットワーキングを準備する

このページでは、新規または既存のクラスタでアンビエント ネットワーキングを有効にする方法、名前空間とワークロードを登録してアンビエント トラフィック リダイレクトを有効にする方法、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)。
  • セキュリティに関する注意事項: 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 用のマネージド ワークロード ID 認証を構成する。

新しいクラスタでアンビエント ネットワーキングを有効にする

次のコマンドを実行して、アンビエント ネットワーキングを有効にした新しい 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
    

    gke-managed-ambient Namespace で 2 つの DaemonSet が実行されるようになりました。

既存のクラスタでアンビエント ネットワーキングを有効にする

既存の GKE クラスタでアンビエント メッシュを有効にする手順は次のとおりです。

  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
    

    gke-managed-ambient Namespace で 2 つの DaemonSet が実行されるようになりました。

  3. 確認するには、CLI でクラスタを指定します。

    gcloud container clusters get-credentials CLUSTER_NAME \
        --location=CLUSTER_LOCATION
    
  4. gke-managed-ambient Namespace の 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 でアンビエント トラフィック リダイレクトを有効にします。

  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 アンビエント プロキシを介したトラフィック リダイレクトを有効にします。

    kubectl label namespace ambient-test networking.gke.io/dataplane-mode=ambient
    
  3. Namespace 内の個々の 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 を通過していることを確認するには、ログ エクスプローラでアクセスログを確認し、gke-ambient-node-proxy-accesslog ログ名を検索します。

    [ログ エクスプローラ] に移動

サービスの 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 分かかることがあります。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 分以上待つことが必要になる場合があります。

  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 が使用されていることを確認するには、ログ エクスプローラでアクセスログを確認し、gke-ambient-node-proxy-accesslog ログ名を検索します。

    [ログ エクスプローラ] に移動

  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
    

    サーバー サービスへの平文トラフィックはすべて拒否されるようになります。

  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 認可ポリシーを設定する

ID ベースの認可を適用するには、ワークロードのオーナーがポリシー セレクタで Pod ラベルを指定します。Namespace のオーナーは、セレクタを使用せずに Namespace 全体にポリシーを適用します。

  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 Namespace 内のサーバー Pod へのトラフィックに適用されます。これにより、SPIFFE ID が spiffe://PROJECT_ID.s3ns.svc.id.goog/ns/ambient-test/sa/client の送信元からのトラフィックのみが許可されます。

  2. クライアント サービス アカウントからサンプル リクエストを送信して、ポリシーの適用が許可されていることを確認します。

    kubectl exec -it deploy/client -n ambient-test -- \
        /bin/curl -fsLS server.ambient-test.svc.cluster.local
    
  3. サーバー サービス アカウントからサンプル リクエストを送信して、ポリシーの適用が許可されていないことを確認します。

    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. ログ エクスプローラを使用して、認可の適用ロギングを表示できます。 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 に適用されていることを確認します。

  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 の指標リファレンスをご覧ください。