Questa pagina mostra come attivare Ambient Networking su un cluster nuovo o esistente, registrare spazi dei nomi e workload per attivare il reindirizzamento del traffico ambient e configurare mTLS e policy di autorizzazione.
Per saperne di più sull'architettura, sui vantaggi e sulle funzionalità di Ambient Networking, consulta la panoramica di Ambient Networking.
Prerequisiti e limitazioni
Prima di configurare l'Ambient Networking, esamina le seguenti limitazioni delle funzionalità, i requisiti di versione e le restrizioni dell'ambito:
- Versione di Google Cloud CLI: richiede Google Cloud CLI versione 592.0.0 o successiva.
- Supporto regionale: i cluster devono essere creati in una regione supportata da Cloud Service Mesh regionale.
- Interoperabilità dei workload: i workload registrati in Ambient Networking non possono interagire con i workload con iniezione sidecar o con gRPC senza proxy.
- Funzionalità non supportate:
- Campo
trafficDistributiondel servizio Kubernetes. - Servizi headless.
- GKE Sandbox (gVisor).
- Campo
- Avviso di sicurezza: se il componente
gke-ambient-nripluginnon è disponibile su un nodo, l'applicazione dell'autenticazione e dell'autorizzazione del traffico in entrata potrebbe essere ignorata.
Prima di iniziare
Completa i seguenti passaggi di configurazione dei prerequisiti in Cloud de Confiance by S3NS:
- Crea o seleziona un progetto.
Abilita le API richieste:
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.comConfigura l'autenticazione dell'identità dei workload gestita per GKE.
Abilita Ambient Networking su un nuovo cluster
Esegui questo comando per creare un nuovo cluster GKE con Ambient Networking abilitato:
Crea un cluster GKE con Ambient Networking abilitato
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.googOra nello spazio dei nomi
gke-managed-ambientsono in esecuzione due DaemonSet.
Abilita Ambient Networking su un cluster esistente
Segui questi passaggi per abilitare l'ambient mesh su un cluster GKE esistente:
Verifica che il cluster soddisfi i seguenti requisiti:
- Versione
1.36.4-gke.1391000o successiva. - GKE Dataplane V2 abilitato.
- Il tipo di macchina deve essere e2-standard-4 o superiore.
- Il cluster deve essere aggiunto a un parco risorse.
- Nel cluster devono essere abilitate l'API Gateway e Workload Identity.
- Versione
Abilita Ambient Networking su un cluster esistente:
gcloud container clusters update CLUSTER_NAME \ --enable-ambient-networking \ --location=CLUSTER_LOCATION \ --enable-fleetOra nello spazio dei nomi
gke-managed-ambientsono in esecuzione due DaemonSet.Per verificare, punta l'interfaccia a riga di comando al cluster:
gcloud container clusters get-credentials CLUSTER_NAME \ --location=CLUSTER_LOCATIONRecupera i daemonset nello spazio dei nomi
gke-managed-ambient:kubectl get daemonset -n gke-managed-ambientL'output è simile al seguente:
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
Registra uno spazio dei nomi per Ambient Networking
Segui questi passaggi per eseguire il deployment di un'applicazione di esempio e attivare il reindirizzamento del traffico in modalità Ambient nel relativo spazio dei nomi:
Esegui il deployment di un'applicazione di esempio:
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 EOFEtichetta lo spazio dei nomi
ambient-testper abilitare il reindirizzamento del traffico tramite il proxy GKE Ambient:kubectl label namespace ambient-test networking.gke.io/dataplane-mode=ambientVerifica che i singoli pod nello spazio dei nomi siano stati configurati per il reindirizzamento del traffico:
kubectl get pods -n ambient-test -o yaml | grep redirectionL'output è simile al seguente:
ambient.networking.gke.io/redirection: enabled ambient.networking.gke.io/redirection: enabledTesta il traffico da client a server:
kubectl exec -it deploy/client -n ambient-test -- \ /bin/curl -fsLS server.ambient-test.svc.cluster.localPer verificare che il traffico in testo non crittografato passi attraverso
gke-ambient-proxy, controlla i log di accesso in Esplora log e cerca il nome del loggke-ambient-node-proxy-accesslog:
Abilita mTLS per un servizio
Dopo aver abilitato il reindirizzamento del traffico per i workload in uno spazio dei nomi, applica le policy per applicare forzatamente la crittografia, l'autenticazione e l'autorizzazione.
Configura una policy mTLS permissiva sui workload lato server:
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 EOFQuesta policy fa sì che i pod accettino sia il traffico mTLS sia quello in testo non crittografato. Tieni presente che mTLS permissivo utilizza lo sniffing del traffico per rilevare se il traffico è mTLS o testo normale. In questo modo, il traffico dell'applicazione che utilizza il proprio TLS o un protocollo "server speaks first" come MySQL verrà interrotto.
Verifica che la policy sia stata accettata dal controller:
kubectl describe gcpservertlspolicies -n ambient-test server | grep -A50 StatusL'output è simile al seguente:
[...] 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 succeededLa propagazione delle policy può richiedere fino a tre minuti dopo l'accettazione del controller. Attendi tre minuti prima di procedere.
Configura una policy mTLS lato client che ha come target il servizio:
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 EOFQuesta policy configura i client registrati in modo che generino traffico mTLS verso il servizio server. Potresti dover attendere almeno due minuti prima di procedere con il passaggio successivo.
Verifica che la policy sia stata accettata dal controller:
kubectl describe gcpclienttlspolicies -n ambient-test server-mtls | grep -A50 StatusL'output è simile al seguente:
[...] Status: Conditions: Last Transition Time: 2024-10-13T01:15:03Z Message: Observed Generation: 1 Reason: Accepted Status: True Type: AcceptedTesta il traffico da client a server:
kubectl exec -it deploy/client -n ambient-test -- \ /bin/curl -fsLS server.ambient-test.svc.cluster.localIl traffico dai pod registrati in Ambient Networking al servizio server nello spazio dei nomi ambient-test ora dovrebbe utilizzare mTLS.
Per verificare che le connessioni utilizzino mTLS, controlla i log di accesso in Esplora log e cerca il nome del log
gke-ambient-node-proxy-accesslog:Aggiorna la risorsa GCPServerTLSPolicy esistente per modificare
modeda Permissive a Strict sul servizio server in modo che i pod del workload non accettino più il traffico in testo non crittografato: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 EOFVerifica che la policy sia stata accettata:
kubectl describe gcpservertlspolicies -n ambient-test server | grep -A50 StatusL'output è simile al seguente:
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 succeededQualsiasi traffico in testo non crittografato verso il servizio server verrà ora rifiutato.
Per verificare che il traffico in testo non crittografato venga ora rifiutato, invia il traffico al servizio server da un client NON registrato in 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.localQuesta connessione dovrebbe non riuscire con un messaggio simile al seguente:
* Request completely sent off * Empty reply from server * shutting down connection #0 curl: (52) Empty reply from server
Imposta la policy di autorizzazione di livello 4
Per applicare l'autorizzazione basata sull'identità, i proprietari dei workload specificano le etichette dei pod nel selettore delle policy. I proprietari degli spazi dei nomi applicano le policy a livello di spazio dei nomi senza selettori.
Applica la seguente policy per imporre che solo il client possa comunicare con il server:
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 EOFQuesta policy viene applicata al traffico verso i pod del server nello spazio dei nomi
ambient-test. In questo modo, il traffico è consentito solo da origini con identità SPIFFE spiffe://PROJECT_ID.s3ns.svc.id.goog/ns/ambient-test/sa/client.Verifica che l'applicazione delle policy sia consentita inviando una richiesta di esempio dal account di servizio client.
kubectl exec -it deploy/client -n ambient-test -- \ /bin/curl -fsLS server.ambient-test.svc.cluster.localVerifica che l'applicazione delle policy non sia consentita inviando una richiesta di esempio dal account di servizio server.
kubectl exec -it deploy/server -n ambient-test -- \ /bin/curl -fsLS server.ambient-test.svc.cluster.localL'output è simile al seguente:
curl: (52) Empty reply from server command terminated with exit code 52Puoi utilizzare Esplora log per visualizzare il logging dell'applicazione dell'autorizzazione. Nella console Cloud de Confiance , vai alla pagina Esplora log e cerca le richieste rifiutate utilizzando il nome del log
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"
Abilita le metriche di livello 4
Facoltativamente, puoi attivare la generazione di metriche di livello 4 per i workload in uno spazio dei nomi registrato.
Prima di attivare la generazione delle metriche di livello 4, verifica di aver attivato
telemetry.googleapis.com e monitoring.googleapis.com e di aver
applicato networking.gke.io/dataplane-mode=ambient allo spazio dei nomi.
Abilita la generazione di metriche di livello 4 per i workload nello spazio dei nomi:
kubectl label namespace ambient-test networking.gke.io/ambient-network-metrics=enabledVerifica che la generazione delle metriche di livello 4 sia abilitata:
kubectl get namespace ambient-test --show-labelsL'output è simile al seguente:
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=ambientDopo aver applicato l'etichetta
networking.gke.io/ambient-network-metrics=enablede i flussi di traffico tra i workload registrati, le metriche di livello 4 sono disponibili in Cloud Monitoring. Puoi utilizzare Network Services Monitoring per visualizzarle e analizzarle.Nella console Cloud de Confiance by S3NS , vai alla pagina Monitoraggio dei servizi di rete.
Vai a Monitoraggio dei servizi di rete
Per saperne di più, consulta Visualizza le metriche e il Riferimento alle metriche di monitoraggio di Network Services.