Sie sehen sich die Dokumentation zu Apigee Edge an.
Sehen Sie sich die Apigee X-Dokumentation an. info
Ab dem 31. Mai 2020 wird Apigee das Hosting von Drupal 7-basierten Entwicklerportalen (D7P) nicht mehr sponsern. Bis dahin müssen Kunden ab dem 31. Mai 2019 jedes neue Drupal-basierte Portal selbst bereitstellen.
Welche Änderungen werden vorgenommen?
Im April 2019 haben wir die Einführung von Entwicklerteams und Zielgruppen für das integrierte Entwicklerportal von Apigee angekündigt. Im Mai 2019 haben wir die Produktionsbereitschaft von Drupal 8-basierten Portalen (D8P) angekündigt. Diese Portale sind eine neue vom Kunden verwaltete Portalalternative zum von Apigee verwalteten integrierten Portal und enthalten die neuen SmartDocs. Gleichzeitig mit der Ankündigung von D8P haben wir das Ende des Hostings für D7P in 12 Monaten angekündigt. Außerdem werden die Installations- und Upgrade-Scripts für die D7P-Private Cloud in der Version 20.06 entfernt.
Warum wird das von Apigee gesponserte Hosting für Drupal 7-basierte Entwicklerportale eingestellt?
Das von Apigee gesponserte Hosting für D7P endet im Mai 2020 aus zwei Gründen:
- Die integrierten Portale von Apigee sind eine attraktive Option für Kunden, da sie erweiterte Funktionen und niedrigere Gesamtkosten bieten.
- Drupal 8 ist die Zukunft für alle, die Drupal weiter nutzen möchten. Die Migration von D7P zu D8P ist zwar nicht trivial, aber D8P bietet Kunden, die ein selbst verwaltetes Entwicklerportal bevorzugen, eine bessere Perspektive.
Was muss ich tun?
Kunden von Apigee D7P sollten die verfügbaren Alternativen prüfen und entweder eine direkte Beziehung zu einem bevorzugten Hostinganbieter wie Pantheon oder Acquia aufbauen oder andere Hostingoptionen in Betracht ziehen.
Welche Optionen gibt es?
Cloud-Kunden, die D7P verwenden, haben drei Möglichkeiten:
- Wechseln Sie zu den integrierten Portalen von Apigee.
- Migrieren Sie zu Drupal 8.
- Sie können bei Drupal 7 bleiben und bis zum 31. Mai 2020 die Hosting-Verantwortung übernehmen.
Kunden der Private Cloud, die D7P verwenden, haben zwei Möglichkeiten:
- Migrieren Sie zu Drupal 8.
- Bleiben Sie vorerst bei Drupal 7.
Diese Optionen werden unten genauer beschrieben.
Option 1: Zu einem integrierten Apigee-Portal wechseln
Für wen ist das geeignet?
API-Anbieter, die Drupal 7 mit minimaler Anpassung verwendet haben, oder solche, die eine All-in-One-Lösung bevorzugen, die stärker auf die Konfiguration ausgerichtet ist und geringere Gesamtkosten verursacht.
Das direkt in Apigee Edge integrierte Entwicklerportal enthält einen leistungsstarken API-Katalog und ein überzeugendes Markdown-basiertes Content-Management-System mit robusten Tools zur Zielgruppenverwaltung. Wenden Sie sich an Ihren Apigee-Kundenbetreuer, um herauszufinden, ob das integrierte Portal für Ihr API-Programm geeignet ist.
Eine Anleitung zum Planen und Ausführen der Migration Ihrer Drupal 7-Portal-Assets in das integrierte Portal finden Sie unter Drupal 7-Portal in das integrierte Portal migrieren.
Option 2: Zu Drupal 8 migrieren
Für wen ist das geeignet?
API-Anbieter, die die Funktionen von Drupal 7 in Verbindung mit einem hohen Maß an Anpassung und Investitionen in die Entwicklung einer bestimmten Entwicklerumgebung genutzt haben
Aufgrund der großen Unterschiede zwischen Drupal 7 und Drupal 8, z. B. bei der Seiten-Rendering-Engine, kann das Erstellen ähnlicher Anpassungen viel Arbeit erfordern. Wenn Sie Drupal 8-Spezialisten beauftragen möchten, kann Ihnen Ihr Apigee-Kundenbetreuer erfahrene Drupal-Entwicklungspartner empfehlen. Apigee bietet zwar kein Hosting für D8P an, Pantheon und Acquia haben jedoch Erfahrung mit dem Hosting von D8P für Apigee-Kunden.
Option 3: Bei Drupal 7 bleiben
Für wen ist das geeignet?
API-Anbieter, die bereits Drupal 7 verwenden und einfach mehr Zeit für eine Entscheidung benötigen
Für das Drupal 7-Projekt wurden Zeitpläne für den langfristigen Support (Long Term Support, LTS) bis 2021 veröffentlicht. Die Unterstützung der Module, die Drupal 7 mit Apigee Edge integrieren, ist von dieser Hosting-Ankündigung nicht betroffen. Cloud-Kunden, die bei Drupal 7 bleiben möchten, müssen jedoch bis zum 31. Mai 2020 die direkte Kontoverantwortung bei ihrem Hostinganbieter übernehmen.
Wie kann ich meine Daten exportieren lassen (Cloud-Kunden)?
Informationen zum Exportieren Ihrer Drupal-Daten finden Sie im Pantheon- oder Acquia.
Was passiert, wenn ich die erforderlichen Maßnahmen nicht ergreife?
Nach dem 31. Mai 2020 ist D7P für Sie und Ihre Kunden nicht mehr verfügbar. Sie können D7P dann nicht mehr verwalten oder damit entwickeln und Ihre Kunden können sich nicht mehr in Ihrem D7P-Portal anmelden. Alle von Apigee gehosteten D7P-Portale werden nach dem 31. Mai 2020 eingestellt.
An wen kann ich mich wenden, wenn ich weitere Informationen oder Hilfe benötige?
Wenn Sie weitere Informationen zum Ende des Hostings für das Drupal 7-basierte Entwicklerportal anfordern möchten, erstellen Sie bitte im Apigee-Supportportal ein Ticket mit dem Betreff „Drupal 7-basiertes Entwicklerportal – Hosting“.
Gibt es Tools oder Support zur Migration von D7P zu D8P?
Apigee bietet keinen direkten Support für Drupal. Ihr Apigee-Account Manager kann Sie jedoch mit Drupal-Experten in Verbindung setzen, die Sie bei der Migration und benutzerdefinierten Entwicklung unterstützen können.
Gibt es Tools oder Support zur Migration von D7P zu integrierten Portalen?
Eine Anleitung zum Planen und Ausführen der Migration Ihrer Drupal 7-Portal-Assets in das integrierte Portal finden Sie unter Drupal 7-Portal in das integrierte Portal migrieren.
Es gibt zwar keine Tools, mit denen Sie von Drupal zum von Apigee verwalteten Portal migrieren können, aber Apigee kann Sie bei der Migration unterstützen. Die besten Kandidaten sind diejenigen, die nicht viel in benutzerdefinierte Entwicklungen investiert haben, die sich möglicherweise nicht gut übertragen lassen, z. B. bestimmte Workflows oder Genehmigungstools. Weitere Informationen erhalten Sie von Ihrem Apigee-Kundenbetreuer.
Welche Änderungen wurden an SmartDocs vorgenommen?
In den folgenden Abschnitten werden die Änderungen beschrieben, die an den neuen SmartDocs in Drupal 8 im Vergleich zu Drupal 7 vorgenommen wurden.
Wie unterscheidet sich die neue SmartDocs-Funktion von der Drupal 7-basierten Version?
Möglicherweise sind Sie mit SmartDocs vertraut, die in Drupal 7-Entwicklerportalen verwendet werden. Weitere Informationen finden Sie unter APIs mit SmartDocs dokumentieren.
SmartDocs in Drupal 8 bietet viele der Funktionen, die Sie von einer API-Referenzdokumentation erwarten. Außerdem wird es jetzt direkt aus einer OpenAPI-Spezifikation ausgeführt. Weitere Informationen finden Sie unter APIs dokumentieren.
Wird die OpenAPI-Spezifikation 3.0.x von SmartDocs unterstützt?
Die OpenAPI-Spezifikation 3.0.x wird von den neuen SmartDocs unterstützt, die im Drupal 8-Portal verfügbar sind. Wir werden die Unterstützung für die neuen Funktionen der Spezifikation in Zukunft verbessern.
Welche Authentifizierungstypen werden von SmartDocs unterstützt?
Das Feld „API testen“ in SmartDocs funktioniert mit ungesicherten Endpunkten oder sicheren Endpunkten entsprechend der in der OpenAPI-Spezifikation festgelegten Sicherheitsmethode mit der grundlegenden API-Schlüsselvalidierung oder der OAuth-Authentifizierung. Bei OAuth werden folgende Abläufe unterstützt: Autorisierungscode, implizites Passwort und Clientanmeldedaten.
Ist SmartDocs meine einzige Option für die API-Dokumentation?
SmartDocs ist die Lösung von Apigee für die API-Dokumentation, die auf einer OpenAPI-Spezifikation basiert. Apigee ist sich jedoch bewusst, dass es gut ist, Optionen zu haben. Für Drupal 8-Portale unterstützt das API-Katalogmodul zusätzliche Rendering-Lösungen, z. B. den Swagger UI-Feldformatierer.