Configura un cluster da gestire tramite l'API Anthos On-Prem

L'API Anthos On-Prem è un'API ospitata da Google Cloud che ti consente di gestire il ciclo di vita dei cluster on-premise utilizzando client come la console Google Cloud e Google Cloud CLI. Quando crei un cluster utente utilizzando uno di questi client, l'API archivia i metadati sullo stato del cluster nella regione Google Cloud specificata durante la creazione del cluster. Questi metadati ti consentono di gestire il ciclo di vita del cluster nella console o nell'gcloud CLI, inclusa l'aggiunta e la rimozione di pool di nodi. Se vuoi utilizzare questi client per visualizzare i dettagli dei cluster o gestire il ciclo di vita dei cluster creati utilizzando bmctl, devi registrare i cluster con l'API Anthos On-Prem.

Sebbene non sia possibile creare cluster di amministrazione utilizzando la console o l'interfaccia a riga di comando gcloud, puoi registrare i cluster di amministrazione con l'API Anthos On-Prem. La registrazione di un cluster di amministrazione nell'API Anthos On-Prem ti consente di utilizzare la console o l'interfaccia a riga di comando gcloud per eseguire l'upgrade dei cluster utente gestiti dal cluster di amministrazione.

Requisiti

Solo i cluster utente e amministratore possono essere registrati con l'API Anthos On-Prem. La registrazione di cluster ibridi e autonomi non è supportata.
Versione 1.13 o successive.
Se la tua organizzazione ha impostato una lista consentita che consente al traffico delle API di Google e di altri indirizzi di passare attraverso il server proxy, aggiungi quanto segue alla lista consentita:
- gkeonprem.googleapis.com
- gkeonprem.mtls.googleapis.com
Questi sono i nomi dei servizi per l'API Anthos On-Prem.

Registra un cluster utente

Per registrare i cluster:

Esegui questo comando per accedere con il tuo Account Google:
```
  gcloud auth login
```
Aggiorna i componenti alpha di Google Cloud CLI:
```
  gcloud components update
```
Abilita l'API Anthos On-Prem nel progetto host del parco risorse:
```
gcloud services enable \
    --project FLEET_PROJECT_ID \
    gkeonprem.googleapis.com
```
Sostituisci FLEET_PROJECT_ID con l'ID del tuo progetto host del parco risorse. Si tratta dell'ID progetto configurato nella sezione gkeconnect del file di configurazione del cluster.
Registra il cluster con l'API Anthos On-Prem:
Cluster utente
```
gcloud alpha container bare-metal clusters enroll USER_CLUSTER_NAME  \
  --project=FLEET_PROJECT_ID \
  --admin-cluster-membership=ADMIN_CLUSTER_MEMBERSHIP_NAME \
  --location=LOCATION
```
Sostituisci quanto segue:
- USER_CLUSTER_NAME: il nome del cluster utente che vuoi registrare.
- FLEET_PROJECT_ID: l'ID del progetto host del parco risorse.
- ADMIN_CLUSTER_MEMBERSHIP_NAME: il cluster di amministrazione che gestisce il cluster utente. Specifica il nome del cluster di amministrazione o il nome del cluster completamente specificato che identifica in modo univoco il cluster in Google Cloud. Il nome del cluster di amministrazione è l'ultimo segmento del nome del cluster completamente specificato: projects/FLEET_HOST_PROJECT_ID/locations/global/memberships/ADMIN_CLUSTER_NAME
- LOCATION: la regione di Google Cloud in cui viene eseguita l'API Anthos On-Prem. Specifica us-west1 o un'altra regione supportata. L'area geografica non può essere modificata dopo la registrazione del cluster. Oltre a impostare la regione in cui viene eseguita l'API Anthos On-Prem, si tratta della regione in cui sono archiviati i seguenti elementi:
  - I metadati del cluster utente necessari dall'API Anthos On-Prem per gestire il ciclo di vita del cluster
  - Dati di Cloud Logging e Cloud Monitoring relativi ai componenti del sistema
  - L'audit log di amministrazione creato da Cloud Audit Logs
Cluster di amministrazione
```
gcloud alpha container bare-metal admin-clusters enroll ADMIN_CLUSTER_NAME \
  --project=FLEET_PROJECT_ID \
  --admin-cluster-membership=ADMIN_CLUSTER_MEMBERSHIP_NAME \
  --location=LOCATION
```
Sostituisci quanto segue:
- ADMIN_CLUSTER_NAME: il nome del cluster di amministrazione che vuoi registrare.
- FLEET_PROJECT_ID: l'ID del progetto host del parco risorse.
- ADMIN_CLUSTER_MEMBERSHIP_NAME: specifica il nome del cluster di amministrazione o il nome completo del cluster che identifica in modo univoco il cluster in Google Cloud. Il nome del cluster di amministrazione è l'ultimo segmento del nome del cluster completamente specificato: projects/FLEET_HOST_PROJECT_ID/locations/global/memberships/ADMIN_CLUSTER_NAME
- LOCATION: la regione di Google Cloud in cui viene eseguita l'API Anthos On-Prem. Specifica us-west1 o un'altra regione supportata. L'area geografica non può essere modificata dopo la registrazione del cluster. Oltre a impostare la regione in cui viene eseguita l'API Anthos On-Prem, si tratta della regione in cui sono archiviati i seguenti elementi:
  - I metadati del cluster utente necessari dall'API Anthos On-Prem per gestire il ciclo di vita del cluster
  - Dati di Cloud Logging e Cloud Monitoring relativi ai componenti del sistema
  - L'audit log di amministrazione creato da Cloud Audit Logs

Una volta registrato il cluster, puoi utilizzare i seguenti comandi per ottenere informazioni sui cluster:

Cluster utente

Per descrivere un cluster utente:

gcloud alpha container bare-metal clusters describe USER_CLUSTER_NAME \
   --project=FLEET_PROJECT_ID \
   --location=LOCATION

Per elencare i cluster utente:

gcloud alpha container bare-metal clusters list \
   --project=FLEET_PROJECT_ID \
   --location=LOCATION

Cluster di amministrazione

Per descrivere un cluster di amministrazione:

gcloud alpha container bare-metal admin-clusters describe ADMIN_CLUSTER_NAME \
   --project=FLEET_PROJECT_ID \
   --location=LOCATION

Per elencare i cluster di amministrazione:

gcloud alpha container bare-metal admin-clusters list \
   --project=FLEET_PROJECT_ID \
   --location=LOCATION

Connettiti al cluster

Dopo aver registrato il cluster con l'API Anthos On-Prem, devi scegliere e configurare un metodo di autenticazione in modo da poter gestire il cluster dalla console Google Cloud. Il metodo di autenticazione selezionato controlla anche l'accesso al cluster dalla riga di comando. Per ulteriori informazioni, consulta quanto segue: