Instalacja portalu usług dla deweloperów

Developer Services Portal w wersji 4.16.09

Przed instalacją upewnij się, że:

  • Wykonujesz instalację w 64-bitowej wersji obsługiwanej wersji systemu Red Hat Enterprise Linux, CentOS lub Oracle. Listę obsługiwanych wersji znajdziesz tutaj.
  • Zainstalowano aplikację Yum.
  • Tworzysz kopię zapasową istniejących instalacji. Jeśli zmienisz kod w podstawowym kodzie Drupal lub w modułach innych niż niestandardowe, te zmiany zostaną zastąpione. Obejmuje to między innymi wszelkie zmiany wprowadzone w pliku .htaccess. Możesz zakładać, że wszystkie dane znajdujące się poza katalogiem /sites należą do platformy Drupal. Wyjątkiem od tej reguły jest plik robots.txt. Jeśli ten plik istnieje w katalogu głównym, zostanie zachowany. Przed kontynuowaniem instalacji utwórz kopię zapasową całego katalogu głównego internetowego Drupal. Domyślna lokalizacja instalacji to /var/www/html, ale mogła zostać zmieniona podczas instalacji. Po wykonaniu opisanych poniżej kroków instalacji możesz przywrócić dostosowania z kopii zapasowej.

Aby zainstalować portal usług kanału dla programistów, wykonaj te czynności.

1. Pobierz pakiet usług kanału dla programistów

Otwórz stronę http://community.apigee.com/content/apigee-customer-support i wybierz Zaloguj się do swojego portalu pomocy, aby poprosić o plik .tar usług kanału dla programistów na 2 sposoby:

  • Poproś o dostęp do katalogu pobierania Edge for Private Cloud.
  • Poproś o adres URL pliku tar usług kanału dla programistów.

2. Testowanie połączenia z Apigee Edge

Przetestuj połączenie z serwerem zarządzania brzegowym, wykonując to polecenie cURL z wiersza polecenia na serwerze portalu:
> curl -u {EMAIL}:{PASSWORD}



Podaj nazwę hosta i numer portu właściwe dla instalacji Edge. Port 8080 to port domyślny używany przez Edge. Jeśli łączysz się z organizacją w chmurze, "request URL", "request URL", "request URL", 1348689232699, "displayName", 1348689232699














3. Usuwanie wersji PHP starszych niż 7.0

Przed rozpoczęciem instalacji skrypt instalacyjny sprawdza, czy w systemie są wersje języka PHP starsze niż 7.0. Jeśli istnieją wersje PHP w wersjach starszych niż 7.0, zobaczysz 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 systemu CentOS i Red Hat Enterprise Linux (RHEL) usuń pakiety PHP za pomocą tego polecenia:

yum remove <package-name>

4. Zainstaluj usługi kanału dewelopera za pomocą automatycznego skryptu instalacji

Zainstaluj portal za pomocą jednej z poniższych procedur w zależności od tego, czy instalujesz go na serwerze z połączeniem internetowym czy bez.

Na serwerze z połączeniem internetowym:

Aby zainstalować usługi kanału dla programistów na serwerze z połączeniem internetowym:

  1. Zaloguj się na serwerze jako root lub superużytkownik.
  2. Utwórz katalog z plikami instalacyjnymi, np. portal.
  3. Dodaj dysk CD do nowego katalogu portal i pobierz plik DeveloperServices_x.y.z.tar usług kanału programisty, gdzie x.y.z odpowiada numerowi wersji portalu.

    Możesz pobrać plik z linku przesłanego przez Apigee w przeglądarce lub skopiować go i dodać do tego polecenia cURL:
    > curl -kOL <wklej link tutaj>
  4. Wyodrębnij zawartość pliku tar w usługach kanału dla programistów za pomocą polecenia:
    > tar -xvf <plik tar>
  5. CD do DeveloperServices-4.x.y.z.
  6. Uruchom skrypt instalacyjny za pomocą tego polecenia:
    > ./networked-install.sh
  7. Odpowiadaj na prompty.

