Migracja portalu Drupal 7 do zintegrowanego portalu

Przeglądasz dokumentację Apigee Edge.
Otwórz dokumentację Apigee X.
Informacje

W tej sekcji znajdziesz wskazówki, jak zaplanować i przeprowadzić migrację zasobów portalu Drupal 7 do zintegrowanego portalu.

Krok 1. Utwórz zintegrowany portal

Zanim przeniesiesz zasoby portalu Drupal 7, musisz utworzyć zintegrowany portal.

Aby utworzyć zintegrowany portal:

  1. Sprawdź, czy masz odpowiednie role pozwalające na zarządzanie zintegrowanym portalem.
  2. Utwórz zintegrowany portal.

Podczas tworzenia zintegrowanego portalu udostępniany jest zestaw stron początkowych, których możesz używać jako punktu wyjścia. Na stronach startowych znajdują się materiały demonstracyjne, które mogą zainspirować Cię przy tworzeniu własnego portalu, gdy będziesz zastępować tekst i obrazy własnymi treściami. Więcej informacji znajdziesz w artykule Informacje o przykładowym portalu.

Krok 2. Utwórz zintegrowany portal

Utwórz zintegrowany portal zgodnie z opisem w sekcji Kroki tworzenia portalu.

Wymagane jest co najmniej wykonanie czynności opisanych w poniższej tabeli.

Step Opis
Tworzenie treści portalu Mogą to być na przykład informacje koncepcyjne lub informacje dla początkujących.

Możesz utworzyć strony, a potem skopiować zawartość strony i wkleić ją bezpośrednio z dotychczasowego portalu Drupal 7.

Konfigurowanie nawigacji Utwórz wymaganą nawigację, aby dopasować ją do istniejącej struktury.
Dostosowywanie motywu Aby spełnić wymagania dotyczące budowania marki, dostosuj co najmniej te komponenty:
Dodawanie skryptów niestandardowych W razie potrzeby dodaj do portalu niestandardowy kod JavaScript.
Konfiguracja poczty e-mail Skonfiguruj serwer SMTP i treść e-maili z powiadomieniami.

Uwaga: konfiguracja powiadomień e-mail nie jest obecnie dostępna w przypadku portali zintegrowanych hybrydowych Apigee.

Zarządzanie widocznością domyślną Zarządzaj domyślną widocznością określonych zasobów.
Konfigurowanie zasad bezpieczeństwa treści Skonfiguruj standard Content Security Policy (CSP) na wszystkich stronach w portalu, aby w razie potrzeby zabezpieczyć się przed atakami typu cross-site scripting (XSS) i innymi atakami polegającymi na wstrzyknięciu kodu.

Uwaga: ta funkcja nie jest obecnie dostępna w przypadku portali zintegrowanych hybrydowych Apigee.

Krok 3. Skonfiguruj dostawcę tożsamości

Skonfiguruj dostawcę tożsamości w zintegrowanym portalu na podstawie typu uwierzytelniania, jak opisano w poniższej tabeli.

Uwierzytelnianie Opis
Wbudowany dostawca tożsamości (nazwa użytkownika i hasło) Skonfiguruj wbudowanego dostawcę tożsamości w zintegrowanym portalu.
Logowanie jednokrotne przy użyciu SAML Skonfiguruj dostawcę tożsamości SAML (beta) w zintegrowanym portalu.

Uwagi:

Gdy deweloperzy zalogują się w portalu, możesz zarządzać ich kontem zgodnie z opisem w artykule Zarządzanie kontami deweloperów.

Krok 4. Kontroluj dostęp do zasobów za pomocą grup odbiorców

Jeśli używasz ról w systemie Drupal 7 do kontrolowania dostępu do zbioru zasobów, na przykład do dokumentacji interfejsu API lub tworzenia klucza interfejsu API dla danej usługi, możesz uzyskać tę samą funkcję za pomocą list odbiorców w zintegrowanym portalu.

Za pomocą list odbiorców możesz kontrolować dostęp do tego zasobu w zintegrowanym portalu:

  • Strony w portalu
  • Opublikowane usługi API

Aby dodać listę odbiorców oraz zarządzać przypisaniami poszczególnych użytkowników i zespołu programistów, przeczytaj artykuł Zarządzanie odbiorcami. Gdy nowy użytkownik utworzy konto i zaloguje się w Twoim portalu, musisz przypisać go do co najmniej 1 grupy odbiorców zgodnie z opisem w sekcji Zarządzanie przypisaniami listy odbiorców.

Aby uprościć migrację, możesz skorzystać z tych wskazówek:

  • Nazwij listy odbiorców zgodnie z rolami Drupal, które chcesz zastąpić.
  • Zarządzaj członkostwem w odbiorcach, korzystając z zespołów programistów. Deweloperzy tworzą zespoły, aby dzielić się odpowiedzialnością za swoje aplikacje i zarządzać członkostwem w zespole.

Krok 5. Opublikuj interfejsy API

Aby publikować interfejsy API i automatycznie generować dokumentację API za pomocą SmartDokumentacja w zintegrowanym portalu, musisz mieć dostęp do specyfikacji OpenAPI powiązanej z interfejsem API.

Mimo że do automatycznego generowania SmartDokumentacja w Drupal 7 mogła zostać użyta specyfikacja OpenAPI, treści są przechowywane w formacie wewnętrznym bez powiązania z oryginalną specyfikacją OpenAPI. Zespoły interfejsów API korzystające z Apigee Edge zwykle przechowują specyfikacje OpenAPI w magazynie specyfikacji Apigee Edge.

Następnie opublikuj interfejs API w portalu. Przygotuj się:

  • Określ specyfikację OpenAPI, która ma być używana jako źródło dokumentacji z magazynu specyfikacji, katalogu lokalnego lub adresu URL
  • Konfigurowanie widoczności dokumentacji (publicznej, użytkowników uwierzytelniania lub wybranych grup odbiorców)
  • W razie potrzeby skonfiguruj adres URL wywołania zwrotnego
  • W razie potrzeby dodaj obraz do wyświetlenia w katalogu interfejsów API

Krok 6. Współdzielenie odpowiedzialności za aplikację z pomocą zespołów programistów

Jeśli deweloperzy używają aplikacji firmowych w systemie Drupal 7, aby wspólnie z nimi korzystać z aplikacji, mogą uzyskać tę samą funkcję, korzystając z zespołów deweloperskich w zintegrowanym portalu.

Deweloperzy mogą tworzyć zespoły programistów, aby dzielić się odpowiedzialnością za ich aplikacje i zarządzać członkostwem w zespole, zgodnie z opisem w artykule Wspólna odpowiedzialność za aplikację przez zespoły programistów (beta).

Możesz poinformować społeczność deweloperów o zespołach programistów i zachęcić ich do przeprowadzenia migracji aplikacji, tak aby zespoły deweloperów mogły podzielić się odpowiedzialnością i przejść na nowe klucze interfejsu API. Następnie możesz usunąć wszystkie aplikacje firmowe i powiązane z nimi artefakty za pomocą interfejsów API Edge.

Możesz też przenieść aplikacje firmowe do aplikacji zespołu deweloperów zgodnie z opisem w tym artykule na temat społeczności: Przenoszenie aplikacji należących do firmy do zespołów deweloperów.

Krok 7. Przygotuj się do uruchomienia zintegrowanego portalu

Zanim uruchomisz zintegrowany portal w środowisku produkcyjnym, rozważ wykonanie czynności opisanych w poniższej tabeli.

Step Opis
Dostosowywanie domeny Podaj własną nazwę domeny, aby spersonalizować swoją witrynę.

Uwaga: ta funkcja nie jest obecnie dostępna w przypadku portali zintegrowanych hybrydowych Apigee.

Konfigurowanie śledzenia Analytics Konfigurowanie śledzenia Analytics za pomocą Google Analytics lub własnej usługi śledzenia Analytics.
Tworzenie strony wyszukiwania niestandardowego Utwórz stronę Twojej wyszukiwarki i umieść w niej Twoją wyszukiwarkę Google.