Questa pagina è stata tradotta dall'API Cloud Translation.

Passaggio 1: creazione di un cluster

Prima di iniziare:

Questi passaggi presuppongono che tu abbia creato 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.

In questi passaggi vengono utilizzate 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 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.

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 nel seguente modo:
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, perché gcloud richiede che specifichi il progetto e la regione di computing in cui vuoi lavorare.
Per elencare le impostazioni attuali, esegui questo 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 viene stabilito che è necessario cambiare le impostazioni correnti in base al progetto e alla regione di computing, puoi anche usare 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 che hai impostato con il comando gcloud config rappresentato da PROJECT_ID).

Nota: il seguente comando presuppone che tu abbia impostato la configurazione di gcloud per l'area di computing, come spiegato nei passaggi precedenti. Se non hai impostato la configurazione, è necessario per aggiungere il parametro --region "compute-region" al comando.

Nota: ti consigliamo di controllare la versione predefinita di Kubernetes e assicurarti che soddisfi la versione I requisiti elencati in Piattaforme supportate. Per determinare quale versione di Kubernetes è quella predefinita, utilizza il seguente comando:

gcloud container get-server-config

Se non vuoi utilizzare il flag predefinito, puoi aggiungere il flag --cluster-version al cluster comando di creazione. Per maggiori dettagli, consulta gcloud container clusters create.

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 questo comando per creare il cluster. il tipo di macchina, il numero di nodi altre impostazioni specificate nel comando creano un cluster con configurazioni minime adatte di un'installazione ibrida di prova di Apigee.
Nota: le dimensioni del cluster che creerai in questo ha una quantità minima di risorse adatte solo per le prove 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 per i cluster non di produzione GKE
```
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
```

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_apigee-hybrid. Il nome include il nome di un progetto Google Cloud (hybrid-project), una regione (us-central1) e il nome 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). Stai usando la versione precedente di get-contexts puoi passare al contesto corretto, come segue:
```
kubectl config use-context context
```
Dove context è il nome contesto completo per il cluster come output dal comando get-contexts precedente. Per esempio: gke_apigee-project_us-west1_apigee-cluster.
Controlla il contesto attuale per assicurarti che sia impostato sul cluster previsto utilizzando il comando seguente:
```
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 questo comando:
```
gcloud container clusters get-credentials $CLUSTER_NAME
```
Dove CLUSTER_NAME è il nome del cluster che (il cluster in cui vuoi installare Apigee hybrid).

Dovresti vedere 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 questo 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