Instalacja portalu usług dla deweloperów

Edge for Private Cloud w wersji 4.17.09

Przed instalacją upewnij się, że:

• Przed zainstalowaniem portalu musisz zainstalować Postgres. Możesz zainstalować Postgres zainstalować Edge lub zainstalować autonomiczną wersję Postgres na potrzeby portalu.
  • Jeśli zainstalujesz samodzielną wersję Postgres, może się ona znajdować w tym samym węźle co portal.
  • Jeśli łączysz się z Postgresem zainstalowanym w ramach Edge i skonfigurowanym Postgres w trybie mastera/gotowania podaj adres IP głównego serwera Postgres.
• Instalujesz 64-bitową wersję obsługiwanej wersji Red Hat Enterprise Linux, CentOS lub Oracle. Listę obsługiwanych wersji znajdziesz w artykule Obsługiwane oprogramowanie i obsługiwane wersje.
• Zainstalowano pakiet Yum.

Instalator zawiera tylko moduły pochodzące z platformy Drupal, które są wymagane przez portalu Apigee dla programistów (lub po prostu portalu). Informacje o instalowaniu innych dodanych modułów znajdziesz tutaj: Przedłużam Drupal 7.

Omówienie instalacji

Po zainstalowaniu w węźle narzędzia Edge apigee-setup użyj tego do zainstalowania portalu w węźle. Narzędzie apigee-setup ma postać:

> sudo /opt/apigee/apigee-setup/bin/setup.sh -p component -f configFile

Przekaż plik konfiguracji do narzędzia apigee-setup, który zawiera informacje na temat instalacji. Jeśli w pliku konfiguracji brakuje jakichkolwiek wymaganych parametr apigee-setup, zobaczysz prośbę o wpisanie go w wierszu poleceń.

Jedynym wymaganiem jest to, aby plik konfiguracji był dostępny i czytelny dla „apigee” użytkownika.

Możesz na przykład zainstalować portal za pomocą tego polecenia:

> sudo /opt/apigee/apigee-setup/bin/setup.sh -p dp -f myConfig

Zobacz Instalowanie narzędzia Edge apigee-setup aby dowiedzieć się więcej.

Tworzenie pliku konfiguracji

Poniżej znajduje się przykładowy plik konfiguracji cichej instalacji portalu. Edytuj ten plik zgodnie z potrzebami konfiguracji. Aby dołączyć ten plik, użyj opcji -f, aby uruchomić setup.sh.

IP1=IPorDNSnameOfNode

# Must resolve to IP address or DNS name of host - not to 127.0.0.1 or localhost.
HOSTIP=$(hostname -i)

# Specify the name of the portal database in Postgres. 
PG_NAME=devportal 

# Specify the Postgres admin credentials. 
# The portal connects to Postgres by using the 'apigee' user. 
# If you changed the Postgres password from the default of 'postgres' 
# then set PG_PWD accordingly. 
# If connecting to a Postgres node installed with Edge, 
# contact the Edge sys admin to get these credentials. 
PG_USER=apigee 
PG_PWD=postgres 

# The IP address of the Postgres server. 
# If it is installed on the same node as the portal, specify that IP. 
# If connecting to a remote Postgres server,specify its IP address. 
PG_HOST=$IP1 

# The Postgres user credentials used by the portal 
# to access the Postgres database, 
# This account is created if it does not already exist. 
DRUPAL_PG_USER=drupaladmin 
DRUPAL_PG_PASS=portalSecret 

# Specify 'postgres' as the database. 
DEFAULT_DB=postgres 

# Specify the Drupal admin account details. 
# DO NOT set DEVPORTAL_ADMIN_USERNAME=admin. 
# The installer creates this user on the portal. 
DEVPORTAL_ADMIN_FIRSTNAME=firstName 
DEVPORTAL_ADMIN_LASTNAME=lastName 
DEVPORTAL_ADMIN_USERNAME=userName 
DEVPORTAL_ADMIN_PWD=pWord 
DEVPORTAL_ADMIN_EMAIL=foo@bar.com 

# Edge connection details. 
# If omitted, you can set them in the portal UI. 
# Specify the Edge organization associated with the portal. 
EDGE_ORG=edgeOrgName 

# Specify the URL of the Edge management API. 
# For a Cloud based installation of Edge, the URL is: 
# https://api.enterprise.apigee.com/v1 
# For a Private Cloud installation, it is in the form: 
# http://<ms_ip_or_DNS>:8080/v1 or 
# https://<ms_ip_or_DNS>:TLSport/v1 
MGMT_URL=https://api.enterprise.apigee.com/v1 

# The org admin credentials for the Edge organization in the form
# of Edge emailAddress:pword. 
# The portal uses this information to connect to Edge. 
DEVADMIN_USER=orgAdmin@myCorp.com 
DEVADMIN_PWD=pWord 

