Proporre uno spoke VPC in un altro progetto

Quando crei uno spoke, devi associarlo a un hub. Se lo spoke si trova in un progetto diverso dall'hub, l'amministratore dell'hub deve approvare lo spoke proposto prima che possa diventare attivo. Per creare uno spoke VPC che vuoi connettere a un hub in un altro progetto, segui questi passaggi.

Per informazioni su come utilizzare gli spoke, tra cui la creazione, l'elenco, l'aggiornamento e l'eliminazione degli spoke, consulta Utilizza gli spoke.

Prima di iniziare

Prima di iniziare, esamina le sezioni seguenti.

Crea o seleziona un progetto

Per semplificare la configurazione di NCC, inizia identificando un progetto valido.

Accedi al tuo account Google Cloud . Se non conosci Google Cloud, crea un account per valutare le prestazioni dei nostri prodotti in scenari reali. I nuovi clienti ricevono anche 300 $di crediti senza costi per l'esecuzione, il test e il deployment dei carichi di lavoro.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Install the Google Cloud CLI.

If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

To initialize the gcloud CLI, run the following command:

gcloud init

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Install the Google Cloud CLI.

If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

To initialize the gcloud CLI, run the following command:

gcloud init

1. Se utilizzi Google Cloud CLI, imposta l'ID progetto utilizzando il comando gcloud config set.

   gcloud config set project PROJECT_ID

   Sostituisci PROJECT_ID con l'ID progetto univoco.

   Le istruzioni di gcloud CLI in questa pagina presuppongono che tu abbia impostato l'ID progetto.

2. Per verificare di aver impostato correttamente l'ID progetto, utilizza il comando gcloud config list.

   gcloud config list --format='text(core.project)'

Abilita l'API Network Connectivity

Prima di poter eseguire qualsiasi attività utilizzando Network Connectivity Center (NCC), devi abilitare l'API Network Connectivity.

Console

Per abilitare l'API Network Connectivity:

1. Nella console Google Cloud , vai alla pagina Network Connectivity Center.

   Vai a Network Connectivity Center

2. Fai clic su Attiva.

In alternativa, puoi abilitare l'API utilizzando la libreria API della console Google Cloud , come descritto in Abilitare le API.

Autorizzazioni richieste per questa attività

Per eseguire questa attività, devi disporre delle seguenti autorizzazioni o dei seguenti ruoli IAM.

Autorizzazioni

• compute.networks.use sulla rete appropriata a seconda del tipo di hub:
  • Per gli spoke VPC: sulla rete VPC da aggiungere a uno spoke
  • Per gli spoke VPC producer: sulla rete VPC consumer in peering
• networkconnectivity.groups.use sull'hub a cui è associato lo spoke
• networkconnectivity.spokes.create nel progetto appropriato a seconda del tipo di spoke:
  • Per gli spoke VPC: nel progetto in cui si trova la rete VPC
  • Per gli spoke VPC producer: nel progetto in cui si trova la rete VPC consumer in peering
• networkconnectivity.spokes.use per gli spoke VPC producer, devi disporre di questa autorizzazione sullo spoke VPC consumer sottoposto a peering

Ruoli

• Compute Network Admin (roles/compute.networkAdmin) sulla rete appropriata a seconda del tipo di spoke:
  • Per gli spoke VPC: la rete VPC da aggiungere a uno spoke
  • Per gli spoke VPC producer: la rete VPC consumer in peering
• Utente del gruppo (roles/networkconnectivity.groupUser) sull'hub a cui viene associato lo spoke
• Amministratore spoke (roles/networkconnectivity.spokeAdmin) nel progetto appropriato a seconda del tipo di spoke:
  • Per gli spoke VPC: nel progetto in cui si trova la rete VPC
  • Per gli spoke VPC producer: nel progetto in cui si trova la rete VPC consumer in peering

Proponi uno spoke

Per creare uno spoke VPC nello stesso progetto dell'hub o in un progetto diverso, segui questi passaggi.

Se vuoi assegnare intervalli di esclusione dall'esportazione o intervalli di esportazione da includere, utilizza le opzioni appropriate durante la creazione dello spoke.

Nota: un amministratore dell'hub non può accettare uno spoke VPC producer proposto sull'hub finché non accetta lo spoke VPC associato per la rete consumer in peering.

Console

1. Nella console Google Cloud , vai alla pagina Network Connectivity Center.

   Vai a Network Connectivity Center

2. Nel menu del progetto, seleziona un progetto in cui vuoi creare lo spoke.

3. Fai clic sulla scheda Raggi.

4. Fai clic su Aggiungi spoke.

5. Nella sezione Seleziona hub, per collegare il nuovo spoke a un hub in un altro progetto, seleziona la posizione dell'hub come In un altro progetto.

6. Inserisci l'ID progetto e il nome dell'hub a cui vuoi collegare il nuovo spoke.

7. Inserisci un Nome spoke e, facoltativamente, una Descrizione.

8. Se l'hub a cui ti stai connettendo è configurato per la topologia a stella, seleziona o inserisci il nome del gruppo di spoke per lo spoke. Per informazioni sulla topologia a stella, vedi Topologia a stella. Per informazioni sui gruppi spoke, vedi Gruppi spoke.

9. Per Tipo di spoke, sono disponibili le seguenti opzioni:

   • Per un hub in un progetto diverso, il Tipo di spoke predefinito è Spoke VPC.
   • Per un hub nello stesso progetto, i tipi di spoke consentiti sono determinati dai tipi di spoke preesistenti.
   • Se non sono presenti spoke, puoi selezionare qualsiasi tipo di spoke, anche se l'opzione preselezionata è il tunnel Cloud VPN.

10. Per aggiungere una rete VPC allo spoke, seleziona la rete VPC dall'elenco.

11. (Facoltativo) Nel campo Filtro spoke VPC, puoi aggiungere un filtro per personalizzare il modo in cui le route vengono annunciate specificando gli intervalli di indirizzi IP da escludere o includere nell'esportazione dallo spoke all'hub. Puoi configurare lo spoke in modo che esporti solo gli intervalli di subnet che utilizzano indirizzi IPv4 privati, solo gli intervalli di subnet IPv6 (interni ed esterni) o entrambi gli intervalli di subnet che utilizzano indirizzi IPv4 privati e intervalli di subnet IPv6 interni ed esterni.

    1. Intervalli IPv4: configura l'esportazione degli intervalli di subnet IPv4.

       • Includi gli intervalli di subnet IPv4 per l'esportazione dallo spoke all'hub: per impostazione predefinita, questa casella di controllo è selezionata e vengono esportati tutti gli intervalli di subnet che utilizzano indirizzi IPv4 privati.

         Se non vuoi esportare gli intervalli di subnet IPv4, deseleziona questa casella di controllo.

         Se vuoi esportare solo intervalli di subnet IPv4 specifici, seleziona Specifica intervalli IPv4 e inserisci gli intervalli di indirizzi che vuoi esportare. Gli intervalli di subnet IPv4 che specifichi devono essere intervalli di indirizzi IPv4 privati, esclusi gli indirizzi IPv4 pubblici utilizzati privatamente. Per saperne di più, consulta Intervalli IPv4 validi.

       • Escludi gli intervalli di subnet per l'esportazione dallo spoke all'hub: se lo spoke esporta tutti gli intervalli di subnet che utilizzano indirizzi IPv4 privati e vuoi escludere intervalli specifici dall'esportazione, inseriscili in questo campo.

    2. Intervalli IPv6: configura l'esportazione degli intervalli di subnet IPv6.

       • Includi tutti gli intervalli di subnet IPv6 per l'esportazione dallo spoke nell'hub: per esportare tutti gli intervalli di subnet IPv6 interne ed esterne nell'hub, seleziona la casella di controllo.

12. Fai clic su Fine.

13. Se vuoi aggiungere altri spoke, fai clic su Aggiungi spoke e ripeti la procedura, iniziando con l'inserimento di un Nome spoke.

14. Al termine dell'aggiunta dei raggi, fai clic su Crea. La pagina NCC viene aggiornata per mostrare i dettagli dei raggi che hai creato.

    Lo stato dell'hub rimane Inactive finché l'amministratore dell'hub non esamina e accetta l'hub secondario proposto.

gcloud

Per creare un VPC spoke, utilizza il comando gcloud network-connectivity spokes linked-vpc-network create.

gcloud network-connectivity spokes linked-vpc-network create SPOKE_NAME \
    --hub=HUB_URI \
    --global \
    --vpc-network=VPC_NETWORK \
    --include-export-ranges=[INCLUDE_EXPORT_RANGES] \
    --exclude-export-ranges=[EXCLUDE_EXPORT_RANGES] \
    --group=GROUP_NAME

Sostituisci quanto segue:

• SPOKE_NAME: un nome per lo spoke che stai creando.
• HUB_URI: l'URI di un hub in un progetto diverso in cui vuoi creare lo spoke.
• VPC_NETWORK: la rete VPC a cui questo spoke fornisce connettività. La rete VPC deve trovarsi nello stesso progetto dello spoke.

• INCLUDE_EXPORT_RANGES: un elenco delimitato da virgole di parole chiave, CIDR o una combinazione di parole chiave e CIDR che definiscono quali intervalli di indirizzi IP della subnet possono essere esportati nell'hub.

  • La parola chiave ALL_PRIVATE_IPV4_RANGES aggiunge tutti gli intervalli di subnet che utilizzano indirizzi IPv4 privati all'elenco degli intervalli di esportazione inclusi.

  • La parola chiave ALL_IPV6_RANGES aggiunge tutti gli intervalli di subnet IPv6 all'elenco degli intervalli di esportazione inclusi.

  • L'elenco degli intervalli di esportazione inclusi supporta fino a 16 intervalli CIDR IPv4 o IPv6 unici e non sovrapposti. Nessun CIDR nell'elenco può corrispondere o contenere un altro CIDR nell'elenco. Ogni intervallo di subnet attuale e futuro nella rete VPC spoke che si sovrappone a un CIDR nell'elenco degli intervalli di esportazione inclusi deve soddisfare una delle seguenti condizioni:

    • Corrisponde esattamente a un CIDR nell'elenco degli intervalli per l'esportazione da includere.

    • Rientrare in un CIDR nell'elenco degli intervalli per l'esportazione da includere. In questa situazione, un intervallo di subnet ha una lunghezza della subnet mask maggiore rispetto al CIDR nell'elenco degli intervalli di esportazione da includere. Ad esempio, se la rete VPC spoke ha l'intervallo di subnet 10.1.2.0/24, 10.1.0.0/16 è un CIDR valido per l'elenco degli intervalli di esportazione inclusi, ma 10.1.2.0/25 non lo è.

  • Se ometti l'elenco INCLUDE_EXPORT_RANGES, NCC funziona come se l'elenco degli intervalli per l'esportazione da includere fosse [ALL_PRIVATE_IPV4_RANGES].

• EXCLUDE_EXPORT_RANGES: un elenco delimitato da virgole di CIDR che definiscono gli intervalli di indirizzi IP della subnet che non vengono mai esportati nell'hub.

  • L'elenco degli intervalli di esclusione supporta fino a 16 CIDR unici e non sovrapposti. Nessun CIDR nell'elenco può corrispondere o contenere un altro CIDR nell'elenco.

  • Ogni CIDR specificato nell'elenco degli intervalli esclusi deve espandersi in indirizzi IP completamente contenuti nell'elenco degli intervalli di esportazione inclusi.

  • Se ometti l'elenco EXCLUDE_EXPORT_RANGES, NCC funziona come se l'elenco degli intervalli di esportazione da escludere fosse vuoto ([]).

• GROUP_NAME: il gruppo a cui appartiene questo spoke. I valori supportati sono default per un hub di topologia mesh o center o edge per un hub di topologia a stella. Questo campo è obbligatorio per i gruppi di spoke che utilizzano la topologia a stella. Per informazioni dettagliate sui gruppi hub, vedi Gruppi hub.

API

