Provisioning della rete VPC condivisa

Console

Per concedere il ruolo Amministratore VPC condiviso a livello di organizzazione

1. Accedi alla console Google Cloud come amministratore dell'organizzazione, quindi vai alla pagina IAM.

   Vai alla pagina IAM

2. Nel menu del progetto, seleziona la tua organizzazione.

   Se selezioni un progetto, il menu Ruoli mostra voci errate.

3. Fai clic su Aggiungi.

4. Inserisci gli indirizzi email delle Nuove entità.

5. Nel menu Ruoli, seleziona Compute Engine > Amministratore VPC condivisa Compute.

6. Fai clic su Aggiungi un altro ruolo.

7. Nel menu a discesa Ruoli, seleziona Resource Manager > Project IAM Admin.

8. Fai clic su Salva.

Per concedere il ruolo Amministratore del VPC condiviso a livello di cartella

1. Accedi alla console Google Cloud come amministratore dell'organizzazione, quindi vai alla pagina IAM.

   Vai alla pagina IAM

2. Dal menu del progetto, seleziona la cartella.

   Se selezioni un progetto o un'organizzazione, le opzioni visualizzate non sono corrette.

3. Fai clic su Aggiungi.

4. Inserisci gli indirizzi email delle Nuove entità.

5. In Seleziona un ruolo, seleziona Compute Engine > Amministratore VPC condivisa Compute.

6. Fai clic su Aggiungi un altro ruolo.

7. Nel menu Ruoli, seleziona Resource Manager > Project IAM Admin.

8. Fai clic su Aggiungi un altro ruolo.

9. Nel menu Ruoli, seleziona Gestore risorse > Visualizzatore rete Compute.

10. Fai clic su Salva.

gcloud

1. Effettua l'autenticazione in gcloud come amministratore dell'organizzazione. Sostituisci ORG_ADMIN con il nome di un amministratore dell'organizzazione:

   gcloud auth login ORG_ADMIN
   

2. Determina il numero di ID organizzazione dall'output di questo comando.

   gcloud organizations list
   

3. Per assegnare il ruolo Amministratore VPC condivisa a livello di organizzazione:

   1. Applica il ruolo Amministratore VPC condiviso a un'entità IAM esistente. Sostituisci ORG_ID con il numero di ID organizzazione del passaggio precedente e EMAIL_ADDRESS con l'indirizzo email dell'utente a cui stai concedendo il ruolo di amministratore VPC condiviso.

      gcloud organizations add-iam-policy-binding ORG_ID \
        --member='user:EMAIL_ADDRESS' \
        --role="roles/compute.xpnAdmin"
      

      gcloud organizations add-iam-policy-binding ORG_ID \
        --member='user:EMAIL_ADDRESS' \
        --role="roles/resourcemanager.projectIamAdmin"
      

4. Per assegnare il ruolo Amministratore della Rete VPC condivisa a livello di cartella:

   1. Determina l'ID della cartella esaminando l'output di questo comando.

      gcloud resource-manager folders list --organization=ORG_ID
      

   2. Applica il ruolo Amministratore VPC condiviso a un'entità IAM esistente. Sostituisci ORG_ID con il numero ID organizzazione del passaggio precedente e EMAIL_ADDRESS con l'indirizzo email dell'utente a cui stai concedendo il ruolo di amministratore VPC condiviso.

      gcloud resource-manager folders add-iam-policy-binding FOLDER_ID \
         --member='user:EMAIL_ADDRESS' \
         --role="roles/compute.xpnAdmin"
      

      gcloud resource-manager folders add-iam-policy-binding FOLDER_ID \
         --member='user:EMAIL_ADDRESS' \
         --role="roles/resourcemanager.projectIamAdmin"
      

      gcloud resource-manager folders add-iam-policy-binding FOLDER_ID \
         --member='user:EMAIL_ADDRESS' \
         --role="roles/compute.networkViewer"
      

5. Revoca il token dell'account amministratore dell'organizzazione nello strumento a riga di comando gcloud quando hai terminato di eseguire le attività per proteggere il tuo account.

   gcloud auth revoke ORG_ADMIN
   

API

• Per assegnare il ruolo di amministratore della Rete VPC condivisa a livello di organizzazione, segui la procedura riportata di seguito:

  1. Determina il numero ID della tua organizzazione.

     POST https://cloudresourcemanager.googleapis.com/v1/organizations
     

  2. Descrivi e poi registra i dettagli delle norme della tua organizzazione esistenti.

     POST https://cloudresourcemanager.googleapis.com/v1/organizations/ORG_ID:getIamPolicy
     

     Sostituisci ORG_ID con l'ID della tua organizzazione.

  3. Assegna il ruolo Amministratore VPC condiviso.

     POST https://cloudresourcemanager.googleapis.com/v1/organizations/ORG_ID:setIamPolicy
     {
       "bindings": [
         ...copy existing bindings
         {
           "members": [
             "user:EMAIL_ADDRESS"
           ],
           "role": "roles/compute.xpnAdmin"
         },
         {
           "members": [
             "user:EMAIL_ADDRESS"
           ],
           "role": "roles/resourcemanager.projectIamAdmin"
         }
       ],
       "etag": "ETAG",
       "version": 1,
       ...other existing policy details
     }
     

     Sostituisci quanto segue:

     • ORG_ID: l'ID dell'organizzazione che contiene l'utente a cui stai concedendo il ruolo di amministratore VPC condiviso.
     • EMAIL_ADDRESS: l'indirizzo email dell'utente.
     • ETAG: un identificatore univoco che hai ricevuto quando hai descritto il criterio esistente. Impedisce le collisioni se vengono inviate più richieste di aggiornamento contemporaneamente.

     Per ulteriori informazioni, consulta il metodo organizations.setIamPolicy.

• Per assegnare il ruolo di amministratore VPC condiviso a livello di cartella, utilizza la seguente richiesta:

  1. Determina il numero ID della tua organizzazione.

     POST https://cloudresourcemanager.googleapis.com/v1/organizations
     

  2. Trova l'ID cartella.

     GET https://cloudresourcemanager.googleapis.com/v2/folders?parent=organizations/ORG_ID
     

     Sostituisci ORG_ID con l'ID della tua organizzazione.

  3. Descrivi e poi registra i dettagli del criterio per le cartelle esistente.

     POST https://cloudresourcemanager.googleapis.com/v2/folders/FOLDER_ID:getIamPolicy
     

     Sostituisci FOLDER_ID con l'ID della cartella.

  4. Assegna il ruolo Amministratore VPC condiviso.

     POST https://cloudresourcemanager.googleapis.com/v1/organizations/FOLDER_ID:setIamPolicy
     {
       "bindings": [
         ...copy existing bindings
         {
           "members": [
             "user:EMAIL_ADDRESS"
           ],
           "role": "roles/compute.xpnAdmin"
         },
         {
           "members": [
             "user:EMAIL_ADDRESS"
           ],
           "role": "roles/resourcemanager.projectIamAdmin"
         },
         {
           "members": [
             "user:EMAIL_ADDRESS"
           ],
           "role": "roles/compute.networkViewer"
         }
       ],
       "etag": "ETAG",
       "version": 1,
       ...other existing policy details
     }
     

     Sostituisci quanto segue:

     • FOLDER_ID: l'ID dell'organizzazione che contiene l'utente a cui stai concedendo il ruolo di amministratore VPC condiviso.
     • EMAIL_ADDRESS: l'indirizzo email dell'utente.
     • ETAG: un identificatore univoco che hai ricevuto quando hai descritto il criterio esistente. Impedisce i conflitti se vengono inviate più richieste di aggiornamento contemporaneamente.

     Per ulteriori informazioni, consulta il metodo folders.setIamPolicy.

Console

Se non disponi ancora del ruolo Amministratore VPC condiviso per Compute (roles/compute.xpnAdmin), non puoi visualizzare questa pagina nella console Google Cloud.

1. Nella console Google Cloud, vai alla pagina VPC condivisa.

   Vai a Rete VPC condivisa

2. Accedi come amministratore VPC condiviso.

3. Seleziona il progetto da attivare come progetto host VPC condiviso dal selettore dei progetti.

4. Fai clic su Configura VPC condiviso.

