Instalacja portalu usług dla deweloperów

Developer Services Portal w wersji 4.16.05

Aby zainstalować portal usług kanału dewelopera, wykonaj te czynności.

Zanim przejdziesz do instalacji, utwórz kopię zapasową całego katalogu głównego witryny Drupal. Domyślna lokalizacja instalacji to /var/www/html, ale mogła zostać zmieniona podczas instalacji. Po wykonaniu opisanych poniżej czynności instalacyjnych możesz przywrócić dostosowania z kopii zapasowej.

1. Pobieranie pakietu usług kanału dla deweloperów

Otwórz stronę http://community.apigee.com/content/apigee-customer-support i wybierz Login to your Support Portal (Zaloguj się w portalu pomocy), aby poprosić o plik .tar usług kanału dewelopera na jeden z 2 sposobów:

• Poproś o dostęp do katalogu pobierania Edge dla chmury prywatnej.
• Poproś o adres URL pliku .tar usługi Developer Channel Services.

2. Sprawdź, czy Twój system spełnia wymagania systemowe.

Zanim zainstalujesz portal, upewnij się, że Twój serwer spełnia te wymagania:

1. Upewnij się, że instalujesz 64-bitową wersję obsługiwanej wersji systemu Red Hat Enterprise Linux, CentOS lub Oracle. Listę obsługiwanych wersji znajdziesz tutaj.
2. Sprawdź, czy masz zainstalowany program Yum.
3. (W przypadku instalacji na serwerze bez połączenia z internetem) Najpierw musisz pobrać wszystkie niezbędne pliki na serwer z połączeniem z internetem jako pojedynczy plik .tar.gz. Następnie skopiuj ten plik .tar.gz na serwer bez połączenia z internetem, aby przeprowadzić instalację.
   1. Zaloguj się na serwerze z połączeniem internetowym jako użytkownik root lub superużytkownik.
   2. Utwórz katalog na pliki instalacyjne, np. portal_tar.
   3. Przejdź do nowego katalogu i pobierz plik Developer Channel Services DeveloperServices_x.y.z.tar, gdzie x.y.z odpowiada numerowi wersji portalu.
   4. Wyodrębnij zawartość pliku .tar Developer Channel Services za pomocą polecenia:
      > tar -xvf <plik tar>
   5. Przejdź do katalogu DeveloperServices-4.x.y.z.
   6. Utwórz plik .tar.gz portalu za pomocą tego polecenia:
      > ./non-networked-install.sh
      
      To polecenie pobiera wszystkie niezbędne pliki i umieszcza je w jednym pliku .tar.gz. Następnie skopiuj ten plik .tar.gz na serwer, który nie ma połączenia z internetem, aby dokończyć instalację.
4. Przetestuj połączenie z serwerem zarządzania Edge, wykonując to polecenie cURL w wierszu poleceń na serwerze portalu:
   > curl -u {EMAIL}:{PASSWORD} https://{hostname}:8080/v1/organizations/{ORGNAME}
   
   Gdzie EMAIL i PASSWORD to adres e-mail i hasło administratora organizacji ORGNAME.
   
   Pamiętaj, aby podać nazwę hosta i numer portu właściwe dla Twojej instalacji Edge. Port 8080 jest domyślnym portem używanym przez Edge. Jeśli łączysz się z organizacją w chmurze, adres URL żądania to:
   https://api.enterprise.apigee.com/v1/organizations/{ORGNAME}
   
   Jeśli polecenie się powiedzie, zwróci odpowiedź podobną do tej:
   {
   "createdAt" : 1348689232699,
   "createdBy" : "USERNAME",
   "displayName" : "cg",
   "environments" : [ "test", "prod" ],
   "lastModifiedAt" : 1348689232699,
   "lastModifiedBy" : "foo@bar.com",
   "name" : "cg",
   "properties" : {
   "property" : [ ]
   },
   "type" : "trial"
   }

