Schritt 3: Umgebungsgruppe erstellen

In diesem Schritt erstellen Sie eine Umgebung und eine Umgebungsgruppe.

In Apigee werden API-Proxys in Umgebungen bereitgestellt, die isolierte Kontexte für Ihre Proxys bereitstellen. Umgebungen sind in Umgebungsgruppen organisiert, die Hostnamen für alle Proxys bereitstellen, die in Umgebungen innerhalb der Gruppe bereitgestellt werden. Sie müssen mindestens eine Umgebung und mindestens eine Umgebungsgruppe haben. Weitere Informationen finden Sie unter Umgebungen und Umgebungsgruppen.

Umgebung erstellen

Erstellen Sie zuerst die Umgebung. Sie können eine Umgebung mit der Apigee-UI oder der API erstellen. Sie können die Benutzeroberfläche auch dazu verwenden, um sich damit vertraut zu machen.

Apigee-Benutzeroberfläche

Führen Sie die folgenden Schritte aus, um auf die UI zuzugreifen und eine Umgebung hinzuzufügen:

  1. Öffnen Sie die Apigee-Benutzeroberfläche. Wenn Sie sich das erste Mal anmelden, zeigt Hybrid einen Schutzdialog an. Wenn Sie aufgefordert werden, aus mehreren Konten auszuwählen, wählen Sie das Konto aus, zu dem das Projekt gehört, das Sie in Schritt 2: Google Cloud-Projekt erstellen erstellt haben. Klicken Sie anschließend auf Zulassen.
  2. In Ihrem Browser wird die Startseite der UI aufgerufen:

    Grafik: Die Startseite in der Apigee-Benutzeroberfläche, die aus der linken Navigationsleiste und großen Bildern besteht, die Links sind.

  3. Prüfen Sie, ob Ihre Organisation in der Drop-down-Liste der Organisation ausgewählt ist. Sollte sie nicht ausgewählt sein, wählen Sie sie aus der Drop-down-Liste aus, wie im folgenden Beispiel gezeigt:

    Eine Liste von Organisationen, die hybridfähig sind

  4. Klicken Sie auf Verwaltung > Umgebungen > Übersicht.

    Grafik: Das Menü der Apigee-UI mit Übersicht über Administrator, Umgebungen und Übersicht

    Die Ansicht Umgebungen wird noch ohne Umgebung angezeigt:

    Die Ansicht „Umgebungen“ mit leerer Umgebung (keine Umgebungen)

  5. Wählen Sie +Umgebung aus.

    Das Dialogfeld Neue Umgebung wird angezeigt:

    Das Dialogfeld „Neue Umgebung“

  6. Geben Sie die folgenden Informationen in das Dialogfeld Neue Umgebung ein:
    1. Anzeigename (erforderlich): Ein Anzeigename für die Umgebung, der in der UI verwendet wird. Zum Beispiel „Meine erste Umgebung“ oder „Test“. Anders als der Umgebungsname kann der Anzeigename Großbuchstaben und andere Sonderzeichen enthalten.
    2. Umgebungsname (Erforderlich): Der programmatische Name für die Umgebung, auch als Umgebungs-ID bezeichnet.

      Zum Beispiel „my-environment“ oder „test“.

      Der Anzeigename und der Umgebungsname können unterschiedlich sein.

    3. Beschreibung (optional): Weitere Informationen zu der Umgebung, die Sie als Erinnerung für den Zweck der Umgebung hinzufügen möchten. Beispiel: „Bei der ersten Installation erstellt“.
  7. Klicken Sie auf Erstellen.

    Apigee erstellt die neue Umgebung und gibt an, dass sie den Status Bereitstellung steht aus hat:

    Nachricht: Status „Bereitstellung steht aus“

    Nach wenigen Augenblicken ändert sich der Status zu bereitgestellt:

    Neue Umgebung wurde bereitgestellt

    Das ist aber noch nicht alles. Sie müssen die neue Umgebung auch der overrides.yaml-Datei der Laufzeit hinzufügen, aber Sie müssen die Laufzeit zuerst installieren, damit Sie sich nicht selbst ausführen können.

Apigee API

Führen Sie die folgenden Schritte aus, um eine Umgebung mit der Umgebungs-API erstellen zu erstellen:

  1. Öffnen Sie ein Terminal auf dem Gerät, mit dem Sie Apigee verwalten.
  2. Rufen Sie in der Befehlszeile die Anmeldedaten der gcloud-Authentifizierung mit dem folgenden Befehl ab:

    Linux / MacOS

    export TOKEN=$(gcloud auth print-access-token)

    Um zu prüfen, ob Ihr Token ausgefüllt wurde, verwenden Sie echo wie im folgenden Beispiel:

    echo $TOKEN

    Das Token sollte als codierter String angezeigt werden.

    Windows

    for /f "tokens=*" %a in ('gcloud auth print-access-token') do set TOKEN=%a

    Um zu prüfen, ob Ihr Token ausgefüllt wurde, verwenden Sie echo wie im folgenden Beispiel:

    echo %TOKEN%

    Das Token sollte als codierter String angezeigt werden.

  3. Erstellen Sie die folgende Umgebungsvariable:

    Linux / MacOS

    export ENV_NAME="YOUR_ENV_NAME"

    Windows

    set ENV_NAME="YOUR_ENV_NAME"

    Dabei gilt:

    • ENV_NAME (erforderlich) Der Umgebungsname kann Kleinbuchstaben, Bindestriche und Ziffern enthalten und muss mit einem Kleinbuchstaben beginnen. Dieser Name wird als Kennung verwendet und kann nach dem Erstellen der Umgebung nicht mehr geändert werden.
  4. Rufen Sie die folgende Apigee API auf:
    curl -H "Authorization: Bearer $TOKEN" -X POST -H "content-type:application/json"   -d '{
        "name": "'"$ENV_NAME"'"
      }'   "https://apigee.googleapis.com/v1/organizations/$ORG_NAME/environments"

    Bei einer erfolgreichen Erstellungsanfrage sollte die Environments API eine Nachricht ähnlich der folgenden ausgeben:

    {
      "name": "organizations/hybrid-example/operations/c2aee040-7e79-4fd4-b0cf-79ca1b7098a8",
      "metadata": {
        "@type": "type.googleapis.com/google.cloud.apigee.v1.OperationMetadata",
        "operationType": "INSERT",
        "targetResourceName": "organizations/hybrid-example/environments/example-env",
        "state": "IN_PROGRESS"
      }
    }

    Da das Attribut state in der Antwort angibt, hat Apigee mit dem Erstellen der neuen Umgebung begonnen. Der Status lautet daher IN_PROGRESS.

  5. Prüfen Sie, ob die Umgebung erfolgreich erstellt wurde:
    curl -H "Authorization: Bearer $TOKEN" \
              "https://apigee.googleapis.com/v1/organizations/$ORG_NAME/environments"

    Bei einer erfolgreichen Erstellungsanfrage antwortet die Environments API mit einer Nachricht wie dieser:

    [
      "your-environment-name"
    ]

Umgebungsgruppe erstellen

Erstellen Sie nun eine Umgebungsgruppe und weisen Sie ihr die zuvor erstellte Umgebung zu.

Apigee-Benutzeroberfläche

Führen Sie die folgenden Schritte aus, um eine Umgebungsgruppe über die Apigee-UI zu erstellen:

  1. Öffnen Sie die Apigee-Benutzeroberfläche.
  2. In Ihrem Browser wird die Startseite der Apigee-UI aufgerufen:

  3. Prüfen Sie, ob Ihre Organisation in der Drop-down-Liste der Organisation ausgewählt ist. Falls es nicht ausgewählt ist, wählen Sie es aus der Drop-down-Liste aus.
  4. Klicken Sie auf Admin > Umgebungen > Groups.

    Die Ansicht Umgebungsgruppenübersicht wird mit allen erstellten Umgebungsgruppen angezeigt:

    Die Ansicht „Umgebungsgruppen“ mit allen erstellten Gruppen

  5. Klicken Sie auf + Umgebungsgruppe.

    Das Dialogfeld Umgebungsgruppe hinzufügen wird angezeigt.

    Dialogfeld „Umgebungsgruppe hinzufügen“ mit leerem Namensfeld

  6. Geben Sie einen Namen ein und klicken Sie auf Erstellen.
  7. Bewegen Sie den Mauszeiger auf die neu erstellte Umgebungsgruppe und klicken Sie dann auf Bearbeiten .

    Fügen Sie einen Hostnamen hinzu, der von allen in dieser Gruppe bereitgestellten Umgebungen verwendet wird. Dies sollte eine Domain sein, auf die Sie Verwaltungszugriff haben. Der Hostname kann die Domain selbst sein, z. B. example.com, oder eine Subdomain wie my-proxies.example.com enthalten.

    Wenn Sie eine Domain registrieren müssen, lesen Sie einen Domain-Registrator wie Google Domains.

  8. Fenster „Umgebungsgruppe bearbeiten“ ohne zugewiesenen Umgebungen

  9. Klicken Sie auf Add (+).
  10. Das Dialogfeld Umgebung hinzufügen wird angezeigt.
  11. Dialogfeld zum Hinzufügen der Umgebung hinzufügen

  12. Wählen Sie eine Umgebung aus der Liste aus und klicken Sie auf Hinzufügen.

Apigee API

So erstellen Sie eine Umgebungsgruppe mit der Apigee API:

  1. Rufen Sie in der Befehlszeile die Anmeldedaten der gcloud-Authentifizierung mit dem folgenden Befehl ab:

    Linux / MacOS

    TOKEN=$(gcloud auth print-access-token)

    Windows

    for /f "tokens=*" %a in ('gcloud auth print-access-token') do set TOKEN=%a
  2. Erstellen Sie die folgenden Umgebungsvariablen:

    Linux / MacOS

    export DOMAIN="YOUR_DOMAIN"
    export ENV_GROUP="YOUR_ENVIRONMENT_GROUP"

    Windows

     data-terminal-prefix=">">set ENV_GROUP="YOUR_ENVIRONMENT_GROUP"
     data-terminal-prefix=">">set DOMAIN="YOUR_DOMAIN"

    Dabei gilt:

    • DOMAIN (erforderlich) Dies ist der Hostname, den alle Proxys verwenden, die in Umgebungen innerhalb dieser Gruppe bereitgestellt werden. Dies sollte eine von Ihnen verwaltete Domain sein. Der Hostname kann die Domain selbst sein, z. B. example.com, oder eine Subdomain wie my-proxies.example.com enthalten. Wenn Sie keine verwaltete Domain haben, können Sie vorerst einen Platzhalter eingeben. Sie können die Domainadresse später ändern.
    • ENV_GROUP (erforderlich) Der Umgebungsname kann Kleinbuchstaben, Bindestriche und Ziffern enthalten und muss mit einem Kleinbuchstaben beginnen. Dieser Name wird als Kennung verwendet und kann nach dem Erstellen nicht mehr geändert werden.
  3. Erstellen Sie die Umgebungsgruppe:
    curl -H "Authorization: Bearer $TOKEN" -X POST -H "content-type:application/json" \
       -d '{
         "name": "'"$ENV_GROUP"'",
         "hostnames":["'"$DOMAIN"'"]
       }' \
       "https://apigee.googleapis.com/v1/organizations/$ORG_NAME/envgroups"
        
  4. Weisen Sie die Umgebung der neuen Gruppe zu:
    curl -H "Authorization: Bearer $TOKEN" -X POST -H "content-type:application/json" \
       -d '{
         "environment": "'"$ENV_NAME"'",
       }' \
       "https://apigee.googleapis.com/v1/organizations/$ORG_NAME/envgroups/$ENV_GROUP/attachments"
        
  5. Prüfen Sie mit folgendem CURL-Befehl, ob die Umgebungsgruppe erfolgreich erstellt wurde:
    curl -H "Authorization: Bearer $TOKEN" \ 
          "https://apigee.googleapis.com/v1/organizations/$ORG_NAME/envgroups"

    Bei einer erfolgreichen Erstellungsanfrage antwortet die Group API mit einer Nachricht wie dieser:

          {
            "environmentGroups": [
              {
                "name": "your_envgroup_hybrid",
                "hostnames": [
                  "apigee.hybrid.com"
                ],
                "createdAt": "1677826235324",
                "lastModifiedAt": "1677826235324",
                "state": "ACTIVE"
              }
            ]
          }
        
  6. Rufen Sie die neuesten Anhänge für die neu erstellte Umgebungsgruppe mit folgendem CURL-Befehl ab:
    curl -H "Authorization: Bearer $TOKEN" \ 
          "https://apigee.googleapis.com/v1/organizations/$ORG_NAME/envgroups/$ENV_GROUP/attachments"

    Der Vorgang zum Erstellen und Anhängen der Umgebung war erfolgreich, wenn das Ergebnis einen eindeutigen Hashwert enthält, wie in der folgenden Beispielantwortausgabe gezeigt:

         
            {
              "environmentGroupAttachments": [
                {
                  "name": "c27046d1-b83e-4cba-xxxx-caaa660b2bd6",
                  "environment": "your_envtest_hybrid",
                  "createdAt": "1677826263567",
                  "environmentGroupId": "your_envgroup_hybrid"
                }
              ]
            }
            

Nächster Schritt

Setzen Sie die Installation fort wie unter Teil 2: Einrichtung der Hybridlaufzeit beschrieben.