Configurare un hub

Questa pagina fornisce informazioni su come creare un hub a cui possono essere collegati gli spoke VPC in un altro progetto. Fornisce inoltre dettagli su come selezionare le opzioni preimpostate topologie di connettività mesh o stella per gli spoke VPC durante la creazione dell'hub.

In qualità di amministratore dell'hub, puoi aggiornare un gruppo spoke utilizzando la proprietà Comando gcloud network-connectivity hubs groups update. Puoi aggiungere un elenco di ID progetto o numeri per attivare l'accettazione automatica per gli spoke. Quando l'accettazione automatica è attivata, lo spoke del progetto con accettazione automatica viene collegato automaticamente all'hub senza che debba essere esaminata la proposta di ogni spoke e passa allo stato ACTIVE. Per i progetti non inclusi nell'elenco di accettazione automatica, lo spoke rimane in INACTIVE fino a quando non esamini e accetti lo spoke.

Puoi elencare i gruppi center e edge come risorse nidificate per un un hub specifico utilizzando Comando gcloud network-connectivity hubs groups list --hub. Per gli hub creati con la topologia mesh, l'output restituisce il gruppo predefinito. Per gli hub creati con la topologia a stella, l'output restituisce center e edge. gruppi.

Prima di iniziare

Prima di iniziare, esamina le sezioni seguenti.

Crea o seleziona un progetto

Per semplificare la configurazione di Network Connectivity Center, inizia identificando un progetto valido.

  1. Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.
  2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Go to project selector

  3. Make sure that billing is enabled for your Google Cloud project.

  4. Install the Google Cloud CLI.
  5. To initialize the gcloud CLI, run the following command:

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

    Go to project selector

  7. Make sure that billing is enabled for your Google Cloud project.

  8. Install the Google Cloud CLI.
  9. To initialize the gcloud CLI, run the following command:

    gcloud init
  10. Se utilizzi Google Cloud CLI, imposta il tuo progetto utilizzando il parametro Comando gcloud config set.

    gcloud config set project PROJECT_ID

    Sostituisci PROJECT_ID con il tuo ID progetto univoco.

    Le istruzioni della gcloud CLI in questa pagina presuppongono che l'ID progetto sia stato impostato.

  11. Per verificare di aver impostato correttamente l'ID progetto, utilizza la proprietà 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, devi attivare la l'API Network Connectivity.

Console

Per abilitare l'API Network Connectivity:

  1. Nella console Google Cloud, vai alla pagina Centro connettività di rete.

    Vai al Network Connectivity Center

  2. Fai clic su Attiva.

In alternativa, puoi abilitare l'API utilizzando libreria API della console Google Cloud, come descritto in Abilitazione delle API.

Chiedi l'accesso

Per utilizzare Network Connectivity Center, è necessario disporre delle autorizzazioni descritte in Ruoli e autorizzazioni.

Identifica le risorse

Quando fai riferimento alle risorse utilizzando gcloud CLI o l'API, utilizza le convenzioni descritte in seguente.

Convegno Supportato per Note Esempio
URI completo Tutte le risorse Utilizza uno di questi metodi per fare riferimento alle istanze dell'appliance router.
"https://www.googleapis.com/compute/projects/PROJECT_ID/zones/ZONE/instances/INSTANCE_NAME"

      
Nome risorsa relativo Tutte le risorse
"projects/PROJECT_ID/zones/ZONE/instances/INSTANCE_NAME"

    
Nome Risorse a livello di regione e globale Utilizza questo metodo per hub, spoke, tunnel VPN e collegamenti VLAN.
 "HUB_NAME"

    

Crea un hub

Per creare un hub, segui questi passaggi.

