Passaggio 1: crea un cluster GKE

Stai visualizzando la versione 1.2 della documentazione di Apigee hybrid. This version is end of life. You should upgrade to a newer version. Per maggiori informazioni, vedi Versioni supportate.

Version 1.2 (unsupported)

Versioni supportate:

• v1.12 (più recente)                        
• v1.11                         
• v1.10                                        
• Elenco delle versioni supportate

Versioni non supportate:

• v1.9                                         
• v1.8                                         
• v1.7                                         
• v1.6                                         
• v1.5                                         
• v1.4                                         
• v1.3                                         
• v1.2                                         
• v1.1                                         

UPGRADING: se stai eseguendo l'upgrade dalla v1.1.x alla v1.2.0, consulta Upgrade di Apigee hybrid per le istruzioni. Se stai eseguendo una nuova installazione, continua con le configurazioni descritte di seguito.

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

Configura la shell del terminale

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

1. 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 offre l'interfaccia a riga di comando principale per eseguire comandi sui cluster Kubernetes.

   gcloud -h
   kubectl -h

2. 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:

   gcloud components install kubectl

3. Utilizza lo strumento gcloud per configurare due impostazioni predefinite: il progetto predefinito e la regione di computing. 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 attuali:

   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 cambiare le impostazioni attuali per riflettere il progetto e la regione (o zona di calcolo), 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 tuo progetto Google Cloud, compute-region è il nome di una regione di computing Google Cloud e compute-zone è il nome di una zona di computing Google Cloud. Ad esempio: compute/region us-central1. Per un elenco di regioni e zone di computing, vedi Regioni e zone disponibili.

crea un cluster GKE

Nota: Apigee non supporta GKE Sandbox o gVisor.

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 gcloud per la regione e/o la zona di computing, come spiegato nei passaggi precedenti. Se non hai impostato la configurazione, dovrai aggiungere i parametri --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 con configurazione minima, adatto a un'installazione ibrida di prova di Apigee.

Ti consigliamo di controllare la versione predefinita di Kubernetes e assicurarti che soddisfi i requisiti di versione elencati in Piattaforme supportate. Per determinare quale versione di Kubernetes è quella predefinita, utilizza questo comando:

gcloud container get-server-config

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

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 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 attuale di gcloud sia impostato sul cluster che hai appena creato.

1. Innanzitutto, elenca i contesti per determinare qual è il contesto attuale. 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
   
   

2. Se necessario, imposta il contesto attuale sul cluster che hai appena creato (il cluster in cui intendi installare Apigee hybrid). Presupponendo l'output get-contexts precedente, se il nome del cluster che hai creato fosse apigee-cluster nella regione us-west1, passerai 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.

3. 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:

1. Recupera le credenziali:

   gcloud container clusters get-credentials cluster-name

   Dove cluster-name è il nome del cluster che hai creato (il cluster in cui vuoi installare Apigee hybrid).

2. 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 nel tuo progetto Google Cloud è in esecuzione un cluster Kubernetes. Il tuo ambiente shell è configurato e puoi installare il software del piano di runtime ibrido Apigee sulla tua macchina locale.

1 (AVANTI) Passaggio 2: installa apigeectl 3 4