5. Nella pagina successiva, fai clic su Salva e continua in Attiva progetto host.

6. In Seleziona subnet, esegui una delle seguenti operazioni:

   1. Fai clic su Condividi tutte le subnet (autorizzazioni a livello di progetto) se devi condividere tutte le subnet attuali e future nelle reti VPC del progetto host con i progetti di servizio e gli amministratori dei progetti di servizio specificati nei passaggi successivi.
   2. Fai clic su Singole subnet (autorizzazioni a livello di subnet) se devi condividere in modo selettivo le subnet delle reti VPC del progetto host con i progetti di servizio e gli amministratori dei progetti di servizio. Quindi, seleziona Subnet da condividere.

7. Fai clic su Continua.
   Viene visualizzata la schermata successiva.

8. In Nomi progetti, specifica i progetti di servizio da associare al progetto host. Tieni presente che l'attacco dei progetti di servizio non definisce alcun amministratore del progetto di servizio. Questa operazione verrà eseguita nel passaggio successivo.

9. Nella sezione Seleziona utenti per ruolo, aggiungi Amministratori progetto di servizio. A questi utenti verrà assegnato il ruolo IAM compute.networkUser per le subnet condivise. Solo gli amministratori dei progetti di servizio possono creare risorse nelle subnet del progetto host VPC condiviso.

10. Fai clic su Salva.

gcloud

1. Effettua l'autenticazione in gcloud come amministratore del VPC condiviso. Sostituisci SHARED_VPC_ADMIN con il nome dell'amministratore dell'VPC condivisa:

   gcloud auth login SHARED_VPC_ADMIN
   

2. Abilita la VPC condivisa per il progetto che deve diventare un progetto host. Sostituisci HOST_PROJECT_ID con l'ID del progetto.

   gcloud compute shared-vpc enable HOST_PROJECT_ID
   

3. Verifica che il progetto sia elencato come progetto host per la tua organizzazione. Sostituisci ORG_ID con l'ID della tua organizzazione (determinato da gcloud organizations list).

   gcloud compute shared-vpc organizations list-host-projects ORG_ID
   

4. Se dovevi solo attivare un progetto host, puoi uscire da gcloud per proteggere le credenziali del tuo account amministratore VPC condiviso. In caso contrario, salta questo passaggio e continua con i passaggi per collegare i progetti di servizio.

   gcloud auth revoke SHARED_VPC_ADMIN
   

API

1. Attiva la rete VPC condivisa per il progetto utilizzando le credenziali con le autorizzazioni di amministratore della rete VPC condivisa.

   POST https://compute.googleapis.com/compute/v1/projects/HOST_PROJECT_ID/enableXpnHost
   

   Sostituisci HOST_PROJECT_ID con l'ID del progetto che sarà un progetto host VPC condiviso.

   Per ulteriori informazioni, consulta il metodo projects.enableXpnHost.

2. Verifica che il progetto sia elencato come progetto host.

   POST https://compute.googleapis.com/compute/v1/projects/HOST_PROJECT_ID/listXpnHosts
   

   Sostituisci HOST_PROJECT_ID con l'ID del progetto host VPC condiviso.

   Per ulteriori informazioni, consulta il metodo projects.listXpnHosts.

Terraform

Puoi utilizzare una risorsa Terraform per attivare un progetto host.

resource "google_compute_shared_vpc_host_project" "host" {
  project = var.project # Replace this with your host project ID in quotes
}

Per scoprire come applicare o rimuovere una configurazione Terraform, consulta Comandi Terraform di base.

Console

1. Accedi alla console Google Cloud come amministratore VPC condiviso.
2. Nella console Google Cloud, vai alla pagina VPC condivisa.
   Vai alla VPC condiviso condivisa
3. Fai clic sulla scheda Progetti allegati.
4. Nella scheda Progetti collegati, fai clic sul pulsante Allega progetti.
5. Seleziona le caselle dei progetti di servizio da collegare nella sezione Nomi progetti. Tieni presente che l'attacco dei progetti di servizio non definisce alcun amministratore del progetto di servizio. Questa operazione verrà eseguita nel passaggio successivo.
6. Nella sezione Autorizzazioni di rete VPC, seleziona i ruoli i cui agenti riceveranno il ruolo compute.networkUser. Alle entità IAM viene concesso il ruolo Utente di rete per l'intero progetto host o per determinate subnet del progetto host, in base alla modalità di condivisione della rete VPC. Questi entità sono note come amministratori dei progetti di servizio nei rispettivi progetti di servizio.
7. Nella sezione Modalità di condivisione della rete VPC, seleziona una delle seguenti opzioni:
   1. Fai clic su Condividi tutte le subnet (autorizzazioni a livello di progetto) per condividere tutte le subnet attuali e future nelle reti VPC del progetto host con tutti i progetti di servizio e gli amministratori dei progetti di servizio.
   2. Fai clic su Singole subnet (autorizzazioni a livello di subnet) se devi condividere in modo selettivo le subnet delle reti VPC del progetto host con i progetti di servizio e gli amministratori dei progetti di servizio. Quindi, seleziona Subnet da condividere.
8. Fai clic su Salva.

gcloud

1. Se non l'hai ancora fatto, autenticati in gcloud come amministratore VPC condiviso. Sostituisci SHARED_VPC_ADMIN con il nome dell'amministratore del VPC condiviso:

   gcloud auth login SHARED_VPC_ADMIN
   

2. Collega un progetto di servizio a un progetto host abilitato in precedenza. Sostituisci SERVICE_PROJECT_ID con l'ID progetto del progetto di servizio e HOST_PROJECT_ID con l'ID progetto del progetto host.

   gcloud compute shared-vpc associated-projects add SERVICE_PROJECT_ID \
       --host-project HOST_PROJECT_ID
   

3. Verifica che il progetto di servizio sia stato collegato.

   gcloud compute shared-vpc get-host-project SERVICE_PROJECT_ID
   

4. Se vuoi, puoi elencare i progetti di servizio associati al progetto host:

   gcloud compute shared-vpc list-associated-resources HOST_PROJECT_ID
   

5. Se dovevi solo collegare un progetto di servizio, puoi uscire da gcloud per proteggere le credenziali del tuo account amministratore VPC condiviso. In caso contrario, salta questo passaggio e definisci gli amministratori del progetto di servizio per tutte le reti sottorinate o solo per alcune reti sottorinate.

   gcloud auth revoke SHARED_VPC_ADMIN
   

API

1. Collega un progetto di servizio al progetto host VPC condiviso.

   POST https://compute.googleapis.com/compute/v1/projects/HOST_PROJECT_ID/enableXpnResource
   {
     "xpnResource": {
       "id": "SERVICE_PROJECT"
     }
   }
   

   Sostituisci quanto segue:

   • HOST_PROJECT_ID: l'ID del progetto host VPC condiviso.
   • SERVICE_PROJECT: l'ID del progetto di servizio da collegare.

   Per ulteriori informazioni, consulta il metodo projects.enableXpnResource.

2. Verifica che i progetti di servizio siano collegati al progetto host.

   GET https://compute.googleapis.com/compute/v1/projects/HOST_PROJECT_ID/getXpnResources
   

   Sostituisci quanto segue:

   • HOST_PROJECT_ID: l'ID del progetto host VPC condiviso.

   Per ulteriori informazioni, consulta il metodo projects.getXpnResources.

Terraform

Puoi utilizzare una risorsa Terraform per collegare un progetto di servizio.

resource "google_compute_shared_vpc_service_project" "service1" {
  host_project    = google_compute_shared_vpc_host_project.host.project
  service_project = var.service_project # Replace this with your service project ID in quotes
}

Per scoprire come applicare o rimuovere una configurazione Terraform, consulta Comandi Terraform di base.

Console

Per definire un'entità IAM di un progetto di servizio come amministratore del progetto di servizio con accesso a tutte le subnet di un progetto host utilizzando la console Google Cloud, consulta la sezione Collegare i progetti di servizio.

gcloud

Questi passaggi illustrano la definizione di un'entità IAM da un progetto di servizio come amministratore del progetto di servizio con accesso a tutte le subnet in un progetto host. Prima di poter eseguire questi passaggi, devi aver attivato un progetto host e aver collegato il progetto di servizio al progetto host.