3. Instalowanie usług kanału dla deweloperów za pomocą skryptu automatycznej instalacji

Aby zainstalować portal za pomocą skryptu automatycznej instalacji, wykonaj podane niżej czynności. Ta procedura działa w przypadku serwerów z zewnętrznym połączeniem z internetem lub bez niego.

1. Zaloguj się na serwerze jako root lub superużytkownik.
2. Utwórz katalog na pliki instalacyjne, np. portal.
3. Na serwerze z połączeniem internetowym:
   1. Przejdź do nowego katalogu portal i pobierz plik Developer Channel Services DeveloperServices_x.y.z.tar, gdzie x.y.z odpowiada numerowi wersji portalu.
      
      Możesz pobrać plik z linku wysłanego przez Apigee w przeglądarce lub skopiować go, a następnie dodać do tego polecenia cURL:
      > curl -kOL <paste link here>
   2. Wyodrębnij zawartość pliku .tar Developer Channel Services za pomocą polecenia:
      > tar -xvf <plik tar>
   3. Przejdź do katalogu DeveloperServices-4.x.y.z.
   4. Uruchom skrypt instalacyjny, używając tego polecenia:
      > ./networked-install.sh
4. Na serwerze bez połączenia z internetem:
   1. Skopiuj plik .tar.gz utworzony w sekcji 2. Sprawdź, czy Twój system spełnia wymagania systemowe.
   2. Wyodrębnij zawartość pliku .tar.gz za pomocą polecenia:
      > tar -xvf <tar file>
   3. Przejdź do katalogu utworzonego przez polecenie tar.
   4. Ustaw uprawnienia skryptu install-from-rpm-bundle.sh:
      > chmod 755 install-from-rpm-bundle.sh
   5. Uruchom skrypt install-from-rpm-bundle.sh, używając polecenia:
      > ./install-from-rpm-bundle.sh
5. Odpowiedz na pytania.
6. Po zakończeniu instalacji otwórz w przeglądarce adres URL serwera, np.
   http://localhost. Jeśli masz skonfigurowany konkretny adres IP lub DNS, wejdź na stronę http://IP_address lub http://DNS_name.
   
   Nastąpi przekierowanie na stronę konfiguracji bazy danych profilu Apigee.
   
   Uwaga: zwykle nazwa hosta jest już skonfigurowana i zarejestrowana na serwerze DNS, więc nie musisz używać adresu http://localhost.
7. Skonfiguruj połączenie z MySQL. Jeśli MySQL znajduje się na maszynie zdalnej, rozwiń sekcję Opcje zaawansowane i wpisz informacje o połączeniu z tą maszyną, a następnie kliknij Zapisz i kontynuuj.
8. Skonfiguruj połączenie z punktem końcowym Apigee, wpisując te informacje, a następnie kliknij Zapisz:
   Więcej informacji o tych wartościach znajdziesz w sekcji „Informacje wymagane przed rozpoczęciem instalacji” w artykule o wymaganiach portalu usług dla programistów.
   1. Dev Portal Org
   2. Dev Portal Endpoint URL (URL punktu końcowego portalu dla programistów)
   3. Uwierzytelniony użytkownik punktu końcowego
   4. Hasło uwierzytelnionych użytkowników
9. Gdy pojawi się prośba, kliknij przycisk Install Sample SmartDocs WADL (Zainstaluj przykładowy plik WADL SmartDocs), aby zainstalować przykładowy plik WADL SmartDocs. Jeśli pominiesz ten krok, przykładowy interfejs API SmartDocs nie pojawi się w Twoim portalu.
   Uwaga: jeśli portal łączy się z instalacją Apigee Edge dla chmury prywatnej, która nie ma zewnętrznego połączenia z internetem, musisz dodatkowo skonfigurować moduł SmartDocs, zanim będzie można z niego korzystać. Więcej informacji o SmartDocs znajdziesz na stronie http://apigee.com/docs/developer-services/content/using-smartdocs-document-apis.
