Provisioning della rete VPC condivisa

La VPC condivisa consente di esportare le subnet da una rete Virtual Private Cloud (VPC) in un progetto host in altri progetti di servizio nella stessa organizzazione. Le istanze nei progetti di servizio possono avere connessioni di rete e le subnet del progetto host. Questa pagina descrive come configurare e utilizzare la VPC condivisa, incluse alcune preparazioni amministrative necessarie per la tua organizzazione.

Nota: se hai iniziato a utilizzare Google Cloud, puoi creare un prompt Rete VPC condiviso nell'ambito del processo di configurazione di Google Cloud.

Il VPC condiviso supporta l'esportazione sia solo IPv4 (stack singolo) che Subnet IPv6 (stack doppio).

Per informazioni su come scollegare i progetti di servizio o rimuovere completamente la configurazione del VPC condiviso, consulta Eseguire il deprovisioning del VPC condiviso.

Il VPC condiviso è anche noto come "XPN" nell'API e a interfaccia a riga di comando.

Quote, limiti e risorse idonee

Prima di iniziare, assicurati di conoscere bene il VPC condiviso e l'IAM, in particolare:

• Prendi nota delle quote e dei limiti relativi alla VPC condivisa.

• Assicurati di capire quali risorse possono partecipare e quali risorse non possono partecipare.

• Assicurati di avere attivata l'API Compute Engine e la fatturazione il tuo progetto host e tutti i progetti di servizio che prevedi di collegare all'host progetto.

Prepara l'organizzazione

Tieni presente le seguenti informazioni quando prepari la tua organizzazione.

Amministratori e IAM

Preparazione dell'organizzazione, configurazione di progetti host del VPC condiviso e l'uso delle reti VPC condiviso prevede almeno tre i ruoli amministrativi di Identity and Access Management (IAM). Per maggiori dettagli su ciascun ruolo e informazioni su quelli facoltativi, consulta la sezione Amministratori e IAM della panoramica del VPC condiviso.

Importante: i ruoli Utente di rete e Amministratore di rete sono diversi. Per maggiori dettagli, consulta la sezione Amministratori di rete e sicurezza della panoramica del VPC condiviso.

Vincoli dei criteri dell'organizzazione

I vincoli dei criteri dell'organizzazione possono proteggere le risorse a livello di progetto, cartella o organizzazione. Le sezioni seguenti descrivono ogni .

Impedire l'eliminazione accidentale dei progetti host

L'eliminazione accidentale di un progetto host causerebbe interruzioni in tutti i progetti di servizio collegati. Quando un progetto è configurato come VPC condiviso viene applicato un blocco speciale, chiamato lien, Come finché il blocco è presente, impedisce l'eliminazione del progetto per errore. Il blocco viene rimosso automaticamente dal progetto host quando non è più configurato per il VPC condiviso.

Attenzione: per impostazione predefinita, un proprietario del progetto può rimuovere un blocco da un progetto, incluso un progetto host VPC condiviso, a meno che non sia definito un criterio a livello di organizzazione per limitare la rimozione dei blocchi. (In particolare, la rimozione dei blocchi richiede una Entità IAM con resourcemanager.projects.get e resourcemanager.projects.updateLiens autorizzazioni per il progetto.) Il proprietario del progetto host può rimuovere il blocco e poi eliminare il progetto VPC condiviso. Per evitare che ciò accada, segui le istruzioni riportate in questa sezione.

Un utente con il ruolo orgpolicy.policyAdmin può definire un vincolo dei criteri a livello di organizzazione (constraints/compute.restrictXpnProjectLienRemoval) che limita la rimozione dei pignoramenti solo ai seguenti ruoli:

• Utenti con roles/owner o roles/resourcemanager.lienModifier a livello di organizzazione
• Utente con ruoli personalizzati che includono le autorizzazioni resourcemanager.projects.get e resourcemanager.projects.updateLiens a livello di organizzazione

In questo modo, un proprietario del progetto che non dispone del ruolo roles/owner a livello di organizzazione o del ruolo resourcemanager.lienModifier a livello di organizzazione non potrà eliminare accidentalmente un progetto host VPC condiviso. Per ulteriori informazioni sulle autorizzazioni associate al ruolo resourcemanager.lienModifier, consulta Applicare un blocco a un progetto nella documentazione di Resource Manager.

Poiché un criterio dell'organizzazione si applica a tutti i progetti nell'organizzazione, seguire questi passaggi una sola volta per limitare la rimozione dei blocchi.

1. Esegui l'autenticazione in gcloud come amministratore dell'organizzazione o entità IAM con il ruolo orgpolicy.policyAdmin. Sostituisci ORG_ADMIN con il nome di un amministratore dell'organizzazione:

   gcloud auth login ORG_ADMIN
   