1. Se non l'hai ancora fatto, autenticati in gcloud come amministratore VPC condiviso. Sostituisci SHARED_VPC_ADMIN con il nome dell'amministratore del VPC condiviso:

   gcloud auth login SHARED_VPC_ADMIN
   

2. Crea un'associazione di criteri per rendere un'entità IAM del progetto di servizio un amministratore del progetto di servizio. Sostituisci HOST_PROJECT_ID con l'ID progetto del progetto host e SERVICE_PROJECT_ADMIN con l'indirizzo email dell'utente amministratore del progetto di servizio.

   gcloud projects add-iam-policy-binding HOST_PROJECT_ID \
   --member "user:SERVICE_PROJECT_ADMIN" \
   --role "roles/compute.networkUser"
   

   Puoi specificare diversi tipi di principali modificando il formato dell'argomento --member:

   • Utilizza group: per specificare un gruppo Google (per indirizzo email) come entità.
   • Utilizza domain: per specificare un dominio Google come principale.
   • Utilizza serviceAccount: per specificare un account di servizio. Per ulteriori informazioni su questo caso d'uso, consulta Account di servizio come amministratori di progetti di servizi.

3. Ripeti il passaggio precedente per ogni amministratore del progetto di servizio aggiuntivo che devi definire.

4. Se hai finito di definire gli amministratori dei progetti di servizio, puoi uscire da gcloud per proteggere le credenziali del tuo account amministratore VPC condiviso.

   gcloud auth revoke SHARED_VPC_ADMIN
   

API

1. Descrivi e poi registra i dettagli delle norme del progetto esistenti. Ti serviranno il criterio esistente e il valore etag.

   POST https://cloudresourcemanager.googleapis.com/v2/projects/HOST_PROJECT_ID:getIamPolicy
   

   Sostituisci HOST_PROJECT_ID con l'ID del progetto host che contiene la rete VPC condiviso.

2. Crea un'associazione di criteri per designare le entità IAM nel progetto di servizio come amministratori del progetto di servizio.

   POST https://cloudresourcemanager.googleapis.com/v1/projects/HOST_PROJECT_ID:setIamPolicy
   {
     "bindings": [
       ...copy existing bindings
       {
         "members": [
           PRINCIPAL,
           ...additional principals
         ],
         "role": "roles/compute.networkUser"
       },
     ],
     "etag": "ETAG",
     "version": 1,
     ...other existing policy details
   }
   

   Sostituisci quanto segue:

   • HOST_PROJECT_ID: l'ID del progetto host che contiene la rete VPC condiviso.
   • PRINCIPAL: un'identità associata al ruolo, ad esempio un utente, un gruppo, un dominio o un account di servizio. Per ulteriori informazioni, consulta il campo members nella documentazione di Resource Manager.
   • ETAG: un identificatore univoco che hai ricevuto quando hai descritto il criterio esistente. Impedisce i conflitti se vengono inviate più richieste di aggiornamento contemporaneamente.

   Per ulteriori informazioni, consulta il metodo projects.setIamPolicy.

Console

Per definire un'entità IAM di un progetto di servizio come amministratore del progetto di servizio con accesso solo ad alcune subnet in un progetto host utilizzando la console Google Cloud, consulta la sezione Collegare i progetti di servizio.

gcloud

Questi passaggi illustrano la definizione di entità IAM da un progetto di servizio come amministratori del progetto di servizio con accesso solo ad alcune subnet in un progetto host. Prima di poterli definire, devi aver attivato un progetto host e aver associato il progetto di servizio al progetto host.

1. Se non l'hai ancora fatto, autenticati in gcloud come amministratore VPC condiviso. Sostituisci SHARED_VPC_ADMIN con il nome dell'amministratore del VPC condiviso:

   gcloud auth login SHARED_VPC_ADMIN
   

2. Scegli la subnet nel progetto host a cui gli amministratori del progetto di servizio devono avere accesso. Recupera il criterio IAM corrente in formato JSON. Sostituisci SUBNET_NAME con il nome della sottorete nel progetto host e HOST_PROJECT_ID con l'ID progetto del progetto host.

   gcloud compute networks subnets get-iam-policy SUBNET_NAME \
       --region SUBNET_REGION \
       --project HOST_PROJECT_ID \
       --format json
   

3. Copia l'output JSON del passaggio precedente e salvalo in un file. Per una maggiore chiarezza, questi passaggi salvano il file in un file denominato subnet-policy.json.

4. Modifica il file subnet-policy.json aggiungendo le entità IAM che diventeranno amministratori del progetto di servizio con accesso alla subnet. Sostituisci ogni SERVICE_PROJECT_ADMIN con l'indirizzo email di un utente IAM del progetto di servizio.

   {
     "bindings": [
     {
        "members": [
              "user:[SERVICE_PROJECT_ADMIN]",
              "user:[SERVICE_PROJECT_ADMIN]"
           ],
           "role": "roles/compute.networkUser"
     }
     ],
     "etag": "[ETAG_STRING]"
   }
   

   Tieni presente che puoi specificare diversi tipi di principali IAM (diversi dagli utenti) nel regolamento:

   • Sostituisci user: con group: per specificare un gruppo Google (per indirizzo email) come principale.
   • Sostituisci user: con domain: per specificare un dominio Google come principale.
   • Utilizza serviceAccount: per specificare un account di servizio. Per ulteriori informazioni su questo caso d'uso, consulta Account di servizio come amministratori dei progetti di servizio.

5. Aggiorna l'associazione dei criteri per la sottorete utilizzando i contenuti del subnet-policy.json file.

   gcloud compute networks subnets set-iam-policy SUBNET_NAME subnet-policy.json \
       --region SUBNET_REGION \
       --project HOST_PROJECT_ID
   

6. Se hai finito di definire gli amministratori dei progetti di servizio, puoi uscire da gcloud per proteggere le credenziali del tuo account amministratore VPC condiviso.

   gcloud auth revoke SHARED_VPC_ADMIN
   

API

1. Descrivi e poi registra i dettagli del criterio di subnet esistente. Ti serviranno il criterio esistente e il valore etag.

   GET https://compute.googleapis.com/compute/v1/projects/HOST_PROJECT_ID/regions/SUBNET_REGION/subnetworks/SUBNET_NAME/getIamPolicy
   

   Sostituisci quanto segue:

   • HOST_PROJECT_ID: l'ID del progetto host che contiene la rete VPC condiviso.
   • SUBNET_NAME: il nome della subnet da condividere.
   • SUBNET_REGION: la regione in cui si trova la subnet.

2. Concedi agli amministratori dei progetti di servizio l'accesso alle subnet nel progetto host aggiornando il criterio delle subnet.

   POST https://compute.googleapis.com/compute/v1/projects/HOST_PROJECT_ID/regions/SUBNET_REGION/subnetworks/SUBNET_NAME/setIamPolicy
   {
     "bindings": [
       ...copy existing bindings
       {
         "members": [
           PRINCIPAL,
           ...additional principals
         ],
         "role": "roles/compute.networkUser"
       },
     ],
     "etag": "ETAG",
     "version": 1,
     ...other existing policy details
   }
   

   Sostituisci quanto segue:

   • ETAG: un identificatore univoco che hai ricevuto quando hai descritto il criterio esistente. Impedisce i conflitti se vengono inviate più richieste di aggiornamento contemporaneamente.
   • HOST_PROJECT_ID: l'ID del progetto host che contiene la rete VPC condiviso.
   • PRINCIPAL: un'identità associata al ruolo, ad esempio un utente, un gruppo, un dominio o un account di servizio. Per ulteriori informazioni, consulta il campo members nella documentazione di Resource Manager.
   • SUBNET_NAME: il nome della subnet da condividere.
   • SUBNET_REGION: la regione in cui si trova la subnet.

   Per ulteriori informazioni, consulta il metodo subnetworks.setIamPolicy.

Console

1. Accedi alla console Google Cloud come amministratore VPC condiviso.
2. Nella console Google Cloud, vai alla pagina Impostazioni.
   Vai alla pagina Impostazioni
