Questo documento mostra come associare uno o più progetti Google Cloud a un cluster in Google Distributed Cloud.
Le istruzioni riportate qui sono complete. Per un'introduzione più breve all'utilizzo di un progetto Google Cloud, consulta Configurare un'infrastruttura minima.
Prima di iniziare
Progetto host del parco risorse
Ogni cluster di amministrazione deve essere registrato 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 di un 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. Nel progetto host del parco risorse della console Google Cloud 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. Nei passaggi successivi devi disporre dell'ID del progetto host del parco risorse.
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 della registrazione della connessione devono essere concessi determinati ruoli nel progetto host del parco risorse. Per i dettagli, consulta Connect-register account account (Connetti account di servizio registrato).
All'account di servizio di monitoraggio del logging devono essere concessi determinati ruoli nel progetto host del parco risorse. Per maggiori dettagli, consulta Account di servizio di monitoraggio di Logging.
All'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
Registri 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 progetto di misurazione dell'utilizzo
All'account di servizio di misurazione dell'utilizzo devono essere concessi determinati ruoli nel progetto di misurazione dell'utilizzo.
Per maggiori dettagli, consulta Account di servizio di misurazione dell'utilizzo.
Progetto principale dell'account di servizio di accesso ai componenti
Prima di creare un cluster, devi avere un account di servizio che Google Distributed Cloud possa utilizzare per scaricare componenti da Container Registry. Questo account di servizio è chiamato account di servizio Accesso componenti.
Il progetto Google Cloud in cui hai creato l'account di servizio di accesso ai componenti è denominato parent dell'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 principali, consulta Informazioni sugli account di servizio e sui progetti Google Cloud.
Per abilitare le API richieste per il progetto principale dell'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
Creare chiavi e account di servizio.