Schritt 3: Umgebungsgruppe erstellen

Version 1.16 (latest)

Unterstützte Versionen:

• v1.16 (aktuellste Version)                        
• v1.15                         
• v1.14                        
• Liste der unterstützten Versionen

Nicht unterstützte Versionen:

• v1.13                         
• v1.12                         
• v1.11                         
• v1.10                                      
• v1.9                                         
• v1.8                                         
• v1.7                                         
• v1.6                                         
• v1.5                                         
• v1.4                                         
• v1.3                                         
• v1.2                                         
• v1.1                                         

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

So erstellen Sie eine neue Umgebung über die Apigee-Benutzeroberfläche:

1. Rufen Sie in der Apigee-Benutzeroberfläche Verwaltung > Umgebungen auf.

   Zur Seite „Umgebungen“

2. Klicken Sie im Bereich Umgebungen auf + Umgebung erstellen.
3. Geben Sie im Bereich Umgebung erstellen Folgendes ein:

   • Name: Der Name der programmatischen Umgebung. Der Name kann nach seinem Erstellen nicht mehr geändert werden.

     Der Name muss zwischen 2 und 32 Zeichen lang sein. Kleinbuchstaben, Zahlen und Bindestriche sind zulässig. Der Name muss mit einem Buchstaben beginnen und darf nicht mit einem Bindestrich enden. Der Name muss sich von jedem anderen Umgebungsnamen in Ihrer Organisation unterscheiden.

   • Anzeigename: Der Name der Umgebung, die in der Benutzeroberfläche angezeigt wird.
   • Beschreibung: Optional. Eine Beschreibung der Umgebung.
   • Instanz: Lassen Sie das Feld Instanz leer. Instanzen gelten nicht für Apigee Hybrid-Installationen.
   • Umgebungsgruppe: Lassen Sie das Feld Umgebungsgruppe vorerst leer. Im nächsten Verfahren erstellen Sie eine Umgebungsgruppe.
   • Bereitstellungstyp: Wählen Sie für die meisten Apigee Hybrid-Installationen die Option zum Bereitstellen einzelner API-Proxys aus. Sie können optional ein Archiv Ihrer API-Proxy-Konfigurationsumgebung bereitstellen. Weitere Informationen finden Sie unter Unterstützte Bereitstellungstypen.
     Hinweis: Der mit dieser Umgebung verwendete Bereitstellungstyp kann nach dem Erstellen der Umgebung nicht mehr geändert werden.
4. Klicken Sie auf Erstellen.

Hinweis: Dieser Vorgang zum Erstellen der Umgebung kann bis zu fünf Minuten dauern.

Nach Abschluss des Vorgangs wird die neue Umgebung in der Tabelle im Bereich Umgebungen angezeigt.

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:

   Kein Datenstandort

   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"

   Datenstandort

   curl -H "Authorization: Bearer $TOKEN" -X POST -H "content-type:application/json"   -d '{
       "name": "'"$ENV_NAME"'"
     }'   "https://$CONTROL_PLANE_LOCATION-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:

   Kein Datenstandort

   curl -H "Authorization: Bearer $TOKEN" \
             "https://apigee.googleapis.com/v1/organizations/$ORG_NAME/environments"

   Datenstandort

   curl -H "Authorization: Bearer $TOKEN" \
             "https://$CONTROL_PLANE_LOCATION-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

So erstellen Sie eine neue Umgebungsgruppe über die Apigee-Benutzeroberfläche:

1. Rufen Sie in der Apigee-Benutzeroberfläche Verwaltung > Umgebungen > Umgebungsgruppen auf.

   Zu Umgebungsgruppen

2. Klicken Sie auf + Umgebungsgruppe erstellen.
3. Geben Sie Folgendes ein:
   • Name der Umgebungsgruppe: Ein Name für die Umgebungsgruppe. Der Name muss mit einem alphanumerischen Zeichen beginnen und enden. Sie kann bis zu 63 Zeichen aus alphanumerischen Zeichen und Bindestrichen enthalten. Der Name muss sich von den Namen einer vorhandenen Umgebungsgruppe in Ihrer Organisation unterscheiden.

   • Hosts: Eine Liste von Hostnamen, die zum Aufrufen von Proxys verwendet werden können. Jeder Hostname muss in einer separaten Zeile stehen.

     Hinweis: Die Namen, die einer Umgebungsgruppe zugewiesen sind, müssen für diese Gruppe eindeutig sein: Sie können nicht von anderen Umgebungsgruppen verwendet werden.

     Sie können auch auf Google-Load-Balancer mit diesen Domains konfigurieren klicken. Dadurch wird die Seite Load-Balancing in der Cloud Console geöffnet, auf der Sie das Load-Balancing für die Hostnamen konfigurieren können.

   • Umgebungen: Eine optionale Liste der Umgebungen, die in die Umgebungsgruppe aufgenommen werden sollen.
4. Klicken Sie auf Erstellen.

Hinweis: Dieser Vorgang kann bis zu fünf Minuten dauern.

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:

   Kein Datenstandort

   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"
       

   Datenstandort

   curl -H "Authorization: Bearer $TOKEN" -X POST -H "content-type:application/json" \
      -d '{
        "name": "'"$ENV_GROUP"'",
        "hostnames":["'"$DOMAIN"'"]
      }' \
      "https://$CONTROL_PLANE_LOCATION-apigee.googleapis.com/v1/organizations/$ORG_NAME/envgroups"
       

4. Weisen Sie die Umgebung der neuen Gruppe zu:

   Kein Datenstandort

   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"
       

   Datenstandort

   curl -H "Authorization: Bearer $TOKEN" -X POST -H "content-type:application/json" \
      -d '{
        "environment": "'"$ENV_NAME"'",
      }' \
      "https://$CONTROL_PLANE_LOCATION-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:

   Kein Datenstandort

   curl -H "Authorization: Bearer $TOKEN" \
     "https://apigee.googleapis.com/v1/organizations/$ORG_NAME/envgroups"

   Datenstandort

   curl -H "Authorization: Bearer $TOKEN" \
     "https://$CONTROL_PLANE_LOCATION-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:

   Kein Datenstandort

   curl -H "Authorization: Bearer $TOKEN" \
     "https://apigee.googleapis.com/v1/organizations/$ORG_NAME/envgroups/$ENV_GROUP/attachments"

   Datenstandort

   curl -H "Authorization: Bearer $TOKEN" \
     "https://$CONTROL_PLANE_LOCATION-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-1234-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.