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. Verifica con i seguenti comandi:

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

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

Questi passaggi utilizzano le seguenti variabili di ambiente:

PROJECT_ID: l'ID del tuo progetto Google Cloud. Vedi Ibrido Guida rapida - 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. Vedi Ibrido Guida rapida - 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. Vedi Ibrido Guida rapida - Passaggio 4: crea un'organizzazione
```
export ORG_NAME=your_organization_name
```
ENV_NAME: il nome del tuo ambiente ibrido. Vedi Ibrido Guida rapida - 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 tuo 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 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 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 esegui questo comando:
Usa lo strumento gcloud per configurare due impostazioni predefinite: project e regione di computing. 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 seguente comando:
```
gcloud config list
```
Se un progetto e/o una regione di computing non sono elencati, devi aggiungerli con illustrati di seguito. Se, dall'output dell'elenco, stabilisci che devi modificare le impostazioni attuali per riflettere il progetto e la regione di calcolo, puoi utilizzare anche 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 computing di 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

(Facoltativo) Crea la variabile di ambiente CLUSTER_NAME:
```
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 informazioni sui requisiti delle risorse cluster per la produzione e non di produzione ambienti, consulta:
- Requisiti per i 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. Se l'operazione riesce, genera un output simile al seguente, con stato di RUNNING, viene visualizzato:
```
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 attuale è il cluster attualmente predefinito kubectl: tutti i comandi kubectl vengono eseguiti sul 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. Nella nell'esempio seguente, il contesto attuale è 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 all'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 attuale sul cluster che hai 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. Per 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 il tuo credenziali e concediti 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 vedere 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. Il tuo ambiente shell è e sei pronto a installare i servizi cert-manager e istio richiesti dal Apigee hybrid sulla tua macchina locale.

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