Progetti Google Cloud per Google Distributed Cloud

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

Installa Google Cloud CLI.

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:

StrumentoCome registrarsi
gkectlCompila il campo gkeConnect.projectID nel file di configurazione del cluster.
Console Google CloudIl cluster viene registrato automaticamente. Il progetto Google Cloud che utilizzi per creare il cluster diventa il progetto host del parco risorse.
TerraformCompila il campo project_id nel file.tfvars.
Interfaccia a riga di comando gcloudQuando 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.