Applicare in modo selettivo i criteri firewall in GKE

Questa pagina mostra come applicare in modo selettivo i criteri firewall di rete di Cloud Next Generation Firewall in Google Kubernetes Engine (GKE) utilizzando i tag. Per scoprire come utilizzare i tag in GKE per altri scopi, come la gestione della fatturazione o i criteri IAM condizionali, consulta Gestire le risorse GKE utilizzando i tag.

Informazioni sui tag

I tag sono coppie chiave/valore che consentono di annotare e gestire le risorse Google Cloud a livello di organizzazione o progetto. Puoi utilizzare i tag per organizzare le risorse e applicare in modo condizionale criteri come i firewall o i criteri IAM. Puoi utilizzare controllo dell'accesso IAM per definire chi può collegare, creare, aggiornare o eliminare i tag.

Per saperne di più sui tag, consulta la Panoramica dei tag nella documentazione di Resource Manager.

Utilizzare i tag per applicare i criteri firewall di rete

Puoi utilizzare i tag per applicare in modo condizionale i criteri firewall di rete globali o regionali ai nodi GKE. Devi designare lo scopo GCE_FIREWALL per i tag che vuoi utilizzare con i criteri firewall di rete. Quando applichi i tag scopo del firewall ai cluster o ai pool di nodi GKE, GKE li associa automaticamente alle macchine virtuali (VM) Compute Engine corrispondenti.

I tag per i criteri firewall di rete eliminano la necessità di utilizzare tag di rete, ovvero metadati che chiunque può associare alle VM Compute Engine sottostanti per l'applicazione delle regole firewall di Virtual Private Cloud e che non supportano controllo dell'accesso dell'accesso IAM. Se al momento utilizzi tag di rete con regole firewall VPC, ti consigliamo di eseguire la migrazione ai criteri firewall di rete e di utilizzare tag firewall sicuri. Per un confronto dettagliato, consulta Confrontare i tag di rete con i tag in questo documento.

Tag per il flusso di lavoro dei criteri firewall di rete

Per utilizzare i tag con i criteri firewall di rete in GKE, procedi nel seguente modo:

  1. Crea un tag:

    1. Definisci una chiave del tag a livello di organizzazione o progetto, ad esempio env.
    2. Definisci i possibili valori dei tag per la chiave, ad esempio dev, staging e prod.

    3. Designa il tag per l'utilizzo del criterio firewall di rete.

  2. Concedi agli utenti l'accesso per interagire con il tag firewall.

  3. Applica coppie chiave-valore dei tag a cluster o node pool GKE specifici. GKE associa automaticamente i tag alle VM Compute Engine sottostanti per l'applicazione delle norme del firewall.

Prima di iniziare

Prima di iniziare, assicurati di aver eseguito le seguenti operazioni:

  • Attiva l'API Google Kubernetes Engine.
    • Attiva l'API Google Kubernetes Engine
  • Se vuoi utilizzare Google Cloud CLI per questa attività, installa e poi inizializza gcloud CLI. Se hai già installato gcloud CLI, ottieni la versione più recente eseguendo gcloud components update.

Requisiti e limitazioni

  • I tag per i criteri firewall di rete sono supportati in GKE 1.28 e versioni successive. Se utilizzi una versione GKE precedente alla 1.28, utilizza invece i tag di rete con le regole firewall VPC.
  • Il cluster GKE e il tag devono essere associati alla stessa rete VPC.
  • Nei cluster standard, ogni pool di nodi supporta fino a cinque tag di firewall collegati.
  • I cluster Autopilot supportano fino a cinque tag firewall.
  • GKE rifiuta le chiavi dei tag che utilizzano il prefisso gke-managed.
  • Devi creare le coppie chiave/valore dei tag prima di poterle associare ai cluster o ai pool di nodi.

Ruoli e autorizzazioni IAM

