Voraussetzungen für die Kubernetes-Integration

<ph type="x-smartling-placeholder"></ph> Sie sehen die Dokumentation zu Apigee Edge.
Gehen Sie zur Apigee X-Dokumentation.
Weitere Informationen

In diesem Artikel werden die Schritte beschrieben, die Sie vor der Installation ausführen müssen. Edge Microgateway als Dienst in einem Kubernetes-Cluster

In diesem Thema werden folgende Themen behandelt:

  • Die Mindestanforderungen für Ihren Kubernetes-Cluster.
  • Edge Microgateway installieren und konfigurieren
  • So installieren Sie die Basiskonfiguration von Edge Microgateway in Kubernetes Cluster.

Anforderungen an den Kubernetes-Cluster

Für Ihren Kubernetes-Cluster ist Folgendes erforderlich:

  • Kubernetes-Version 1.9 oder höher.
  • Kubernetes CLI kubectl v1.9 oder höher.
  • Ein Cluster mit mindestens 3 Knoten mit jeweils 2 vCPUs.

Beispiel: Kubernetes-Cluster in der Google Kubernetes Engine (GKE) erstellen

Kubernetes-Verwaltungscomputer einrichten

Die Kubernetes-Verwaltungsmaschine ist Ihr lokaler Computer, mit dem Sie die Datei ausführen. für Ihren Kubernetes-Cluster ausführen. Dieser Computer ist normalerweise ein Desktop-Computer. die Zugriff auf Ihre Kubernetes-VMs hat.

Sie müssen die folgenden Dienstprogramme in der Kubernetes-Verwaltung installieren Computer:

  • Installieren Sie den kubectl-Befehl. Line Interface 1.9 oder höher.

  • (Nur GKE) Installieren Sie gcloud, wenn Sie Kubernetes in GKE ausführen.

Kubernetes-Cluster in GKE erstellen

  1. Im Google Kubernetes Engine-Dashboard (GKE) auf Google anmelden Cloud Platform (GCP) verfügbar.
  2. Klicken Sie auf Cluster erstellen.
  3. Wählen Sie Standardcluster aus.
  4. Geben Sie einen Namen für den Cluster ein.
  5. Wählen Sie eine Zone aus.
  6. Wählen Sie „Cluster Version 1.9.7-gke-*“ aus. z. B. 1.9.7-gke.6.
  7. Wählen Sie eine Größe von 3 Knoten aus.
  8. Wählen Sie 2 vCPUs mit 7,5 GB Arbeitsspeicher aus.
  9. Klicken Sie auf Erstellen.

    Der folgende Screenshot zeigt das GKE-Dashboard, das wie in den Vorherige Schritte:

    GKE-Dashboard

Clusteranmeldedaten abrufen

  1. Legen Sie den Namen Ihres GKE-Projekts fest:

    gcloud config set project projectName
  2. Legen Sie die Zone Ihres GKE-Projekts fest:

    gcloud config set compute/zone zoneName
  3. Rufen Sie Ihre gcloud-Containeranmeldedaten ab:

    gcloud container clusters get-credentials cluster-name --zone zone --project project-name

    Dabei gilt:

    • cluster-name ist der Name des von Ihnen erstellten Kubernetes-Clusters.
    • zone ist die Zone, in der sich der Cluster befindet.
    • project-name ist der Name Ihres GCP-Projekts.

    Beispiel:

    gcloud container clusters get-credentials edgemicrogateway-cluster --zone us-central1-a --project edgemicro-project
  4. Führen Sie den folgenden Befehl genau wie gezeigt aus. Der Befehl gewährt Cluster Administratorberechtigungen für den aktuellen Nutzer. Administratorberechtigungen sind erforderlich, um Erstellen Sie die erforderlichen RBAC-Regeln für den Edge Microgateway-Dienst:

    kubectl create clusterrolebinding cluster-admin-binding --clusterrole=cluster-admin --user=$(gcloud config get-value core/account)
    

Edge Microgateway für Kubernetes installieren

  1. Edge Microgateway für Kubernetes herunterladen Unter macOS oder Linux können Sie die neueste Version oder eine bestimmte Version herunterladen, indem Sie den Versionsnamen.

    So laden Sie die neueste Version herunter:

    curl -L https://raw.githubusercontent.com/apigee-internal/microgateway/master/kubernetes/release/downloadEdgeMicrok8s.sh | sh -

    So rufen Sie eine bestimmte Version nach Versionsnummer ab: Beachten Sie, dass die Versionsnummer dem Buchstaben „v“ vorangestellt werden. Beispiel: v3.0.2

    curl -L https://raw.githubusercontent.com/apigee-internal/microgateway/master/kubernetes/release/downloadEdgeMicrok8s.sh | sh -s  version

    Beispiel:

    curl -L https://raw.githubusercontent.com/apigee-internal/microgateway/master/kubernetes/release/downloadEdgeMicrok8s.sh | sh -s v3.0.2
  2. Ändern Sie das Verzeichnis in das Installationsverzeichnis microgateway_Version_OS_ARCH. Beispiel:

    cd microgateway_2.5.26_Darwin_x86_64
  3. Untersuchen Sie das Installationsverzeichnis:

    • /install/kubernetes – Konfigurationsdateien des Typs .yaml für die Bereitstellung Kubernetes
    • /samples: Beispielanwendungen zum Testen Ihrer Installation.
    • /bin: die ausführbare Datei edgemicroctl. Das edgemicroctl Befehl fügt Edge Microgateway in Kubernetes ein
  4. Fügen Sie den edgemicroctl-Client zu PATH hinzu. Führen Sie beispielsweise folgenden Befehl aus: -Befehl auf einem MacOS- oder Linux-System:

    export PATH=$PWD/bin:$PATH
  5. Wenden Sie die Basiseinrichtung von Edge Microgateway auf den Kubernetes-Cluster an. Die folgenden -Befehl einen edgemicro-system-Namespace und Clusterrollen erstellt.

    kubectl apply -f install/kubernetes/edgemicro.yaml
  6. NGINX-Ingress-Controller im Cluster installieren Achten Sie darauf, dass keine anderen Nginix-Controller wird ausgeführt. Das können Sie prüfen, indem Sie kubectl get pods ausführen.

    kubectl apply -f install/kubernetes/edgemicro-nginx-gke.yaml

Installation überprüfen

  1. Führen Sie den folgenden Befehl aus, um zu prüfen, ob der Ingress-Controller gestartet wurde:

    kubectl get pods --all-namespaces -l app=edgemicro-ingress --watch

    Wie die folgende Beispielausgabe zeigt, dauert es ein bis zwei Minuten, bis die um Prozesse zu starten. Es ist normal, dass mehrere Fehler- und Neustartzyklen angezeigt werden. bevor sich STATUS zu Running ändert.

    NAMESPACE          NAME                                            READY     STATUS             RESTARTS   AGE
    edgemicro-system   edgemicro-ingress-controller-64444469bf-wjhrn   0/1       CrashLoopBackOff   1          33s
    edgemicro-system   edgemicro-ingress-controller-64444469bf-wjhrn   0/1       Error              2          33s
    edgemicro-system   edgemicro-ingress-controller-64444469bf-wjhrn   0/1       CrashLoopBackOff   2          40s
    edgemicro-system   edgemicro-ingress-controller-64444469bf-wjhrn   0/1       Running            3          1m
    edgemicro-system   edgemicro-ingress-controller-64444469bf-wjhrn   1/1       Running            3          1m
    
  2. Sobald das Ingress ausgeführt wird, können Sie den obigen Befehl abbrechen, indem Sie Ctrl+C

  3. Führen Sie diesen Befehl aus, um zu prüfen, ob die Kubernetes-Dienste bereitgestellt wurden. Sie sollten Die Ausgabe ähnelt der unten gezeigten Beispielausgabe:

    kubectl get svc -n edgemicro-system
    

    Beispielausgabe:

    NAME                        TYPE           CLUSTER-IP     EXTERNAL-IP    PORT(S)                     AGE
    default-http-backend        ClusterIP      10.19.255.106  <none>         80/TCP                       2h
    edgemicro-ingress           LoadBalancer   10.19.247.156  35.224.24.13   80:30176/TCP,443:32325/TCP   2h
    
  4. Prüfen Sie, ob alle Pods ausgeführt werden:

    kubectl get pods -n edgemicro-system
    

    Beispielausgabe:

    NAME                                            READY     STATUS    RESTARTS   AGE
    default-http-backend-55c6c69b88-2lvtw           1/1       Running   0          4m
    edgemicro-ingress-controller-64444469bf-wjhrn   1/1       Running   3          4m
    

Edge Microgateway installieren

  1. Sie müssen mindestens Edge Microgateway 2.5.26 installiert haben. Das können Sie prüfen, indem Sie Folgendes eingeben:

    edgemicro --version
  2. Wenn Edge Microgateway 2.5.26 oder höher nicht installiert ist, führen Sie die Installation aus Skript:

    npm install edgemicro -g
  3. Wenn Sie Edge Microgateway gerade zum ersten Mal installiert oder aktualisiert haben, führen Sie den folgenden Befehl aus:

    edgemicro init

    Weitere Hilfe finden Sie unter Edge Microgateway installieren.

Nächster Schritt

Jetzt können Sie Edge Microgateway auf Kubernetes bereitstellen.