Questa pagina è stata tradotta dall'API Cloud Translation.

Passaggio 1: creazione di un cluster

Prima di iniziare:

Questa procedura presuppone che tu abbia creato le variabili di ambiente nei passaggi precedenti. Controllali con i seguenti comandi:

echo $PROJECT_ID
echo $ANALYTICS_REGION
echo $ORG_NAME
echo $ENV_NAME

Fai clic per visualizzare descrizioni e comandi per definire le variabili.

Questi passaggi utilizzano le seguenti variabili di ambiente:

PROJECT_ID: l'ID del tuo progetto Google Cloud. Consulta la guida rapida sull'integrazione ibrida - Passaggio 2: crea un progetto Google Cloud
```
export PROJECT_ID=your_project_ID
```
ANALYTICS_REGION: la regione in cui è in esecuzione il progetto GKE regione di analisi per la tua organizzazione. Consulta la guida rapida sull'ibrido - Passaggio 4: crea un'organizzazione
```
export ANALYTICS_REGION=your_analytics region
```
ORG_NAME: il nome della tua organizzazione. Deve corrispondere all'ID progetto Google Cloud. Consulta la guida rapida sull'ibrido - Passaggio 4: crea un'organizzazione
```
export ORG_NAME=your_organization_name
```
ENV_NAME: il nome del tuo ambiente ibrido. Consulta la guida rapida sull'ambiente hybrid - Passaggio 6: crea un gruppo di ambienti
```
export ENV_NAME=your_environment_name
```

Questo passaggio spiega come configurare l'ambiente shell e creare un cluster GKE nel progetto Google Cloud.

Configura la shell del terminale

Lo strumento gcloud fornisce l'interfaccia a riga di comando principale per Google Cloud, mentre kubectl fornisce l'interfaccia a riga di comando principale per l'esecuzione di comandi sui cluster Kubernetes.

Assicurati di avere installato gcloud e kubectl nella shell locale. Lo strumento gcloud fornisce l'interfaccia a riga di comando principale per Google Cloud, mentre kubectl fornisce l'interfaccia a riga di comando principale per l'esecuzione di comandi sui cluster Kubernetes.
```
gcloud -h
kubectl -h
```
Se non hai installato queste utilità, installale ora come segue:
1. Installa Cloud SDK, che include lo strumento a riga di comando gcloud.
2. Dopo aver installato Cloud SDK, installa lo strumento a riga di comando kubectl eseguendo il seguente comando:
Utilizza lo strumento gcloud per configurare due impostazioni predefinite: il progetto e la regione di calcolo predefiniti. La configurazione di queste impostazioni semplifica l'esecuzione dei comandi gcloud, poiché gcloud richiede di specificare il progetto e la regione di calcolo in cui vuoi lavorare.
Per elencare le impostazioni correnti, esegui il comando seguente:
```
gcloud config list
```
Se un progetto e/o una regione di calcolo non sono elencati, devi aggiungerli con i comandi indicati di seguito. Se, dall'output dell'elenco, stabilisci che devi modificare le impostazioni attuali per riflettere il progetto e la regione di calcolo, puoi anche utilizzare questi comandi:
```
gcloud config set project $PROJECT_ID
gcloud config set compute/region $ANALYTICS_REGION
```
Dove:
- PROJECT_ID è il nome del tuo progetto Google Cloud.
- ANALYTICS_REGION è il nome di una regione di calcolo Google Cloud

Crea un cluster GKE

In questo passaggio, creerai un cluster Kubernetes nel tuo progetto Google Cloud (il progetto impostato con il comando gcloud config rappresentato da PROJECT_ID).

Nota: il comando seguente presuppone che tu abbia impostato la configurazione gcloud per la regione di calcolo, come spiegato nei passaggi precedenti. Se non hai impostato la configurazione, dovrai aggiungere il parametro --region "compute-region" al comando.

Crea il cluster

