Questa pagina fornisce informazioni su come creare un hub a cui possono essere collegati gli spoke VPC in un progetto diverso. Fornisce inoltre dettagli su come selezionare le opzioni preimpostate per le topologie di connettività mesh o a stella per gli spoke VPC durante la creazione dell'hub.
In qualità di amministratore hub, puoi aggiornare un gruppo spoke utilizzando il
comando gcloud network-connectivity hubs groups update
. Puoi aggiungere un elenco di ID progetto o numeri di progetto per abilitare l'accettazione automatica per gli spoke. Quando l'accettazione automatica è attivata, lo spoke
del progetto con accettazione automatica viene collegato automaticamente all'hub senza
la necessità di una revisione individuale della proposta di spoke e passa allo stato ACTIVE
.
Per i progetti non inclusi nell'elenco di accettazione automatica, lo spoke rimane nello stato
INACTIVE
finché non lo rivedi e lo accetti.
Puoi elencare i gruppi center ed edge come risorse nidificate per un hub specifico utilizzando il 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 i gruppi centrale e perimetrale.
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.
- 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.
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Make sure 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.
-
Make sure 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
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.
Per verificare di aver impostato correttamente l'ID progetto, utilizza il comando
gcloud config list
.gcloud config list --format='text(core.project)'
Nella console Google Cloud , vai alla pagina Network Connectivity Center.
Fai clic su Attiva.
Nella console Google Cloud , vai alla pagina Network Connectivity Center.
Nel menu del progetto, seleziona un progetto.
Fai clic su Crea hub.
Completa la sezione Configurazione di base del modulo:
- Inserisci un nome hub.
- (Facoltativo) Inserisci una Descrizione.
- Scegli il tipo di topologia preimpostata.
- (Facoltativo) Per aggiungere un'etichetta, fai clic su Aggiungi elemento e poi inserisci una chiave e un valore.
- Verifica che nel modulo venga visualizzato l'ID progetto corretto. Se l'ID progetto non è corretto, seleziona un progetto diverso utilizzando il menu nella parte superiore della pagina.
Nella sezione Propagazione della connessione Private Service Connect, attiva o disattiva la propagazione della connessione Private Service Connect facendo clic su On o Off.
Esegui una di queste operazioni:
- Se vuoi creare un raggio collegato a questo hub, fai clic su Passaggio successivo e completa la sezione di creazione del raggio del modulo. Per le istruzioni, vedi Creare un VPC spoke.
- Se non vuoi creare un raggio in questo momento, fai clic su Crea per terminare la creazione del nuovo hub.
HUB_NAME
: il nome del nuovo hubPOLICY_MODE
: (facoltativo) la modalità policy per attivare una topologia preimpostata, ad esempioPRESET
TOPOLOGY_TYPE
: il tipo di topologia preimpostata. I valori supportati sonoSTAR
oMESH
. Il valore predefinito èMESH
.DESCRIPTION
: testo facoltativo che descrive l'hubKEY
: la chiave nella coppia chiave-valore per il testo dell'etichetta facoltativaVALUE
: il valore nella coppia chiave-valore per il testo dell'etichetta facoltativaPROJECT_ID
: l'ID progetto del progetto che contiene il nuovo hubHUB_NAME
: il nome del nuovo hubDESCRIPTION
: testo facoltativo che descrive l'hubKEY
: la chiave nella coppia chiave-valore per il testo dell'etichetta facoltativaVALUE
: il valore nella coppia chiave-valore per il testo dell'etichetta facoltativaTOPOLOGY_TYPE
: il tipo di topologia preimpostata. I valori supportati sonoSTAR
oMESH
. Il valore predefinito èMESH
.Nella console Google Cloud , vai a Network Connectivity Center.
Nel menu del progetto, seleziona il progetto in cui si trova l'hub.
Fai clic sul nome dell'hub per cui vuoi aggiornare i progetti di accettazione automatica.
Nella pagina Dettagli hub, in Gruppi, fai clic su Modifica accanto al nome del gruppo. Per la connettività di topologia mesh, esiste un singolo gruppo predefinito. Per la connettività di topologia a stella, i gruppi sono centrale e perimetrale.
Nel riquadro Modifica gruppo, esegui uno di questi passaggi:
Per aggiungere i progetti da cui vuoi accettare automaticamente gli spoke, fai clic su Aggiungi ID progetto e digita l'ID 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.
Fai clic su Salva.
GROUP_NAME
: il nome del gruppoHUB_NAME
: il nome dell'hubDESCRIPTION
: testo facoltativo che descrive il gruppoPROJECT_NAME_1
,PROJECT_NAME_2
: un elenco separato da virgole di uno o più ID progetto o numeri di progetto per cui vuoi attivare l'accettazione automaticaGROUP_NAME
: il nome del gruppoHUB_NAME
: il nome dell'hubDESCRIPTION
: testo facoltativo che descrive l'hubGROUP_NAME
: il nome del gruppoHUB_NAME
: il nome dell'hubDESCRIPTION
: testo facoltativo che descrive l'hubPROJECT_NAME_1
,PROJECT_NAME_2
: un elenco separato da virgole di uno o più ID progetto o numeri di progetto per cui vuoi disattivare l'accettazione automaticaPROJECT_ID
: l'ID progetto in cui hai creato l'hubHUB_NAME
: il nome dell'hubGROUP_NAME
: il nome del gruppoPROJECT_NAME_1
,PROJECT_NAME_2
: un elenco separato da virgole di uno o più ID progetto o numeri di progetto per cui vuoi aggiungere o rimuovere l'accettazione automaticaNella console Google Cloud , vai alla pagina Network Connectivity Center.
Nel menu del progetto, seleziona un progetto.
Fai clic sulla scheda Hub.
Nell'elenco degli hub, seleziona quello che vuoi eliminare.
Fai clic sulla scheda Spoke. Tutti gli spoke collegati a questo hub sono elencati con il relativo stato.
Dall'elenco dei raggi attivi, elimina i raggi attivi. Se non hai le autorizzazioni per eliminare lo spoke, rifiuta lo spoke.
Fai clic su
Elimina hub.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.
Per elencare tutti gli spoke attivi collegati all'hub che vuoi eliminare, utilizza il 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 vuoi eliminare.Elimina gli spoke attivi. Se non hai le autorizzazioni per eliminare lo spoke, rifiuta lo spoke.
Per eliminare un hub, utilizza il comando
gcloud network-connectivity hubs delete
.gcloud network-connectivity hubs delete HUB_NAME
Sostituisci
HUB_NAME
con il nome dell'hub.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 progetto del progetto che contiene l'hub per il quale vuoi elencare gli spokeHUB_NAME
: il nome dell'hub per cui vuoi elencare gli spoke
Elimina gli spoke attivi. Se non hai le autorizzazioni per eliminare lo spoke, rifiuta lo spoke.
Per eliminare l'hub, utilizza il 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 progetto del progetto che contiene l'hub da eliminareHUB_NAME
: il nome dell'hub da eliminare
- Per creare hub e spoke, vedi Utilizzo di hub e spoke.
- Per visualizzare un elenco dei partner le cui soluzioni sono integrate con Network Connectivity Center, consulta Partner di Network Connectivity Center.
- Per trovare soluzioni ai problemi comuni, consulta la sezione Risoluzione dei problemi.
- Per informazioni dettagliate sui comandi API e Google Cloud CLI, consulta API e riferimenti.
Abilita l'API Network Connectivity
Prima di poter eseguire qualsiasi attività utilizzando Network Connectivity Center, devi abilitare l'API Network Connectivity.
Console
Per abilitare l'API Network Connectivity:
In alternativa, puoi abilitare l'API utilizzando la libreria API della console, come descritto in Abilitare le API.Google Cloud
Richiedi l'accesso
Per utilizzare Network Connectivity Center, devi disporre delle autorizzazioni descritte in Ruoli e autorizzazioni.
Identificare le risorse
Quando fai riferimento alle risorse utilizzando gcloud CLI o l'API, utilizza le convenzioni descritte nella tabella seguente.
Convegno | Supporto soltanto 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 regionali e globali | Utilizza questo metodo per hub, spoke, tunnel VPN e collegamenti VLAN. | "HUB_NAME" |
Crea un hub
Per creare un hub:
Console
gcloud
Per creare un hub, utilizza il
comando gcloud network-connectivity hubs create
.
gcloud network-connectivity hubs create HUB_NAME \ --policy-mode="POLICY_MODE" \ --preset-topology="TOPOLOGY_TYPE" \ --description="DESCRIPTION" \ --labels="KEY"="VALUE"
Se vuoi attivare la connessione propagata di Private Service Connect a livello globale per l'hub Network Connectivity Center, utilizza il flag --export-psc
.
gcloud network-connectivity hubs create HUB_NAME \ --description="DESCRIPTION" \ --labels="KEY"="VALUE" \ --export-psc
Sostituisci i seguenti valori:
Per abilitare la propagazione della connessione Private Service Connect su un hub esistente, consulta Aggiornare un hub.
Se vuoi disattivare la funzionalità di propagazione della connessione Private Service Connect sugli hub esistenti, utilizza il flag --no-export-psc
. Le connessioni di propagazione esistenti vengono rimosse in modo asincrono.
API
Per creare un hub, utilizza il
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 abilitare la connessione propagata di Private Service Connect a livello globale per l'hub Network Connectivity Center, imposta il valore di export-psc
su "true".
POST https://networkconnectivity.googleapis.com/v1/projects/PROJECT_ID/locations/global/hubs { "export_psc": true }
Sostituisci i seguenti valori:
Per abilitare la propagazione della connessione Private Service Connect su un hub esistente, consulta Aggiornare un hub.
Se vuoi disattivare la funzionalità di propagazione della connessione Private Service Connect in un hub esistente, imposta il valore di export_psc
su "false". Le connessioni di propagazione esistenti
vengono rimosse in modo asincrono.
Per informazioni dettagliate su altri comandi hub, come list, describe e update, vedi Utilizzare hub e raggi.
Gestire i progetti con accettazione automatica per i gruppi spoke
Per aggiornare i progetti con accettazione automatica per un gruppo spoke, segui questi passaggi.
Console
gcloud
Per aggiornare un gruppo di spoke, utilizza il comando
gcloud network-connectivity hubs groups update
.
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:
Per cancellare tutti i progetti dall'elenco dei progetti con accettazione automatica, utilizza il flag --clear-auto-accept-projects
.
gcloud network-connectivity hubs groups update GROUP_NAME \ --hub=HUB_NAME \ --description=DESCRIPTION \ --clear-auto-accept-projects
Sostituisci quanto segue:
Per rimuovere progetti specifici dall'elenco dei progetti con accettazione automatica, utilizza il flag
--remove-auto-accept-projects
.
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:
API
Per aggiornare i progetti con accettazione automatica per un gruppo spoke, utilizza il
Metodo networkconnectivity.hubs.groups.update
.
PATCH https://networkconnectivity.googleapis.com/v1/projects/PROJECT_ID/locations/global/hubs/HUB_NAME/groups/GROUP_NAME/updateMask=auto_accept.auto_accept_projects { "auto_accept": { "auto_accept_projects": ["PROJECT_NAME_1","PROJECT_NAME_2"], } }
Sostituisci quanto segue:
Eliminare 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 per eliminarlo. In questo caso, devi rifiutare lo spoke.
Per la procedura per eliminare un raggio, vedi Eliminare un raggio.