Schritt 1: GKE-Cluster erstellen

In diesem Schritt wird erläutert, wie Sie Ihre Shell-Umgebung einrichten und einen GKE-Cluster in Ihrem GCP-Projekt (Google Cloud Platform) erstellen.

Terminal-Shell einrichten

Das gcloud-Tool ist die primäre Befehlszeile für die GCP und kubectl die primäre Befehlszeile zum Ausführen von Befehlen für Kubernetes-Cluster.

  1. Achten Sie darauf, dass gcloud und kubectl in Ihrer lokalen Shell installiert sind. Das gcloud-Tool ist die primäre Befehlszeile für die GCP und kubectl die primäre Befehlszeile zum Ausführen von Befehlen für Kubernetes-Cluster.

    gcloud -h
    kubectl -h
  2. Wenn diese Dienstprogramme nicht installiert sind, installieren Sie sie jetzt:
    1. Installieren Sie das Cloud SDK. Das gcloud-Befehlszeilentool ist dort enthalten.
    2. Installieren Sie nach der Installation des Cloud SDK das kubectl-Befehlszeilentool mit folgendem Befehl:
    3. gcloud components install kubectl
  3. Mit dem gcloud-Tool können Sie zwei Standardeinstellungen konfigurieren: Ihr Standardprojekt und die Computing-Region. Wenn Sie diese Einstellungen konfigurieren, erleichtert dies die Ausführung von gcloud-Befehlen, da Sie für gcloud das Projekt und die Computing-Zone angeben müssen, in denen Sie arbeiten möchten.

    So listen Sie die aktuellen Einstellungen auf:

    gcloud config list

    Wenn ein Projekt und/oder eine Computing-Zone nicht aufgeführt ist, müssen Sie diese mit den unten aufgeführten Befehlen hinzufügen. Wenn Sie in der Listenausgabe feststellen, dass Sie die aktuellen Einstellungen entsprechend Ihrem Projekt und Ihrer Computing-Region (oder -Zone) ändern müssen, können Sie auch diese Befehle verwenden:

    gcloud config set project project-id
    gcloud config set compute/region compute-region
    gcloud config set compute/zone compute-zone
    

    Dabei ist project-id der Name Ihres GCP-Projekts, compute-region der Name einer GCP-Computing-Region und compute-zone der Name einer GCP-Computing-Zone. Beispiel: compute/region us-central1. Eine Liste der Computing-Regionen und -Zonen finden Sie unter Verfügbare Regionen und Zonen.

GKE-Cluster erstellen

In diesem Schritt erstellen Sie einen Kubernetes-Cluster in Ihrem GCP-Projekt (dem Projekt, das Sie mit dem Befehl gcloud config festgelegt haben).

Führen Sie den folgenden Befehl aus, um den Cluster zu erstellen. Der im Befehl angegebene Maschinentyp, die Anzahl der Knoten und andere Einstellungen erstellen einen minimal konfigurierten Cluster, der sich für eine Apigee Hybrid-Testinstallation eignet.

gcloud container clusters create cluster-name \
--machine-type "n1-standard-4" --num-nodes "3" --enable-autoscaling --min-nodes "3" --max-nodes "6"

Dabei steht cluster-name für den Namen, den Sie für den Cluster auswählen.

Die Erstellung eines Clusters kann einige Minuten dauern. Bei Erfolg wird eine Ausgabe wie die folgende mit dem Status RUNNING angezeigt:

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

Aktuellen Kontext festlegen

Ein Kontext ist eine Gruppe von Zugriffsparametern. Jeder Kontext enthält einen Kubernetes-Cluster, einen Nutzer und einen Namespace. Der aktuelle Kontext ist der Cluster, der derzeit als Standard für kubectl gilt: alle kubectl-Befehle werden für diesen Cluster ausgeführt.

Achten Sie darauf, dass der aktuelle Kontext gcloud auf den soeben erstellten Cluster eingestellt ist.

  1. Listen Sie zuerst die Kontexte auf, um den aktuellen Kontext zu ermitteln. Im folgenden Beispiel lautet der aktuelle Kontext gke_hybrid-project_us-central1-a_apigee-hybrid. Der Name enthält den Namen eines GCP-Projekts (hybrid-project), eine Region oder Zone (us-central1-a) und einen Clusternamen (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. Legen Sie gegebenenfalls den aktuellen Kontext auf den soeben erstellten Cluster fest (den Cluster, in dem Sie Apigee Hybrid installieren möchten). Wenn nach der vorherigen Ausgabe get-contexts der von Ihnen erstellte Clustername apigee-cluster in der Region us-west1 lautet, wechseln Sie so zum Kontext gke_apigee-project_us-west1-a_apigee-cluster:
    kubectl config use-context gke_apigee-project_us-west1-a_apigee-cluster

    Dabei ist gke_apigee-project_us-west1-a_apigee-cluster der Name des Kontexts, zu dem gewechselt wird.

  3. Prüfen Sie, ob der aktuellen Kontext auf den gewünschten Cluster eingestellt ist. Beispiel:
    kubectl config current-context
     gke_apigee-project_us-west1-a_apigee-cluster

Clusteranmeldedaten zuweisen

Clusteranmeldedaten gewähren Ihnen Zugriff auf die Container, die im Cluster ausgeführt werden. Rufen Sie Ihre Anmeldedaten ab und gewähren Sie sich selbst die Rolle cluster-admin:

  1. Rufen Sie die Anmeldedaten ab:
    gcloud container clusters get-credentials cluster-name

    Dabei ist cluster-name der Name des von Ihnen erstellten Clusters (der Cluster, in dem Sie Apigee Hybrid installieren möchten).

  2. Legen Sie die Bindung der Clusterrolle fest. Führen Sie diesen Befehl genau so aus:
    kubectl create clusterrolebinding cluster-admin-binding \
    --clusterrole cluster-admin --user $(gcloud config get-value account)

Fazit

Sie haben jetzt einen Kubernetes-Cluster in Ihrem GCP-Projekt ausgeführt. Ihre Shell-Umgebung ist eingerichtet und Sie können die Apigee Hybrid-Software auf Laufzeitebene auf Ihrem lokalen Rechner installieren.

1 (WEITER): Schritt 2: Apigeectl installieren 3 4