Crea la variabile di ambiente CLUSTER_NAME con il seguente comando (facoltativo):
```
export CLUSTER_NAME=cluster-name
```
dove cluster-name è il nome che scegli per il cluster.
Esegui il seguente comando per creare il cluster. Il tipo di macchina, il numero di nodi e altre impostazioni specificate nel comando creano un cluster configurato in modo minimo, adatto per un'installazione di prova di Apigee hybrid.
Nota: le dimensioni del cluster che creerai in questo passaggio hanno una quantità minima di risorse adatte solo per la prova o i test. Per informazioni più dettagliate sui requisiti delle risorse del cluster per gli ambienti di produzione e non di produzione, consulta:
- Requisiti del cluster di produzione GKE
- Requisiti dei cluster GKE non di produzione
```
gcloud container clusters create $CLUSTER_NAME \
--machine-type "e2-standard-4" --num-nodes "4" --enable-autoscaling --min-nodes "3" --max-nodes "6"
```
La creazione del cluster può richiedere alcuni minuti. In caso di esito positivo, viene visualizzato un output simile al seguente, con stato RUNNING:
```
NAME           LOCATION       MASTER_VERSION  MASTER_IP     MACHINE_TYPE   NODE_VERSION   NUM_NODES  STATUS
apigee-hybrid  us-central1    1.15.12-gke.2   35.222.54.89  e2-standard-4  1.15.12-gke.2             RUNNING
```

Impostare il contesto corrente

Un contesto è un gruppo di parametri di accesso. Ogni contesto contiene un cluster Kubernetes, un utente e uno spazio dei nomi. Il contesto corrente è il cluster attualmente predefinito per kubectl: tutti i comandi kubectl vengono eseguiti su quel cluster.

Assicurati che il contesto gcloud corrente sia impostato sul cluster che hai appena creato.

Innanzitutto, elenca i contesti per determinare quale sia quello attuale. Nel seguente esempio, il contesto corrente è gke_hybrid-project_us-central1_apigee-hybrid. Il nome include il nome di un progetto Google Cloud (hybrid-project), di una regione (us-central1) e di un cluster (apigee-hybrid).

kubectl config get-contexts

I risultati dovrebbero essere simili a quelli dell'esempio seguente:

CURRENT   NAME                                             CLUSTER                                          AUTHINFO                                           NAMESPACE
*         gke_hybrid-project_us-central1_apigee-hybrid     gke_hybrid-project_us-central1_apigee-hybrid     gke_hybrid-project_us-central1_apigee-hybrid
          gke_apigee-project_us-west1_apigee-cluster       gke_apigee-project_us-west1_apigee-cluster       gke_apigee-project_us-west1_apigee-cluster

Se necessario, imposta il contesto corrente sul cluster appena creato (il cluster in cui intendi installare Apigee hybrid). Utilizzando l'output get-contexts precedente, puoi passare al contesto corretto nel seguente modo:
```
kubectl config use-context context
```
dove context è il nome completo del contesto per il cluster visualizzato dall'output del comando get-contexts precedente. Ad esempio: gke_apigee-project_us-west1_apigee-cluster.
Controlla il contesto corrente per assicurarti che sia impostato sul cluster previsto utilizzando il seguente comando:
```
kubectl config current-context
```
Ad esempio:
```
gke_apigee-project_us-west1_apigee-cluster
```

Concedi le credenziali del cluster

Le credenziali del cluster ti consentono di accedere ai container in esecuzione nel cluster. Recupera le tue credenziali e concedi a te stesso il ruolo cluster-admin:

Recupera le credenziali inserendo il seguente comando:
```
gcloud container clusters get-credentials $CLUSTER_NAME
```
dove CLUSTER_NAME è il nome del cluster che hai creato (il cluster in cui intendi installare Apigee Hybrid).

Dovresti visualizzare un risultato simile al seguente:
```
Fetching cluster endpoint and auth data.
kubeconfig entry generated for example-cluster.
```

Imposta l'associazione del ruolo del cluster. Esegui il seguente comando esattamente come mostrato:

kubectl create clusterrolebinding cluster-admin-binding \
--clusterrole cluster-admin --user $(gcloud config get-value account)

Dovresti visualizzare un risultato simile al seguente:

clusterrolebinding.rbac.authorization.k8s.io/cluster-admin-binding created

Riepilogo

Ora hai un cluster Kubernetes in esecuzione nel tuo progetto Google Cloud. L'ambiente shell è stato configurato e puoi installare i servizi cert-manager e istio richiesti da Apigee hybrid sulla tua macchina locale.

1 (AVANTI) Passaggio 2: installa cert-manager e ASM 3 4 5