1.1.0 – Versionshinweise zur Apigee Hybrid-Laufzeit

Sie sehen die Dokumentation zu Apigee Edge.
Zur Apigee X-Dokumentation
weitere Informationen

Am 27. Januar 2020 hat Google die Apigee Hybrid-Laufzeitversion 1.1.0 veröffentlicht. In diesem Abschnitt werden neue Features und Änderungen beschrieben, die in Version 1.1.0 veröffentlicht wurden.

Upgrade wird durchgeführt

Sie können kein Upgrade von Version 1.0.0 auf 1.1.0 ausführen. Die neue Version ist nicht mit Version 1.0.0 abwärtskompatibel. Version 1.1.0 erfordert eine Neuinstallation.

Neue Funktionen und Verbesserungen

Apigee Connect (Alpha release)

Mit Apigee Connect Alpha kann der Apigee Hybrid-MART-Dienst eine Verbindung zur Verwaltungsebene herstellen, ohne dass Sie den MART-Endpunkt verfügbar machen müssen. Wenn Sie Apigee Connect verwenden, müssen Sie das MART-Ingress-Gateway nicht mit einem Hostalias und einem autorisierten DNS-Zertifikat konfigurieren. Weitere Informationen erhalten Sie von Ihrem Apigee-Ansprechpartner.

Basispfad-Routing

Mit dem Basispfad-Routing können Sie konfigurieren und verwalten, wie API-Proxy-Aufrufe von Apigee Hybrid an bestimmte Umgebungen weitergeleitet werden. Weitere Informationen finden Sie im Abschnitt zur Konfiguration des Basispfad-Routings.

Änderungen

Die folgenden Änderungen wurden für die Hybrid-Laufzeitversion 1.1.0 vorgenommen. Einige dieser Änderungen sind wie bereits erwähnt nicht abwärtskompatibel mit Version 1.0.0.

  • Über die apigeectl-Befehlszeile wird Istio nun im Namespace istio-system installiert. Dies ist der Standard-Namespace für Istio. Diese Änderung ist mit der Hybrid-Version 1.0.0 nicht abwärtskompatibel.
  • Mit der apigeectl-Befehlszeile wird CertManager jetzt im Namespace cert-manager installiert. Diese Änderung ist mit der Hybrid-Version 1.0.0 nicht abwärtskompatibel.
  • Die unterstützte Version von Istio, die mit der Apigee Hybrid-Laufzeit bereitgestellt wird, wurde auf 1.4.2 migriert, da Version 1.2.x nicht mehr unterstützt wird.

Fehlerkorrekturen

Die folgenden Probleme, die in den Versionshinweisen zu Apigee Hybrid 1.0.0 aufgeführt werden, wurden behoben:

Problem Beschreibung
144886537 Basispfad-Routing funktioniert in Apigee Hybrid v1.0.0. nicht. Wenn die Überschreibungen so eingerichtet sind, dass Weiterleitungen an verschiedene Umgebungen mit demselben hostAlias erfolgen, wird der eingehende Traffic nicht an die Umgebung des Basispfades weitergeleitet.
143774187 Auf der Hybrid-Benutzeroberfläche wird das Label „Company“ in der Apps-Ansicht angezeigt.

Bekannte Probleme

In der folgenden Tabelle werden die bekannten Probleme für diesen Release beschrieben:

Problem Beschreibung
Sie können nicht das Sternchen „*“ für das Attribut hostAlias für die Konfigurationen mart und envs verwenden. Als Best Practice wird empfohlen, einen bestimmten Hostnamen für die Konfiguration mart zu verwenden.
Die Variablen HTTP_PROXY, HTTPS_PROXY und NO_PROXY werden in der Apigee Connect-Alphaversion nicht unterstützt.

Fehler „Ungültiger HTTP-Header“: Beim Istio-Ingress werden alle eingehenden Zielantworten auf das HTTP2-Protokoll umgestellt. Da der Hybrid Message Processor nur HTTP1 unterstützt, wird beim Aufruf eines API-Proxys möglicherweise der folgende Fehler angezeigt:

http2 error: Invalid HTTP header field was received: frame type: 1, stream: 1,
   name: [:authority], value: [domain_name]

Wenn dieser Fehler angezeigt wird, können Sie das Problem mit einer der folgenden Maßnahmen beheben:

  • Ändern Sie den Zieldienst so, dass der Host-Header in der Antwort weggelassen wird.
  • Entfernen Sie den Host-Header gegebenenfalls mit der AssignMessage-Richtlinie in Ihrem API-Proxy.
144584813 Wenn Sie eine Debugging-Sitzung erstellen, die Sitzung jedoch noch keine Transaktionen enthält, ist die Sitzung nicht in der Liste der API zum Auflisten von Debugging-Sitzungen enthalten. Die API enthält nur dann Sitzungen in der Antwort, wenn die Sitzung mindestens eine Transaktion enthält.
144436206 In der Ansicht Cache Performance ist die Berechnung der Cache-Trefferquote falsch.
144321491 Apigee Hybrid protokolliert die Meldung „Fehlender Cache wird erstellt“, die auf mögliche Leistungseinbußen hinweist. Diese Meldungen sind zu erwarten und können ignoriert werden.
144321144 Proxys mit sicheren virtuellen Hosts können nicht neu geladen werden.
144286363

Debugging-Maske in „env.json“ maskiert Antwortdaten nicht.

Die folgende API zum Aktualisieren der Debugging-Maske „env.json“ mit dem Feld „responseJSONPaths“ funktioniert nicht:

PATCH /v1/organizations/org/environments/env/debugmask?replaceRepeatedFields=true
{
  "responseJSONPaths": ["$.maskedDataEnv"]
}

Zur Umgehung dieses Problems mit Trace können Sie die gesamte Trace-Sitzung auf der Benutzeroberfläche löschen oder die Trace APIs verwenden, um einzelne Transaktionen innerhalb einer Sitzung zu löschen.

143659917

Die Ablaufeinstellung der PopulateCache-Richtlinie muss auf einen expliziten Wert zwischen 1 und 30 festgelegt werden. Beispiel:

<ExpirySettings>
  <TimeoutInSec>30</TimeoutInSec>
</ExpirySettings>
133192879

Zusammenfassung: Wenn Sie den Bereitstellungsstatus Ihrer Organisation mit der API oder der Benutzeroberfläche abrufen, tritt eine sehr hohe Latenz auf. Diese kann zu der Antwort HTTP 204 (No Content) oder HTTP 400 (Bad Request) führen.

Problemumgehung: Aktualisieren Sie Ihren Browser oder senden Sie die Anfrage noch einmal.