Wyświetlasz dokumentację Apigee Edge.
Otwórz dokumentację Apigee X. Informacje
Od 31 maja 2020 r. Apigee nie będzie już sponsorować hostingu portali deweloperskich opartych na Drupalu 7 (D7P). Wcześniej, od 31 maja 2019 roku, klienci muszą samodzielnie konfigurować nowe portale oparte na Drupalu.
Jakie zmiany są wprowadzane?
W kwietniu 2019 roku ogłosiliśmy udostępnienie zespołów i odbiorców deweloperów w ramach zintegrowanego portalu dla deweloperów Apigee. W maju 2019 roku ogłosiliśmy, że portale oparte na Drupalu 8 (D8P) są gotowe do wdrożenia w produkcji. Zapewniają one nową alternatywę dla portalu zintegrowanego zarządzanego przez Apigee. Zawierają też nową funkcję SmartDocs. Wraz z ogłoszeniem D8P ogłosiliśmy, że za 12 miesięcy zakończymy hosting D7P, a skrypty instalacyjne i aktualizacyjne dla chmury prywatnej D7P zostaną usunięte w wersji 20.06.
Dlaczego sponsoring przez Apigee hostingu portali deweloperskich opartych na Drupalu 7 się kończy?
Hosting sponsorowany przez Apigee dla D7P zostanie zakończony w maju 2020 r. z 2 powodów:
- Zintegrowane portale firmy Apigee stały się atrakcyjną opcją dla klientów, ponieważ oferują zaawansowane funkcje i niższe całkowite koszty posiadania.
- Drupal 8 to przyszłość dla tych, którzy chcą pozostać na ścieżce Drupal. Chociaż przeniesienie z D7P na D8P wymaga sporo pracy, D8P oferuje lepszą trajektorię dla każdego klienta, który woli samodzielnie zarządzać kontem dewelopera.
Co muszę zrobić?
Klienci Apigee D7P powinni rozważyć dostępne alternatywy i nawiązać bezpośrednie relacje z preferowanym dostawcą hostingu, takim jak Pantheon czy Acquia, lub rozważyć inne opcje hostingu.
Jakie opcje należy wziąć pod uwagę?
Klienci Google Cloud, którzy korzystają z D7P, mają 3 opcje:
- Przejdź do zintegrowanych portali Apigee.
- Przejdź na Drupala 8.
- Do 31 maja 2020 r. pozostań przy Drupalu 7 i przejmij odpowiedzialność za hosting.
Klienci korzystający z chmury prywatnej, którzy używają D7P, mają do wyboru 2 opcje:
- Przejdź na Drupala 8.
- Na razie pozostań przy Drupal 7.
Poniżej znajdziesz bardziej szczegółowe omówienie każdej z tych opcji.
Opcja 1. Przejście na zintegrowany portal Apigee
Kto powinien to rozważyć?
Dostawcy interfejsów API, którzy korzystają z Drupala 7 z minimalną ilością dostosowań, lub osoby, które wolą kompleksowe rozwiązanie, które jest bardziej zorientowane na konfigurację i ma niższy całkowity koszt posiadania.
Portal deweloperski zintegrowany bezpośrednio z Apigee Edge zawiera potężny katalog interfejsów API oraz atrakcyjny system zarządzania treścią oparty na Markdownie z zaawansowanymi narzędziami do zarządzania odbiorcami. Aby ustalić, czy zintegrowany portal będzie odpowiedni dla Twojego programu API, skontaktuj się z przedstawicielem konta Apigee.
Wskazówki dotyczące planowania i przeprowadzania migracji komponentów portalu Drupal 7 do zintegrowanego portalu znajdziesz w artykule Przenoszenie portalu Drupal 7 do zintegrowanego portalu.
Opcja 2. Przejdź na Drupala 8
Kto powinien to rozważyć?
Dostawcy interfejsów API, którzy wykorzystali funkcje Drupala 7 w połączeniu z wysoką elastycznością i zainwestowali w stworzenie konkretnego środowiska dla programistów.
Ze względu na duże różnice między Drupalem 7 a Drupalem 8, np. w sposobie renderowania stron, odtworzenie podobnych dostosowań może wymagać sporo pracy. Jeśli przewidujesz, że będziesz potrzebować pomocy specjalistów od Drupala 8, przedstawiciel konta Apigee może polecić Ci doświadczonych partnerów zajmujących się tworzeniem aplikacji Drupal. Chociaż firma Apigee nie udostępnia hostingu dla D8P, firmy Pantheon i Acquia mają doświadczenie w hostowaniu D8P dla klientów Apigee.
Opcja 3. Pozostań przy Drupal 7
Kto powinien to rozważyć?
Dostawcy interfejsów API, którzy korzystają już z Drupala 7 i chcą mieć więcej czasu na podjęcie decyzji.
Projekt Drupal 7 opublikował harmonogram wsparcia długoterminowego (LTS) do 2021 r. Ten komunikat o przenoszeniu usług hostingowych nie ma wpływu na obsługę modułów, które integrują Drupala 7 z Apigee Edge. Pamiętaj jednak, że każdy klient chmury, który chce pozostać na Drupalu 7, musi do 31 maja 2020 r. przejąć bezpośrednią odpowiedzialność za swoje konto u swojego dostawcy usług hostingowych.
Jak mogę wyeksportować swoje dane (klienci korzystający z usług w chmurze)?
Aby wyeksportować dane Drupal, skorzystaj z procesu eksportu w Pantheon lub Acquia.
Co się stanie, jeśli nie podejmę odpowiednich działań?
Po 31 maja 2020 r. D7P nie będzie już dostępna dla Ciebie ani Twoich klientów. Nie będziesz mieć możliwości administrowania ani rozwijania D7P, a Twoi klienci nie będą mogli zalogować się w portalu D7P. Wszystkie portale D7P hostowane przez Apigee zostaną wycofane 31 maja 2020 r.
Z kim mogę się skontaktować, aby uzyskać więcej informacji lub pomoc?
Aby uzyskać dodatkowe informacje o zakończeniu hostingu portalu dla deweloperów opartego na Drupalu 7, zgłoś zgłoszenie w portalu pomocy Apigee, wpisując w polu tematu „Drupal 7-based Developer Portal - hosting”.
Czy są dostępne jakieś narzędzia lub pomoc ułatwiające migrację z D7P na D8P?
Chociaż firma Apigee nie zapewnia bezpośredniej pomocy dotyczącej Drupala, opiekun konta Apigee może skontaktować Cię z ekspertami Drupala, którzy pomogą Ci w migracji i rozwoju niestandardowym.
Czy są dostępne jakieś narzędzia lub pomoc, które ułatwiają migrację z D7P do zintegrowanych portali?
Wskazówki dotyczące planowania i przeprowadzania migracji komponentów portalu Drupal 7 do zintegrowanego portalu znajdziesz w artykule Przenoszenie portalu Drupal 7 do zintegrowanego portalu.
Chociaż nie ma żadnych narzędzi do migracji z Drupala do portalu zarządzanego przez Apigee, firma Apigee może pomóc w przeprowadzce. Najlepszymi kandydatami są te, które nie zainwestowały znacznych środków w rozwiązania niestandardowe, które mogą nie nadawać się do przeniesienia, np. w przypadku określonych procesów roboczych lub narzędzi zatwierdzania. Aby uzyskać więcej informacji, skontaktuj się z opiekunem klienta Apigee.
Jakie zmiany zostały wprowadzone w SmartDocs?
W następnych sekcjach opisano zmiany wprowadzone w Drupalu 8 w nowej wersji aplikacji SmartDocs w porównaniu z Drupalem 7.
Jak nowa funkcja SmartDocs wypada na tle wersji opartej na Drupal 7?
Możesz być już zaznajomiony z dokumentami SmartDocs używanymi w portalach deweloperów Drupala 7. Zapoznaj się z artykułem Używanie SmartDocs do dokumentowania interfejsów API.
SmartDocs w Drupalu 8 oferuje wiele funkcji, których można oczekiwać w dokumentacji interfejsu API, a teraz działa bezpośrednio na podstawie specyfikacji OpenAPI. Więcej informacji znajdziesz w artykule Dokumentowanie interfejsów API.
Czy specyfikacja OpenAPI 3.0.x jest obsługiwana w SmartDocs?
Specyfikacja OpenAPI 3.0.x jest obsługiwana przez nowe dokumenty inteligentne dostępne w portalu Drupal 8. W przyszłości planujemy wprowadzić lepszą obsługę nowych funkcji specyfikacji.
Jakie typy uwierzytelniania są obsługiwane w usłudze SmartDocs?
Panel Wypróbuj ten interfejs API w SmartDocs działa z niezabezpieczonymi lub zabezpieczonymi punktami końcowymi, korzystając z uwierzytelniania podstawowego, za pomocą klucza interfejsu API lub OAuth, w zależności od metody zabezpieczeń zdefiniowanej w specyfikacji OpenAPI. W przypadku OAuth obsługiwane są te procesy: kod autoryzacji, pośredni, hasło i dane logowania klienta.
Czy SmartDocs to jedyna opcja w przypadku dokumentacji interfejsu API?
SmartDocs to gotowe rozwiązanie Apigee do dokumentacji interfejsu API oparte na specyfikacji OpenAPI, ale Apigee zdaje sobie sprawę, że warto mieć wybór. W przypadku portali Drupal 8 moduł katalogu interfejsu API obsługuje dodatkowe rozwiązania do renderowania, takie jak formatowanie pól w interfejsie Swagger UI.