Questa pagina è stata tradotta dall'API Cloud Translation.

Passaggio 1: crea un cluster GKE

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

Configura la shell del terminale

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

Assicurati di aver installato gcloud e kubectl nella shell locale. Lo strumento gcloud fornisce l'interfaccia a riga di comando principale per GCP, mentre kubectl fornisce l'interfaccia a riga di comando principale per l'esecuzione di comandi nei cluster Kubernetes.
```
gcloud -h
kubectl -h
```
Se non hai installato queste utilità, installale ora:
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 questo comando:
Utilizza lo strumento gcloud per configurare due impostazioni predefinite: il progetto e la regione di computing predefiniti. La configurazione di queste impostazioni semplifica l'esecuzione dei comandi gcloud, perché gcloud richiede di specificare il progetto e zona di computing in cui vuoi lavorare.
Per elencare le impostazioni correnti:
```
gcloud config list
```
Se un progetto e/o una zona di computing non sono elencati, devi aggiungerli con i comandi mostrati di seguito. Se dall'output dell'elenco determini che devi modificare le impostazioni attuali per riflettere il tuo progetto e la regione (o zona) di calcolo, puoi utilizzare anche questi comandi:
```
gcloud config set project project-id
gcloud config set compute/region compute-region
gcloud config set compute/zone compute-zone
```
dove project-id è il nome del tuo progetto GCP, compute-region è il nome di una regione di calcolo GCP e compute-zone è il nome di una zona di computinglo GCP. Ad esempio: compute/region us-central1. Per un elenco delle regioni e delle zone di calcolo, consulta Regioni e zone disponibili.

Crea un cluster GKE

In questo passaggio creerai un cluster Kubernetes nel tuo progetto GCP (il progetto che hai impostato con il comando gcloud config).

NOTA:il seguente comando presuppone che tu abbia impostato la configurazione gcloud per la regione e/o la zona di calcolo, come spiegato nei passaggi precedenti. Se non hai impostato la configurazione, devi aggiungere il parametro --region "compute-region" e/o --zone "compute-zone" al comando.

Esegui questo 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 minimale adatto a un'installazione di prova di Apigee hybrid.

gcloud container clusters create cluster-name \
--machine-type "n1-standard-4" --num-nodes "3" --enable-autoscaling --min-nodes "3" --max-nodes "6"

Dove cluster-name è il nome che scegli per il cluster.

La creazione del cluster può richiedere alcuni minuti. In caso di esito positivo, vedrai un output simile al seguente con lo stato RUNNING:

NAME           LOCATION       MASTER_VERSION  MASTER_IP     MACHINE_TYPE   NODE_VERSION   NUM_NODES  STATUS
apigee-hybrid  us-central1-a  1.14.10-gke.27   35.222.54.89  n1-standard-4  1.14.10-gke.27          RUNNING

Imposta il contesto attuale

Un contesto è un gruppo di parametri di accesso. Ogni contesto contiene un cluster Kubernetes, un utente e uno spazio dei nomi. Il contesto attuale è 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 qual è quello attuale. Nell'esempio seguente, il contesto attuale è gke_hybrid-project_us-central1-a_apigee-hybrid. Il nome include il nome di un progetto GCP (hybrid-project), una regione o una zona (us-central1-a) e un nome cluster (apigee-hybrid):

kubectl config get-contexts
CURRENT   NAME                                             CLUSTER                                          AUTHINFO                                           NAMESPACE
*         gke_hybrid-project_us-central1-a_apigee-hybrid   gke_hybrid-project_us-central1-a_apigee-hybrid   gke_hybrid-project_us-central1-a_apigee-hybrid
          gke_apigee-project_us-west1-a_apigee-cluster     gke_apigee-project_us-west1-a_apigee-cluster     gke_apigee-project_us-west1-a_apigee-cluster

Se necessario, imposta il contesto corrente sul cluster che hai appena creato (il cluster in cui intendi installare Apigee hybrid). Supponendo l'output get-contexts precedente, se il nome del cluster creato fosse apigee-cluster nella regione us-west1, passeresti al contesto gke_apigee-project_us-west1-a_apigee-cluster, come segue:
```
kubectl config use-context gke_apigee-project_us-west1-a_apigee-cluster
```
dove gke_apigee-project_us-west1-a_apigee-cluster è il nome del contesto a cui passare.
Controlla il contesto attuale per assicurarti che sia impostato sul cluster previsto. Ad esempio:
```
kubectl config current-context
 gke_apigee-project_us-west1-a_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 concediti il ruolo cluster-admin:

Recupera le credenziali:
```
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).

Imposta l'associazione di ruoli cluster. Esegui questo comando esattamente come mostrato:

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

Riepilogo

Ora hai un cluster Kubernetes in esecuzione nel tuo progetto GCP. L'ambiente shell è configurato e puoi installare il software del piano di runtime Apigee hybrid sulla tua macchina locale.

1 (NEXT) Step 2: Install apigeectl 3 4