Instalacja portalu usług dla deweloperów

Edge dla chmury prywatnej w wersji 4.18.01

Zanim zainstalujesz, upewnij się, że:

• Postgres instaluje się przed instalacją portalu. Możesz zainstalować Postgres w ramach instalacji Edge lub zainstalować Postgres jako samodzielną usługę do użytku przez portal.
  • Jeśli zainstalujesz samodzielną bazę danych Postgres, może ona znajdować się w tym samym węźle co portal.
  • Jeśli łączysz się z instancją Postgres zainstalowaną w ramach Edge i skonfigurowaną w trybie czuwania, 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.
• Yum jest zainstalowany.

Instalator zawiera tylko moduły Drupal, które są wymagane przez portal usług dla programistów Apigee (lub po prostu portal). Informacje o instalowaniu innych modułów znajdziesz w artykule Extending Drupal 7 (Rozszerzanie Drupala 7).

Omówienie instalacji

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

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

Przekaż do narzędzia apigee-setup plik konfiguracji zawierający informacje o instalacji. Jeśli w pliku konfiguracji brakuje wymaganych informacji, narzędzie apigee-setup poprosi o ich podanie w wierszu poleceń.

Jedynym wymaganiem jest to, aby plik konfiguracji był dostępny lub możliwy do odczytania przez użytkownika „apigee”.

Na przykład, aby zainstalować portal, użyj tego polecenia:

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

Więcej informacji znajdziesz w artykule Instalowanie narzędzia apigee-setup w Edge.

Wycofanie właściwości SMTPSSL

We wcześniejszych wersjach do ustawiania protokołu używanego przez serwer SMTP połączony z portalem służyła właściwość SMTPSSL. Ta właściwość została wycofana.

Do ustawiania protokołu używanego przez serwer SMTP połączony z portalem służy teraz właściwość SMTP_PROTOCOL, a nie SMTPSSL. Prawidłowe wartości to: „standard”, „ssl” lub „tls”.

Tworzenie pliku konfiguracji

Poniżej znajdziesz przykładowy plik konfiguracji instalacji dyskretnej portalu. W razie potrzeby zmodyfikuj ten plik, aby dostosować go do swojej konfiguracji. Użyj opcji -f w poleceniu setup.sh, aby dołączyć ten plik.

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 

# Optionally configure the SMTP server used by the portal. 
# If you do, 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 

# Set the SMTP protocol as "standard", "ssl", or "tls",
# where "standard" corresponds to HTTP.
# Note that in previous releases, this setting was controlled by the 
# SMTPSSL property. That property has been deprecated. 
SMTP_PROTOCOL="standard" 

# 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 Edge, wykonując to 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 i hasło administratora 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 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

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

Usuń pakiety PHP za pomocą tego polecenia:

yum remove package-name

3. Instalowanie Postgres

Zanim zainstalujesz portal, musisz zainstalować Postgres. Możesz zainstalować Postgres w ramach instalacji Edge lub zainstalować Postgres jako samodzielną usługę do użytku przez portal.

• Jeśli łączysz się z Postgres zainstalowanym w ramach Edge, a Postgres jest skonfigurowany w trybie czuwania/master, podaj adres IP serwera Postgres master.
• Jeśli zainstalujesz samodzielną bazę danych Postgres, może ona znajdować się w tym samym węźle co portal.

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

Aby zainstalować samodzielną bazę danych Postgres:

1. Zainstaluj narzędzie Edge apigee-setup w węźle, korzystając z procedury internetowej lub innej niż internetowa. Więcej informacji znajdziesz w artykule o instalowaniu narzędzia apigee-setup w Edge.
2. Utwórz plik konfiguracji dla Postgres, jak pokazano poniżej:

   # Must resolve to IP address or DNS
       name of host - not to 127.0.0.1 or localhost.
       HOSTIP=$(hostname -i)
   
       # The pod and region of Postgres. Use the default values shown below.
       MP_POD=gateway
       REGION=dc-1
   
       # Set the Postgres password. The default value is 'postgres'.
       PG_PWD=postgres

3. W wierszu poleceń uruchom skrypt konfiguracyjny, aby zainstalować Postgres:

   /opt/apigee/apigee-setup/bin/setup.sh -p pdb -f configFile

   Opcja -p pdb określa, że ma zostać zainstalowany PostgreSQL. Plik konfiguracji musi być dostępny lub możliwy do odczytania przez użytkownika „apigee”.

4. Instalowanie portalu

Aby zainstalować portal:

1. Zainstaluj narzędzie Edge apigee-setup w węźle, korzystając z procedury internetowej lub innej niż internetowa. Więcej informacji znajdziesz w artykule Instalowanie narzędzia apigee-setup w Edge.
2. Upewnij się, że masz zainstalowaną bazę danych Postgres (samodzielnie lub w ramach instalacji Edge).
3. W wierszu poleceń uruchom skrypt konfiguracji:

   /opt/apigee/apigee-setup/bin/setup.sh -p dp -f configFile

   Opcja -p dp określa, że portal ma zostać zainstalowany.

   Plik konfiguracji musi być dostępny lub możliwy do odczytania przez użytkownika „apigee”.

4. Przejdź na stronę główną portalu pod adresem http://localhost:8079 lub do nazwy DNS portalu.
5. Zaloguj się w portalu, używając danych logowania administratora ustawionych w pliku konfiguracji, aby sprawdzić, czy portal działa prawidłowo.
6. W menu Drupal wybierz Reports > Status Report (Raporty > Raport o stanie), aby sprawdzić, czy widzisz bieżący stan portalu.

5. 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

To polecenie musisz uruchomić z katalogu głównego witryny. Domyślnie portal dla deweloperów jest instalowany w /opt/apigee/apigee-drupal/wwwroot. Dlatego przed uruchomieniem polecenia musisz najpierw zmienić katalog na /opt/apigee/apigee-drupal/wwwroot. Jeśli portal nie został zainstalowany w katalogu domyślnym, przejdź do katalogu instalacyjnego.

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.

6. 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ą one 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.

7. 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.

Musisz też włączyć SmartDocs w portalu. Więcej informacji o SmartDocs znajdziesz w artykule Dokumentowanie interfejsów API za pomocą SmartDocs.

8. Konfigurowanie modułu JQuery Update na potrzeby instalacji bez dostępu do internetu (opcjonalnie)

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

Aby skonfigurować moduł JQuery Update do korzystania z lokalnej wersji JQuery:

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

9. 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: