Aggiunta di tag di rete

Un tag è semplicemente una stringa di caratteri aggiunta a un campo tags in una risorsa, come ad esempio le istanze di macchine virtuali (VM) di Compute Engine o i modelli di istanze. Un tag non è una risorsa separata, quindi non puoi crearlo separatamente. Tutte le risorse con quella stringa hanno questo tag. I tag consentono di rendere applicabili regole firewall e route a istanze VM specifiche.

Puoi assegnare tag di rete alle nuove VM al momento della creazione oppure modificare l'insieme di tag assegnati in qualsiasi momento successivo. Puoi modificare i tag di rete senza arrestare una VM.

Specifiche

I tag di rete assegnati a un'istanza si applicano a tutte le interfacce di rete dell'istanza. Un tag di rete si applica solo alle reti VPC direttamente collegate alle interfacce di rete dell'istanza. Questo vale anche per il peering di rete VPC, perché le reti in peering rimangono reti distinte. Di conseguenza, i tag di rete rimangono significativi solo nella rete a cui è collegata l'interfaccia di rete dell'istanza.

I tag di rete devono iniziare con una lettera minuscola e possono contenere lettere minuscole, numeri e trattini. I tag devono terminare con una lettera minuscola o un numero.

Autorizzazioni

I seguenti ruoli IAM sono obbligatori per le attività descritte in questa pagina. Per maggiori dettagli, consulta Ruoli IAM di Compute Engine.

Limiti

Ai tag di rete si applicano i limiti seguenti:

Regole e route firewall

I tag di rete consentono di applicare route e regole firewall a un'istanza o un insieme di istanze specifico:

• Puoi rendere applicabile una regola firewall a istanze specifiche utilizzando i tag di destinazione e i tag di origine.

• Puoi rendere una route applicabile a istanze specifiche utilizzando un tag.

Target per le regole firewall

Ogni regola firewall in Google Cloud deve avere un target che definisce le istanze a cui si applica. Il target predefinito è tutte le istanze nella rete, ma puoi specificare le istanze come destinazioni utilizzando tag di destinazione o account di servizio di destinazione.

Il tag target definisce le VM Google Cloud a cui si applica la regola. La regola viene applicata a una rete VPC specifica. Viene reso applicabile all'indirizzo IP interno principale associato all'interfaccia di rete di qualsiasi istanza collegata a quella rete VPC che ha un tag di rete corrispondente.

Le regole firewall in entrata e in uscita hanno destinazioni:

• Le regole in entrata si applicano al traffico che entra nella rete VPC. Per le regole in entrata, le destinazioni sono VM di destinazione in Google Cloud.

• Le regole in uscita si applicano al traffico che esce dalla rete VPC. Per le regole in uscita, le destinazioni sono VM di origine in Google Cloud.

Considera una regola firewall in entrata che consenta il traffico sulla porta TCP 80 da qualsiasi origine. La regola ha un tag di destinazione pari a http-server. Questa regola si applica solo alle istanze che hanno il tag di rete http-server, il che significa che il traffico in entrata sulla porta 80 sarebbe consentito verso queste istanze.

Filtri di origine per le regole firewall in entrata

Quando crei regole firewall in entrata, devi specificare un'origine. Puoi definirla utilizzando intervalli di indirizzi IP interni o esterni o facendo riferimento a istanze specifiche. Puoi specificare le istanze utilizzando tag di origine o account di servizio di origine.

Il tag origine per una regola firewall in entrata applicata su una rete VPC definisce una sorgente di traffico come proveniente dall'indirizzo IP interno principale associato all'interfaccia di rete collegata a quella rete VPC per qualsiasi istanza con un tag di rete corrispondente.

Puoi utilizzare una combinazione di intervalli IP e tag di origine o di intervalli IP e account di servizio di origine. Non è possibile utilizzare sia i tag di rete sia gli account di servizio nella stessa regola. Per ulteriori informazioni sui tag di origine e sugli account di servizio, consulta la sezione su come filtrare i dati per account di servizio o per tag di rete.

Considerazioni

Quando utilizzi una regola firewall in entrata con tag di origine, potresti osservare un ritardo di propagazione. Questo ritardo è in genere di pochi secondi, ma in rari casi può verificarsi alcuni minuti. Quando apporti le seguenti modifiche, l'applicazione o la rimozione della regola firewall in entrata da un'istanza associata può richiedere del tempo:

• Avvio o interruzione di un'istanza il cui tag è associato al tag di origine di una regola
• Avvio di un'istanza con un tag associato al tag di destinazione di una regola
• Aggiungere o rimuovere tag da un'istanza se i tag vengono utilizzati nei campi di origine o di destinazione di una regola
• Aggiunta o rimozione di tag di origine o di destinazione da una regola