# The PHP port. 
# If omitted, it defaults to 8888. 
PHP_FPM_PORT=8888 

# You must configure the SMTP server used by the portal. 
# The properties SMTPHOST and SMTPPORT are required. 
# The others are optional with a default value as notated below. 
# SMTP hostname. For example, for the Gmail server, use smtp.gmail.com. 
SMTPHOST=smtp.gmail.com 

# Use SSL for SMTP: 'y' or 'n' (default). 
SMTPSSL="n" 

# SMTP port (usually 25). 
# The value can be different based on the selected encryption protocol. 
# For example, for Gmail, the port is 465 when using SSL and 587 for TLS. 
SMTPPORT=25 

# Username used for SMTP authentication, defaults is blank. 
SMTPUSER=your@email.com 

# Password used for SMTP authentication, default is blank. 
SMTPPASSWORD=yourEmailPassword

1. Testowanie połączenia z Apigee Edge

Przetestuj połączenie z serwerem zarządzania brzegowego, wykonując następujące polecenie cURL w wierszu poleceń na serwerze portalu:

> curl -u {EMAIL}:{PASSWORD} http://<ms_ip_or_DNS>:8080/v1/organizations/{ORGNAME}

lub

> curl -u {EMAIL}:{PASSWORD} https://<ms_ip_or_DNS>:TLSPort/v1/organizations/{ORGNAME}

Gdzie EMAIL i PASSWORD to adres e-mail adres i hasło administratora organizacji ORGNAME.

Pamiętaj, aby podać nazwę hosta i numer portu właściwe dla instalacji Edge. Porto 8080 to domyślny port używany 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 zadziała, 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"
}

2. Usuwanie wersji PHP starszych niż 7.0

Skrypt instalacyjny sprawdza, czy w systemie są wersje PHP w wersji starszej niż 7.0, zanim rozpocznie się instalacji. Jeśli istnieją wersje języka PHP starszych niż 7.0, wyświetli się następujący 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

Usuń pakiety PHP za pomocą następującego polecenia:

yum remove <package-name>

3. Zainstaluj Postgres

Aby było możliwe zainstalowanie portalu, portal wymaga zainstalowania Postgres. Możesz: zainstaluj Postgres w ramach instalowania Edge lub zainstaluj Postgres samodzielnie do użytku przez z portalu.

• Jeśli łączysz się z Postgresem zainstalowanym w ramach Edge, a Postgres jest skonfigurowany w w trybie mastera/gotowy podaj adres IP głównego serwera Postgres.
• Jeśli zainstalujesz samodzielną wersję Postgres, może się ona znajdować w tym samym węźle co portal.

Informacje o instalowaniu Postgres w ramach instalowania Edge znajdziesz w artykule Instalowanie komponentów Edge w węźle.

Aby zainstalować autonomiczną wersję Postgres:

1. Zainstaluj narzędzie Edge apigee-setup na węźle, korzystając z za pomocą internetu, czy też poza internetem. Zapoznaj się z sekcją Instalowanie narzędzia Edge apigee-setup, i innych.
2. Utwórz plik konfiguracyjny Postgres w ten sposób:
   
   # Musi odpowiadać adresowi IP lub DNS nazwa hosta – nie 127.0.0.1 ani localhost.
   HOSTIP=$(nazwa hosta -i)
   
   # Pod i region Postgres. Użyj wartości domyślnych przedstawionych poniżej.
   MP_POD=gateway
   REGION=dc-1
   
   # Ustaw hasło Postgres. Wartość domyślna to „postgres”.
   PG_PWD=postgres
3. W wierszu poleceń uruchom skrypt konfiguracji, aby zainstalować Postgres:
   > /opt/apigee/apigee-setup/bin/setup.sh -p pdb -f configFile
   
   Opcja „-p pdb” określa, czy należy zainstalować Postgre.
   
   Plik konfiguracji musi być dostępny lub czytelny dla „apigee” użytkownika.

4. Zainstaluj portal

Aby zainstalować portal:

1. Zainstaluj narzędzie Edge apigee-setup na za pomocą procedury internetowej lub poza internetem. Zapoznaj się z sekcją Instalowanie narzędzia Edge apigee-setup, i innych.
2. Sprawdź, czy masz zainstalowaną aplikację Postgres – samodzielną lub częścią instaluję Edge.
3. W wierszu polecenia uruchom skrypt konfiguracji:
   > /opt/apigee/apigee-setup/bin/setup.sh -p dp -f configFile
   
   Opcja „-p dp” określa instalację portalu.
   
   Plik konfiguracji musi być dostępny lub czytelny dla „apigee” użytkownika.
4. Wejdź na stronę główną portalu pod adresem http://localhost:8079 lub wpisz nazwę DNS do swojego portalu.
5. Zaloguj się w portalu za pomocą danych logowania administratora określonych w pliku konfiguracji na należy się upewnić, że portal działa poprawnie.
6. Wybierz Raporty > raportu stanu w menu Drupala, aby upewnić się, że zobaczysz bieżący stan portalu.