Per ottenere le autorizzazioni necessarie per utilizzare i tag per i criteri firewall in GKE, chiedi all'amministratore di concederti i seguenti ruoli IAM:

Per saperne di più sulla concessione dei ruoli, consulta Gestire l'accesso a progetti, cartelle e organizzazioni.

Potresti anche riuscire a ottenere le autorizzazioni richieste tramite i ruoli personalizzati o altri ruoli predefiniti.

Creare tag

I tag devono esistere per poterli associare a cluster o nodi. Per creare un tag, consulta Utilizzare i tag per i firewall nella documentazione di Cloud NGFW.

Ad esempio, per creare un tag firewall basato sul progetto, esegui i seguenti comandi:

  1. Crea la chiave tag:

    gcloud resource-manager tags keys create TAG_KEY \
    --parent=projects/PROJECT_ID \
    --purpose=GCE_FIREWALL \
    --purpose-data=network=PROJECT_ID/NETWORK_NAME

    Sostituisci quanto segue:

    • TAG_KEY: il nome della chiave del tag, ad esempio env
    • PROJECT_ID: il tuo ID progetto Google Cloud
    • NETWORK_NAME: il nome della rete VPC che utilizzerai con il tag

  2. Recupera l'ID della chiave del tag:

    gcloud resource-manager tags keys describe PROJECT_ID/TAG_KEY \
    --format="value(name)"

    L'output è tagKeys/KEY_ID, dove KEY_ID è un ID numerico per la chiave. Prendi nota di questo ID per utilizzarlo in un secondo momento.

  3. Aggiungi un valore tag alla chiave tag:

    gcloud resource-manager tags values create TAG_VALUE \
    --parent=tagKeys/KEY_ID

    Sostituisci TAG_VALUE con il nome di un valore consentito per la chiave del tag, ad esempio dev.

Sintassi dei tag nei comandi gcloud CLI

Quando fai riferimento ai tag utilizzando gcloud CLI, devi formattare le coppie chiave-valore utilizzando una delle seguenti sintassi:

Sintassi dei tag 
tagKeys/KEY_ID=tagValues/VALUE_ID

Sostituisci quanto segue:

  • KEY_ID: l'ID chiave numerico
  • VALUE_ID: l'ID del valore numerico

Ad esempio, tagKeys/123456789=tagValues/987654321.

 
ORGANIZATION_ID/TAG_KEY=TAG_VALUE

Sostituisci quanto segue:

  • ORGANIZATION_ID: il tuo ID numerico dell'organizzazione Google Cloud
  • TAG_KEY: il nome della chiave tag che hai creato
  • TAG_VALUE: il nome del valore tag che hai creato

Ad esempio, 12345678901/env=dev.

 
PROJECT_ID/TAG_KEY=TAG_VALUE

Sostituisci quanto segue:

  • PROJECT_ID: il tuo ID progetto Google Cloud
  • TAG_KEY: il nome della chiave tag che hai creato
  • TAG_VALUE: il nome del valore tag che hai creato

Ad esempio, example-project/env=dev.

 
PROJECT_NUMBER/TAG_KEY=TAG_VALUE

Sostituisci quanto segue:

  • PROJECT_ID: l'identificatore numerico del tuo progetto Google Cloud
  • TAG_KEY: il nome della chiave tag che hai creato
  • TAG_VALUE: il nome del valore tag che hai creato

Ad esempio, 11223344556/env=dev.

Tag di destinazione con criteri firewall

Dopo aver creato i tag, puoi fare riferimento a coppie chiave-valore specifiche nelle regole del criterio firewall. Per le istruzioni, consulta Utilizzare i tag per i firewall.

Concedi le autorizzazioni IAM agli agenti di servizio