Questo ritardo di propagazione si applica solo alle regole in entrata che utilizzano tag di origine. Tutte le altre regole firewall hanno effetto immediato su un'istanza. Ad esempio, una regola in entrata che utilizza un intervallo di indirizzi IP di origine e tag di destinazione non ha ritardi di propagazione.

Interazione con route statiche

Quando crei una route statica, devi specificare una rete VPC. Puoi quindi specificare i tag in modo che la route si applichi solo al traffico inviato da VM con tag di rete corrispondenti nella rete VPC specificata.

Aggiungi, visualizza e rimuovi tag

Puoi specificare i tag di rete quando crei un'istanza VM. Puoi anche aggiungere e rimuovere tag da una VM esistente.

Aggiungere tag durante la creazione di una VM

gcloud compute instances create INSTANCE_NAME \
    --zone ZONE \
    --tags TAGS \
    ...other parameters as needed.

resource "google_compute_instance" "default" {
  project      = var.project_id # Replace this with your project ID in quotes
  zone         = "southamerica-east1-b"
  name         = "backend-instance"
  machine_type = "e2-medium"
  boot_disk {
    initialize_params {
      image = "debian-cloud/debian-9"
    }
  }
  network_interface {
    network = "default"
  }
  tags = ["health-check", "ssh"]
}

Aggiungi tag a una VM esistente

gcloud compute instances add-tags INSTANCE_NAME \
    --zone ZONE \
    --tags TAGS

Visualizza tag

gcloud compute instances list --format='table(name,status,tags.list())'

gcloud compute instances list --filter='tags:TAG_EXPRESSION'

Rimuovi i tag

gcloud compute instances remove-tags INSTANCE_NAME \
    --zone ZONE \
    --tags TAGS

Richieste API dirette

Puoi impostare i tag di rete associati a un'istanza effettuando una richiesta API diretta. A differenza dell'utilizzo della console Google Cloud o dei comandi gcloud, l'aggiornamento dei tag tramite richiesta API diretta non conserva i tag esistenti. Assicurati di specificare l'insieme completo di tag da associare a un'istanza ogni volta che aggiorni i tag in questo modo.

Per aggiornare i tag utilizzando una richiesta API diretta:

1. Determina l'ultima fingerprint associata ai tag. L'impronta viene utilizzata per evitare collisioni causate da richieste API simultanee. Il processo di aggiornamento dei tag di rete per un'istanza è simile all'aggiornamento dei metadati dell'istanza.
   
   Esegui una richiesta GET all'istanza, ad esempio:

   GET https://compute.googleapis.com/compute/v1/projects/myproject/zones/us-central1-f/instances/example-instance
   

   Cerca la proprietà tags.fingerprint nella risposta:

   200 OK
   {
   ...
   "tags": {
    "items": [
    "http-server",
    "db-client"
    ],
    "fingerprint": "MW8EqhxILtc="
   },
   ...
   }
   

   Puoi anche utilizzare un comando gcloud per ottenere fingerprint, come mostrato nell'esempio seguente:

   gcloud compute instances describe INSTANCE_NAME \
      --zone ZONE \
      --format="get(tags.fingerprint)"

2. Effettua una richiesta POST al metodo instance().setTags. Il corpo della richiesta deve contenere tutti i tag che devono essere associati all'istanza insieme al valore fingerprint.
   
   Esempio di richiesta:

   POST https://compute.googleapis.com/compute/v1/projects/myproject/zones/us-central1-f/instances/example-instance/setTags
   {
    "items": [
     "http-server",
     "db-client",
     "allow-internet-access"
     ],
    "fingerprint": "MW8EqhxILtc="
   }
   

   Esempio di risposta:

   200 OK
   {
         "kind": "compute#operation",
         "id": "9251830049681941507",
         "name": "operation-1442414898862-51fde63aa57b1-422323e0-c439fb04",
         "zone": "https://www.googleapis.com/compute/v1/projects/myproject/zones/us-central1-f",
         "operationType": "setTags",
         "targetLink": "https://www.googleapis.com/compute/v1/projects/myproject/zones/us-central1-f/instances/example-instance",
         "targetId": "4392196237934605253",
         "status": "PENDING",
         "user": "user@example.com",
         "progress": 0,
   ...
   }
   

Passaggi successivi

• Per ulteriori informazioni su come utilizzare le regole firewall, consulta Regole firewall VPC e Utilizzare le regole firewall VPC.
• Per ulteriori informazioni su come utilizzare le route, vedi Route e Utilizzare le route.