1.2.0 – Versionshinweise zur Apigee Hybrid-Laufzeit

<ph type="x-smartling-placeholder"></ph> Sie sehen die Dokumentation zu Apigee Edge.
Gehen Sie zur Apigee X-Dokumentation.
Weitere Informationen

Am 3. April 2020 wurde die Apigee Hybrid-Laufzeitversion 1.2.0 veröffentlicht.

Upgrade ausführen

Neue Features und Updates

Im Folgenden sind die neuen Features und Aktualisierungen in diesem Release aufgeführt:

Zum Angeben von Routingregeln wurde eine neue virtuelle Hostkonfiguration hinzugefügt

Mit dem neuen Konfigurationsfeature virtualhosts kann ein Problem behoben werden, bei dem die Reihenfolge, in der Basispfade an mehrere Umgebungen weitergeleitet wurden, nicht bekannt war. Weitere Informationen finden Sie unter Virtuelle Hosts konfigurieren. (150336519)

Betarelease der OASValidation-Richtlinie

Mit der OASValidation-Richtlinie (OpenAPI Specification Validation) (Beta) können Sie eine eingehende Anfrage oder Antwortnachricht mit einer OpenAPI 3.0-Spezifikation (JSON oder YAML) prüfen. Weitere Informationen finden Sie unter OASValidation-Richtlinie (Beta). (144949685)

Betarelease des WebSocket-Supports

Apigee Hybrid unterstützt WebSocket-Verbindungen. API-Proxy-Clients können jetzt ein Protokollupgrade von HTTP auf WebSockets anfordern. Weitere Informationen finden Sie unter WebSockets verwenden (Beta).

Über Kubernetes-Secrets auf Richtlinien-Secret-Werte zugreifen

Mit einem neuen Feature können Sie auf Werte zugreifen, die in einem Kubernetes-Secret in Proxy-Ablaufvariablen gespeichert sind. Weitere Informationen finden Sie unter Daten in einem Kubernetes-Secret speichern. (133377603)

Das Element „Azure Operators (AO)“ von Apigee ersetzt „ADC“ und „ADAH“

Apigee Operators (AO) erstellt und aktualisiert untergeordnete Kubernetes- und Istio-Ressourcen, die zur Bereitstellung und Verwaltung der Apigee-Bereitstellung erforderlich sind. Beispielsweise führt der Controller den Release von Message Processors aus. Außerdem wird die ApigeeDeployment-Konfiguration überprüft, bevor sie im Kubernetes-Cluster dauerhaft gespeichert wird. AO ersetzt den Apigee Deployment Admissionhook (ADAH) und den Apigee Deployment Controller (ADC). Weitere Informationen finden Sie in der Referenz zu Konfigurationsattributen. (151250559)

Bestimmte Cluster- und Projektkonfigurationsattribute ersetzen und verwerfen

Zwei neue Konfigurationsattribute wurden hinzugefügt: k8sCluster und gcp. Diese ersetzen die folgenden verworfenen Attribute: k8sClusterName, gcpRegion und gcpProjectID. Weitere Informationen finden Sie in der Referenz zu Konfigurationsattributen. (146299599)

Erweiterung des nichtflüchtigen Volumes für Cassandra auf Kubernetes

Es wurde ein Prozess hinzugefügt, um das von apigee-cassandra verwendete nichtflüchtige Volume entsprechend den Speicheranforderungen zu erweitern. Sie müssen nun keine weiteren Knoten hinzufügen, um den Speicher zu erhöhen. Siehe Nichtflüchtige Cassandra-Volumes erweitern. (138167919)

Zusätzliche Quellen für Zertifikate, Verschlüsselungsschlüssel und Dienstkonten unterstützen

Es wurden neue Konfigurationsattribute hinzugefügt, die mehr Flexibilität bei der Festlegung von TLS-Zertifikaten, Verschlüsselungsschlüsseln und Dienstkontoschlüsseln bieten. Die neuen Attribute sind unten aufgeführt:

  • kmsEncryptionPath
  • kmsEncryptionSecret.key
  • kmsEncryptionSecret.name
  • cassandra.backup.serviceAccountSecretRef
  • cassandra.restore.serviceAccountSecretRef
  • envs[].cacheEncryptionPath
  • envs[].cacheEncryptionSecret.key
  • envs[].cacheEncryptionSecret.name
  • envs[].kmsEncryptionPath
  • envs[].kmsEncryptionSecret.key
  • envs[].kmsEncryptionSecret.name
  • envs[].serviceAccountSecretRefs.synchronizer
  • envs[].serviceAccountSecretRefs.udca
  • envs[].sslSecret
  • logger.serviceAccountSecretRef
  • mart.serviceAccountSecretRef
  • mart.sslSecret
  • metrics.serviceAccountSecretRef
  • synchronizer.serviceAccountSecretRef
  • udca.serviceAccountSecretRef

Weitere Informationen finden Sie in der Referenz zu Konfigurationsattributen. (145303466)

Zulassen, dass Kunden Daten vor dem Senden zur Analyse verschleiern

Es wurde ein Feature hinzugefügt, mit dem Sie bestimmte Analysedaten verschleiern können, bevor sie an die Verwaltungsebene gesendet werden. Weitere Informationen finden Sie im Artikel zum Verschleiern von Nutzerdaten für Analysen. (142578910)

Nichtflüchtige Volumes für StatefulSets erweitern

Es wurde ein Feature hinzugefügt, mit dem Sie das von apigee-cassandra verwendete nichtflüchtige Volume entsprechend den Speicheranforderungen erweitern können, ohne dass mehr Rechenleistung benötigt wird. Weitere Informationen finden Sie unter Nichtflüchtige Volumes für StatefulSets erweitern. (138167919)

Mindestens unterstützte Versionen von GKE, Anthos und AKS wurden aktualisiert

Apigee Hybrid unterstützt jetzt GKE 1.14.x, Anthos 1.2 und AKS 1.14.x. (149578101)

TLS 1.3 für Northbound-Verbindungen unterstützen

Mit zwei neuen Konfigurationsattributen können Sie die minimale und maximale TLS-Version für eingehenden Traffic festlegen: ingress.minTLSProtocolVersion und maxTLSProtocolVersion. Mögliche Werte sind 1.0, 1.1, 1.2 und 1.3. Weitere Informationen finden Sie in der Referenz zu Konfigurationsattributen. (117580780)

Weiterleitungsproxy-Konfiguration für die Hybrid-Laufzeit unterstützen

HTTP-Weiterleitungsproxys werden jetzt für API-Proxys unterstützt, die in einer Umgebung bereitgestellt werden. Einzelheiten finden Sie im Artikel zum Konfigurieren von Weiterleitungsproxys. (148970527)

Mehrere hostAliases pro Umgebung unterstützen

Das neue Konfigurationsattribut envs[].hostAliases wurde hinzugefügt. Damit können Sie einer Umgebung mehrere Hostaliasse hinzufügen. Verwenden Sie dieses Element anstelle von hostAlias, da Letzteres eingestellt wurde. Weitere Informationen finden Sie im Artikel zum Hinzufügen mehrerer Hostaliasse zu einer Umgebung. (150738495)

Vorlagen für Attributgruppen zulassen

Dem Element <AssignVariable> der Richtlinie <AssignMessage> wurde das neue Element <PropertySetRef> hinzugefügt. Mit <PropertySetRef> lässt sich ein Name/Schlüssel-Paar für die Attributgruppe dynamisch erstellen. Dieses Feature ist nur für API-Proxys verfügbar, die in Apigee Hybrid bereitgestellt werden. Siehe „AssignVariable“. (148612340)

Fehlerkorrekturen

Folgende Fehler wurden in diesem Release behoben. Diese Liste ist hauptsächlich für Nutzer gedacht, die prüfen möchten, ob ihre Support-Tickets erfolgreich bearbeitet wurden. Sie enthält keine detaillierten Informationen für allgemeine Nutzer.

Fehler-ID Komponentenname Beschreibung
147958049 Laufzeit Ein Zeitproblem bei der Sequenzierung des Laufzeitstarts wurde behoben, durch das der Synchronizer in einigen Fällen nicht richtig gestartet werden konnte.
149867244 K8S-Plattform apigee-cps-setup-Pod schlägt bei multiregionalen Einrichtungen fehl
150187652/149117839 Laufzeit Es können keine Bindestriche in Umgebungsnamen verwendet werden.
149220463 MP-Pod Zuvor bereitgestellte Proxys müssen noch einmal bereitgestellt werden.
144321144 Laufzeit Proxys mit sicheren virtuellen Hosts konnten nicht neu geladen werden.
147685310 Laufzeit Synchronizer-Initialisierungsfehler aufgrund von fehlgeschlagenem Abruf von GCP-Tokens während der Initialisierung
151115900 Laufzeit Regelmäßige interne Prüfungen wurden nicht für HybridMART durchgeführt, was zu falsch positiven Ergebnissen führte.

Bekannte Probleme

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

Problem Beschreibung

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.
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.