3. Cambia il progetto nel progetto di servizio che contiene l'account di servizio che deve essere definito come amministratore del progetto di servizio.
4. Copia l'ID progetto del progetto di servizio. Per chiarezza, in questa procedura l'ID progetto di servizio è indicato come SERVICE_PROJECT_ID.
5. Cambia il progetto in progetto host VPC condiviso.
6. Vai alla pagina IAM nella console Google Cloud.
   Vai alla pagina IAM
7. Fai clic su Aggiungi.
8. Aggiungi SERVICE_ACCOUNT_NAME@SERVICE_PROJECT_ID.iam.gserviceaccount.com al campo Principali, sostituendo SERVICE_ACCOUNT_NAME con il nome dell'account di servizio.
9. Seleziona Compute Engine > Utente rete Compute dal menu Ruoli.
10. Fai clic su Aggiungi.

gcloud

1. Se non l'hai ancora fatto, autenticati in gcloud come amministratore VPC condiviso. Sostituisci SHARED_VPC_ADMIN con il nome dell'amministratore del VPC condiviso:

   gcloud auth login SHARED_VPC_ADMIN
   

2. Se non conosci l'ID progetto del progetto di servizio, puoi elencare tutti i progetti della tua organizzazione. Questo elenco mostra l'ID progetto per ciascuno.

   gcloud projects list
   

3. Crea un'associazione di criteri per rendere l'account di servizio un amministratore del progetto di servizio. Sostituisci HOST_PROJECT_ID con l'ID progetto per il progetto host, SERVICE_ACCOUNT_NAME con il nome dell'account di servizio e SERVICE_PROJECT_ID con l'ID progetto di servizio.

   gcloud projects add-iam-policy-binding HOST_PROJECT_ID \
       --member "serviceAccount:SERVICE_ACCOUNT_NAME@SERVICE_PROJECT_ID.iam.gserviceaccount.com" \
       --role "roles/compute.networkUser"
   

API

1. Descrivi e poi registra i dettagli delle norme del progetto esistenti. Ti serviranno il criterio esistente e il valore etag.

   POST https://cloudresourcemanager.googleapis.com/v2/projects/HOST_PROJECT_ID:getIamPolicy
   

   Sostituisci HOST_PROJECT_ID con l'ID del progetto host che contiene la rete VPC condiviso.

2. Crea un'associazione di criteri per designare gli account di servizio come amministratori del progetto di servizio.

   POST https://cloudresourcemanager.googleapis.com/v1/projects/HOST_PROJECT_ID:setIamPolicy
   {
     "bindings": [
       ...copy existing bindings
       {
         "members": [
           "serviceAccount:SERVICE_ACCOUNT_NAME@SERVICE_PROJECT_ID.iam.gserviceaccount.com",
           ...include additional service accounts
         ],
         "role": "roles/compute.networkUser"
       },
     ],
     "etag": "ETAG",
     "version": 1,
     ...other existing policy details
   }
   

   Sostituisci quanto segue:

   • HOST_PROJECT_ID: l'ID del progetto host che contiene la rete VPC condiviso.
   • SERVICE_ACCOUNT_NAME: il nome dell'account del servizio.
   • SERVICE_PROJECT_ID: l'ID del progetto di servizio che contiene l'account di servizio.
   • ETAG: un identificatore univoco che hai ricevuto quando hai descritto il criterio esistente. Impedisce i conflitti se vengono inviate più richieste di aggiornamento contemporaneamente.

   Per ulteriori informazioni, consulta il metodo projects.setIamPolicy.

Console

1. Accedi alla console Google Cloud come amministratore VPC condiviso.
2. Nella console Google Cloud, vai alla pagina Impostazioni.
   Vai alla pagina Impostazioni
3. Cambia il progetto nel progetto di servizio che contiene l'account di servizio che deve essere definito come amministratore del progetto di servizio.
4. Copia il numero del progetto del progetto di servizio. Per chiarezza, in questa procedura il numero del progetto di servizio è indicato come SERVICE_PROJECT_NUMBER.
5. Cambia il progetto in progetto host VPC condiviso.
6. Vai alla pagina IAM nella console Google Cloud.
   Vai alla pagina IAM
7. Fai clic su Aggiungi.
8. Aggiungi SERVICE_PROJECT_NUMBER@cloudservices.gserviceaccount.com al campo Membri.
9. Seleziona Compute Engine > Utente rete Compute dal menu Ruoli.
10. Fai clic su Aggiungi.

gcloud

1. Se non l'hai ancora fatto, autenticati in gcloud come amministratore VPC condiviso. Sostituisci SHARED_VPC_ADMIN con il nome dell'amministratore del VPC condiviso:

   gcloud auth login SHARED_VPC_ADMIN
   

2. Determina il numero del progetto per il progetto di servizio. Per chiarezza delle istruzioni, questa procedura fa riferimento al numero del progetto di servizio come SERVICE_PROJECT_NUMBER. Sostituisci SERVICE_PROJECT_ID con l'ID del progetto del servizio.

   gcloud projects describe SERVICE_PROJECT_ID --format='get(projectNumber)'
   

   • Se non conosci l'ID progetto del progetto di servizio, puoi elencare tutti i progetti della tua organizzazione. Questo elenco mostra il numero di progetto per ciascuno.

     gcloud projects list
     

3. Crea un'associazione di criteri per rendere l'account di servizio un amministratore del progetto di servizio. Sostituisci HOST_PROJECT_ID con l'ID progetto per il progetto host e SERVICE_PROJECT_NUMBER con il numero del progetto di servizio.

   gcloud projects add-iam-policy-binding HOST_PROJECT_ID \
       --member "serviceAccount:SERVICE_PROJECT_NUMBER@cloudservices.gserviceaccount.com" \
       --role "roles/compute.networkUser"
   

API

1. Descrivi e poi registra i dettagli delle norme del progetto esistenti. Ti serviranno il criterio esistente e il valore etag.

   POST https://cloudresourcemanager.googleapis.com/v2/projects/HOST_PROJECT_ID:getIamPolicy
   

   Sostituisci HOST_PROJECT_ID con l'ID del progetto host che contiene la rete VPC condiviso.

2. Elenca il tuo progetto per trovare il relativo numero.

   GET https://cloudresourcemanager.googleapis.com/v1/projects?filter=projectId="SERVICE_PROJECT_ID"
   

   Sostituisci SERVICE_PROJECT_ID con l'ID del progetto di servizio in cui si trova l'account di servizio.

3. Crea un'associazione di criteri per designare gli account di servizio come amministratori del progetto di servizio.

   POST https://cloudresourcemanager.googleapis.com/v1/projects/HOST_PROJECT_ID:setIamPolicy
   {
     "bindings": [
       ...copy existing bindings
       {
         "members": [
           "serviceAccount:SERVICE_PROJECT_NUMBER@cloudservices.gserviceaccount.com"
         ],
         "role": "roles/compute.networkUser"
       },
     ],
     "etag": "ETAG",
     "version": 1,
     ...other existing policy details
   }
   

   Sostituisci quanto segue:

   • HOST_PROJECT_ID: l'ID del progetto host che contiene la rete VPC condiviso.
   • SERVICE_PROJECT_NUMBER: il numero del progetto di servizio che contiene l'account di servizio.
   • ETAG: un identificatore univoco che hai ricevuto quando hai descritto il criterio esistente. Impedisce i conflitti se vengono inviate più richieste di aggiornamento contemporaneamente.

   Per ulteriori informazioni, consulta il metodo projects.setIamPolicy.

Console

Nella console Google Cloud, vai alla pagina VPC condivisa.

Vai a Rete VPC condivisa

gcloud

1. Se non l'hai ancora fatto, autenticati in gcloud come amministratore del progetto di servizio. Sostituisci SERVICE_PROJECT_ADMIN con il nome dell'amministratore del progetto di servizio:

   gcloud auth login SERVICE_PROJECT_ADMIN
   

2. Esegui il seguente comando, sostituendo HOST_PROJECT_ID con l'ID progetto del progetto host VPC condiviso:

   gcloud compute networks subnets list-usable --project HOST_PROJECT_ID
   

   L'esempio seguente elenca le subnet disponibili nel progetto host project-1:

   $ gcloud compute networks subnets list-usable --project project-1
   
   PROJECT    REGION       NETWORK  SUBNET    RANGE          SECONDARY_RANGES
   project-1  us-west1     net-1    subnet-1  10.138.0.0/20
   project-1  us-central1  net-1    subnet-2  10.128.0.0/20  r-1 192.168.2.0/24
                                                             r-2 192.168.3.0/24
   project-1  us-east1     net-1    subnet-3  10.142.0.0/20
   