Console

  1. Nella console Google Cloud, vai alla pagina Centro connettività di rete.

    Vai al Network Connectivity Center

  2. Nel menu del progetto, seleziona un progetto.

  3. Fai clic su Crea hub.

  4. Completa la sezione Configurazione di base del modulo:

    1. Inserisci un Nome hub.
    2. (Facoltativo) Inserisci una descrizione.
    3. Scegli il tipo di topologia preimpostato.
    4. (Facoltativo) Per aggiungere un'etichetta, fai clic su Aggiungi elemento, quindi inserisci un'etichetta Chiave e Valore.
    5. Verifica che il modulo mostri l'ID progetto corretto. Se l'ID progetto non è corretto, seleziona un progetto diverso utilizzando il menu nella parte superiore della pagina.
  5. Nella sezione Propagazione connessione Private Service Connect, attiva o disattiva la connessione Private Service Connect di propagazione facendo clic su On o Off (Anteprima).

  6. Esegui una di queste operazioni:

    • Se vuoi creare uno spoke collegato a questo hub, fai clic su Passaggio successivo e completa la sezione del modulo per la creazione di spoke. Per le istruzioni, consulta Creare uno spoke VPC.
    • Se non vuoi creare uno spoke adesso, fai clic su Crea per finisci di creare il tuo nuovo hub.

gcloud

Per creare un hub, utilizza Comando gcloud network-connectivity hubs create.

  gcloud network-connectivity hubs create hub HUB_NAME \
      --policy-mode="POLICY_MODE" \
      --preset-topology="TOPOLOGY_TYPE" \
      --description="DESCRIPTION" \
      --labels="KEY"="VALUE"

Se vuoi abilitare Private Service Connect connessione propagata (anteprima) a livello globale per l'hub di Network Connectivity Center, utilizza il flag --export-psc. Questa funzionalità si applica solo agli spoke VPC.

  gcloud network-connectivity hubs create HUB_NAME \
      --description="DESCRIPTION" \
      --labels="KEY"="VALUE" \
      --export-psc

Sostituisci i seguenti valori:

  • HUB_NAME: il nome del nuovo hub
  • POLICY_MODE: Facoltativo: la modalità dei criteri per attivare una preimpostazione di classificazione, ad esempio PRESET
  • TOPOLOGY_TYPE: il tipo di topologia preimpostata. I valori supportati sono STAR o MESH. Il valore predefinito è MESH.
  • DESCRIPTION: testo facoltativo che descrive l'hub
  • KEY: la chiave nella coppia chiave-valore per il testo facoltativo dell'etichetta
  • VALUE: il valore nella coppia chiave-valore per la testo etichetta facoltativo

Per attivare la propagazione della connessione Private Service Connect su un hub esistente, consulta Aggiornare un hub. Se vuoi disattivare la funzionalità di propagazione delle connessioni Private Service Connect negli hub esistenti, utilizza il flag --no-export-psc. Le connessioni di propagazione esistenti vengono rimosse in modo asincrono.

API

Per creare un hub, utilizza Metodo networkconnectivity.hubs.create.

  POST https://networkconnectivity.googleapis.com/v1/projects/PROJECT_ID/locations/global/hubs
  {
    "name":"HUB_NAME",
    "description":"DESCRIPTION",
    "labels": {
      "KEY": "VALUE"
    }
  }

Per scegliere una topologia preimpostata, utilizza lo stesso metodo e specifica la topologia:

  POST https://networkconnectivity.googleapis.com/v1/projects/PROJECT_ID/locations/global/hubs
  {
    "name":"HUB_NAME",
    "description":"DESCRIPTION",
    "preset_topology": "TOPOLOGY_TYPE"
  }

Se vuoi attivare la connessione propagata di Private Service Connect (anteprima) a livello globale per l'hub del Centro di connettività di rete, imposta il valore export-psc su "true". Questo si applica solo agli spoke VPC.

  POST https://networkconnectivity.googleapis.com/v1/projects/PROJECT_ID/locations/global/hubs
  {
    "export_psc": true
  }

