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 (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 che gcloud e kubectl siano installati in shell locale. Lo strumento gcloud offre l'interfaccia a riga di comando principale per Google Cloud e kubectl offre l'interfaccia a riga di comando principale dei comandi sui 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 esegui questo 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, perché gcloud richiede di specificare il progetto e la 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 illustrati di seguito. Se dall'output dell'elenco viene stabilito che è necessario cambiare le impostazioni correnti in base al progetto e alla regione (o zona di computing), puoi anche utilizzare 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 progetto Google Cloud, compute-region è il nome di una regione di calcolo Google Cloud e compute-zone è il nome di una zona di calcolo Google Cloud. 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 Google Cloud (il progetto che hai impostato con il comando gcloud config).

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

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.

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. Se l'operazione riesce, vedrai un output simile a quanto segue con 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 kubectl: tutti i comandi kubectl vengono eseguiti sul cluster.

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

Innanzitutto, elenca i contesti per determinare qual è il contesto attuale. Nella nell'esempio seguente, il contesto attuale è gke_hybrid-project_us-central1-a_apigee-hybrid. Il nome include il nome di un progetto Google Cloud (hybrid-project), una regione o una zona (us-central1-a) e il nome di un 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 attuale 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 che hai 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 corrente 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 concedi a te stesso 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 del ruolo del 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 Google Cloud. L'ambiente shell è stato configurato e puoi installare il software del piano di runtime Apigee Hybrid sulla tua macchina locale.

1 (AVANTI) Passaggio 2: installa apigeectl 3 4