Per ulteriori informazioni, consulta il comando list-usable nella documentazione dell'SDK.

API

Elenca le subnet disponibili nel progetto host. Invia la richiesta come Amministratore del progetto di servizi.

GET https://compute.googleapis.com/compute/v1/projects/HOST_PROJECT_ID/aggregated/subnetworks/listUsable

Sostituisci HOST_PROJECT_ID con l'ID del progetto host che contiene la rete VPC condiviso.

Per ulteriori informazioni, consulta il metodo subnetworks.listUsable.

Console

1. Configura la rete VPC condivisa.

2. Nella console Google Cloud, vai alla pagina VPC condivisa.

   Vai a Rete VPC condivisa

3. Accedi come amministratore VPC condiviso.

4. Seleziona il progetto di servizio dal selettore dei progetti.

5. Vai alla pagina Indirizzi IP selezionando Rete VPC > Indirizzi IP.

6. Fai clic su Prenota indirizzo IP interno statico.

7. Nel campo Nome, inserisci un nome per l'indirizzo IP.

8. Nell'elenco Versione IP, seleziona la versione IP richiesta:

   • Per prenotare un indirizzo IPv4 interno statico, seleziona IPv4.
   • Per prenotare un indirizzo IPv6 interno statico, seleziona IPv6.

9. Fai clic sul pulsante Reti condivise con me.

10. Negli elenchi Rete e Subnet, seleziona rispettivamente una rete VPC e una subnet.

11. Specifica come vuoi prenotare l'indirizzo IP:

    • Per gli indirizzi IPv4, per specificare un indirizzo IPv4 interno statico da prenotare, in Indirizzo IP statico, seleziona Scegli manualmente e inserisci un indirizzo IP personalizzato. In caso contrario, il sistema assegna automaticamente un indirizzo IPv4 interno statico nella subnet.
    • Per gli indirizzi IPv6, il sistema assegna automaticamente un indirizzo IPv6 interno statico dall'intervallo di indirizzi IPv6 interno della subnet.

12. (Facoltativo) Se vuoi condividere l'indirizzo IPv4 interno statico in diversi frontend, per Finalità, scegli Condiviso. L'impostazione predefinita selezionata è Non condivisa.

13. Fai clic su Prenota.

gcloud

1. Se non l'hai già fatto, esegui l'autenticazione in Google Cloud CLI come amministratore del progetto di servizio. Sostituisci SERVICE_PROJECT_ADMIN con il nome dell'amministratore del progetto di servizio:

   gcloud auth login SERVICE_PROJECT_ADMIN
   

2. Utilizza il comando compute addresses create.

   • Prenota indirizzi IPv4:

     gcloud compute addresses create IP_ADDR_NAME \
         --project SERVICE_PROJECT_ID \
         --subnet projects/HOST_PROJECT_ID/regions/REGION/subnetworks/SUBNET \
         --region=REGION
         --ip-version=IPV4
     

   • Prenota indirizzi IPv6:

     gcloud compute addresses create IP_ADDR_NAME \
         --project SERVICE_PROJECT_ID \
         --subnet projects/HOST_PROJECT_ID/regions/REGION/subnetworks/SUBNET \
         --region=REGION
         --ip-version=IPV6
     

   Sostituisci quanto segue:

   • IP_ADDR_NAME: un nome per l'oggetto indirizzo IPv4.
   • SERVICE_PROJECT_ID: l'ID del progetto di servizio.
   • HOST_PROJECT_ID: l'ID del progetto host VPC condiviso.
   • REGION: la regione che contiene la subnet condivisa.
   • SUBNET: il nome della subnet condivisa.

Ulteriori dettagli per la creazione di indirizzi IP sono pubblicati nella documentazione dell'SDK.

API

Utilizza il metodo addresses.insert.

• Per prenotare un indirizzo IPv4 interno statico come amministratore del progetto di servizio:

  POST https://compute.googleapis.com/compute/v1/projects/SERVICE_PROJECT_ID/regions/REGION/addresses
  {
  "name": "ADDRESS_NAME",
  "subnetwork": "projects/HOST_PROJECT_ID/regions/REGION/subnetworks/SUBNET_NAME",
  "addressType": "INTERNAL"
  }
  

Sostituisci quanto segue:

• ADDRESS_NAME: un nome per l'indirizzo IP interno riservato.
• HOST_PROJECT_ID: l'ID del progetto che contiene la rete VPC condiviso.
• REGION: la regione in cui si troverà l'indirizzo IPv4 riservato e la subnet condivisa.
• SERVICE_PROJECT_ID: l'ID del progetto di servizio dove stai prenotando l'indirizzo IPv4.
• SUBNET_NAME: il nome della subnet condivisa.

Per ulteriori informazioni, consulta il metodo addresses.insert.

Terraform

Puoi utilizzare un blocco di dati Terraform per specificare le informazioni sulla sottorete dell'host. Quindi, utilizza una risorsa Terraform per prenotare un indirizzo IPv4 interno statico. Se ometti l'argomento facoltativoaddress, viene selezionato e riservato un indirizzo IPv4 disponibile.

Specifica la subnet dell'host:

data "google_compute_subnetwork" "subnet" {
  name    = "my-subnet-123"
  project = var.project
  region  = "us-central1"
}

Riserva un indirizzo IPv4 dalla subnet del progetto host da utilizzare nel progetto di servizio:

resource "google_compute_address" "internal" {
  project      = var.service_project
  region       = "us-central1"
  name         = "int-ip"
  address_type = "INTERNAL"
  address      = "10.0.0.8"
  subnetwork   = data.google_compute_subnetwork.subnet.self_link
}

Per scoprire come applicare o rimuovere una configurazione Terraform, consulta Comandi Terraform di base.

Console

Puoi prenotare un indirizzo IPv6 esterno autonomo nel progetto di servizio utilizzando la console Google Cloud:

1. Configura la rete VPC condivisa.
2. Nella console Google Cloud, vai alla pagina VPC condiviso.
   Vai alla VPC condiviso condivisa
3. Accedi come amministratore VPC condiviso.
4. Seleziona il progetto di servizio dal selettore dei progetti.
5. Per andare alla pagina Indirizzi IP, seleziona Rete VPC > Indirizzi IP.
6. Fai clic su Prenota indirizzo IP statico esterno.
7. Scegli un nome per il nuovo indirizzo.
8. Specifica se il livello di servizio di rete è Premium o Standard. La prenotazione di indirizzi IPv6 statici è supportata solo nel livello Premium.
9. In Versione IP, seleziona IPv6.
10. Specifica se questo indirizzo IP è regionale o globale.
    • Se stai riservando un indirizzo IP statico per un bilanciatore del carico globale, scegli Globale.
    • Se stai prenotando un indirizzo IP statico per un'istanza o per un bilanciatore del carico regionale, scegli Regionale e seleziona la regione in cui creare l'indirizzo.
11. Scegli quanto segue:
    • Reti in questo progetto: scegli questa opzione se vuoi prenotare un indirizzo IPv6 esterno in una subnet della stessa rete Virtual Private Cloud (VPC) in cui stai prenotando l'indirizzo IPv6.
    • Reti condivise con me: scegli questa opzione se vuoi prenotare un indirizzo IPv6 esterno in una subnet di una rete VPC condiviso.

12. In base alla tua scelta, scegli quanto segue:

    • Rete: la rete VPC
    • Subnet: la subnet da cui assegnare l'indirizzo IPv6 regionale statico
    • Tipo di endpoint: scegli Istanza VM o Bilanciatore del carico di rete.

13. (Facoltativo) Se hai scelto Istanza VM come tipo di endpoint, seleziona un'istanza VM a cui collegare l'indirizzo IPv6.

14. Fai clic su Prenota.

gcloud

1. Se non l'hai ancora fatto, autenticati in gcloud come amministratore del progetto di servizio. Sostituisci SERVICE_PROJECT_ADMIN con il nome dell'amministratore del progetto di servizio:

   gcloud auth login SERVICE_PROJECT_ADMIN
   

