Questo documento mostra come associare uno o più progetti Google Cloud a un cluster in Google Distributed Cloud.
Le istruzioni sono complete. Per un'introduzione più breve all'utilizzo di un progetto Google Cloud, consulta Configurare l'infrastruttura minima.
Prima di iniziare
Progetto host del parco risorse
Tutti i cluster di amministrazione devono essere registrati in un parco risorse. Inoltre, ogni cluster utente gestito da un cluster di amministrazione deve essere registrato nello stesso parco risorse del cluster di amministrazione.
Quando un cluster di amministrazione o utente è registrato in un parco risorse, viene associato a un progetto host del parco risorse. Un cluster di amministrazione e tutti i cluster utente che gestisce hanno lo stesso progetto host del parco risorse. Nella console Google Cloud, nel progetto host del parco risorse, puoi visualizzare e gestire i cluster di amministrazione e utente.
Scegli un progetto Google Cloud da utilizzare come progetto host del parco risorse. Puoi scegliere un progetto esistente o crearne uno nuovo. Prendi nota dell'ID progetto. Devi usare l'ID del progetto host del parco risorse nei passaggi che seguono.
Abilita le API nel progetto host del parco risorse
Nel progetto host del parco risorse, abilita le API richieste:
Linux e macOS
Abilita le seguenti API nel progetto host del parco risorse:
gcloud services enable --project FLEET_HOST_PROJECT_ID \
anthos.googleapis.com \
container.googleapis.com \
gkehub.googleapis.com \
gkeconnect.googleapis.com \
connectgateway.googleapis.com \
monitoring.googleapis.com \
kubernetesmetadata.googleapis.com \
logging.googleapis.com \
opsconfigmonitoring.googleapis.com \
serviceusage.googleapis.com \
iam.googleapis.com \
cloudresourcemanager.googleapis.com
Se vuoi gestire il ciclo di vita dei cluster nella console Google Cloud, in Google Cloud CLI o in Terraform, abilita queste API aggiuntive nel progetto host del parco risorse:
gcloud services enable --project FLEET_HOST_PROJECT_ID \
gkeonprem.googleapis.com \
anthosaudit.googleapis.com \
storage.googleapis.com
Windows
Abilita le seguenti API nel progetto host del parco risorse:
gcloud services enable --project FLEET_HOST_PROJECT_ID ^
anthos.googleapis.com ^
container.googleapis.com ^
gkehub.googleapis.com ^
gkeconnect.googleapis.com ^
connectgateway.googleapis.com ^
monitoring.googleapis.com ^
kubernetesmetadata.googleapis.com ^
logging.googleapis.com ^
opsconfigmonitoring.googleapis.com ^
serviceusage.googleapis.com ^
iam.googleapis.com ^
cloudresourcemanager.googleapis.com
Se vuoi gestire il ciclo di vita dei cluster utente nella console Google Cloud, in Google Cloud CLI o in Terraform, abilita queste API aggiuntive nel progetto host del parco risorse:
gcloud services enable --project FLEET_HOST_PROJECT_ID ^
gkeonprem.googleapis.com ^
anthosaudit.googleapis.com ^
storage.googleapis.com
Concedi ruoli agli account di servizio nel progetto host del parco risorse
All'account di servizio connect-register devono essere concessi determinati ruoli nel progetto host del parco risorse. Per maggiori dettagli, vedi Connect-register service account.
All'account di servizio di monitoraggio dei log devono essere concessi determinati ruoli nel progetto host del parco risorse. Per maggiori dettagli, consulta Account di servizio di logging-monitoraggio.
Al tuo account di servizio di audit logging devono essere concessi determinati ruoli nel progetto host del parco risorse. Per maggiori dettagli, consulta Account di servizio di audit logging.
Registra un cluster in un parco risorse
Puoi registrare un cluster in un parco risorse quando lo crei. I dettagli della registrazione dipendono dallo strumento utilizzato per creare il cluster:
| Strumento | Come registrarsi |
|---|---|
gkectl | Compila il campo gkeConnect.projectID nel file di configurazione del cluster. |
| Console Google Cloud | Il cluster viene registrato automaticamente. Il progetto Google Cloud che utilizzi per creare il cluster diventa il progetto host del parco risorse. |
| Terraform | Compila il campo project_id nel
file.tfvars. |
| Interfaccia a riga di comando gcloud | Quando chiami gcloud container vmware clusters create, fornisci un valore per --project. |
Progetto di misurazione dell'utilizzo
Se abiliti la misurazione dell'utilizzo per un cluster utente, Google Distributed Cloud archivia i dati sull'utilizzo in un set di dati BigQuery associato a un progetto Google Cloud di tua scelta. Questo progetto Google Cloud è chiamato progetto di misurazione dell'utilizzo.
Il progetto di misurazione dell'utilizzo può essere uguale al progetto host del parco risorse o può essere diverso.
Se scegli di abilitare la misurazione dell'utilizzo, abilita queste API nel tuo progetto di misurazione dell'utilizzo:
Linux e macOS
gcloud services enable --project USAGE_METERING_PROJECT_ID] \
bigquery.googleapis.com \
serviceusage.googleapis.com \
iam.googleapis.com \
cloudresourcemanager.googleapis.com
Windows
gcloud services enable --project USAGE_METERING_PROJECT_ID ^
bigquery.googleapis.com ^
serviceusage.googleapis.com ^
iam.googleapis.com ^
cloudresourcemanager.googleapis.com
Concedi ruoli agli account di servizio nel tuo progetto di misurazione dell'utilizzo
È necessario concedere all'account di servizio di misurazione dell'utilizzo determinati ruoli nel progetto di misurazione dell'utilizzo.
Per maggiori dettagli, consulta l'account di servizio di misurazione dell'utilizzo.
Progetto padre dell'account di servizio di accesso ai componenti
Prima di creare un cluster, devi disporre di un account di servizio che Google Distributed Cloud possa utilizzare per scaricare componenti da Container Registry. Questo account di servizio è chiamato account di servizio di accesso ai componenti.
Il progetto Google Cloud in cui hai creato l'account di servizio di accesso ai componenti è denominato parent del tuo account di servizio di accesso ai componenti. Questo progetto può essere uguale al progetto host del parco risorse o può essere diverso. Per ulteriori informazioni sugli account di servizio e sui progetti padre, consulta Informazioni sugli account di servizio e sui progetti Google Cloud.
Per abilitare le API richieste per il progetto padre del tuo account di servizio di accesso ai componenti:
Linux e macOS
gcloud services enable --project [PARENT_PROJECT_ID] \
serviceusage.googleapis.com \
iam.googleapis.com \
cloudresourcemanager.googleapis.com
Windows
gcloud services enable --project [PARENT_PROJECT_ID] ^
serviceusage.googleapis.com ^
iam.googleapis.com ^
cloudresourcemanager.googleapis.com
Passaggi successivi
Crea account di servizio e chiavi.