Fehlerbehebung bei der Apigee-Installation

Diese Seite gilt für Apigee, aber nicht für Apigee Hybrid.

Apigee Edge-Dokumentation aufrufen

In diesem Dokument werden häufige Fehler aufgelistet und mögliche Lösungen für die Installation und Konfiguration von Apigee beschrieben.

Neue Instanz erstellen

In diesem Abschnitt werden häufige Fehler und mögliche Lösungen beschrieben, nachdem Sie eine Anfrage an Apigee gesendet haben, um eine neue Instanz zu erstellen:

• 401 (UNAUTHENTICATED) gibt an, dass Ihre Anmeldedaten abgelaufen sind. Versuchen Sie, Ihr Autorisierungstoken zu erneuern, wie im folgenden Beispiel gezeigt:

  AUTH="Authorization: Bearer $(gcloud auth print-access-token)"

• RANGES_EXHAUSTED gibt an, dass der von Ihnen angeforderte IP-Adressbereich nicht passt und Sie einen neuen Bereich anfordern müssen. Sie haben ursprünglich in Schritt 2: Netzwerk einrichten eine Bereichsanfrage erstellt.
  1. Erstellen Sie folgende Umgebungsvariablen

  RANGE_NAME_1=YOUR_RANGE_NAME_1
    RANGE_NAME_2=YOUR_RANGE_NAME_2
    NETWORK_NAME=YOUR_NETWORK_NAME

  2. Prüfen Sie die Details der vorhandenen Adressbereiche und achten Sie darauf, dass sie sich nicht mit dem neuen Bereich überschneiden.

   gcloud compute addresses list --global --project=$PROJECT_ID

   gcloud compute addresses describe $RANGE_NAME_1 --global --project=$PROJECT_ID 

  3. Um einen neuen Bereich anzufordern, aus dem Apigee eine IP-Adresse für die privaten Dienstverbindungen auswählt, führen Sie folgenden gcloud-Befehl aus:

   gcloud compute addresses create $RANGE_NAME_2
              --project=$PROJECT_ID --global --prefix-length=16
              --description="additional peering range for Google services" --network=$NETWORK_NAME
              --purpose=VPC_PEERING 

  Mit diesem Befehl wird ein neuer Bereich mit dem Namen $RANGE_NAME_2 erstellt.

  4. Details sowohl des alten als auch des neuen Adressbereichs bestätigen

   gcloud compute addresses list --global --project=$PROJECT_ID 

   gcloud compute addresses describe $RANGE_NAME_1 --global --project=$PROJECT_ID 

   gcloud compute addresses describe $RANGE_NAME_2 --global --project=$PROJECT_ID 

  5. Prüfen Sie die Details zum vorhandenen VPC-Peering:

   gcloud services vpc-peerings list \
              --network=$NETWORK_NAME \
              --service=servicenetworking.googleapis.com \
              --project=$PROJECT_ID 

  6. Führen Sie den folgenden Befehl aus, um Ihre Verbindungsanfrage zu aktualisieren:

   gcloud services vpc-peerings update
              --service=servicenetworking.googleapis.com --network=$NETWORK_NAME
              --ranges=$RANGE_NAME_1,$RANGE_NAME_2 --project=$PROJECT_ID 

  Hinweis: Sie müssen den Namen Ihres ersten Bereichs (in diesem Fall RANGE_NAME_1) sowie einen Namen für den neu angeforderten Bereich (in diesem Fall RANGE_NAME_2) angeben. Weitere Informationen finden Sie unter gcloud services vpc-peerings update.
  7. Prüfen Sie die Details zum vorhandenen VPC-Peering:

   gcloud services vpc-peerings list \
              --network=$NETWORK_NAME \
              --service=servicenetworking.googleapis.com \
              --project=$PROJECT_ID 

Apigee-Organisation erstellen

Das folgende Beispiel zeigt einen allgemeinen Fehler, den Apigee beim ersten Erstellen einer Organisation anzeigen kann:

In diesem Fall ist mindestens eine der erforderlichen APIs nicht aktiviert. Prüfen Sie die in Schritt 1: Erforderliche APIs aktivieren aufgeführten APIs und achten Sie darauf, dass alle APIs aktiviert sind, bevor Sie fortfahren.

Darüber hinaus kann es zu einem der folgenden HTTP-Fehler kommen:

• 401 (UNAUTHENTICATED) gibt an, dass Ihre Anmeldedaten abgelaufen sind. Versuchen Sie, Ihr Autorisierungstoken zu erneuern, wie im folgenden Beispiel gezeigt:

  AUTH="Authorization: Bearer $(gcloud auth print-access-token)"

• 404 (Not Found) kann das Ergebnis folgender Elemente sein:
  • Du hast die falsche Endpunkt-/Anfrage-URL eingegeben. Prüfen Sie, ob Sie apigee.googleapis.com für die Domain des API-Aufrufs angegeben haben.
  • Ihr Projekt wurde möglicherweise noch nicht bereitgestellt. Apigee-Vertriebsteam kontaktieren.
• 409 (Conflict) gibt normalerweise an, dass der angegebene Organisationsname bereits vorhanden ist. Organisationsnamen müssen global eindeutig sein. Wählen Sie einen anderen Namen für die Organisation aus und geben Sie den Befehl noch einmal aus. Sie geben den Namen in der Nutzlast der Anfrage an, wenn Sie eine Organisation über die Befehlszeile erstellen. Denke daran, dass du eine Organisation erstellen musst, die denselben Namen wie dein Projekt hat. Das soll aber nur passieren, wenn ein Tippfehler vorliegt.

Der folgende Fehler wird möglicherweise von Apigee zurückgegeben, wenn Sie den Status einer neuen Organisationsanfrage prüfen:

• 403 (Permission Denied) könnte bedeuten, dass die Organisation noch nicht erstellt wurde. Warten Sie eine Minute und versuchen Sie es dann noch einmal. Wenn Apigee beim ersten Versuch, die neue Organisation zu erstellen, eine 403 zurückgibt, kann dies bedeuten, dass eine oder mehrere Ihrer APIs nicht aktiviert wurden. Alle APIs müssen wie unter Schritt 1: Erforderliche APIs aktivieren beschrieben aktiviert sein.

Beispiele bereitstellen

Load Balancer nicht betriebsbereit

Beim Bereitstellen eines Beispielproxys kann Apigee den HTTP-Fehler 502 (Bad Gateway) zurückgeben. Versuchen Sie in diesem Fall Folgendes:

1. Cloud Console öffnen
2. Integrität des Load-Balancers prüfen Wählen Sie in der Cloud Console Netzwerkdienste > Load-Balancing aus. Der Tab Load-Balancer zeigt alle Load-Balancer für das Projekt und deren Status an. Ein gelbes Dreieck zeigt an, dass der Back-End-Dienst des Load-Balancers fehlerfrei ist.
3. Nachdem Sie ein Problem mit dem Load-Balancer bestätigt haben, prüfen Sie die VMs in Ihrer Laufzeitinstanz darauf, ob sie betriebsbereit sind.
4. Prüfen Sie in den Logdateien, ob ein Fehler vorliegt, der möglicherweise zu einem Problem geführt hat. Weitere Informationen zum Aktivieren und Ansehen von Logs finden Sie unter Logs ansehen.
5. Führen Sie einen rollierenden Neustart für die Instanzgruppe in der Cloud Console durch:
   1. Wählen Sie Compute Engine > Instanzgruppen aus.
   2. Klicken Sie in der Liste der Instanzgruppen in der Spalte Name auf die Instanzgruppe, die nicht reagiert.
   3. Klicken Sie auf Rollierender Neustart/Ersetzen, wie das folgende Beispiel zeigt:

      

   4. Klicken Sie auf dem nächsten Bildschirm auf Neu starten.

      Dadurch wird die Envoy-Instanz neu gestartet.

Falsche IP-Adresse der Instanz

Wenn Sie Ihre Apigee-Instanz löschen und neu erstellen, ändert sich die IP-Adresse der Apigee-Instanz und kann nicht mehr mit der Endpunkt-IP der MIG-Vorlage (Managed Instance Group, verwaltete Instanzgruppe) synchronisiert werden. Beispiel: Die MIG-Vorlage hat weiterhin die alte IP-Adresse der gelöschten Instanz. Die MIG-Vorlage wurde während des Bereitstellungsprozesses von Apigee erstellt. Führen Sie in diesem Fall die folgenden Schritte aus, um die MIG-Vorlage mit der richtigen Apigee-IP zu aktualisieren:

1. Öffnen Sie die Apigee-Benutzeroberfläche.

   Apigee-Benutzeroberfläche aufrufen

2. Gehen Sie zu Admin > Instanzen.
3. Notieren Sie sich die IP-Adresse der Instanz. Sie benötigen diese IP-Adresse in einem späteren Schritt. Beispiel: 10.117.200.2.

4. Rufen Sie in der Google Cloud Console die Seite Instanzvorlagen auf.

   Zu Instanzvorlagen

5. Öffnen Sie die Instanzvorlage. Sie müssen die Instanzvorlage öffnen, die vom Backend verwendet wird, das Ihrem Load-Balancer zugeordnet ist.
6. Scrollen Sie nach unten zur IP-Adresse ENDPOINT im Bereich Benutzerdefinierte Metadaten.
7. Wenn die Endpunkt-IP von der in der Apigee-Benutzeroberfläche abweicht, müssen Sie die IP-Adresse der Instanzvorlage so ändern, dass sie mit der IP-Adresse der Apigee-Instanz übereinstimmt. Weitere Informationen finden Sie unter Instanz-IP-Adressen ändern.