Per creare uno spoke VPC, utilizza il metodo networkconnectivity.spokes.create.

  POST https://networkconnectivity.googleapis.com/v1/projects/PROJECT_ID/locations/global/spokes
  {
    "name":"SPOKE_NAME",
    "hub":"HUB_URI",
    "linkedVpcNetwork": {
       "uri": VPC_URI,
       "include_export_ranges": "[INCLUDE_EXPORT_RANGES]",
       "exclude_export_ranges": "[EXCLUDE_EXPORT_RANGES]",
       "group": "GROUP_NAME"
    },
  }

Sostituisci quanto segue:

• PROJECT_ID: l'ID progetto del progetto che contiene il nuovo spoke
• SPOKE_NAME: un nome per lo spoke che stai creando
• HUB_URI: l'URI completo dell'hub, incluso il progetto, poiché l'hub si trova in un progetto diverso dallo spoke, ad esempio projects/hub-project-ID/locations/global/hubs/hub-name
• VPC_URI: la rete VPC a cui punta questo spoke, ad esempio vpc_uri

• INCLUDE_EXPORT_RANGES: un elenco delimitato da virgole di parole chiave, CIDR o una combinazione di parole chiave e CIDR che definiscono quali intervalli di indirizzi IP della subnet possono essere esportati nell'hub.

  • La parola chiave ALL_PRIVATE_IPV4_RANGES aggiunge tutti gli intervalli di subnet che utilizzano indirizzi IPv4 privati all'elenco degli intervalli di esportazione inclusi.

  • La parola chiave ALL_IPV6_RANGES aggiunge tutti gli intervalli di subnet IPv6 all'elenco degli intervalli di esportazione inclusi.

  • L'elenco degli intervalli di esportazione da includere supporta fino a 16 CIDR univoci e non sovrapposti. Nessun CIDR nell'elenco può corrispondere o contenere un altro CIDR nell'elenco. Ogni intervallo di subnet attuale e futuro nella rete VPC spoke che si sovrappone a un CIDR nell'elenco degli intervalli di esportazione inclusi deve soddisfare una delle seguenti condizioni:

    • Corrisponde esattamente a un CIDR nell'elenco degli intervalli per l'esportazione da includere.

    • Rientrare in un CIDR nell'elenco degli intervalli per l'esportazione da includere. In questa situazione, un intervallo di subnet ha una lunghezza della subnet mask maggiore rispetto al CIDR nell'elenco degli intervalli di esportazione da includere. Ad esempio, se la rete VPC spoke ha l'intervallo di subnet 10.1.2.0/24, 10.1.0.0/16 è un CIDR valido per l'elenco degli intervalli di esportazione inclusi, ma 10.1.2.0/25 non lo è.

  • Se ometti l'elenco INCLUDE_EXPORT_RANGES, NCC funziona come se l'elenco degli intervalli per l'esportazione da includere fosse [ALL_PRIVATE_IPV4_RANGES].

• EXCLUDE_EXPORT_RANGES: un elenco delimitato da virgole di CIDR che definiscono gli intervalli di indirizzi IP della subnet che non vengono mai esportati nell'hub.

  • L'elenco degli intervalli di esclusione supporta fino a 16 CIDR unici e non sovrapposti. Nessun CIDR nell'elenco può corrispondere o contenere un altro CIDR nell'elenco.

  • Ogni CIDR specificato nell'elenco degli intervalli esclusi deve espandersi in indirizzi IP completamente contenuti nell'elenco degli intervalli di esportazione inclusi.

  • Se ometti l'elenco EXCLUDE_EXPORT_RANGES, NCC si comporta come se l'elenco intervalli di esportazione esclusi fosse vuoto ([]).

• GROUP_NAME: il gruppo a cui appartiene questo spoke, ad esempio center o edge. Questo campo è obbligatorio per i gruppi spoke che utilizzano la topologia a stella. Per informazioni dettagliate sui gruppi spoke, consulta Gruppi spoke.

Passaggi successivi

• Per creare hub e spoke, consulta Utilizzare hub e spoke.
• Per visualizzare un elenco di partner le cui soluzioni sono integrate con NCC, consulta Partner NCC.
• Per trovare soluzioni ai problemi comuni, consulta la sezione Risolvere i problemi relativi a NCC.
• Per informazioni dettagliate sull'API e sui comandi gcloud, consulta API e riferimenti.