2. Determina il numero ID della tua organizzazione esaminando l'output di questo comando.

   gcloud organizations list
   

3. Applica il criterio compute.restrictXpnProjectLienRemoval per la tua organizzazione eseguendo questo comando. Sostituisci ORG_ID con il numero determinato nel passaggio precedente.

   gcloud resource-manager org-policies enable-enforce \
       --organization ORG_ID compute.restrictXpnProjectLienRemoval
   

4. Esci da gcloud se hai completato le attività come organizzazione Amministratore per proteggere il tuo account.

   gcloud auth revoke ORG_ADMIN
   

Limitare i collegamenti del progetto host

Per impostazione predefinita, un amministratore della rete VPC condivisa può collegare un utente non host a qualsiasi host progetto nella stessa organizzazione. L'amministratore dei criteri dell'organizzazione può limita l'insieme di progetti host a cui un progetto non host o uno non host puoi collegare i progetti in una cartella o un'organizzazione. Per ulteriori informazioni, vedi il Vincolo constraints/compute.restrictSharedVpcHostProjects.

Vincola le subnet nel progetto host utilizzabili da un progetto di servizio

Per impostazione predefinita, dopo aver configurato il VPC condiviso, le entità IAM nei progetti di servizio possono utilizzare qualsiasi subnet nel progetto host se dispongono delle autorizzazioni IAM appropriate. Oltre a gestire le autorizzazioni dei singoli utenti, un amministratore dei criteri dell'organizzazione può impostare un criterio per definire l'insieme di sottoreti a cui può accedere un determinato progetto o i progetti in una cartella o un'organizzazione. Per ulteriori informazioni, consulta il vincolo constraints/compute.restrictSharedVpcSubnetworks.

Impedisci l'arresto accidentale dei progetti host

La disconnessione della fatturazione su una rete VPC condiviso può portare a un di tutte le risorse dipendenti, inclusi i progetti di servizio. Per evitare possibile arresto accidentale del VPC condiviso a causa di fatturazione inattiva o disabilitata, protegge il collegamento tra il progetto host e e il relativo account di fatturazione.

Nomina gli amministratori della VPC condivisa

Un amministratore dell'organizzazione può concedere a una o più entità IAM Amministratore VPC condiviso e Ruoli di Amministratore IAM progetto.

Il ruolo Amministratore IAM progetto concede gli amministratori del VPC condiviso l'autorizzazione a condividere tutte le subnet esistenti e future, non solo singole subnet. Questa concessione crea un'associazione a livello di organizzazione o cartella, non a livello di progetto. Pertanto, le entità IAM devono essere definite nell'organizzazione, non solo in un progetto al suo interno.

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. Dal menu del progetto, seleziona la tua organizzazione.

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

3. Fai clic su Aggiungi.

4. Inserisci gli indirizzi email delle nuove entità.

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

   Nota: se non vedi il ruolo Amministratore VPC condiviso Compute come è possibile che tu non abbia eseguito l'accesso alla console Google Cloud come Amministratore dell'organizzazione oppure potresti aver selezionato un progetto anziché all'intera organizzazione.

6. Fai clic su Aggiungi un altro ruolo.

7. Nel menu a discesa Ruoli, seleziona Resource Manager > IAM del progetto Console di amministrazione.

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 tua cartella.

   Se selezioni un progetto o un'organizzazione, le opzioni visualizzate sono risposta errata.

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 > Amministratore IAM del progetto.

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. Esegui 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 condiviso a livello di organizzazione di questo livello, procedi nel seguente modo:

   1. Applica il ruolo Amministratore VPC condiviso a un progetto esistente Entità IAM. 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 della VPC condivisa.

      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 VPC condiviso cartella, procedi nel seguente modo:

   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 progetto esistente Entità IAM. Sostituisci ORG_ID con l'ID organizzazione del passaggio precedente e EMAIL_ADDRESS con l'indirizzo email del utente a cui stai concedendo il ruolo 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 per in gcloud a strumento a riga di comando al termine delle attività per proteggere al 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 dell'organizzazione esistente .

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

     Sostituisci ORG_ID con l'ID della tua organizzazione.

  3. Assegnare 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 della VPC condivisa.
     • EMAIL_ADDRESS: l'indirizzo email dell'utente.
     • ETAG: un identificatore univoco ricevuto quando hai descritto il criterio esistente. Impedisce le collisioni se vengono inviate più richieste di aggiornamento contemporaneamente.

     Per ulteriori informazioni, consulta Metodo organizations.setIamPolicy.

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

  1. Determina il numero dell'ID 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 esistente per le cartelle.

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

     Sostituisci FOLDER_ID con l'ID della cartella.

  4. Assegnare 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 della VPC condivisa.
     • EMAIL_ADDRESS: l'indirizzo email dell'utente.
     • ETAG: un identificatore univoco ricevuto quando hai ha descritto il criterio esistente. Impedisce collisioni se vengono inviate più richieste di aggiornamenti contemporaneamente.

     Per ulteriori informazioni, consulta il metodo folders.setIamPolicy.

Configura rete VPC condivisa

Tutte le attività in questa sezione devono essere eseguite da un amministratore VPC condiviso.

Abilita un progetto host

All'interno di un'organizzazione, gli amministratori della rete VPC condivisa possono designare Progetti host VPC condiviso, soggetti a quote e limiti, seguendo questa procedura. Gli amministratori della rete VPC condivisa possono anche creare ed eliminare progetti se dispongono del Ruolo Autore progetto e ruolo Autore eliminazione progetto (roles/resourcemanager.projectCreator e roles/resourcemanager.projectDeleter) per la tua organizzazione.

Quando attivi un progetto host, le risorse di rete del progetto non vengono condivise automaticamente con i progetti di servizio. Devi allegare di servizio al progetto host per condividere i progetti di reti e subnet con i progetti di servizio.

Nota: il API Compute Engine deve essere abilitato per il progetto che diventa il progetto host del VPC condiviso e per tutti i progetti di servizio che verranno collegati. Per ulteriori informazioni, consulta la documentazione dell'API Compute Engine.

Attenzione: per evitare interruzioni del servizio causate dall'eliminazione o dall'arresto accidentale di un progetto host, consulta Impedire l'eliminazione accidentale dei progetti host e Impedire l'arresto accidentale dei progetti host.

Console

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

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

   Vai al VPC condiviso

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 un VPC condiviso.

5. Nella pagina successiva, fai clic su Salva & 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 hai bisogno di condividere tutte le subnet attuali e future nelle reti VPC progetto host con progetti di servizio e amministratori progetti di servizio specificato 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 progetto, specifica i progetti di servizio da collegare 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 gli utenti in base al ruolo, aggiungi gli amministratori dei progetti di servizio. A questi utenti verrà concesso 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

Nota: questi passaggi designano un progetto come progetto host con VPC condiviso. A differenza delle indicazioni stradali della console, nessun servizio I progetti sono collegati al progetto host e nessun amministratore del progetto di servizio vengono definiti. Dopo aver completato questi passaggi, puoi collegare Google Cloud.

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

   gcloud auth login SHARED_VPC_ADMIN
   

2. Abilita il VPC condiviso per il progetto che devi diventare un host progetto. 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 il tuo dell'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. Abilita il VPC condiviso per il progetto utilizzando le credenziali con 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 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.

Associa i progetti di servizio

Un progetto di servizio deve essere collegato a un progetto host prima del rispettivo progetto di servizio Gli amministratori possono utilizzare il VPC condiviso. Un amministratore del VPC condiviso deve eseguire i seguenti passaggi per completare l'allegato.

Un progetto di servizio può essere associato a un solo progetto host, ma un progetto host supporta più associazioni di progetti di servizio. Consulta Limiti specifici del VPC condiviso nella pagina delle quote VPC per i dettagli.

Nota: prima di poter eseguire il collegamento a un progetto host, devi attivare l'API Compute Engine per il progetto di servizio.

Console

Nota: se hai utilizzato la Console per attivare un progetto host, hai già collegato uno o più progetti di servizio. Le seguenti istruzioni spiegano come modificare configurazione di un progetto host esistente.

1. Accedi alla console Google Cloud come amministratore VPC condiviso.
2. Nella console Google Cloud, vai alla pagina VPC condivisa.
   Vai alla pagina del VPC condiviso
3. Fai clic sulla scheda Progetti collegati.
4. Nella scheda Progetti collegati, fai clic su Collega progetti. .
5. Seleziona le caselle corrispondenti ai progetti di servizio da collegare nella sezione dei nomi. 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 alle entità verrà assegnato il ruolo compute.networkUser. IAM alle entità viene concesso il ruolo Utente di rete per l'intero progetto host oppure a determinate subnet nel progetto host, in base alla condivisione della rete VPC . Queste entità sono note come amministratori progetti di servizio ai rispettivi progetti di servizio.
7. Nella sezione Modalità di condivisione rete VPC, seleziona una delle seguenti opzioni:
   1. Fai clic su Condividi tutte le subnet (autorizzazioni a livello di progetto) per condividere tutti alle subnet attuali e future nelle reti VPC dell'host con tutti i progetti di servizio e gli amministratori 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. Poi, Seleziona Subnet da condividere.
8. Fai clic su Salva.

gcloud

Nota: questi passaggi riguardano solo l'associazione di un progetto di servizio a un progetto host. Devi prima aver abilitato un progetto host.

1. Se non l'hai già fatto, esegui l'autenticazione su 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

Nota: questi passaggi riguardano solo il collegamento di un progetto di servizio a un host progetto. Devi prima aver abilitato un host progetto.