10. Skonfiguruj ustawienia serwera SMTP. Apigee wymaga skonfigurowania serwera SMTP do wysyłania e-maili z portalu.
    Więcej informacji znajdziesz na stronie http://apigee.com/docs/developer-services/content/configuring-email.
11. Skonfiguruj konto administratora, wpisując te informacje, a następnie kliknij Zapisz. Pamiętaj, że Drupal domyślnie tworzy konto administratora o nazwie „admin”, więc nie używaj nazwy użytkownika „admin”.
    Jeśli pominiesz ten krok, nadal możesz użyć Drush, aby utworzyć administratora, jak opisano poniżej w punkcie 4. Utwórz konto administratora.
    1. Imię i nazwisko dewelopera
    2. Nazwa użytkownika portalu dla deweloperów
    3. Hasło
    4. Adres e-mail
12. Po zakończeniu instalacji ustaw uprawnienia do pliku settings.php:
    > chmod 640 /var/www/html/sites/default/settings.php
13. Przejdź na stronę główną portalu pod adresem http://localhost/ lub do nazwy DNS portalu.
14. Zaloguj się w portalu, używając danych logowania administratora.

4. Tworzenie konta administratora

Użyj Drush, aby utworzyć użytkownika z dostępem administracyjnym do instalacji Developer Channel Services. Drupal domyślnie automatycznie tworzy administratora o nazwie „admin”, więc nie używaj nazwy użytkownika „admin”.

1. Przejdź do katalogu drupal_root/sites/default. Standardowa lokalizacja katalogu głównego Drupal to /var/www/html:
   > cd <drupal_root>/sites/default
2. Sprawdź, czy masz uprawnienia do zapisu prywatnych plików Drupal:
   > drush vget file_private_path
   
   To polecenie zwraca ścieżkę do prywatnych plików Drupal, na przykład:
   file_private_path: 'sites/default/private'
   
   Odpowiada to ścieżce /var/www/html/sites/default/private/. Użyj tego polecenia, aby upewnić się, że właściciel i grupa mają uprawnienia do zapisu w tym katalogu:
   chmod -R g+w dirPathAndName
   chmod -R o+r dirPathAndName
3. Wpisz te polecenia, aby utworzyć konto administratora, zastępując polecenia w „< >” swoimi wartościami:
   > drush user-create <username> --mail="<email-address>" --password="<password>"
   > drush user-add-role Administrator <username>
4. Zaloguj się w portalu dla programistów jako administrator, używając nazwy użytkownika i hasła podanych powyżej.

5. Ustawianie głównego hasła do MySQL

Jeśli MySQL został zainstalowany w ramach instalacji portalu, skrypt instalacyjny pozostawia główne hasło do MySQL ustawione na wartość domyślną, czyli puste.

Aby ustawić hasło roota, użyj tego polecenia:

> mysqladmin -u root password NEWPASSWORD

Jeśli masz już ustawione hasło użytkownika root i chcesz je zmienić, użyj tego polecenia:

> mysqladmin -u root -p'OLDPASSWORD' password NEWPASSWORD

Musisz też zaktualizować hasło w pliku /var/www/html/sites/default/settings.php.

6. Upewnij się, że moduł Update manager jest włączony.

Aby otrzymywać powiadomienia o aktualizacjach Drupala, upewnij się, że moduł Drupal Update manager jest włączony. W menu Drupal wybierz Modules (Moduły) i przewiń w dół do modułu Update manager (Menedżer aktualizacji). Jeśli nie jest włączony, włącz go.

Po włączeniu tej opcji możesz zobaczyć dostępne aktualizacje, klikając Raporty > Dostępne aktualizacje. Możesz też użyć tego polecenia Drush:

> drush pm-info update

Użyj opcji menu Raporty > Dostępne aktualizacje > Ustawienia, aby skonfigurować moduł tak, aby wysyłał Ci e-maile, gdy dostępne są aktualizacje, i ustawić częstotliwość sprawdzania dostępności aktualizacji.