Affinché GKE colleghi automaticamente i tag ai nuovi nodi durante gli eventi di scalabilità, devi concedere i ruoli IAM corrispondente agli account di servizio gestiti da Google Cloud, chiamati anche agenti di servizio.

  1. Concedi il ruolo Utente tag (roles/resourcemanager.tagUser) all'agente di servizio Kubernetes Engine:

    gcloud projects add-iam-policy-binding PROJECT_ID \
    --member=serviceAccount:service-PROJECT_NUMBER@container-engine-robot.iam.gserviceaccount.com \
    --role=roles/resourcemanager.tagUser \
    --condition=None

    Sostituisci PROJECT_NUMBER con il numero del progetto Google Cloud del cluster. Per trovare il numero di progetto, esegui il seguente comando:

    gcloud projects describe PROJECT_ID --format="value(projectNumber)"

  2. Concedi il ruolo Amministratore delle assegnazioni dei tag (roles/resourcemanager.tagHoldAdmin) all'agente di servizio Kubernetes Engine per la coppia chiave-valore del tag:

    gcloud resource-manager tags values add-iam-policy-binding PROJECT_ID/TAG_KEY/TAG_VALUE \
    --member=serviceAccount:service-PROJECT_NUMBER@container-engine-robot.iam.gserviceaccount.com \
    --role=roles/resourcemanager.tagHoldAdmin

    Questo ruolo consente all'agente di servizio di impedire l'eliminazione dei tag se la coppia chiave-valore è ancora in uso in GKE.

  3. Concedi il ruolo Utente tag (roles/resourcemanager.tagUser) all'agente di servizio API di Google:

    gcloud projects add-iam-policy-binding PROJECT_ID \
    --member=serviceAccount:PROJECT_NUMBER@cloudservices.gserviceaccount.com \
    --role=roles/resourcemanager.tagUser \
    --condition=None

Concedi ruoli IAM aggiuntivi per i tag esterni al progetto

Per utilizzare i tag di proprietà di un'organizzazione o di un progetto diverso da quello del cluster, svolgi i seguenti passaggi aggiuntivi:

  1. Concedi il ruolo Utente tag (roles/resourcemanager.tagUser) all'accesso dell'agente di servizio Kubernetes Engine per i tag nella risorsa principale:

    gcloud resource-manager tags keys add-iam-policy-binding PARENT_RESOURCE/TAG_KEY \
    --member=serviceAccount:service-PROJECT_NUMBER@container-engine-robot.iam.gserviceaccount.com \
    --role=roles/resourcemanager.tagUser \
    --condition=None

    Sostituisci quanto segue:

    • PARENT_RESOURCE: l'ID progetto o l'ID organizzazione della risorsa proprietaria del tag
    • PROJECT_NUMBER: il numero del progetto cluster.

  2. Concedi il ruolo Utente tag (roles/resourcemanager.tagUser) all'accesso dell'agente di servizio per le API Google per i tag nella risorsa principale:

    gcloud resource-manager tags keys add-iam-policy-binding PARENT_RESOURCE/TAG_KEY \
    --member=serviceAccount:PROJECT_NUMBER@cloudservices.gserviceaccount.com \
    --role=roles/resourcemanager.tagUser \
    --condition=None

  3. Concedi il ruolo Amministratore delle strutture dei tag (roles/resourcemanager.tagHoldAdmin) all'agente di servizio Kubernetes Engine per la coppia chiave-valore del tag:

    gcloud resource-manager tags values add-iam-policy-binding PARENT_RESOURCE/TAG_KEY/TAG_VALUE \
    --member=serviceAccount:service-PROJECT_NUMBER@container-engine-robot.iam.gserviceaccount.com \
    --role=roles/resourcemanager.tagHoldAdmin

Collega i tag firewall ai cluster Autopilot

Collega i tag firewall ai cluster Autopilot a livello di cluster. GKE applica automaticamente questi tag a livello di cluster a ogni nodo.

Attaccare i tag quando crei un nuovo cluster Autopilot

Esegui questo comando:

gcloud beta container clusters create-auto CLUSTER_NAME \
    --location=LOCATION \
    --autoprovisioning-resource-manager-tags=TAG1,TAG2,...

Sostituisci quanto segue:

  • CLUSTER_NAME: il nome del nuovo cluster.
  • LOCATION: la regione Compute Engine del cluster.
  • TAG1,TAG2,...: un insieme di coppie chiave-valore da associare, separate da virgole. Ogni coppia chiave-valore deve utilizzare una sintassi supportata, come descritto nella sezione Sintassi dei tag nei comandi. Ad esempio, example-project/env=dev,1234567901/team=sre.

Collega i tag ai cluster Autopilot esistenti

Esegui questo comando:

gcloud beta container clusters update CLUSTER_NAME \
    --location=LOCATION \
    --autoprovisioning-resource-manager-tags=TAG1,TAG2,...

Quando aggiorni i tag di un cluster, GKE sovrascrive eventuali tag esistenti su tutti i nodi.

Associare i tag firewall ai cluster e ai pool di nodi standard

Il metodo utilizzato per allegare i tag dipende dal fatto che tu voglia o meno che gli altri pool di nodi del cluster ereditino i tag, come segue:

Tag firewall del cluster standard
--autoprovisioning-resource-manager-tags

Impostazione a livello di cluster

GKE applica i tag a tutti i nuovi pool di nodi di cui è stato eseguito il provisioning automatico nel cluster.

Se utilizzi questo flag in un cluster esistente, GKE non applica i tag ai pool di nodi esistenti nel cluster. I pool di nodi esistenti mantengono i tag già applicati prima dell'aggiornamento. Per aggiornare i tag dei pool di nodi esistenti, utilizza il flag --resource-manager-tags.
--resource-manager-tags

Impostazione a livello di node pool

GKE applica i tag al pool di nodi specificato. Se utilizzi questo flag durante la creazione del cluster, GKE applica i tag al pool di nodi predefinito creato da GKE. Se utilizzi questo flag su un pool di nodi di cui è stato eseguito il provisioning automatico, GKE sovrascrive eventuali tag esistenti nel pool di nodi.

Associare i tag firewall ai cluster standard

Puoi associare i tag a cluster standard nuovi o esistenti. Quando colleghi i tag a un intero cluster, GKE li considera impostati a livello di cluster.

Associare tag a un nuovo cluster standard con provisioning automatico dei nodi

Per impostazione predefinita, GKE utilizza i tag a livello di cluster per i nuovi nodi di cui è stato eseguito il provisioning automatico. Il pool di nodi predefinito creato da GKE nel cluster non viene eseguito il provisioning automaticamente e non riceve questi tag.

gcloud beta container clusters create CLUSTER_NAME \
    --location=LOCATION \
    --autoprovisioning-resource-manager-tags=TAG1,TAG2,... \
    --enable-autoprovisioning \
    --max-cpu=MAX_CPU \
    --max-memory=MAX_MEMORY

Sostituisci quanto segue:

  • CLUSTER_NAME: il nome del nuovo cluster
  • LOCATION: la regione o la zona Compute Engine per il cluster
  • TAG1,TAG2,...: un insieme di coppie chiave-valore da associare, separate da virgola. Ogni coppia chiave-valore deve utilizzare una sintassi supportata, come descritto nella sezione Sintassi dei tag nei comandi. Ad esempio, example-project/env=dev,1234567901/team=sre.
  • MAX_CPU: il numero massimo di core per il cluster
  • MAX_MEMORY: la capacità di memoria massima per il cluster in gigabyte

Attaccare i tag quando attivi il provisioning automatico dei nodi su un cluster esistente

GKE applica questi tag solo ai nuovi node pool di cui è stato eseguito il provisioning automatico. I pool di nodi esistenti mantengono i tag che avevano prima dell'aggiornamento.

  1. Collega i tag al cluster:

    gcloud beta container clusters update CLUSTER_NAME \
    --location=LOCATION \
    --autoprovisioning-resource-manager-tags=TAG1,TAG2,...

  2. Abilita il provisioning automatico dei nodi nel cluster:

    gcloud beta container clusters update CLUSTER_NAME \
    --location=LOCATION \
    --enable-autoprovisioning \
    --max-cpu=MAX_CPU \
    --max-memory=MAX_MEMORY

Associare i tag firewall ai pool di nodi

Puoi associare tag a pool di nodi nuovi o esistenti, indipendentemente dal fatto che utilizzino o meno il provisioning automatico dei nodi. GKE considera questi tag come un'impostazione a livello di pool di nodi.

Associare tag al pool di nodi predefinito

GKE associa i tag specificati utilizzando il flag --resource-manager-tags quando crei un cluster al pool di nodi predefinito creato da GKE nel cluster.

gcloud beta container clusters create CLUSTER_NAME \
    --location=LOCATION \
    --resource-manager-tags=TAG1,TAG2,...

Sostituisci quanto segue:

  • CLUSTER_NAME: il nome del nuovo cluster
  • LOCATION: la regione o la zona Compute Engine per il cluster
  • TAG1,TAG2,...: un insieme di coppie chiave-valore da associare, separate da virgole. Ogni coppia chiave-valore deve utilizzare una sintassi supportata, come descritto nella sezione Sintassi dei tag nei comandi. Ad esempio, example-project/env=dev,1234567901/team=sre.

Attaccare i tag a un nuovo pool di nodi

Quando utilizzi il flag --resource-manager-tags durante la creazione del pool di nodi, GKE allega i tag specificati al pool di nodi.

gcloud beta container node-pools create NODE_POOL_NAME \
    --cluster=CLUSTER_NAME \
    --location=LOCATION \
    --resource-manager-tags=TAG1,TAG2,...

Sostituisci quanto segue:

  • NODE_POOL_NAME: il nome del nuovo pool di nodi
  • CLUSTER_NAME: il nome del cluster
  • LOCATION: la regione o la zona di Compute Engine del cluster
  • TAG1,TAG2,...:un insieme di coppie chiave-valore da associare, separate da virgole. Ogni coppia chiave-valore deve utilizzare una sintassi supportata, come descritto nella sezione Sintassi dei tag nei comandi. Ad esempio, example-project/env=dev,1234567901/team=sre.

Collegare i tag a un pool di nodi esistente

Quando aggiorni i tag di un pool di nodi esistente utilizzando il flag --resource-manager-tags, GKE sovrascrive eventuali tag esistenti nel pool di nodi. Puoi utilizzare questo comando per aggiornare i tag dei node pool con provisioning automatico.

gcloud beta container node-pools update NODE_POOL_NAME \
    --cluster=CLUSTER_NAME \
    --location=LOCATION \
    --resource-manager-tags=TAG1,TAG2,...

Sostituisci NODE_POOL_NAME con il nome del pool di nodi da actualizare.

Attiva/disattiva le impostazioni di provisioning automatico nei cluster e nei pool di nodi esistenti

Quando aggiorni i tag a livello di cluster, GKE li applica a tutti i nuovi pool di nodi del cluster e conserva i tag associati ai pool di nodi esistenti.

Quando aggiorni i pool di nodi esistenti per abilitare o disabilitare il provisioning automatico dei nodi, tieni presente le seguenti implicazioni per i tag:

  • Quando attivi o disattivi il provisioning automatico dei nodi, il pool di nodi conserva tutti i tag esistenti. GKE non sovrascrive questi tag con quelli a livello di cluster, nemmeno durante la ricostituzione dei nodi.
  • Se aggiorni manualmente i tag in pool di nodi specifici, GKE sovrascrive i tag esistenti con quelli specificati per quel pool di nodi.

Verifica i tag del firewall sul cluster

  • Elenca i tag sui cluster Autopilot:

    gcloud beta container clusters describe CLUSTER_NAME \
    --location=LOCATION \
    --format="value(nodePoolAutoConfig.resourceManagerTags)"

  • Elenca i tag su pool di nodi specifici:

    gcloud beta container node-pools describe NODE_POOL_NAME \
  --cluster=CLUSTER_NAME \
  --location=LOCATION \
  --format="value(config.resourceManagerTags)"

Scollegare i tag firewall da cluster e pool di nodi

Per rimuovere i tag firewall da cluster e node pool, aggiorna la risorsa con un valore vuoto per i tag.

Scollegare i tag dai cluster Autopilot

Esegui questo comando:

gcloud beta container clusters update CLUSTER_NAME \
    --location=LOCATION \
    --autoprovisioning-resource-manager-tags=

Scollegare i tag dai node pool

  1. Scollega i tag di provisioning automatico dei nodi a livello di cluster:

    gcloud beta container clusters update CLUSTER_NAME \
    --location=LOCATION \
    --autoprovisioning-resource-manager-tags=

    GKE non collegherà i tag ai nuovi pool di nodi di cui è stato eseguito il provisioning automatico.

  2. Scollega i tag dei pool di nodi:

    gcloud beta container node-pools update NODE_POOL_NAME \
    --cluster=CLUSTER_NAME \
    --location=LOCATION \
    --resource-manager-tags=

    GKE rimuove i tag esistenti dal pool di nodi.

Eliminare le chiavi e i valori dei tag

Per eliminare una chiave o un valore tag, assicurati che il tag sia scollegato da tutte le risorse. Quindi, consulta Elimina i tag nella documentazione di Resource Manager.

Confrontare i tag di rete con i tag

L'utilizzo dei tag per l'applicazione dei criteri firewall offre significativi vantaggi in termini di sicurezza e usabilità rispetto ai tag di rete. Analogamente, i criteri firewall di rete migliorano le funzionalità delle regole firewall VPC facilitando l'applicazione delle regole firewall in intere organizzazioni, cartelle, progetti o reti.

L'utilizzo dei tag con i criteri firewall di rete è un modo più sicuro e scalabile per gestire l'accesso agli ambienti GKE della tua organizzazione. Puoi utilizzare i tag di rete nello stesso cluster dei tag, anche se non puoi utilizzarli per applicare i criteri firewall di rete.

Per un confronto dettagliato tra i tag e i tag di rete, consulta Confronto tra tag e tag di rete nella documentazione di Cloud NGFW.

Differenze funzionali nei pool di nodi di cui è stato eseguito il provisioning automatico

Nei cluster Autopilot e nei pool di nodi standard che non utilizzano il provisioning automatico dei nodi, i tag di rete e i tag hanno un comportamento simile. La tabella seguente mostra le differenze funzionali tra i tag di rete e i tag nei pool di nodi provisionati automaticamente nei cluster standard:

Azione Comportamento dei tag di rete Comportamento dei tag
GKE esegue il provisioning automatico di un pool di nodi GKE applica i tag di rete a livello di cluster GKE applica i tag a livello di cluster
Aggiorna i tag o i tag di rete in un pool di nodi di cui è stato eseguito il provisioning automatico
  • Se esistono tag di rete a livello di cluster, l'operazione di aggiornamento non va a buon fine
  • Se i tag di rete a livello di cluster non esistono, GKE sovrascrive i tag di rete esistenti per il pool di nodi
 GKE sovrascrive i tag esistenti per il pool di nodi indipendentemente dall'esistenza di tag a livello di cluster
Aggiorna i tag o i tag di rete per l'intero cluster GKE sovrascrive i tag di rete per i pool di nodi con provisioning automatico nuovi ed esistenti nel cluster. GKE applica i nuovi tag a livello di cluster ai nuovi pool di nodi di cui è stato eseguito il provisioning automatico. I pool di nodi con provisioning automatico esistenti mantengono i tag che avevano prima dell'aggiornamento.

Passaggi successivi