Na serwerze bez połączenia z internetem:

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

  1. Zaloguj się do systemu z połączeniem internetowym jako użytkownik root lub superużytkownik.
  2. Utwórz katalog z plikami instalacyjnymi, np. portal_tar.
  3. Znajdź na dysku CD katalog portal_tar i pobierz plik DeveloperServices_x.y.z.tar usług kanału programisty, gdzie x.y.z odpowiada numerowi wersji portalu.
  4. Wyodrębnij zawartość pliku .tar w usługach kanału dla programistów za pomocą polecenia:
    > tar -xvf <plik tar>
  5. CD do DeveloperServices-4.x.y.z.
  6. Utwórz plik portalu .tar.gz za pomocą polecenia:
    > ./non-networked-install.sh

Zostanie utworzony nowy plik .tar.gz dla instalacji bez sieci.

Aby zainstalować usługi kanału dla programistów na serwerze bez połączenia z internetem:

      1. Zaloguj się na serwerze jako root lub superużytkownik.
      2. Utwórz katalog z plikami instalacyjnymi, np. portal.
      3. CD do katalogu portalu.
      4. Skopiuj do katalogu portal plik .tar.gz utworzony dla instalacji spoza sieci (zgodnie z procedurą powyżej).
      5. Wyodrębnij zawartość pliku .tar.gz za pomocą polecenia:
        > tar -xvf <plik tar>
      6. CD do katalogu utworzonego przez polecenie tar.
      7. Ustaw uprawnienia w skrypcie install-from-rpm-bundle.sh:
        > chmod 755 instalacja-from-rpm-bundle.sh
      8. Uruchom skrypt install-from-rpm-bundle.sh za pomocą polecenia:
        > ./install-from-rpm-bundle.sh
      9. Odpowiadaj na prompty.

      5. Konfigurowanie portalu dla programistów

      Znaczna część konfiguracji portalu jest realizowana bez konieczności udziału użytkownika, na przykład instalacji modułu Drupal i tworzenia domyślnej zawartości. Pojawi się prośba o skonfigurowanie bazy danych i punktu końcowego Edge oraz utworzenie nowego administratora.

      Aby skonfigurować portal dla programistów:

      1. Otwórz w przeglądarce adres URL serwera, na przykład:
        http://localhost. Jeśli masz skonfigurowany określony adres IP lub DNS, otwórz adres http://adres_IP lub http://nazwa_DNS.

        Nastąpi przekierowanie na stronę konfiguracji bazy danych profilu Apigee.

        Uwaga: zwykle nazwa hosta jest skonfigurowana i zarejestrowana na Twoim serwerze DNS, dzięki czemu nie musisz używać http://localhost.
      2. Skonfiguruj połączenie z bazą danych. Jeśli baza danych znajduje się na komputerze zdalnym, rozwiń sekcję Opcje zaawansowane i wpisz informacje o połączeniu z tym komputerem, a następnie kliknij Zapisz i kontynuuj.
      3. Skonfiguruj połączenie z punktem końcowym Apigee, wpisując poniższe informacje, a następnie kliknij Zapisz.
        Więcej informacji o tych wartościach znajdziesz w sekcji „Informacje wymagane przed rozpoczęciem instalacji” w wymaganiach portalu dla programistów.
        1. Organizacja interfejsu Management API
        2. URL punktu końcowego interfejsu API zarządzania
        3. Uwierzytelniony użytkownik punktu końcowego
        4. Uwierzytelnione hasło użytkowników
      4. Skonfiguruj administratora, wpisując poniższe informacje, a potem kliknij Zapisz. Pamiętaj, że w Drupal domyślnie tworzony jest administrator o nazwie „admin”, więc nie używaj słowa „admin” jako nazwy użytkownika.
        Nawet jeśli pominiesz ten krok, nadal możesz użyć Drush, aby utworzyć administratora w sposób opisany w kroku 4. Utwórz administratora.
        1. Imię i nazwisko dewelopera
        2. Nazwa użytkownika portalu dla programistów
        3. Hasło
        4. Adres e-mail
      5. Po zakończeniu instalacji ustaw uprawnienia w pliku settings.php:
        > chmod 640 /var/www/html/sites/default/settings.php
      6. Wejdź na stronę główną portalu (http://localhost/) lub do nazwy DNS portalu.
      7. Zaloguj się w portalu przy użyciu danych logowania administratora.

      6. Tworzenie administratora (opcjonalnie)

      Użyj Drush, aby utworzyć użytkownika administracyjnego do instalacji usług kanału dla programistów. Drupal automatycznie tworzy administratora o domyślnej nazwie „admin”, więc nie używaj słowa „admin” jako nazwy użytkownika.

      1. Dysk CD 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 w prywatnych plikach Drupal:
        > drush vget file_private_path

        To polecenie zwraca ścieżkę do prywatnych plików Drupala, na przykład:
        file_private_path: 'sites/default/private'

        Odpowiada to adresowi /var/www/html/sites/default/private/. Użyj tego polecenia, aby upewnić się, że właściciel i grupa mogą zapisywać w tym katalogu:
        chmod -R g+w dirPathAndName
        chmod -R o+r dirPathAndName
      3. Wpisz te polecenia, aby utworzyć administratora, zastępując polecenia w elemencie „< >” własnymi wartościami:
        > drush user-create <nazwa_użytkownika> --mail="<adres-e-mail>" --password="<hasło>"
        > drush user-add-role Administrator <nazwa_użytkownika>
      4. Zaloguj się w portalu dla programistów jako administrator przy użyciu nazwy użytkownika i hasła podanych powyżej.

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

      Jeśli podczas instalacji portalu zainstalowano MySQL, skrypt instalacyjny pozostawia domyślne hasło główne MySQL ustawione na wartość domyślną, która jest pusta.

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

      > mysqladmin -u root password NEWPASSWORD

      Jeśli masz już ustawione hasło roota 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. Sprawdź, czy moduł menedżera aktualizacji jest włączony

      Aby otrzymywać powiadomienia o aktualizacjach w serwisie Drupal, musisz włączyć moduł menedżera aktualizacji Drupal. W menu Drupal wybierz Modules (Moduły) i przewiń w dół do modułu Zaktualizuj menedżera. Jeśli nie jest włączony, włącz go.

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

      > drush pm-info update

      Użyj opcji Raporty > Dostępne aktualizacje > Ustawienia, aby skonfigurować wysyłanie e-maili z modułem o dostępności aktualizacji oraz 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ć swoją instalację MySQL:
        > /usr/bin/mysql_secure_installation

        Skrypt ten ustawia hasło roota i umożliwia ograniczenie dostępu roota tylko do hosta lokalnego oraz usunięcie domyślnie utworzonych testowych baz danych i anonimowego użytkownika. Uruchomienie tego skryptu jest zdecydowanie zalecane w przypadku serwerów produkcyjnych.
      2. Jeśli wymagają tego zasady obowiązujące w firmie, włącz i skonfiguruj SELinux.

      8. Skonfiguruj wyszukiwarkę Apache Solr (opcjonalnie)

      Domyślnie moduły Drupal łączące się z wyszukiwarką Apache Solr są wyłączone podczas instalacji portalu. Większość portali używa wewnętrznej wyszukiwarki Drupal, więc nie wymagają one modułów Drupal Solr.

      Jeśli chcesz 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 z uprawnieniami do tworzenia treści.
      2. W menu Drupal wybierz Modules (Moduły).
      3. Włącz moduł Apache Solr Framework i Apache Solr Search.
      4. Zapisz zmiany.
      5. Skonfiguruj oprogramowanie Solr w sposób opisany na stronie https://drupal.org/node/1999280.

      9. Zainstaluj mod_ssl, aby obsługiwać protokół HTTPS (opcjonalnie)

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

      > yum install mod_ssl

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

      10. Zainstaluj SmartDokumenty (opcjonalnie)

      SmartDokumentacja umożliwia dokumentowanie interfejsów API w portalu usług dla programistów w taki sposób, że dokumentacja interfejsu API jest w pełni interaktywna. Jeśli jednak chcesz używać aplikacji SmartDokumentacja w portalu, musisz najpierw zainstalować te dokumenty w przeglądarce Edge.

      • Jeśli łączysz portal z instalacją Edge Cloud, aplikacja SmartDokumentacja jest już zainstalowana i nie jest wymagana żadna dodatkowa konfiguracja.
      • Jeśli łączysz portal z instalacją Edge dla Private Cloud, musisz zainstalować aplikację SmartDokumentacja w Edge. Więcej informacji o instalowaniu Edge i SmartDokumentów znajdziesz w artykule Instalowanie SmartDokumentów.

      Więcej informacji o SmartDokumentach znajdziesz w artykule Używanie SmartDokumentów do dokumentowania interfejsów API.

      11. Co dalej?

      Następnym krokiem po zainstalowaniu portalu usług dla programistów jest jego skonfigurowanie i dostosowanie do swoich potrzeb. Dokumentacja w witrynie Apigee zawiera wszystkie informacje na temat konfigurowania portalu i określania jego stylu oraz zarządzania nim. Zapoznaj się z dokumentacją 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 wykonujesz po instalacji, oraz linki do dokumentacji Apigee, gdzie znajdziesz więcej informacji:

      Zadanie

      Opis

      Dostosowywanie motywu

      Motyw określa wygląd portalu, w tym kolory, styl i inne aspekty wizualne.

      Dostosowywanie wyglądu

      Strona główna zawiera menu główne, wiadomość powitalną, nagłówek, stopkę i tytuł.

      Dodawanie kont użytkowników i zarządzanie nimi

      Proces rejestracji kontroluje sposób, w jaki nowi deweloperzy rejestrują konto w portalu. Na przykład nowi deweloperzy uzyskają natychmiastowy dostęp do portalu lub muszą zostać zweryfikowani przez administratora. Ten proces określa też sposób powiadamiania administratora portalu o utworzeniu nowego konta.

      Konfiguruję pocztę e-mail

      Portal wysyła e-maile w odpowiedzi na określone zdarzenia. na przykład gdy nowy deweloper zarejestruje się w portalu i utraci hasło.

      Dodawanie kont użytkowników i zarządzanie nimi

      Dodaj stronę z warunkami korzystania z usługi, którą deweloperzy muszą zaakceptować, zanim będą mogli uzyskać dostęp do portalu.

      Dodawanie kont użytkowników i zarządzanie nimi

      Portal stosuje model autoryzacji na podstawie ról. Zanim zezwolisz deweloperom na rejestrację, określ uprawnienia i role używane przez portal.

      Dodawanie postów na blogu i forum

      Portal ma wbudowaną obsługę blogów i forów z wątkami. Określ uprawnienia wymagane do wyświetlania, dodawania, edytowania i usuwania postów na blogu i forum.

      Sprawdź, czy wykonujesz kopie zapasowe bazy danych

      Upewnij się, że tworzysz kopię zapasową bazy danych Drupal. Każda instalacja jest inna, dlatego to Ty decydujesz, jak najlepiej utworzyć kopię zapasową bazy danych.

      Skonfiguruj nazwę hosta

      Jeśli nie skonfigurujesz nazwy hosta na serwerze DNS, zawsze możesz uzyskać dostęp do witryny za pomocą adresu IP serwera. Jeśli chcesz używać nazwy hosta, możesz dla niego skonfigurować DNS. Powinien on działać prawidłowo bez żadnej innej konfiguracji w ramach konfiguracji podstawowej.

      Jeśli skonfigurujesz system równoważenia obciążenia lub z jakiegoś powodu w witrynie otrzymujesz nieprawidłowe adresy URL, możesz ustawić parametr $base_url w pliku settings.php portalu dla programistów, który domyślnie znajduje się w katalogu /var/www/html/sites/default.