7. Opcjonalnie – wdrażanie na serwerze produkcyjnym

Jeśli wdrażasz portal na serwerze produkcyjnym, wykonaj dodatkowe czynności związane z bezpieczeństwem, takie jak:

1. Uruchom ten skrypt, aby zabezpieczyć instalację MySQL:
   > /usr/bin/mysql_secure_installation
   
   Ten skrypt ustawia hasło roota i daje możliwość ograniczenia dostępu roota tylko do hosta lokalnego oraz usunięcia domyślnie utworzonych testowych baz danych i anonimowego użytkownika. Zdecydowanie zalecamy uruchomienie tego skryptu na serwerach produkcyjnych.
2. Jeśli wymagają tego zasady firmy, włącz i skonfiguruj SELinux.

8. Opcjonalnie – skonfiguruj wyszukiwarkę Apache Solr

Domyślnie moduły Drupal, które łączą się z wyszukiwarką Apache Solr, są wyłączone podczas instalacji portalu. Większość portali korzysta z wewnętrznej wyszukiwarki Drupal, dlatego nie wymagają modułów Drupal Solr.

Jeśli zdecydujesz się używać Solr jako wyszukiwarki, musisz zainstalować Solr lokalnie na serwerze, a następnie włączyć i skonfigurować moduły Drupal Solr w portalu.

Aby włączyć moduły Drupal Solr:

1. Zaloguj się w portalu jako użytkownik z uprawnieniami administratora lub uprawnieniami do tworzenia treści.
2. W menu Drupal wybierz Modules (Moduły).
3. Włącz moduły Apache Solr Framework i Apache Solr Search.
4. Zapisz zmiany.
5. Skonfiguruj Solr zgodnie z opisem na stronie https://drupal.org/node/1999280.

9. Opcjonalnie – zainstaluj mod_ssl, aby obsługiwać HTTPS

Moduł mod_ssl jest używany przez serwer HTTP Apache do wyświetlania stron internetowych przez HTTPS. Jeśli chcesz używać protokołu HTTPS, zainstaluj mod_ssl za pomocą tego polecenia:

> yum install mod_ssl

Więcej informacji o konfigurowaniu portalu do korzystania z protokołu SSL znajdziesz na stronie http://apigee.com/docs/developer-services/content/using-ssl-portal.

10. Opcjonalnie – instalowanie SmartDocs

SmartDocs umożliwia dokumentowanie interfejsów API w portalu usług dla deweloperów w sposób, który sprawia, że dokumentacja API jest w pełni interaktywna. Aby jednak używać SmartDocs w portalu, musisz najpierw zainstalować SmartDocs w Edge.

• Jeśli łączysz portal z instalacją Edge Cloud, usługa SmartDocs jest już zainstalowana i nie jest wymagana żadna dalsza konfiguracja.
• Jeśli łączysz portal z instalacją Edge dla chmury prywatnej, musisz upewnić się, że w Edge jest zainstalowana usługa SmartDocs. Więcej informacji o instalowaniu Edge i SmartDocs znajdziesz w artykule Instalowanie SmartDocs.

Więcej informacji o SmartDocs znajdziesz w artykule Dokumentowanie interfejsów API za pomocą SmartDocs.

11. Co dalej?

Po zainstalowaniu portalu usług dla programistów należy go skonfigurować i dostosować do konkretnych wymagań. Dokumentacja w witrynie Apigee zawiera wszystkie informacje o konfigurowaniu i stylizowaniu portalu oraz zarządzaniu nim. Dokumentacja jest dostępna na stronie http://apigee.com/docs/developer-services/content/what-developer-portal.

W tabeli poniżej znajdziesz niektóre z najczęstszych zadań, które wykonuje się po instalacji, oraz linki do dokumentacji Apigee, w której znajdziesz więcej informacji: