Schritt 1: Cluster erstellen

Hinweis

Bei diesen Schritten wird davon ausgegangen, dass Sie in den vorherigen Schritten Umgebungsvariablen erstellt haben. Prüfen Sie diese mit den folgenden Befehlen:

echo $PROJECT_ID
echo $CLUSTER_LOCATION
echo $ORG_NAME
echo $ENV_NAME

Im Folgenden wird beschrieben, wie Sie den Cluster einrichten, in dem Sie Apigee Hybrid ausführen. Die Anleitungen variieren je nach Plattform, auf der Sie Hybrid ausführen. Wählen Sie eine Plattform aus, um auf die Anleitungen zuzugreifen:

GKE

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

Cluster erstellen

  1. Legen Sie Ihre Anforderungen für den Apigee Hybrid-Cluster fest. Es gelten folgende Mindestkonfigurationen für Ihren Cluster:
    Konfiguration Zustandsorientierter Knotenpool Zustandsloser Knotenpool
    Anzahl der Knoten 3 (pro Region) 3 (pro Region)
    CPU 4 4
    RAM 15 15
    Name des Standardlabels Apigee-Daten Apigee-Laufzeit
    Speicher dynamic Verwaltet mit der ApigeeDeployment-CRD

    Weitere Informationen zur Mindestclusterkonfiguration finden Sie unter Minimale Clusterkonfigurationen.

  2. Prüfen Sie die GKE-Version, die von dieser Version der Hybrid-Version 1.6.9 unterstützt wird:
  3. Erstellen Sie mit der folgenden Anleitung einen regionalen Cluster mit mindestens sechs Knoten:
    • Regionale Cluster erstellen.
  4. Erstellen Sie mindestens zwei Knotenpools für Ihren Cluster. Es gelten folgende Mindestanforderungen für Knotenpools:
    Name des Standardknotenpools Beschreibung Mindestanzahl an Knoten Mindestanzahl an CPUs pro Knotenpool Mindestanzahl an CPUs pro Knoten
    apigee-data Ein zustandsorientierter Knotenpool. 3 4 4/Anzahl der Knoten im Pool
    apigee-runtime Ein zustandsloser Knotenpool. 3 4 4/Anzahl der Knoten im Pool

    Folgen Sie der Anleitung unter Knotenpools hinzufügen und verwalten.

    Weitere Informationen zur Konfiguration von Knotenpools finden Sie unter Dedizierte Knotenpools konfigurieren.

  5. Nach dem Erstellen des Clusters aktivieren Sie mit dem folgenden Befehl Workload Identity auf dem Cluster:
    gcloud container clusters update ${CLUSTER_NAME} \
      --workload-pool=$PROJECT_ID.svc.id.goog \
      --region ${CLUSTER_LOCATION}

    Weitere Informationen finden Sie unter Workload Identity in einem Cluster aktivieren.

  6. Rufen Sie mit dem folgenden Befehl die Anmeldedaten gcloud des soeben erstellten Clusters ab:
    gcloud container clusters get-credentials ${CLUSTER_NAME} \
      --region ${CLUSTER_LOCATION} \
      --project ${PROJECT_ID}

Nachdem Sie einen Cluster installiert haben und dieser ausgeführt wird, fahren Sie mit dem nächsten Schritt fort.

GKE On-Prem

Cluster erstellen

  1. Legen Sie die Clusteranforderungen für den Apigee Hybrid-Cluster fest:
    • Die Mindestkonfigurationen für einen Cluster sind:
      Konfiguration Zustandsorientierter Knotenpool Zustandsloser Knotenpool
      Anzahl der Knoten 3 (pro Region) 3 (pro Region)
      CPU 4 4
      RAM 15 15
      Name des Standardlabels Apigee-Daten Apigee-Laufzeit
      Speicher dynamic Verwaltet mit der ApigeeDeployment-CRD

      Weitere Informationen zur minimalen Clusterkonfiguration finden Sie unter Minimale Clusterkonfigurationen.

    • Erstellen Sie mindestens zwei Knotenpools:
      Name des Standardknotenpools Beschreibung
      apigee-data Ein zustandsorientierter Knotenpool.
      apigee-runtime Ein zustandsloser Knotenpool.

      Weitere Informationen zur Konfiguration von Knotenpools finden Sie unter Dedizierte Knotenpools konfigurieren.

  2. Prüfen Sie die GKE-Version, die von dieser Version der Hybrid-Version 1.6.9 unterstützt wird:
  3. So erstellen Sie einen Nutzercluster:

Nachdem Sie einen Cluster installiert haben und dieser ausgeführt wird, fahren Sie mit dem nächsten Schritt fort.

Anthos on Bare Metal

Anforderungen und Voraussetzungen

Mit Anthos-Clustern auf Bare-Metal-Servern können Sie Kubernetes-Cluster direkt auf Ihren eigenen Maschinenressourcen ausführen.