Sostituisci i seguenti valori:

  • PROJECT_ID: l'ID del progetto che contiene il nuovo hub
  • HUB_NAME: il nome del nuovo hub
  • DESCRIPTION: testo facoltativo che descrive l'hub
  • KEY: la chiave nella coppia chiave-valore per il testo facoltativo della etichetta
  • VALUE: il valore nella coppia chiave-valore per il testo facoltativo dell'etichetta
  • TOPOLOGY_TYPE: il tipo di topologia preimpostata. Lo strumento sono STAR o MESH. Il valore predefinito è MESH.

Per abilitare la propagazione della connessione di Private Service Connect su un per l'hub esistente, Aggiornare un hub. Se vuoi disabilitare la connessione Private Service Connect di propagazione su un hub esistente, imposta il valore export_psc su "false". Connessioni di propagazione esistenti vengono rimossi in modo asincrono.

Per informazioni dettagliate sui comandi hub aggiuntivi, come list, describe, e aggiorna, vedi Utilizzare hub e spoke.

Gestisci i progetti di accettazione automatica per i gruppi spoke

Per aggiornare l'accettazione automatica dei progetti per un gruppo spoke, segui questi passaggi.

Console

  1. Nella console Google Cloud, vai a Centro connettività di rete.

    Vai al Network Connectivity Center

  2. Nel menu progetto, seleziona il progetto in cui si trova l'hub.

  3. Fai clic sul nome dell'hub per il quale vuoi aggiornare i progetti con accettazione automatica.

  4. Nella pagina Dettagli hub, in Gruppi, fai clic su Modifica accanto al il nome del gruppo. Per la connettività di topologia mesh, è disponibile un'unica regola predefinita gruppo. Per la connettività di topologia a stella, i gruppi sono center e perimetrale.

  5. Nel riquadro Modifica gruppo, esegui una delle questi passaggi:

    • Per aggiungere i progetti da cui vuoi accettare automaticamente gli spoke, fai clic su Aggiungi l'ID progetto e digita l'ID del progetto. Per aggiungere altri progetti, fai clic su Aggiungi ID progetto.

    • Per rimuovere un ID progetto dall'elenco di accettazione automatica, fai clic su Elimina accanto a ID progetto.

  6. Fai clic su Salva.

gcloud

Per aggiornare un gruppo di spoke, utilizza gcloud network-connectivity hubs groups update un comando kubectl.

gcloud network-connectivity hubs groups update GROUP_NAME \
  --hub=HUB_NAME \
  --description=DESCRIPTION \
  --add-auto-accept-projects=PROJECT_NAME_1,PROJECT_NAME_2

Sostituisci quanto segue:

  • GROUP_NAME: il nome del gruppo
  • HUB_NAME: il nome dell'hub
  • DESCRIPTION: testo facoltativo che descrive il gruppo
  • PROJECT_NAME_1, PROJECT_NAME_2: un un elenco separato da virgole di uno o più ID progetto o numeri di progetto che vuoi attivare l'accettazione automatica per

Per cancellare tutti i progetti dall'elenco di progetti accettati automaticamente, utilizza il --clear-auto-accept-projects flag.

gcloud network-connectivity hubs groups update GROUP_NAME \
  --hub=HUB_NAME \
  --description=DESCRIPTION \
  --clear-auto-accept-projects

Sostituisci quanto segue:

  • GROUP_NAME: il nome del gruppo
  • HUB_NAME: il nome dell'hub
  • DESCRIPTION: testo facoltativo che descrive l'hub

Per rimuovere progetti specifici dall'elenco di progetti accettati automaticamente, utilizza il --remove-auto-accept-projects flag.

gcloud network-connectivity hubs groups update GROUP_NAME \
  --hub=HUB_NAME \
  --description=DESCRIPTION \
  --remove-auto-accept-projects=PROJECT_NAME_1,PROJECT_NAME_2

Sostituisci quanto segue:

  • GROUP_NAME: il nome del gruppo
  • HUB_NAME: il nome dell'hub
  • DESCRIPTION: testo facoltativo che descrive l'hub
  • PROJECT_NAME_1, PROJECT_NAME_2: un un elenco separato da virgole di uno o più ID progetto o numeri di progetto che vuoi disattivare l'accettazione automatica per