2. Utilizza il comando gcloud compute addresses create:

   gcloud compute addresses create IP_ADDR_NAME \
       --project SERVICE_PROJECT_ID \
       --subnet projects/HOST_PROJECT_ID/regions/REGION/subnetworks/SUBNET \
       --region=REGION \
       --ip-version=IPV6 \
       --endpoint-type=[VM | NETLB]
   

   Sostituisci quanto segue:

   • IP_ADDR_NAME: un nome per l'oggetto indirizzo IPv6.
   • SERVICE_PROJECT_ID: l'ID del progetto di servizio.
   • HOST_PROJECT_ID: l'ID del progetto host VPC condiviso.
   • SUBNET: il nome della subnet condivisa.
   • REGION: la regione che contiene la subnet condivisa.

API

Per prenotare un indirizzo IPv6 interno statico come amministratore del progetto di servizio, utilizza il metodo addresses.insert:

POST https://compute.googleapis.com/compute/v1/projects/SERVICE_PROJECT_ID/regions/REGION/addresses
{
  "name": "ADDRESS_NAME",
  "ipVersion": "IPV6",
  "ipv6EndpointType": "VM|LB",
  "networkTier": "PREMIUM",
  "subnetwork": "projects/HOST_PROJECT_ID/regions/REGION/subnetworks/SUBNET_NAME",
  "addressType": "EXTERNAL"
}

Sostituisci quanto segue:

• SERVICE_PROJECT_ID: l'ID del progetto di servizio dove stai prenotando l'indirizzo IPv6.
• REGION: la regione in cui si trovano l'indirizzo IPv6 riservato e la subnet condivisa.
• ADDRESS_NAME: un nome per l'indirizzo IPv6 esterno statico riservato.
• HOST_PROJECT_ID: l'ID del progetto che contiene la rete VPC condiviso.
• SUBNET_NAME: il nome della subnet condivisa.

Console

1. Configura la rete VPC condivisa.

2. Nella console Google Cloud, vai alla pagina VPC condivisa.

   Vai a Rete VPC condivisa

3. Accedi come amministratore VPC condiviso.

4. Seleziona il progetto di servizio dal selettore dei progetti.

5. Per andare alla pagina Crea un'istanza, seleziona Compute Engine > Istanze VM > Crea istanza.

6. Specifica un nome per l'istanza.

7. In Regione, seleziona una regione che contenga una subnet condivisa.

8. Fai clic su Networking in Opzioni avanzate.

9. In Interfacce di rete, fai clic sul pulsante di opzione Reti condivise con me.

10. Nell'elenco Subnet condivisa, seleziona la subnet richiesta in cui vuoi creare l'istanza:

    • Per gli indirizzi IPv4, seleziona una subnet a stack singolo.
    • Per gli indirizzi IPv6, seleziona una subnet a doppio stack con il tipo di accesso IPv6 richiesto.

11. Seleziona il tipo di stack IP:

    • Per gli indirizzi IPv4, seleziona IPv4 (stack singolo).
    • Per gli indirizzi IPv6, seleziona IPv4 e IPv6 (stack doppio).

12. Specifica eventuali altri parametri necessari per l'istanza.

13. Fai clic su Crea.

gcloud

• Crea un'istanza con un indirizzo IPv4 interno temporaneo in una subnet condivisa di una rete VPC condiviso:

  gcloud compute instances create INSTANCE_NAME \
      --project SERVICE_PROJECT_ID \
      --subnet projects/HOST_PROJECT_ID/regions/REGION/subnetworks/SUBNET \
      --zone ZONE
  

  Sostituisci quanto segue:

  • INSTANCE_NAME: il nome dell'istanza.
  • SERVICE_PROJECT_ID: l'ID del progetto di servizio.
  • HOST_PROJECT_ID: l'ID del progetto host VPC condiviso.
  • REGION: la regione che contiene la subnet condivisa.
  • SUBNET: il nome della subnet condivisa.
  • ZONE: una zona nella regione specificata. .

• Crea un'istanza con un indirizzo IPv4 interno statico riservato in una rete VPC condiviso:

  1. Prenota un indirizzo IPv4 interno statico nel progetto di servizio dall'intervallo di indirizzi disponibili del progetto host.

  2. Crea l'istanza:

     gcloud compute instances create INSTANCE_NAME \
         --project SERVICE_PROJECT_ID \
         --private-network-ip IP_ADDR_NAME \
         --zone ZONE \
         --subnet projects/HOST_PROJECT_ID/regions/REGION/subnetworks/SUBNET
     

     Sostituisci quanto segue:

     • INSTANCE_NAME: il nome dell'istanza.
     • SERVICE_PROJECT_ID: l'ID del progetto di servizio.
     • IP_ADDR_NAME: il nome dell'indirizzo IP statico.
     • ZONE: una zona nella stessa regione di IP_ADDR_NAME.
     • HOST_PROJECT_ID: l'ID del progetto host VPC condiviso.
     • REGION: la regione che contiene la sottorete condivisa.
     • SUBNET: il nome della subnet condivisa associata all'indirizzo IPv4 interno statico.

• Crea un'istanza con un indirizzo IPv4 interno ed un indirizzo IPv6 entrambi temporanei:

  gcloud compute instances create INSTANCE_NAME \
      --project SERVICE_PROJECT_ID \
      --stack-type IPV4_IPV6 \
      --subnet projects/HOST_PROJECT_ID/regions/REGION/subnetworks/SUBNET \
      --zone ZONE
  

  Sostituisci quanto segue:

  • INSTANCE_NAME: il nome dell'istanza.
  • SERVICE_PROJECT_ID: l'ID del progetto di servizio.
  • HOST_PROJECT_ID: l'ID del progetto host VPC condiviso.
  • REGION: la regione che contiene la subnet condivisa.
  • SUBNET: il nome della subnet condivisa.
  • ZONE: una zona nella regione specificata.

• Crea un'istanza con un indirizzo IPv6 esterno statico prenotato:

  gcloud compute instances create INSTANCE_NAME \
      --project SERVICE_PROJECT_ID \
      --stack-type IPV4_IPV6 \
      --subnet projects/HOST_PROJECT_ID/regions/REGION/subnetworks/SUBNET \
      --ipv6-address IPV6_ADDRESS \
      --ipv6-prefix-length=96 \
      --ipv6-network-tier PREMIUM \
      --zone ZONE
  

  Sostituisci quanto segue:

  • INSTANCE_NAME: il nome dell'istanza.
  • SERVICE_PROJECT_ID: l'ID del progetto di servizio.
  • HOST_PROJECT_ID: l'ID del progetto host VPC condiviso.
  • REGION: la regione che contiene la subnet condivisa.
  • SUBNET: il nome della subnet condivisa.
  • IPV6_ADDRESS: l'indirizzo IPv6 da assegnare alla VM.
  • ZONE: una zona nella regione specificata.

API

• Per creare un'istanza con un indirizzo IPv4 interno temporaneo, specifica solo la subnet:

  POST https://compute.googleapis.com/compute/v1/projects/SERVICE_PROJECT_ID/zones/ZONE/instances
  {
    "machineType": "MACHINE_TYPE",
    "name": "INSTANCE_NAME",
    "networkInterfaces": [
      {
        "subnetwork": "projects/HOST_PROJECT_ID/regions/REGION/subnetworks/SUBNET_NAME"
      }
    ],
    "disks": [
      {
        "boot": true,
        "initializeParams": {
          "sourceImage": "SOURCE_IMAGE"
        }
      }
    ]
  }
  

  Sostituisci quanto segue:

  • INSTANCE_NAME: un nome per l'istanza.
  • HOST_PROJECT_ID: l'ID del progetto che contiene la rete VPC condiviso.
  • MACHINE_TYPE: un tipo di macchina per l'istanza.
  • REGION: la regione che contiene la subnet condivisa.
  • SERVICE_PROJECT_ID: l'ID del progetto di servizio.
  • SOURCE_IMAGE: un'immagine per l'istanza.
  • SUBNET: il nome della subnet condivisa.
  • ZONE: una zona nella regione specificata.

  Per ulteriori informazioni, consulta il metodo instances.insert.

• Per creare un'istanza con un indirizzo IPv4 interno riservato, specifica la subnet e il nome dell'indirizzo IPv4 riservato:

  POST https://compute.googleapis.com/compute/v1/projects/SERVICE_PROJECT_ID/zones/ZONE/instances
  {
    "machineType": "MACHINE_TYPE",
    "name": "INSTANCE_NAME",
    "networkInterfaces": [
      {
        "subnetwork": "projects/HOST_PROJECT_ID/regions/REGION/subnetworks/SUBNET_NAME",
        "networkIP": "projects/SERVICE_PROJECT_ID/regions/REGION/addresses/ADDRESS_NAME"
      }
    ],
    "disks": [
      {
        "boot": true,
        "initializeParams": {
          "sourceImage": "SOURCE_IMAGE"
        }
      }
    ]
  }
  

  Sostituisci quanto segue:

  • ADDRESS_NAME: il nome dell'indirizzo IPv4 interno riservato.
  • INSTANCE_NAME: un nome per l'istanza.
  • HOST_PROJECT_ID: l'ID del progetto che contiene la rete VPC condiviso.
  • MACHINE_TYPE: un tipo di macchina per l'istanza.
  • REGION: la regione che contiene la subnet condivisa.
  • SERVICE_PROJECT_ID: l'ID del progetto di servizio.
  • SOURCE_IMAGE: un'immagine per l'istanza.
  • SUBNET: il nome della subnet condivisa.
  • ZONE: una zona nella regione specificata.

  Per ulteriori informazioni, consulta il metodo instances.insert.

• Per creare un'istanza con un indirizzo IPv4 interno ed un indirizzo IPv6 temporanei, specifica la subnet e il tipo di stack:

  POST https://compute.googleapis.com/compute/v1/projects/SERVICE_PROJECT_ID/zones/ZONE/instances
  {
    "machineType": "MACHINE_TYPE",
    "name": "INSTANCE_NAME",
    "networkInterfaces": [
      {
        "subnetwork": "projects/HOST_PROJECT_ID/regions/REGION/subnetworks/SUBNET_NAME",
        "stackType": "IPv4_IPv6"
      }
    ],
    "disks": [
      {
        "boot": true,
        "initializeParams": {
          "sourceImage": "SOURCE_IMAGE"
        }
      }
    ]
  }
  

  Sostituisci quanto segue:

  • INSTANCE_NAME: un nome per l'istanza.
  • HOST_PROJECT_ID: l'ID del progetto che contiene la rete VPC condiviso.
  • MACHINE_TYPE: un tipo di macchina per l'istanza.
  • REGION: la regione che contiene la subnet condivisa.
  • SERVICE_PROJECT_ID: l'ID del progetto di servizio.
  • SOURCE_IMAGE: un'immagine per l'istanza.
  • SUBNET: il nome della subnet condivisa.
  • ZONE: una zona nella regione specificata.

  Per ulteriori informazioni, consulta il metodo instances.insert.

Terraform

Puoi utilizzare un blocco di dati Terraform per specificare le informazioni sulla sottorete dell'host. Quindi, utilizza una risorsa Terraform per creare un'istanza VM in un progetto di servizio.

Specifica la subnet dell'host:

data "google_compute_subnetwork" "subnet" {
  name    = "my-subnet-123"
  project = var.project
  region  = "us-central1"
}

Crea un'istanza VM in un progetto di servizio con un indirizzo IPv4 temporaneo dalla subnet condivisa del progetto host:

resource "google_compute_instance" "ephemeral_ip" {
  project      = var.service_project
  zone         = "us-central1-a"
  name         = "my-vm"
  machine_type = "e2-medium"
  boot_disk {
    initialize_params {
      image = "debian-cloud/debian-9"
    }
  }
  network_interface {
    subnetwork = data.google_compute_subnetwork.subnet.self_link
  }
}

Crea un'istanza VM in un progetto di servizio con un indirizzo IPv4 statico riservato dalla subnet condivisa del progetto host:

resource "google_compute_instance" "reserved_ip" {
  project      = var.service_project
  zone         = "us-central1-a"
  name         = "reserved-ip-instance"
  machine_type = "e2-medium"
  boot_disk {
    initialize_params {
      image = "debian-cloud/debian-9"
    }
  }
  network_interface {
    subnetwork = data.google_compute_subnetwork.subnet.self_link
    network_ip = google_compute_address.internal.address
  }
}

Per scoprire come applicare o rimuovere una configurazione Terraform, consulta Comandi Terraform di base.

Console

1. Configura la rete VPC condivisa.
2. Nella console Google Cloud, vai alla pagina VPC condiviso.
   Vai alla VPC condiviso condivisa
3. Accedi come amministratore VPC condiviso.
4. Seleziona il progetto di servizio dal selettore dei progetti.
5. Per andare alla pagina Crea un modello di istanza, seleziona Compute Engine > Modelli di istanza > Crea modelli di istanza.
6. Specifica un nome per il modello di istanza.
7. Nella sezione Opzioni avanzate, fai clic su Networking.
8. Nella sezione Interfacce di rete, fai clic sul pulsante di opzione Reti condivise con me.
9. Nell'elenco Subnet condivisa, seleziona la subnet richiesta in cui vuoi creare il modello di istanza:
   • Per gli indirizzi IPv4, seleziona una subnet a stack singolo.
   • Per gli indirizzi IPv6, seleziona una subnet a doppio stack con il tipo di accesso IPv6 richiesto.
10. Seleziona il tipo di stack IP:
    • Per gli indirizzi IPv4, seleziona IPv4 (stack singolo).
    • Per gli indirizzi IPv6, seleziona IPv4 e IPv6 (stack doppio).
11. Specifica eventuali altri parametri necessari per il modello di istanza.
12. Fai clic su Crea.

gcloud

• Crea un modello di istanze solo IPv4 da utilizzare in qualsiasi subnet creata automaticamente di una rete VPC condiviso in modalità automatica:

  gcloud compute instance-templates create TEMPLATE_NAME \
      --project SERVICE_PROJECT_ID \
      --network projects/HOST_PROJECT_ID/global/networks/NETWORK
  

  Sostituisci quanto segue:

  • TEMPLATE_NAME: il nome del modello.
  • SERVICE_PROJECT_ID: l'ID del progetto di servizio.
  • HOST_PROJECT_ID: l'ID del progetto host VPC condiviso.
  • NETWORK: il nome della rete VPC condiviso.

• Per creare un modello di istanza solo IPv4 per una subnet creata manualmente in una rete VPC condiviso (modalità automatica o personalizzata):

  gcloud compute instance-templates create TEMPLATE_NAME \
      --project SERVICE_PROJECT_ID \
      --region REGION \
      --subnet projects/HOST_PROJECT_ID/regions/REGION/subnetworks/SUBNET
  

  Sostituisci quanto segue:

  • TEMPLATE_NAME: il nome del modello.
  • SERVICE_PROJECT_ID: l'ID del progetto di servizio.
  • HOST_PROJECT_ID: l'ID del progetto host VPC condiviso.
  • REGION: la regione che contiene la subnet condivisa.
  • SUBNET: il nome della subnet condivisa.

• Crea un modello di istanza a doppio stack che utilizza una subnet in una rete VPC condiviso in modalità personalizzata:

  gcloud compute instance-templates create TEMPLATE_NAME \
      --project SERVICE_PROJECT_ID \
      --stack-type IPV4_IPV6 \
      --region REGION \
      --subnet projects/HOST_PROJECT_ID/regions/REGION/subnetworks/SUBNET
  

  Sostituisci quanto segue:

  • TEMPLATE_NAME: il nome del modello.
  • SERVICE_PROJECT_ID: l'ID del progetto di servizio.
  • HOST_PROJECT_ID: l'ID del progetto host VPC condiviso.
  • REGION: la regione che contiene la subnet condivisa.
  • SUBNET: il nome della subnet condivisa.

API