5. Upewnij się, że moduł Menedżer aktualizacji jest włączono

Aby otrzymywać powiadomienia o aktualizacjach Drupala, sprawdź, czy moduł Menedżera aktualizacji Drupal jest . W menu Drupal wybierz Modules (Moduły) i przewiń w dół do Moduł menedżera. Jeśli nie jest, włącz ją.

Po włączeniu możesz zobaczyć dostępne aktualizacje w sekcji Raporty > Dostępny(-a) Aktualizacje. Możesz też użyć tego polecenia pędzla:

> drush pm-info update

To polecenie musisz uruchomić w katalogu głównym witryny. Domyślnie Deweloper Portal jest zainstalowany pod adresem /opt/apigee/apigee-drupal/wwwroot. Dlatego należy najpierw zmienić katalog na /opt/apigee/apigee-drupal/wwwroot po uruchomieniu polecenia. Jeśli portal nie został zainstalowany w katalogu domyślnym, zmień go na katalogu instalacyjnego.

Skorzystaj z menu Raporty > Dostępne aktualizacje > Ustawienia do skonfigurowania. modułu wysyłania e-maili o dostępności aktualizacji oraz ustawiania częstotliwości sprawdzania aktualizacje.

6. Konfigurowanie wyszukiwarki Apache Solr (Opcjonalnie)

Domyślnie moduły Drupal łączące się z wyszukiwarką Apache Solr są wyłączone, gdy musisz zainstalować portal. Większość portali korzysta z wewnętrznej wyszukiwarki Drupala, więc 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łącz i skonfiguruj 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 do tworzenia treści.
2. W menu Drupal wybierz Modules (Moduły).
3. Włącz moduły Apache Solr Framework i Apache Solr. w module wyszukiwania.
4. Zapisz zmiany.
5. Skonfiguruj Solr zgodnie z opisem na https://drupal.org/node/1999280.

7. Zainstaluj SmartDocuments (opcjonalnie)

SmartDokumenty umożliwiają dokumentowanie interfejsów API w portalu usług dla deweloperów w sposób, który sprawia, Dokumentacja interfejsu API jest w pełni interaktywna. Aby jednak używać w portalu SmartDokumentów, musisz najpierw Zainstaluj SmartDocuments na Edge.

• Jeśli łączysz portal z instalacją Edge Cloud, usługa SmartDocuments jest już zainstalowana i nie jest wymagana żadna dodatkowa konfiguracja.
• Jeśli łączysz portal z instalacją Edge for Private Cloud, musisz upewnić się, że aplikacja SmartDokumenty jest zainstalowana na urządzeniu Edge. Więcej informacji na temat instalowania Edge i SmartDocuments znajdziesz w artykule Instalowanie SmartDocuments.

Musisz też włączyć Dokumenty SmartDokumenty w portalu. Więcej informacji na ten temat znajdziesz w artykule o używaniu Dokumentów Google przy tworzeniu dokumentów. interfejsów API.

8. Skonfiguruj Moduł aktualizacji JQuery dla instalacji innych niż internetowe (opcjonalny)

Jeśli instalujesz moduł JQuery Update i używasz go w instalacji innej niż internet, musisz wykonać skonfigurować moduł do używania lokalnej wersji JQuery. Jeśli skonfigurujesz moduł tak, aby używał sieci CDN w przypadku instalacji niezwiązanej z internetem spróbuje uzyskać dostęp do sieci CDN, co spowoduje opóźnienia na stronie wczytuję. Więcej informacji o module JQuery Update znajdziesz na stronie https://www.drupal.org/project/jquery_update.

Aby skonfigurować moduł aktualizacji JQuery do używania lokalnej wersji JQuery:

1. Zaloguj się w portalu jako użytkownik z uprawnieniami administratora lub do tworzenia treści.
2. Wybierz Konfiguracja > Tworzenie > JQuery Update w menu Drupala.
3. W panelu nawigacyjnym po lewej stronie kliknij Skuteczność.
4. W menu CDN JQuery i JQuery UI wybierz Brak.
5. Kliknij Save Configuration (Zapisz konfigurację).

9. Co dalej?

Następnym krokiem po zainstalowaniu portalu usług dla deweloperów jest skonfigurowanie i dostosowanie jej pod kątem swoich wymagań. Dokumentacja na stronie Apigee zawiera informacje o konfigurowaniu portalu, jego stylu i zarządzaniu. Zapoznaj się z dokumentacją na stronie http://apigee.com/docs/developer-services/content/what-developer-portal.

W tabeli poniżej znajdziesz najczęściej występujące czynności, które możesz wykonać po instalacji: i zawiera linki do dokumentacji Apigee, w której można znaleźć więcej informacji:

/opt/apigee/apigee-drupal-devportal-opdk_version/source/conf/settings.php