API

Per aggiornare l'accettazione automatica dei progetti per un gruppo spoke, utilizza il metodo

Metodo networkconnectivity.hubs.groups.update.

  PATCH https://networkconnectivity.googleapis.com/v1/projects/PROJECT_ID/locations/global/hubs/HUB_NAME/groups/GROUP_NAME/update
  {
   "auto_accept": {
       "auto_accept_projects": ["PROJECT_NAME_1","PROJECT_NAME_2"],
    }
  }

Sostituisci quanto segue:

  • PROJECT_ID: l'ID progetto in cui hai creato l'hub
  • HUB_NAME: il nome dell'hub
  • GROUP_NAME: il nome del gruppo
  • PROJECT_NAME_1, PROJECT_NAME_2: un un elenco separato da virgole di uno o più ID progetto o numeri di progetto che vuoi aggiungere o rimuovere l'accettazione automatica per

Elimina un hub

Per eliminare un hub:

Prima di poter eliminare un hub, devi eliminare o rifiutare tutti gli spoke collegati all'hub. Se lo spoke si trova in un progetto diverso, potresti non avere l'autorizzazione a eliminarlo. In questo caso, devi rifiutare lo spoke.

Per la procedura di eliminazione di uno spoke, vedi Elimina uno spoke.

Console

  1. Nella console Google Cloud, vai alla pagina Centro connettività di rete.

    Vai al Network Connectivity Center

  2. Nel menu del progetto, seleziona un progetto.

  3. Fai clic sulla scheda Hub.

  4. Nell'elenco di hub, seleziona quello che vuoi eliminare.

  5. Fai clic sulla scheda Spoke. Tutti gli spoke collegati a questo hub sono elencati con il relativo stato.

  6. Dall'elenco di spoke attivi, elimina gli spoke attivi. Se non hai le autorizzazioni per eliminare lo spoke, rifiuta lo spoke.

  7. Fai clic su Elimina hub.

  8. Nella finestra di dialogo di conferma, esegui una delle seguenti operazioni:

    • Fai clic su Annulla se non vuoi eliminare l'hub.
    • Fai clic su Elimina per eliminare l'hub.

gcloud

  1. Per elencare tutti gli spoke attivi collegati all'hub che vuoi eliminare: utilizza la Comando gcloud network-connectivity hubs list-spokes.

    gcloud network-connectivity hubs list-spokes HUB_NAME \
        --filter="state:ACTIVE"
    

    Sostituisci HUB_NAME con il nome dell'hub che ti interessa. da eliminare.

  2. Elimina gli spoke attivi. Se non hai le autorizzazioni per eliminare lo spoke, rifiuta lo spoke.

  3. Per eliminare un hub, utilizza Comando gcloud network-connectivity hubs delete.

    gcloud network-connectivity hubs delete HUB_NAME
    

    Sostituisci HUB_NAME con il nome dell'hub.

API

  1. Per elencare tutti gli spoke attivi collegati all'hub che vuoi eliminare: utilizza il metodo networkconnectivity.hubs.listSpokes.

     GET https://networkconnectivity.googleapis.com/v1/projects/PROJECT_ID/locations/global/hubs/HUB_NAME:listSpokes
    

    Sostituisci i seguenti valori:

    • PROJECT_ID: l'ID del progetto che contiene l'hub per cui vuoi elencare gli spoke
    • HUB_NAME: il nome dell'hub per il quale vuoi elenco spoke
  2. Elimina gli spoke attivi. Se non hai le autorizzazioni per eliminare lo spoke, rifiuta lo spoke.

  3. Per eliminare l'hub, utilizza Metodo networkconnectivity.hubs.delete.

     DELETE https://networkconnectivity.googleapis.com/v1/projects/PROJECT_ID/locations/global/hubs/HUB_NAME
    

    Sostituisci i seguenti valori:

    • PROJECT_ID: l'ID del progetto che contiene l'hub da eliminare
    • HUB_NAME: il nome dell'hub da eliminare

Passaggi successivi