Sehen Sie sich die folgenden Anforderungen und Voraussetzungen an:

Cluster erstellen

  1. Legen Sie die Clusteranforderungen für den Apigee Hybrid-Cluster fest:
    • Die Mindestkonfigurationen für einen Cluster sind:
      Konfiguration Zustandsorientierter Knotenpool Zustandsloser Knotenpool
      Anzahl der Knoten 3 (pro Region) 3 (pro Region)
      CPU 4 4
      RAM 15 15
      Name des Standardlabels Apigee-Daten Apigee-Laufzeit
      Speicher dynamic Verwaltet mit der ApigeeDeployment-CRD

      Weitere Informationen zur minimalen Clusterkonfiguration finden Sie unter Minimale Clusterkonfigurationen.

    • Erstellen Sie mindestens zwei Knotenpools:
      Name des Standardknotenpools Beschreibung
      apigee-data Ein zustandsorientierter Knotenpool.
      apigee-runtime Ein zustandsloser Knotenpool.

      Weitere Informationen zur Konfiguration von Knotenpools finden Sie unter Dedizierte Knotenpools konfigurieren.

  2. Prüfen Sie die GKE-Version, die von dieser Version der Hybrid-Version 1.6.9 unterstützt wird:
  3. Verwenden Sie die folgende Anleitung in der Anthos-Cluster auf Bare Metal-Dokumentation, um einen Nutzercluster zu erstellen:

Nachdem Sie einen Cluster installiert haben und dieser ausgeführt wird, fahren Sie mit dem nächsten Schritt fort.

AKS

AKS-Cluster erstellen

  1. Legen Sie die Clusteranforderungen für den Apigee Hybrid-Cluster fest:
    • Die Mindestkonfigurationen für einen Cluster sind:
      Konfiguration Zustandsorientierter Knotenpool Zustandsloser Knotenpool
      Anzahl der Knoten 3 (pro Region) 3 (pro Region)
      CPU 4 4
      RAM 15 15
      Name des Standardlabels Apigee-Daten Apigee-Laufzeit
      Speicher dynamic Verwaltet mit der ApigeeDeployment-CRD

      Weitere Informationen zur minimalen Clusterkonfiguration finden Sie unter Minimale Clusterkonfigurationen.

    • Erstellen Sie mindestens zwei Knotenpools:
      Name des Standardknotenpools Beschreibung
      apigee-data Ein zustandsorientierter Knotenpool.
      apigee-runtime Ein zustandsloser Knotenpool.

      Weitere Informationen zur Konfiguration von Knotenpools finden Sie unter Dedizierte Knotenpools konfigurieren.

  2. Prüfen Sie die AKS-Version, die von dieser Version der Hybrid-Version 1.6.9 unterstützt wird:
  3. Verwenden Sie einen der folgenden Anleitungen zum Erstellen eines Clusters:

EKS

Cluster erstellen

  1. Legen Sie die Clusteranforderungen für den Apigee Hybrid-Cluster fest:
    • Die Mindestkonfigurationen für einen Cluster sind:
      Konfiguration Zustandsorientierter Knotenpool Zustandsloser Knotenpool
      Anzahl der Knoten 3 (pro Region) 3 (pro Region)
      CPU 4 4
      RAM 15 15
      Name des Standardlabels Apigee-Daten Apigee-Laufzeit
      Speicher dynamic Verwaltet mit der ApigeeDeployment-CRD

      Weitere Informationen zur minimalen Clusterkonfiguration finden Sie unter Minimale Clusterkonfigurationen.

    • Erstellen Sie mindestens zwei Knotenpools:
      Name des Standardknotenpools Beschreibung
      apigee-data Ein zustandsorientierter Knotenpool.
      apigee-runtime Ein zustandsloser Knotenpool.

      Weitere Informationen zur Konfiguration von Knotenpools finden Sie unter Dedizierte Knotenpools konfigurieren.

  2. Prüfen Sie die EKS-Version, die von dieser Version der Hybrid-Version 1.6.9 unterstützt wird:
  3. So erstellen Sie einen Nutzercluster:

Nachdem Sie einen Cluster installiert haben und dieser ausgeführt wird, fahren Sie mit dem nächsten Schritt fort.

GKE on AWS