• Per creare un modello di istanza solo IPv4 che utilizzi qualsiasi subnet creata automaticamente di una rete VPC condiviso in modalità automatica, specifica la rete VPC:

  POST https://compute.googleapis.com/compute/v1/projects/SERVICE_PROJECT_ID/global/instanceTemplates
  {
  "properties": {
    "networkInterfaces": [
      {
        "network": "projects/HOST_PROJECT_ID/global/networks/NETWORK"
      }
    ]
  ...
  }
  

  Sostituisci quanto segue:

  • HOST_PROJECT_ID: l'ID del progetto che contiene la rete VPC condiviso.
  • SERVICE_PROJECT_ID: l'ID del progetto di servizio.
  • NETWORK: il nome della rete VPC condiviso.

  Per ulteriori informazioni, consulta il metodo instanceTemplates.insert.

• Per creare un modello di istanza solo IPv4 che utilizza una subnet creata manualmente in una rete VPC condiviso (modalità automatica o personalizzata), specifica la subnet:

  POST https://compute.googleapis.com/compute/v1/projects/SERVICE_PROJECT_ID/global/instanceTemplates
  {
  "properties": {
    "networkInterfaces": [
      {
        "subnetwork": "projects/HOST_PROJECT_ID/regions/REGION/subnetworks/SUBNET_NAME"
      }
    ]
  ...
  }
  

  Sostituisci quanto segue:

  • HOST_PROJECT_ID: l'ID del progetto che contiene la rete VPC condiviso.
  • REGION: la regione che contiene la subnet condivisa.
  • SERVICE_PROJECT_ID: l'ID del progetto di servizio.
  • SUBNET_NAME: il nome della subnet condivisa.

  Per ulteriori informazioni, consulta il metodo instanceTemplates.insert.

• Per creare un modello di istanza a doppio stack che utilizza una subnet in una rete VPC condiviso in modalità personalizzata, specifica la subnet e il tipo di stack:

  POST https://compute.googleapis.com/compute/v1/projects/SERVICE_PROJECT_ID/global/instanceTemplates
  {
  "properties": {
    "networkInterfaces": [
      {
        "subnetwork": "projects/HOST_PROJECT_ID/regions/REGION/subnetworks/SUBNET_NAME",
        "stackType": "IPV4_IPV6"
      }
    ]
  ...
  }
  

  Sostituisci quanto segue:

  • HOST_PROJECT_ID: l'ID del progetto che contiene la rete VPC condiviso.
  • REGION: la regione che contiene la subnet condivisa.
  • SERVICE_PROJECT_ID: l'ID del progetto di servizio.
  • SUBNET_NAME: il nome della subnet condivisa.

  Per ulteriori informazioni, consulta il metodo instanceTemplates.insert.

Terraform

Puoi utilizzare un blocco di dati Terraform per specificare le informazioni sulla sottorete dell'host. Quindi, utilizza una risorsa Terraform per creare un modello di istanza VM. Gli indirizzi IPv4 per le VM provengono dalla subnet condivisa del progetto host.

La subnet deve esistere nella stessa regione in cui verranno create le istanze VM.

Specifica la subnet dell'host:

data "google_compute_subnetwork" "subnet" {
  name    = "my-subnet-123"
  project = var.project
  region  = "us-central1"
}

Crea un modello di istanza VM nel progetto di servizio:

resource "google_compute_instance_template" "default" {
  project      = var.service_project
  name         = "appserver-template"
  description  = "This template is used to create app server instances."
  machine_type = "n1-standard-1"
  disk {
    source_image = "debian-cloud/debian-9"
  }
  network_interface {
    subnetwork = data.google_compute_subnetwork.subnet.self_link
  }
}

Per scoprire come applicare o rimuovere una configurazione Terraform, consulta Comandi Terraform di base.

Console

1. Vai alla pagina Bilanciamento del carico nella console Google Cloud.
   Vai alla pagina Bilanciamento del carico

2. Crea il bilanciatore del carico TCP/UDP interno apportando la seguente modifica: nella sezione Configura i servizi frontend, seleziona la subnet VPC condiviso necessaria dalla sezione Reti condivise da altri progetti del menu Subnet.

3. Completa la creazione del bilanciatore del carico.

gcloud

Quando crei la regola di forwarding interno, specifica una subnet nel progetto dell'host con il flag --subnet:

gcloud compute forwarding-rules create FR_NAME \
    --project SERVICE_PROJECT_ID \
    --load-balancing-scheme internal \
    --region REGION \
    --ip-protocol IP_PROTOCOL \
    --ports PORT,PORT,... \
    --backend-service BACKEND_SERVICE_NAME \
    --subnet projects/HOST_PROJECT_ID/regions/REGION/subnetworks/SUBNET \
    --address INTERNAL_IP

Sostituisci quanto segue:

• FR_NAME: il nome della regola di forwarding.
• SERVICE_PROJECT_ID: l'ID del progetto di servizio.
• REGION: la regione che contiene la subnet condivisa.
• IP_PROTOCOL: TCP o UDP, corrispondente al protocollo del servizio di backend del bilanciatore del carico.
• PORT: la porta numerica o l'elenco di porte per il bilanciatore del carico.
• BACKEND_SERVICE_NAME: il nome del servizio di backend (già creato nell'ambito della procedura generale per la creazione di un bilanciatore del carico di rete passthrough interno).
• HOST_PROJECT_ID: l'ID del progetto host VPC condiviso.
• SUBNET: il nome della subnet condivisa.
• INTERNAL_IP: un indirizzo IP interno nella subnet condivisa (se non specificato, ne verrà selezionato uno disponibile).

Per ulteriori opzioni, consulta il comando gcloud compute forwarding-rules create.

API

Crea la regola di forwarding interno e specifica una subnet nel progetto dell'host.

POST https://compute.googleapis.com/compute/v1/projects/SERVICE_PROJECT_ID/regions/REGION/forwardingRules
{
  "name": "FR_NAME",
  "IPAddress": "IP_ADDRESS",
  "IPProtocol": "PROTOCOL",
  "ports": [ "PORT", ... ],
  "loadBalancingScheme": "INTERNAL",
  "subnetwork": "https://www.googleapis.com/compute/v1/projects/HOST_PROJECT_ID/regions/REGION/subnetworks/SUBNET",
  "network": "https://www.googleapis.com/compute/v1/projects/HOST_PROJECT_ID/global/networks/NETWORK_NAME",
  "backendService": "https://www.googleapis.com/compute/v1/projects/SERVICE_PROJECT_ID/regions/us-west1/backendServices/BE_NAME",
  "networkTier": "PREMIUM"
}

Sostituisci quanto segue:

• BE_NAME: il nome del servizio di backend (creato già nell'ambito della procedura generale per creare un bilanciatore del carico di rete passthrough interno).
• FR_NAME: un nome per la regola di forwarding.
• HOST_PROJECT_ID: l'ID del progetto host VPC condiviso.
• IP_ADDRESS: un indirizzo IP interno nella sottorete condivisa.
• IP_PROTOCOL: TCP o UDP, in base al protocollo del servizio di backend del bilanciatore del carico.
• PORT: la porta numerica o l'elenco di porte per il bilanciamento del carico.
• REGION: la regione che contiene la subnet condivisa.
• SERVICE_PROJECT_ID: l'ID del progetto di servizio.
• SUBNET: il nome della subnet condivisa.

Per ulteriori informazioni, consulta il metodo forwardingRules.insert.

Terraform

Puoi utilizzare un blocco di dati Terraform per specificare la subnet host e la rete host. Quindi, utilizza una risorsa Terraform per creare la regola di forwarding.

Specifica la rete host:

data "google_compute_network" "network" {
  name    = "my-network-123"
  project = var.project
}

Specifica la subnet dell'host:

data "google_compute_subnetwork" "subnet" {
  name    = "my-subnet-123"
  project = var.project
  region  = "us-central1"
}

Nel progetto di servizio, crea una regola di forwarding nella rete e nella subnet del progetto host:

resource "google_compute_forwarding_rule" "default" {
  project               = var.service_project
  name                  = "l4-ilb-forwarding-rule"
  backend_service       = google_compute_region_backend_service.default.id
  region                = "europe-west1"
  ip_protocol           = "TCP"
  load_balancing_scheme = "INTERNAL"
  all_ports             = true
  allow_global_access   = true
  network               = data.google_compute_network.network.self_link
  subnetwork            = data.google_compute_subnetwork.subnet.self_link
}

Per scoprire come applicare o rimuovere una configurazione Terraform, consulta Comandi Terraform di base.