Instalacja portalu usług dla deweloperów

Developer Services Portal w wersji 4.16.09

Zanim zainstalujesz, upewnij się, że:

• Instalujesz 64-bitową wersję obsługiwanej wersji Red Hat Enterprise Linux, CentOS lub Oracle. Listę obsługiwanych wersji znajdziesz tutaj.
• Yum jest zainstalowany.
• tworzyć kopie zapasowe istniejących instalacji, Jeśli zmodyfikowano kod w rdzeniu Drupal lub w modułach niestandardowych, zmiany zostaną zastąpione. Obejmuje to m.in. wszelkie zmiany wprowadzone w pliku .htaccess. Możesz założyć, że wszystko poza katalogiem /sites należy do Drupal. Wyjątkiem od tej reguły jest plik robots.txt. Jeśli ten plik istnieje w katalogu głównym witryny, zostanie zachowany. 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.

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

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. Testowanie połączenia z Apigee Edge

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. Usuwanie wersji PHP starszych niż 7.0

Przed rozpoczęciem instalacji skrypt instalacyjny sprawdza, czy w systemie są zainstalowane wersje PHP starsze niż 7.0. Jeśli istnieją wersje PHP starsze niż 7.0, pojawi się ten komunikat ostrzegawczy:

The following packages present on your system conflict with software we are
about to install. You will need to manually remove each one, then re-run this install script.
php
php-cli
php-common
php-gd
php-mbstring
php-mysql
php-pdo
php-pear
php-pecl-apc
php-process
php-xml

W przypadku CentOS i Red Hat Enterprise Linux (RHEL) usuń pakiety PHP za pomocą tego polecenia:

yum remove <package-name>

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

Użyj jednej z poniższych procedur, aby zainstalować portal, w zależności od tego, czy instalujesz go na serwerze z połączeniem internetowym czy bez niego.

Na serwerze z połączeniem z internetem:

Aby zainstalować Developer Channel Services na serwerze z połączeniem internetowym:

1. Zaloguj się na serwerze jako root lub superużytkownik.
2. Utwórz katalog na pliki instalacyjne, np. portal.
3. 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, korzystając z linku wysłanego przez Apigee w przeglądarce, lub skopiować go i dodać do tego polecenia cURL:
   > curl -kOL <paste link here>
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. Uruchom skrypt instalacyjny za pomocą tego polecenia:
   > ./networked-install.sh
7. Odpowiedz na pytania.

Na serwerze bez połączenia z internetem:

Najpierw utwórz skrypt instalacyjny bez połączenia z siecią w systemie, który ma połączenie z internetem:

1. Zaloguj się w systemie z połączeniem internetowym jako użytkownik root lub superużytkownik.
2. Utwórz katalog na pliki instalacyjne, np. portal_tar.
3. Przejdź do katalogu portal_tar 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ą polecenia:
   > ./non-networked-install.sh

Zostanie utworzony nowy plik .tar.gz do instalacji bez połączenia z siecią.

1. Zaloguj się na serwerze jako root lub superużytkownik.
2. Utwórz katalog na pliki instalacyjne, np. portal.
3. Przejdź do katalogu portal.
4. Skopiuj plik .tar.gz utworzony na potrzeby instalacji bez połączenia z siecią (w procedurze powyżej) do katalogu portal.
5. Wyodrębnij zawartość pliku .tar.gz za pomocą polecenia:
   > tar -xvf <tar file>
6. Przejdź do katalogu utworzonego przez polecenie tar.
7. Ustaw uprawnienia skryptu install-from-rpm-bundle.sh:
   > chmod 755 install-from-rpm-bundle.sh
8. Uruchom skrypt install-from-rpm-bundle.sh za pomocą polecenia:
   > ./install-from-rpm-bundle.sh
9. Odpowiedz na pytania.

5. Konfigurowanie portalu dla programistów

Duża część konfiguracji portalu, np. instalacja modułu Drupal i tworzenie domyślnych treści, odbywa się bez konieczności interakcji z Twojej strony. Pojawi się prośba o skonfigurowanie bazy danych, skonfigurowanie punktu końcowego Edge i utworzenie nowego administratora.

Aby skonfigurować portal dla programistów:

1. W przeglądarce otwórz 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.
2. Skonfiguruj połączenie z bazą danych. Jeśli baza danych 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.
3. 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 Wymagania dotyczące portalu usług dla deweloperów.
   1. Organizacja interfejsu API zarządzania Google Analytics
   2. Management API Endpoint URL (URL punktu końcowego interfejsu API zarządzania).
   3. Uwierzytelniony użytkownik punktu końcowego
   4. Hasło uwierzytelnionych użytkowników
4. 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
5. Po zakończeniu instalacji ustaw uprawnienia do pliku settings.php:
   > chmod 640 /var/www/html/sites/default/settings.php
6. Przejdź na stronę główną portalu pod adresem http://localhost/ lub do nazwy DNS portalu.
7. Zaloguj się w portalu, używając danych logowania administratora.

6. Tworzenie konta administratora (opcjonalnie)

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. Wdrażanie na serwerze produkcyjnym (opcjonalnie)

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. Konfigurowanie wyszukiwarki Apache Solr (opcjonalnie)

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. Instalowanie mod_ssl w celu obsługi protokołu HTTPS (opcjonalnie)

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. Instalowanie SmartDocs (opcjonalnie)

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: