Sie sehen die Dokumentation zu Apigee Edge.
Zur Apigee X-Dokumentation weitere Informationen
Am Dienstag, dem 31. Mai 2016, wurde eine neue Version von Apigee Edge für Private Cloud veröffentlicht.
Seit dem vorherigen Feature Release von Edge for Private Cloud (4.16.01) wurden die folgenden Releases veröffentlicht und sind in diesem Feature-Release enthalten:
- Cloud: 16.02.17, 16.03.02, 16.03.09 (UI), 16.03.16 (UI), 16.03.23 (UI), 16.03.30
Unter Releasenummerierung erfahren Sie, wie Sie herausfinden können, ob ein bestimmter Cloud-Release in Ihrer Version von Edge for Private Cloud enthalten ist.
Neue Features und Verbesserungen
Im Folgenden sind die neuen Funktionen und Verbesserungen in dieser Version aufgeführt. Zusätzlich zu den folgenden Verbesserungen enthält diese Version auch zahlreiche Verbesserungen in puncto Nutzerfreundlichkeit, Leistung, Sicherheit und Stabilität.
Weitere Informationen und Anweisungen finden Sie in der Dokumentation zu Edge für Private Cloud.
Installations- und Betriebsanleitungen jetzt online
Sie können jetzt unter Version 4.18.01 auf den Leitfaden zur Installation und Vorgänge von Edge for Private Cloud zugreifen.
Softwareupdates
Die folgenden Softwareupdates sind in diesem Release enthalten:
- Java JDK 1.8 – Damit Sie die neuesten Java-Funktionen nutzen können, ist diese Version mit Java 1.8 kompatibel. In Ihrer Umgebung ist Oracle JDK 1.8 oder OpenJDK 8 erforderlich.
Im Rahmen des Updates auf Java 8 sind einige TLS-Chiffren in Oracle JDK 1.8 nicht mehr verfügbar. Eine vollständige Liste finden Sie im Abschnitt "Standardmäßig deaktivierte Cipher Suites" http://docs.oracle.com/javase/8/docs/technotes/guides/security/SunProviders.html. - Cassandra 2.1.13 – Aktualisiert von Cassandra 2.0.15.
Installation, Upgrade, Rollback
Im Folgenden finden Sie eine Liste der Änderungen an der Installation, dem Upgrade und den zugehörigen Skripts. Informationen zur Verwendung finden Sie in der Dokumentation zu Edge for Private Cloud.
- Neuer Prozess zur Aktualisierung von Version 4.16.01: Diese Version ersetzt das Dienstprogramm
apigee-migrate
durch das Dienstprogrammupdate.sh
, um Ihre Installation von 4.16.01 auf 4.16.05 zu aktualisieren. Siehe Apigee Edge 4.16.01 auf 4.16.05 aktualisieren. -
Bootstrap
bootstrap.sh
(Version 4.16.01) ist jetztbootstrap_4.16.05.sh
in 4.16.05.- Sie müssen
uname:pword
nicht mehr angeben, umbootstrap_4.16.05.sh
herunterzuladen.
- Rollback - Für ein Rollback eines Updates auf 4.16.05 deinstallierst du die Version 4.16.05 der Komponente und installierst die vorherige Version neu. Das vorherige
rollback.sh
-Dienstprogramm wurde entfernt. Siehe 4.16.05 Rollback-Prozess. setup.sh
undupdate.sh
können die Logdatei in/tmp
schreiben: Standardmäßig schreiben die Dienstprogrammesetup.sh
undupdate.sh
Loginformationen in/opt/apigee/var/log/apigee-setup
. Wenn der Nutzer, der das Dienstprogramm ausführt, keinen Zugriff auf dieses Verzeichnis hat, wird das Log in das Verzeichnis/tmp
geschrieben. Wenn der Nutzer keinen Zugriff auf/tmp
hat, schlägt das Dienstprogramm fehl.- Verfahren für API-BaaS-Aktualisierung: In der Version 4.16.01 mussten Sie API BaaS neu installieren, um sie zu migrieren. Das neue
update.sh
-Dienstprogramm unterstützt die aktuelle API-BaaS-Aktualisierung. Siehe Apigee Edge 4.16.01 auf 4.16.05 aktualisieren.
Verwaltung
Im Folgenden finden Sie neue Features für die Verwaltung und Konfiguration der Private Cloud.
- Installationsprüfung – Das Dienstprogramm
apigee-validate
, das zum Testen Ihrer Edge Private Cloud-Installation verwendet wird, kann jetzt über den Verwaltungsserver ausgeführt werden. Bisher musste das Skript auf dem Message Processor ausgeführt werden. Siehe Installation testen. - Name der Region: Die Region kann ein beliebiger Name sein. In früheren Versionen hatte der Name die Form "dc-#", wobei # eine Ganzzahl war.
- Gateway-Pods – Gateway-Pods können einen beliebigen Namen haben. In früheren Releases musste der Pod „gateway“ genannt werden.
- Skriptbasierte Verwaltung: Mit einem neuen
apigee-adminapi.sh
-Befehlszeilendienstprogramm können Sie dieselben Edge-Konfigurationsaufgaben ausführen wie durch Aufrufe an die Edge Management API. Siehe Dienstprogramm apigee-adminapi.sh verwenden. - Lautlose SSL-Konfiguration für virtuelle Hosts – Beim Erstellen einer Organisation oder Umgebung können Sie jetzt Attribute übergeben, um SSL auf einem virtuellen Host zu konfigurieren. Weitere Informationen finden Sie unter Eine Organisation in das Programm aufnehmen.
API-Dienste
Im Folgenden finden Sie neue Features für Edge API-Dienste, die in früheren Cloud-Versionen des Produkts bereitgestellt wurden.
Präfix mit fester Länge für das Syslog-Nachrichten-Logging (Cloud 16.03.30)
Die Syslog-Konfiguration enthält ein neues <FormatMessage>
-Element der Nachrichtenprotokollierungsrichtlinie. Wenn Sie <FormatMessage>true</FormatMessage>
festlegen, beginnen Syslog-Nachrichten mit einer festen Anzahl von Zeichen, mit der Sie von Apigee eingefügte Daten herausfiltern können. Weitere Informationen finden Sie unter Richtlinie für das Nachrichten-Logging. (APIRT-1398)
Platzhalter im API-Proxy-Basispfad (Cloud 16.03.09-UI)
Die Verwaltungs-UI unterstützt die Verwendung eines oder mehrerer /*/
-Platzhalter in API-Proxy-Basispfaden. Mit dem Basispfad /team/*/members
können Clients beispielsweise Ihren Proxy mit https://[host]/team/blue/members
oder https://[host]/team/green/members
aufrufen, ohne dass Sie einen neuen Proxy erstellen müssen, um neue Teams zu unterstützen. /**/
ist nicht zulässig. (MGMT-3154)
API-Proxy-Verkettung (Cloud 16.03.02, Cloud 16.03.09 UI)
Edge unterstützt die lokale API-Proxy-Verkettung. Dadurch kann ein API-Proxy einen anderen in Ihrer Edge-Organisation bereitgestellten API-Proxy ohne zusätzlichen Netzwerkaufwand aufrufen. Bisher war für die API-Proxy-Verkettung ein HTTP(s)-Aufruf an einen anderen API-Proxy erforderlich, der die Anfrage über einen Load-Balancer, Router und Message Processor weiterleitete.
Auf dem TargetEndpoint eines API-Proxys sind neue LocalTargetConnection
-Elemente verfügbar, mit denen Sie einen API-Proxy-Namen, den Namen eines bestimmten ProxyEndpoint innerhalb eines API-Proxys oder einfach den Basispfad zu einer lokalen API-Proxy-Ressource (z. B. /v1/myresource) angeben können. Die Proxy-Editor-UI bietet diese Optionen auch, wenn Sie einen TargetEndpoint hinzufügen oder aktualisieren.
Proxy-Verkettungen sind auch in Service-Callout-Richtlinien verfügbar.
Weitere Informationen finden Sie unter API-Proxys verketten. Die neuen LocalTargetConnection
-Elemente sind auch im folgenden XML-Schema aufgelistet: https://github.com/apigee/api-platform-samples/blob/master/schemas/configuration/configuration_schemas.xsd.
(MGMT-3049, MGMT-3050)
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 behoben wurden. Sie ist nicht darauf ausgelegt, detaillierte Informationen für alle Nutzer bereitzustellen.
Edge für Private Cloud 4.16.05
Fehler-ID | Beschreibung |
---|---|
PRC-770 | 16.01-Installationsprogramm kann den Postgres-Standby-Server nicht in axgroup registrieren |
PRC-758 | Nutzer mit der Nutzerrolle können benutzerdefinierte Berichte bearbeiten |
PRC-883 | Update auf dem Postgres-Server mit Master-Standby-Konfiguration schlägt fehl |
Cloud 16.03.30
Fehler-ID | Beschreibung |
---|---|
SECENG-584 | Validierungsprüfung für Zeilenumbruch zwischen Zertifikaten in einer Zertifikatskette verursacht Probleme mit einigen Zertifikaten in der Produktion |
MGMT-3217 | Management API-Aufrufe schlagen fehl, wenn der KVMap-Name auf „keys“ endet |
MGMT-3214 | Klassenkonflikte können während JavaCallouts auftreten, wodurch der Java-Code eines Kunden fehlschlägt. |
MGMT-3185 | Fehler beim Hinzufügen von orgadmins-Administratoren zu einer Organisation |
EDGEUI-127 | Unzureichende Berechtigungen mit neuem Proxy-Editor erhalten |
EDGEUI-119 | Problem mit Zeitüberschreitung bei UI-Sitzung |
CORESERV-671 | Fehlermeldung „Keine Ringe konfiguriert; CPS-Dienst kann nicht initialisiert werden“ |
AXAPP-2345 | Problem beim Auflisten benutzerdefinierter AX-Berichte für Kunden ohne CPS |
AXAPP-2302 | Die tägliche Apigee Analytics-Zusammenfassung zeigt, dass die Entwicklung nicht von den Entwicklern angenommen wird. |
APIRT-2750 | Viele Traffic-Fehler in einer bestimmten Organisation |
APIRT-2516 | Laufzeitfehler in JavaScript-Callouts enthalten falsche Zeilennummern |
APIRT-2508 | Exit-Fehler beim Aufrufen von Express Listen in einem Vault-Callback |
APIRT-2336 | Gzip-Problem mit Node.js |
APIRT-1975 | Maskenkonfigurationen funktionieren nicht für message.content |
Cloud 16.03.16-UI
Fehler-ID | Beschreibung |
---|---|
MGMT-3142 | Grafiken werden im Dashboard für die Fehleranalyse nicht geladen (aktualisierte Korrektur) |
Cloud 16.03.09-UI
Fehler-ID | Beschreibung |
---|---|
MGMT-3158 | Unzureichende Berechtigungen in der UI, wenn RBAC für einzelne Proxys über die API festgelegt ist |
MGMT-3142 | Diagramme werden im Dashboard für die Fehleranalyse nicht geladen |
MGMT-3118 | Die Benutzeroberfläche zeigt eine falsche Konfiguration des virtuellen SSL-Hosts für den Parameter „clientAuthEnabled“ an |
DEVRT-2344 | Definitionen für Einzeltagesberichte laden keine Transaktionen in die UI |
Cloud 16.03.02
Fehler-ID | Beschreibung |
---|---|
MGMT-3083 | Automatische Aktualisierung von Node.js-Logs ist zu ausführlich mit Logmeldungen |
DEVRT-2275 | Preispläne für benutzerdefinierte Attribute zeigen nur 5 Attribute anstelle der zulässigen 10 Attribute an. |
DEVRT-1275 | Im Drop-down-Menü „Preisplan“ werden nicht alle Entwickler angezeigt |
DEVRT-1074 | Prepaid-Entwickler mit null Guthaben wirft NullpointerException ab, wenn Guthaben angewendet wird |
Cloud 16.02.17
Fehler-ID | Beschreibung |
---|---|
MGMT-3083 | Automatische Aktualisierung von Node.js-Logs ist zu ausführlich mit Logmeldungen |
MGMT-3077 | Die UI generiert ein ungültiges Proxy-Bundle aus einer WSDL, die den Standard-Namespace verwendet |
MGMT-1642 | In der benutzerdefinierten Nutzerrolle fehlt die Get-Berechtigung für Entwickler-Apps |
Bekannte Probleme
In dieser Version gibt es die folgenden bekannten Probleme.
Fehler-ID | Beschreibung |
---|---|
APIRT-2978 |
Router startet nicht Nginx oder Router kann nicht gestartet werden Wenn der Edge Router Nginx nicht oder überhaupt nicht starten kann, wie in der Datei /opt/apigee/var/log/edge-router/logs/system.log gezeigt, löschen Sie alle Dateien im Verzeichnis /opt/nginx/conf.d und starten Sie den Router neu: > rm -f /opt/nginx/conf.d/* > /opt/apigee/apigee-service/bin/apigee-service edge-router restart |
APIRT-3364 |
Nachrichtenprozessor führt DNS-Lookups für IPv4 und IPv6 Wenn Sie NSCD (Name Service Cache Daemon) installiert und aktiviert haben, stellen Sie möglicherweise fest, dass Nachrichtenprozessoren zwei DNS-Lookups ausführen: eine für IPv4 und eine für IPv6. So deaktivieren Sie den DNS-Lookup für IPv6:
|
PRC-1118 |
Fehler beim Ausführen des Befehls „apigee-service apigee-postgresql pg-data-purge“ Wenn Sie den Befehl „apigee-service apigee-postgresql pg-data-purge“ ausführen und erhalten Sie einen Fehler im folgenden Format: FEHLER: muss Inhaber der Beziehung sein Bearbeiten Sie /opt/apigee/apigee-postgresql-4.16.05-0.0.894/lib/actions/pg-data-purge und setzen Sie das folgende Attribut auf „apigee“: POSTGRES_USER=apigee |
DOC-1687 | Aufgrund eines bekannten Konflikts aufgrund einer Paketabhängigkeit wird der in Satellite Server 6 verwendete Katello-Agent auf Apigee Edge-Hosts, auf denen der Qpid-Daemon ausgeführt wird, nicht ordnungsgemäß installiert. |
JSON-Nutzlasten in den Richtlinien zum Zuweisen von Nachrichten, Java-Callouts und zum Auslösen von Fehlern
Mit den Richtlinien „Zuweisen von Nachrichten“, „Java-Callout“ und „Fehler ausgeben“ können Sie mit dem Element <Set><Payload>
Nachrichteninhalte generieren. Dazu können Sie Variablen einbeziehen, deren Werte zur Laufzeit automatisch ausgefüllt werden. Wenn Sie beispielsweise das Datum aus dem HTTP-Header ausgeben möchten, können Sie {message.header.date}
in Ihre Nachricht einfügen.
Im JSON-Format sieht die Nachricht in etwa so aus:
{"The date is: " : "{message.header.date}"}
Wie Sie sehen, ist dies jedoch ein fehlerhaftes JSON-Format. Sie haben zwei Möglichkeiten, dieses Problem zu umgehen:
- Verwenden Sie zur Maskierung der öffnenden geschweiften Klammer einen umgekehrten Schrägstrich:
\{"The date is: " : "{message.header.date}"}
- Verwenden Sie in der Konfiguration des Nutzlastelements die Attribute
variablePrefix
undvariableSuffix
, um eine Variable in einer JSON-Nutzlast anzugeben. Beispiel:
<Payload contentType="application/json" variablePrefix="#" variableSuffix="%">{"The date is: " : "#message.header.date%"}</Payload>
Im nächsten Feature Release von Edge for Private Cloud können Sie geschweifte Klammern für Variablen in JSON-Nachrichten ohne Probleme verwenden. (APIRT-1160)
Router startet nicht Nginx oder Router kann nicht gestartet werden
Wenn der Edge Router Nginx nicht oder überhaupt nicht starten kann, wie in der Datei /opt/apigee/var/log/edge-router/logs/system.log gezeigt, löschen Sie alle Dateien im Verzeichnis /opt/nginx/conf.d und starten Sie den Router neu:
> rm -f /opt/nginx/conf.d/* > /opt/apigee/apigee-service/bin/apigee-service edge-router restart