Cluster erstellen

  1. Legen Sie die Clusteranforderungen für den Apigee Hybrid-Cluster fest:
    • Die Mindestkonfigurationen für einen Cluster sind:
      Konfiguration Zustandsorientierter Knotenpool Zustandsloser Knotenpool
      Anzahl der Knoten 3 (pro Region) 3 (pro Region)
      CPU 4 4
      RAM 15 15
      Name des Standardlabels Apigee-Daten Apigee-Laufzeit
      Speicher dynamic Verwaltet mit der ApigeeDeployment-CRD

      Weitere Informationen zur minimalen Clusterkonfiguration finden Sie unter Minimale Clusterkonfigurationen.

    • Erstellen Sie mindestens zwei Knotenpools:
      Name des Standardknotenpools Beschreibung
      apigee-data Ein zustandsorientierter Knotenpool.
      apigee-runtime Ein zustandsloser Knotenpool.

      Weitere Informationen zur Konfiguration von Knotenpools finden Sie unter Dedizierte Knotenpools konfigurieren.

  2. Prüfen Sie die GKE-Version, die von dieser Version der Hybrid-Version 1.6.9 unterstützt wird:
  3. So erstellen Sie einen Nutzercluster:

Nachdem Sie einen Cluster installiert haben und dieser ausgeführt wird, fahren Sie mit dem nächsten Schritt fort.

OpenShift

Cluster erstellen

  1. Legen Sie die Clusteranforderungen für den Apigee Hybrid-Cluster fest:
    • Die Mindestkonfigurationen für einen Cluster sind:
      Konfiguration Zustandsorientierter Knotenpool Zustandsloser Knotenpool
      Anzahl der Knoten 3 (pro Region) 3 (pro Region)
      CPU 4 4
      RAM 15 15
      Name des Standardlabels Apigee-Daten Apigee-Laufzeit
      Speicher dynamic Verwaltet mit der ApigeeDeployment-CRD

      Weitere Informationen zur minimalen Clusterkonfiguration finden Sie unter Minimale Clusterkonfigurationen.

    • Erstellen Sie mindestens zwei Knotenpools:
      Name des Standardknotenpools Beschreibung
      apigee-data Ein zustandsorientierter Knotenpool.
      apigee-runtime Ein zustandsloser Knotenpool.

      Weitere Informationen zur Konfiguration von Knotenpools finden Sie unter Dedizierte Knotenpools konfigurieren.

  2. Prüfen Sie die GKE-Version, die von dieser Version der Hybrid-Version 1.6.9 unterstützt wird:
  3. Folgen Sie der nachstehenden Anleitung, um Apigee in Ihrem OpenShift-Nutzercluster zu installieren und bei GKE Hub zu registrieren.
    1. Installieren und konfigurieren Sie das oc-Befehlszeilentool. Siehe Erste Schritte mit der OpenShift-Befehlszeile in der OpenShift-Dokumentation.
    2. Bei GKE-Hub registrieren
      1. Erstellen Sie eine Datei mit dem Namen gke-connect-scc.yaml und mit folgendem Inhalt:
        # Connect Agent SCC
        apiVersion: v1
        kind: SecurityContextConstraints
        metadata:
          name: gke-connect-scc
        allowPrivilegeEscalation: false
        requiredDropCapabilities:
        - ALL
        runAsUser:
          type: MustRunAsNonRoot
        seLinuxContext:
          type: RunAsAny
        supplementalGroups:
          type: MustRunAs
          ranges:
          - min: 1
            max: 65535
        fsGroup:
          type: MustRunAs
          ranges:
          - min: 1
            max: 65535
        volumes:
        - secret
        readOnlyRootFilesystem: true
        seccompProfiles:
        - docker/default
        users:
        groups:
          - system:serviceaccounts:gke-connect
                
      2. Erstellen Sie die Komponente in oc mit dem folgenden Befehl:
        oc create -f gke-connect-scc.yaml
      3. Erstellen Sie mit den folgenden Befehlen die Umgebungsvariablen für den Kontext:
        export KUBECONFIG=<> # Cluster kubeconfig file path
        export CONTEXT=admin
      4. Registrieren Sie sich mit dem folgenden Befehl bei GKE Hub:
        gcloud --project=${PROJECT_ID} container hub memberships register ${CLUSTER_NAME} \
          --kubeconfig=${KUBECONFIG} \
          --context=${CONTEXT} \
          --service-account-key-file=KEY_FILE_PATH

        Dabei gilt:

        • PROJECT_ID ist Ihre Google Cloud-Projekt-ID.
        • CLUSTER_NAME ist der Name des Clusters, den Sie gerade erstellt haben.
        • KUBECONFIG ist der Pfad zu Ihrer kubeconfig-Datei des Clusters.
        • CONTEXT ist der Kontext, in dem gcloud den Cluster registriert. CONTEXT muss für diesen Befehl admin sein.
        • KEY_FILE_PATH ist der Pfad zu Ihrer Dienstkontoschlüsseldatei, z. B. ./dist/apigee-my-project-ro-sa.json. Das Dienstkonto muss die folgenden beiden IAM-Rollen haben:
          • GKE-Hub-Administrator
          • GKE-Connect-Agent

Wenn Sie einen Cluster installiert und bei GKE Hub registriert haben, fahren Sie mit dem nächsten Schritt fort.

 

Weitere Informationen

1 (WEITER) Schritt 2: Cert-manager installieren 3 4 5 6 7 8 9