1. Collega un progetto di servizio al progetto host del 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 allegare.

   Per ulteriori informazioni, consulta 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 usare un modello Terraform risorsa 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.

Amministratori dei progetti di servizi per tutte le subnet

Un amministratore della VPC condivisa può assegnare a un'entità IAM di un progetto di servizio il ruolo di Amministratore del progetto di servizio con accesso a tutte le subnet nel progetto host. Agli amministratori dei progetti di servizio di questo tipo viene concesso il ruolo compute.networkUser per l'intero progetto host. Ciò significa che a tutte le subnet definite e future nel progetto host.

Un utente con il ruolo compute.networkUser nel progetto host può vedere tutte le subnet all'interno dei progetti di servizio collegati.

Nota: se non riesci a creare nuove risorse in una determinata subnet, un'organizzazione potrebbe vincolare le subnet che questo progetto può utilizzare. Per maggiori informazioni le informazioni, vedi Vincolo constraints/compute.restrictSharedVpcSubnetworks.

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 servizio progetto come amministratore progetti di servizio con accesso a tutte le subnet in un host progetto. Prima di poter eseguire questi passaggi, è necessario avere aver abilitato un progetto host e ha 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 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 entità: modificando il formato dell'argomento --member:

   • Utilizza group: per specificare un gruppo Google (tramite l'indirizzo email) come entità.
   • Utilizza domain: per specificare un dominio Google come entità.
   • Usa 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 aggiuntivo dei progetti di servizio che devono 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. Sono necessari 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 dell'host che contiene la rete VPC condiviso.

2. Crea un'associazione di criteri per designare le entità IAM in il progetto di servizio come amministratori progetti 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 condivisa.
   • PRINCIPAL: un'identità che a cui è associato il ruolo, ad esempio un utente, un gruppo, un dominio o l'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. Evita le collisioni se richieste di aggiornamento vengono inviate contemporaneamente.

   Per ulteriori informazioni, consulta il metodo projects.setIamPolicy.

Amministratori dei progetti di servizio per alcune subnet

Un amministratore della VPC condivisa può assegnare a un entità IAM di un progetto di servizio il ruolo di Amministratore del progetto di servizio con accesso solo ad alcune delle subnet del progetto host. Questa opzione fornisce un mezzo più granulare per definire gli amministratori dei progetti di servizio concedendo loro il ruolo compute.networkUser solo per alcune subnet nel progetto host.

Un utente con il ruolo compute.networkUser nel progetto host può vedere tutte le subnet all'interno dei progetti di servizio collegati.

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 il progetto di servizio Gli amministratori devono disporre dell'accesso. Ottieni il criterio IAM attuale in JSON. Sostituisci SUBNET_NAME con il nome di alla subnet nel progetto host e a HOST_PROJECT_ID con l'ID 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 dal passaggio precedente e salvalo in un file. Per chiarezza e istruzioni, questi passaggi lo salvano 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 IAM (diverse dagli utenti) in le norme:

   • Cambia user: con group: per specificare un gruppo Google (via email di destinazione) come entità.
   • Sostituisci user: con domain: per specificare un dominio Google come principale.
   • Usa 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 file subnet-policy.json.

   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 registra i dettagli del criterio di subnet esistente. Sono necessari 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 del progetto di servizio l'accesso alle subnet nel progetto host aggiornare il criterio della 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 collisioni se vengono inviate più richieste di aggiornamenti 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.

Account di servizio come amministratori progetti di servizio

Un amministratore della rete VPC condivisa può anche definire un servizio account dai progetti di servizio come progetto di servizio Amministratori. Questa sezione illustra come definire due diversi tipi di account servizio come amministratori del progetto di servizio:

• Servizio gestito dall'utente account con questo formato: USER_ID@SERVICE_PROJECT_ID.iam.gserviceaccount.com

• L'account di servizio API di Google con questo formato:[e-mail]

Il ruolo Amministratore progetto di servizio (compute.networkUser) può essere concesso per tutte le subnet o solo per alcune subnet del progetto host. Tuttavia, per semplicità di istruzione, questa sezione illustra solo come definire ciascuno dei due tipi di account di servizio come amministratori del progetto di servizio per tutte le sottoreti del progetto host.

Account di servizio gestiti dall'utente come amministratori progetti di servizio

Queste istruzioni descrivono come definire un account di servizio gestito dall'utente come Amministratore progetti di servizio per tutte le subnet del progetto host del VPC condiviso.

Console

1. Accedi alla console Google Cloud come amministratore del VPC condiviso.
2. Nella console Google Cloud, vai alla pagina Impostazioni.
   Vai alla pagina Impostazioni
3. Passa al 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 nel progetto host del 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 già fatto, esegui l'autenticazione su gcloud come Amministratore VPC condiviso. Sostituisci SHARED_VPC_ADMIN con il nome 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 il progetto ID per ogni elemento.

   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 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. Sono necessari 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 dell'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. Evita le collisioni se richieste di aggiornamento vengono inviate contemporaneamente.

   Per ulteriori informazioni, consulta il metodo projects.setIamPolicy.

Service account API di Google come amministratore del progetto di servizio

Queste istruzioni descrivono come definire il servizio API di Google account come amministratore progetti di servizio per tutte le subnet del VPC condiviso progetto host. La configurazione dell'account di servizio delle API di Google come amministratore del progetto di servizio è un requisito per i gruppi di istanze gestite utilizzati con il VPC condiviso perché attività come la creazione di istanze vengono eseguite da questo tipo di account di servizio. Per ulteriori informazioni su questa relazione, consulta Gruppi di istanze gestite e IAM.

Console

1. Accedi alla console Google Cloud come amministratore del VPC condiviso.
2. Nella console Google Cloud, vai alla pagina Impostazioni.
   Vai alla pagina Impostazioni
3. Passa al 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 didattica e chiarezza, questa procedura si riferisce al numero del progetto di servizio 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 [e-mail] al campo Membri.
9. Seleziona Compute Engine > Utente di rete Compute dai ruoli o dal menu Fogli Google.
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 Amministratore del VPC condiviso:

   gcloud auth login SHARED_VPC_ADMIN
   

2. Determina il numero di progetto per il progetto di servizio. Per chiarezza didattica, questa procedura si riferisce al progetto di servizio numero come SERVICE_PROJECT_NUMBER. Sostituisci SERVICE_PROJECT_ID con l'ID progetto per progetto di servizio.

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

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

     gcloud projects list
     

3. Crea un'associazione di criteri per trasformare l'account di servizio in un progetto di servizio Amministratore 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:[e-mail]" \
       --role "roles/compute.networkUser"
   

API

1. Descrivi e poi registra i dettagli delle norme del progetto esistenti. Sono necessari 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 dell'host che contiene la rete VPC condiviso.

2. Elenca il 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 account di servizio come progetto di servizio Amministratori.

   POST https://cloudresourcemanager.googleapis.com/v1/projects/HOST_PROJECT_ID:setIamPolicy
   {
     "bindings": [
       ...copy existing bindings
       {
         "members": [
           "serviceAccount:[e-mail]"
         ],
         "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 condivisa.
   • SERVICE_PROJECT_NUMBER: il numero del progetto di servizio che contiene l'account di servizio.
   • ETAG: un identificatore univoco ricevuto quando hai ha descritto il criterio esistente. Evita le collisioni se richieste di aggiornamento vengono inviate contemporaneamente.

   Per ulteriori informazioni, consulta il metodo projects.setIamPolicy.

Usa VPC condiviso

Dopo che un amministratore della rete VPC condivisa completa le attività per abilitare un host progetto, allegando i progetti di servizio necessari it e la definizione degli amministratori dei progetti di servizio tutti o parte del progetto host di subnet, gli amministratori dei progetti di servizio possono creare istanze, modelli bilanciatori del carico interni nei progetti di servizio utilizzando le subnet dell'host progetto.

Tutte le attività in questa sezione devono essere eseguite da un amministratore del progetto di servizio.

È importante notare che un amministratore del VPC condiviso concede solo il servizio Amministra il progetto del ruolo Utente di rete Compute (roles/compute.networkUser) all'intero progetto host o solo ad alcuni e le relative subnet. Gli amministratori dei progetti di servizio devono disporre anche degli altri ruoli necessari i rispettivi progetti di servizio. Ad esempio, un amministratore progetto di servizio potrebbe anche essere un proprietario del progetto o almeno hanno Ruolo Amministratore istanze Compute (roles/compute.instanceAdmin) per il progetto.

Attenzione: il ruolo Utente rete Compute e il ruolo Amministratore rete Compute (roles/compute.networkAdmin) hanno insiemi di autorizzazioni diversi. Il team di computing Il ruolo Utente di rete include autorizzazioni che non sono disponibili in Amministratore rete Compute. Un'entità IAM che dispone del ruolo Amministratore di rete Compute per un'organizzazione o un progetto, ma non del ruolo Utente di rete Compute per il progetto host o per almeno una delle subnet nel progetto host, non è un amministratore del progetto di servizio.

Elenca le subnet disponibili

Gli amministratori dei progetti di servizio possono elencare le subnet a cui sono state assegnate seguendo questi passaggi.

Console

Nella console Google Cloud, vai alla pagina VPC condivisa.

Vai al VPC condiviso

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 questo comando, sostituendo HOST_PROJECT_ID con l'ID del progetto host del VPC condiviso:

   gcloud compute networks subnets list-usable --project HOST_PROJECT_ID
   

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

   $ 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 condivisa.

Per ulteriori informazioni, consulta Metodo subnetworks.listUsable.

Prenota un indirizzo IPv4 o IPv6 interno statico

Gli amministratori dei progetti di servizio possono prenotare un indirizzo IPv4 o IPv6 interno in una subnet di un Rete VPC condiviso. L'oggetto di configurazione dell'indirizzo IP viene creato nel progetto di servizio, mentre il relativo valore proviene dall'intervallo di indirizzi IPv4 disponibili nella subnet condivisa scelta.

Importante: un indirizzo IPv6 interno statico riservato in un progetto di servizio può essere utilizzato solo dalle risorse all'interno dello stesso progetto di servizio. Risorse nella il progetto host non può utilizzare un indirizzo IPv6 interno statico riservato progetto di servizio.

Per prenotare un indirizzo IP interno autonomo nel progetto di servizio, completa i seguenti passaggi.

Console

1. Configura la rete VPC condivisa.

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

   Vai a Rete VPC condivisa

3. Accedi come amministratore VPC condiviso.

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

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

6. Fai clic su Prenota indirizzo IP statico interno.

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, specificare un indirizzo IPv4 interno statico da prenotare, nel Indirizzo IP statico, seleziona Fammi scegliere e inserisci un valore 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 Indirizzo IPv6 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. Il valore predefinito è impostata su Non condivisa.

    Nota: non puoi condividere un indirizzo IPv6 interno statico tra più dei bilanciatori del carico.

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. Usa 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 servizio progetto.
   • 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 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 condivisa.
• REGION: la regione dove l'indirizzo IPv4 riservato verrà e la posizione della subnet condivisa.
• SERVICE_PROJECT_ID: l'ID del progetto di servizio in cui prenota l'indirizzo IPv4.
• SUBNET_NAME: il nome della subnet condivisa.

Per ulteriori informazioni, consulta 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"
}

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

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.

Prenota un indirizzo IPv4 esterno statico

Una risorsa in un progetto di servizio può utilizzare un indirizzo IPv4 esterno statico regionale definito nel progetto di servizio o nel progetto host. Pertanto, una risorsa nei progetti di servizio collegati può usare indirizzo IPv4 esterno riservato nel progetto host.

Prenota un indirizzo IPv6 esterno statico

Gli amministratori dei progetti di servizio possono prenotare un indirizzo IPv6 esterno statico in un servizio progetto. L'oggetto di configurazione dell'indirizzo IPv6 creato nel progetto di servizio, mentre il suo valore proviene dall'intervallo gli indirizzi IPv6 disponibili nella subnet condivisa scelta.

Console

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

1. Configura un VPC condiviso.
2. Nella console Google Cloud, vai alla pagina VPC condivisa.
   Vai alla pagina Rete VPC condivisa
3. Accedi come amministratore VPC condiviso.
4. Seleziona il progetto di servizio dal selettore di 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 statici IPv6 è supportata solo nel livello Premium.
9. In Versione IP, seleziona IPv6.
10. Specifica se questo indirizzo IP è regionale o globale.
    • Se prenoti un indirizzo IP statico per un bilanciatore del carico globale, scegli Globale.
    • Se prenoti un indirizzo IP statico a un'istanza o a un regionale, scegli A livello di regione e poi 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 sottorete della stessa rete Virtual Private Cloud (VPC) in cui stai prenotando l'indirizzo IPv6.
    • Reti condivise con me: scegli questa opzione se vuoi prenotare. su 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. Usa 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 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 condivisa.
• SUBNET_NAME: il nome della subnet condivisa.

Crea un'istanza

Tieni presente quanto segue quando utilizzi il VPC condiviso per creare un'istanza:

• La procedura standard per la creazione di un istanza comporta la selezione di un'istanza una zona, una rete e una subnet. Sia la subnet selezionata che la zona selezionata deve trovarsi nella stessa regione. Quando un amministratore del progetto di servizio crea un'istanza utilizzando una subnet da una rete VPC condiviso, la zona selezionata l'istanza deve trovarsi nella stessa regione della subnet selezionata.

  Quando crei un'istanza con un indirizzo IPv4 interno statico riservato, la subnet e la regione sono già selezionate quando l'indirizzo IPv4 statico viene creato. In questa sezione viene fornito un esempio gcloud per la creazione di un'istanza con un indirizzo IPv4 interno statico.

• Gli amministratori dei progetti di servizio possono creare istanze solo utilizzando subnet in cui a cui è stata concessa l'autorizzazione. Per determinare quali subnet sono disponibili, consulta Elencare le subnet disponibili.

• Quando Google Cloud riceve una richiesta di creazione di un'istanza in una subnet di una rete VPC condivisa, controlla se l'entità IAM che effettua la richiesta ha l'autorizzazione per utilizzare la subnet condivisa. Se il controllo non va a buon fine, l'istanza non viene creata e Google Cloud restituisce un errore di autorizzazione. Per assistenza, contatta l'amministratore della VPC condivisa.

• Puoi creare un'istanza a doppio stack se la crei in una subnet a doppio stack. Le subnet a doppio stack supportato solo sulle reti VPC in modalità personalizzata. Il tipo di accesso IPv6 della subnet determina se l'indirizzo IPv6 assegnato alla VM un indirizzo IPv6 interno o esterno.

Console

1. Configura un VPC condiviso.

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

   Vai a Rete VPC condivisa

3. Accedi come amministratore del VPC condiviso.

4. Seleziona il progetto di servizio dal selettore di 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 nella sezione 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 condivisa:

  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 servizio progetto.
  • 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 condivisa:

  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'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 associato all'indirizzo IPv4 interno statico.

• Crea un'istanza con un indirizzo IPv4 interno temporaneo e un indirizzo IPv6 temporaneo:

  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 servizio progetto.
  • 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 servizio progetto.
  • 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 servizio progetto.
  • 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'account interno prenotato Indirizzo IPv4.
  • 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 servizio progetto.
  • 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 servizio progetto.
  • SOURCE_IMAGE: un'immagine per l'istanza.
  • SUBNET: il nome della subnet condivisa.
  • ZONE: una zona nella regione specificata.

  Per ulteriori informazioni, consulta Metodo instances.insert.

Terraform

Puoi utilizzare un blocco dati Terraform per specificare la subnet host informazioni. 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 prenotato 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.

Crea un modello di istanza

Nota: la connessione a un Rete VPC condiviso tramite interfacce diverse da nic0 è supportato per i seguenti servizi configurazioni:

Modelli di istanza: supportati in gcloud CLI e nell'API.

Gruppi di istanze gestite: supportati in gcloud CLI e nell'API.

Tieni presente quanto segue quando utilizzi un VPC condiviso per creare di un modello di istanza:

• La procedura per creare un modello di istanza prevede la selezione di una rete e di una subnet.

  • I modelli creati per l'utilizzo in una rete VPC condivisa in modalità personalizzata devono specificare sia la rete sia una subnet.

  • I modelli creati per l'utilizzo in una rete VPC condivisa in modalità automatica possono, facoltativamente, posticipare la selezione di una subnet. In questi casi, viene selezionata automaticamente una subnet nella stessa regione di qualsiasi gruppo di istanze gestite che utilizza il modello. (Reti in modalità automatica avere una subnet in ogni regione per definizione.)

• Quando un'entità IAM crea un modello di istanza, Google Cloud non esegue un controllo delle autorizzazioni per verificare se L'entità può usare la subnet specificata. Questo controllo delle autorizzazioni viene sempre posticipato quando viene richiesto un gruppo di istanze gestite che utilizza il modello.

• Puoi creare un modello di istanza dual-stack se lo crei in una subnet dual-stack. Le subnet a doppio stack sono supportate solo nelle reti VPC in modalità personalizzata. Il tipo di accesso IPv6 della subnet determina se l'indirizzo IPv6 assegnato alla VM è un indirizzo IPv6 interno o esterno.

Console

1. Configura un VPC condiviso.
2. Nella console Google Cloud, vai alla pagina VPC condivisa.
   Vai alla pagina Rete VPC condivisa
3. Accedi come amministratore del VPC condiviso.
4. Seleziona il progetto di servizio dal selettore di 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 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 qualsiasi subnet a stack singolo.
   • Per gli indirizzi IPv6, seleziona una subnet a doppio stack con gli indirizzi IPv6 richiesti tipo di accesso.
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 del VPC condiviso in ogni rete.

• 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 condivisa 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 condivisa 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 condivisa.
  • SERVICE_PROJECT_ID: l'ID del progetto di servizio.
  • NETWORK: il nome della rete VPC condivisa.

  Per ulteriori informazioni, consulta Metodo instanceTemplates.insert.

• Per creare un modello di istanza solo IPv4 che utilizza un modello creato manualmente una subnet in una rete VPC condiviso (modalità automatica o personalizzata), specifica 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 condivisa.
  • REGION: la regione che contiene la subnet condivisa.
  • SERVICE_PROJECT_ID: l'ID del servizio progetto.
  • SUBNET_NAME: il nome della subnet condivisa.

  Per ulteriori informazioni, consulta il metodo instanceTemplates.insert.

• Creare un modello di istanza a doppio stack che utilizza una subnet in un ambiente modalità rete VPC condiviso, 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 condivisa.
  • REGION: la regione che contiene la subnet condivisa.
  • SERVICE_PROJECT_ID: l'ID del servizio progetto.
  • SUBNET_NAME: il nome della subnet condivisa.

  Per ulteriori informazioni, consulta 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 delle VM provengono dalla subnet condivisa del progetto host.

La subnet deve esistere nella stessa regione in cui si troveranno le istanze VM è stato creato.

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.

Creare un gruppo di istanze gestite

Nota: la connessione a un Rete VPC condiviso che utilizza interfacce diverse da nic0 è supportato per i seguenti configurazioni:

• Modelli di istanze: supportati nell'API e nell'interfaccia a riga di comando gcloud.
• Gruppi di istanze gestite: supportati in gcloud CLI e nell'API.

Tieni presente quanto segue quando crei un gruppo di istanze gestite utilizzando la VPC condivisa:

• I gruppi di istanze gestite utilizzati con la VPC condivisa richiedono di configurare l'account di servizio delle API Google come amministratore del progetto di servizio perché attività come la creazione automatica di istanze tramite la scalabilità automatica vengono eseguite da questo account di servizio.

• Il processo standard per la creazione di un'istanza gestita prevede la selezione di una zona o regione, a seconda del tipo di gruppo, e modello di istanza. I dettagli della rete e della subnet sono collegati al modello dell'istanza. Idoneo sono limitati a quelli che fanno riferimento a subnet nello stesso regione utilizzata dal gruppo di istanze gestite.

• Gli amministratori dei progetti di servizio possono creare solo gruppi di istanze gestite il cui membro e utilizzano subnet per le quali hanno ottenuto l'autorizzazione. Poiché i dettagli della rete e della subnet sono legati al modello di istanza, al progetto di servizio Gli amministratori possono utilizzare solo modelli che fanno riferimento a subnet di cui sono autorizzati per l'utilizzo.

• Quando Google Cloud riceve una richiesta per creare un'istanza gestita verifica se l'entità IAM che esegue le operazioni richiesta ha l'autorizzazione per utilizzare la subnet (nella stessa regione del gruppo) specificato nel modello di istanza. Se il controllo non va a buon fine, l'istanza gestita gruppo non viene creato e Google Cloud restituisce un errore: Required 'compute.subnetworks.use' permission for 'projects/SUBNET_NAME.

  Elenca le subnet disponibili per determinare quali possono essere utilizzate e contatta l'amministratore del VPC condiviso se l'account di servizio richiede un accesso aggiuntivo. Per ulteriori informazioni, consulta Account di servizio come amministratori di progetti di servizio.

Per ulteriori informazioni, consulta la sezione Creare gruppi di istanze gestite nella documentazione di Compute Engine.

Crea un bilanciatore del carico HTTP(S)

Esistono molti modi per configurare i bilanciatori del carico delle applicazioni esterni all'interno di una rete VPC condivisa. Indipendentemente dal tipo di implementazione, tutti i componenti del bilanciatore del carico devono trovarsi nella stessa organizzazione e nella stessa rete VPC condivisa.

Per saperne di più sulle architetture delle reti VPC condivise supportate, consulta seguenti:

• Architettura VPC condivisa per bilanciatori del carico delle applicazioni esterni.
• Architettura VPC condivisa per bilanciatori del carico delle applicazioni interni.

Creare un bilanciatore del carico di rete passthrough interno

L'esempio seguente spiega cosa devi prendere in considerazione quando crei un un bilanciatore del carico di rete passthrough interno in una rete VPC condiviso. Gli amministratori del progetto di servizio possono creare un bilanciatore del carico di rete passthrough interno che utilizza una subnet (nel progetto host) a cui hanno accesso. L'interfaccia del bilanciatore regola di forwarding interno è definite nel progetto di servizio, ma riferimento subnet punta a una subnet in una rete VPC condiviso del progetto host.

Prima di creare un bilanciatore del carico di rete passthrough interno in un ambiente VPC condiviso, consulta Architettura VPC condivisa.

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 condivisa 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 inoltro 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 servizio progetto.
• 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 nell'host progetto.

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 fa già parte della procedura generale creando un bilanciatore del carico di rete passthrough interno).
• FR_NAME: un nome per la regola di inoltro.
• HOST_PROJECT_ID: l'ID del VPC condiviso progetto host.
• 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 caricamento con il bilanciatore del carico di rete passthrough esterno regionale.
• 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 dati Terraform per specificare la subnet host e la rete host. Quindi, utilizza una risorsa Terraform per creare la regola di inoltro.

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 nel progetto host di rete e della subnet:

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.

Passaggi successivi

• Per ulteriori informazioni sul VPC condiviso, consulta VPC condiviso.
• Per istruzioni sulla configurazione dei cluster Google Kubernetes Engine con VPC condiviso, consulta Configurare i cluster con VPC condiviso.
• Scopri come configurare l'accesso a una rete VPC condivisa da Cloud Run, funzioni Cloud Run o ambiente standard App Engine.
• Per istruzioni sull'eliminazione di una configurazione del VPC condiviso, consulta Esegui il deprovisioning di un VPC condiviso.