Passaggio 1: crea un cluster GKE

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

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.

  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 fornisce l'interfaccia a riga di comando principale per l'esecuzione di 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 esegui questo comando:
    3. gcloud components install kubectl
  3. 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 zona di calcolo 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 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 impostato con il comando gcloud config).

Esegui questo comando per creare il cluster. il tipo di macchina, il numero di nodi le altre impostazioni specificate nel comando creano un cluster con configurazioni minime adatte di un'installazione ibrida di prova di Apigee:

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.13.11-gke.9   35.222.54.89  n1-standard-4  1.13.11-gke.9  3          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 attuale di gcloud sia impostato sul cluster che hai appena creato.

  1. Innanzitutto, elenca i contesti per determinare qual è il contesto attuale. Nel seguente esempio, il contesto corrente è gke_hybrid-project_us-central1-a_apigee-hybrid. Il nome include il nome di un progetto Google Cloud (hybrid-project), di una regione o di una zona (us-central1-a) e 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). Presumendo l'output get-contexts precedente, Se il nome del cluster che hai creato fosse apigee-cluster nella regione us-west1, passerai alla 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 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:

  1. Recupera le credenziali:
    gcloud container clusters get-credentials cluster-name

    Dove cluster-name è il nome del cluster che hai creato (il in cui intendi 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 hai un cluster Kubernetes in esecuzione nel tuo progetto Google Cloud. Il tuo ambiente shell è e puoi installare il software del piano di runtime ibrido Apigee sul tuo computer locale.

1 (AVANTI) Passaggio 2: installa apigeectl 3 4