Ta strona została przetłumaczona przez Cloud Translation API.

Instalacja portalu usług dla deweloperów

Portal usług dla deweloperów w wersji 4.16.05

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

Przed rozpoczęciem instalacji utwórz kopię zapasową całego internetowego katalogu głównego Drupala. katalogu. 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ć plik dostosowania z kopii zapasowej.

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

Otwórz stronę http://community.apigee.com/content/apigee-customer-support i wybierz Zaloguj się do portalu pomocy. na jeden z dwóch sposobów:

Poproś o dostęp do katalogu pobierania Edge for Private Cloud.
Poproś o adres URL pliku .tar usług kanału dewelopera.

2. Sprawdzanie, czy Twój system jest zgodny z systemem wymagania

Zanim zainstalujesz portal, Twój serwer musi spełniać te wymagania:

Upewnij się, że instalujesz 64-bitową wersję obsługiwanej wersji Red Hat Enterprise Linux, CentOS lub Oracle. Listę obsługiwanych wersji znajdziesz tutaj.
Sprawdź, czy pakiet Yum jest zainstalowany.
(W przypadku instalacji na serwerze bez połączenia z internetem) Musisz pobrać wszystkie niezbędne pliki na serwer połączony z internetem jako jeden .tar.gz. Następnie musisz skopiować ten plik .tar.gz na serwer bez połączenia z internetem, po instalacji.
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 DeveloperServices_x.y.z.tar usług kanału dla deweloperów. , gdzie x.y.z odpowiada numerowi wersji portalu.
4. Wyodrębnij zawartość pliku .tar usług kanału dla deweloperów za pomocą polecenie:
  > tar -xvf <tar file>
5. CD do DeveloperServices-4.x.y.z.
6. Utwórz plik .tar.gz portalu za pomocą polecenia:
  > ./non-networked-install.sh
  
  Polecenie to spowoduje pobranie wszystkich niezbędnych plików i umieszczenie ich w jednym pliku .tar.gz. Ty a następnie skopiuj ten plik .tar.gz na swój serwer, który nie ma połączenia z internetem, instalacji.
Przetestuj połączenie z serwerem zarządzania brzegowego, wykonując następujące polecenie cURL z wiersza polecenia na serwerze portalu:
> curl -u {EMAIL}:{PASSWORD} https://{hostname}:8080/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 będzie wyglądał tak:
https://api.enterprise.apigee.com/v1/organizations/{ORGNAME}

Jeśli polecenie zadziała, zwróci odpowiedź podobną do tej:
{
„utworzonoW” : 1348689232699,
„createdBy” : „NAZWA UŻYTKOWNIKA”,
"displayName" : "cg",
„środowiska” : [ "test", "prod" ],
„lastZmodyfikowanow” : 1348689232699,
„lastModifiedBy” : "foo@bar.com",
„name” : "cg",
„właściwości” : {
„property” : [ ]
},
"typ" : "próbna"
}

3. Zainstaluj programistę Usługi kanału przy użyciu skryptu automatycznej instalacji

Wykonaj poniższe czynności, aby zainstalować portal za pomocą skryptu automatycznej instalacji. Ten działa w przypadku serwerów z zewnętrznym połączeniem internetowym lub bez niego.

Zaloguj się na serwerze jako root lub superużytkownik.
Utwórz katalog na pliki instalacyjne, np. portal.
Na serwerze z połączeniem internetowym:
1. płyta CD z nowym portalem; i pobierz plik DeveloperServices_x.y.z.tar Usługi kanału dewelopera. , gdzie x.y.z odpowiada numerowi wersji portalu.
  
  Plik możesz pobrać za pomocą linku wysłanego do Ciebie przez Apigee w przeglądarce lub skopiować go i dodaj go do tego polecenia cURL:
  > curl -kOL <wklej link here>
2. Wyodrębnij zawartość pliku .tar usług kanału dla deweloperów za pomocą polecenie:
  > tar -xvf <tar file>
3. CD do DeveloperServices-4.x.y.z.
4. Uruchom skrypt instalacji za pomocą tego polecenia:
  > ./networked-install.sh
Na serwerze bez połączenia z internetem:
1. Skopiuj plik .tar.gz utworzony powyżej w sekcji 2. Upewnij się, że Twój system spełnia wymagania wymagania systemowe.
2. Wyodrębnij zawartość pliku .tar.gz za pomocą polecenia:
  > tar -xvf <tar file>
3. do katalogu utworzonego w wyniku polecenia tar.
4. Ustaw uprawnienia w skrypcie install-from-rpm-bundle.sh:
  Chmod 755 install-from-rpm-bundle.sh
5. Uruchom skrypt install-from-rpm-bundle.sh, wykonując używając polecenia:
  ./install-from-rpm-bundle.sh
Odpowiedz na pytania.
Po zakończeniu instalacji otwórz w przeglądarce adres URL serwera, na przykład jako:
http://localhost. Jeśli masz określony adres IP lub DNS http://IP_address lub http://IP_address.

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

Uwaga: zwykle jest już skonfigurowana i zarejestrowana nazwa hosta. ze swoim serwerem DNS, aby nie trzeba było używać http://localhost.
Skonfiguruj połączenie z MySQL. Jeśli MySQL znajduje się na komputerze zdalnym, rozwiń Opcje zaawansowane i wpisz informacje o połączeniu z tym komputerem. Kliknij Zapisz i kontynuuj.
Skonfiguruj połączenie z punktem końcowym Apigee, wpisując poniższe informacje. i kliknij Zapisz:
Więcej informacji o tych wartościach znajdziesz w sekcji „Informacje wymagane przed rozpoczęciem instalacji” w portalu usług dla deweloperów .
1. Organizacja portalu dla programistów
2. Adres URL punktu końcowego portalu dla programistów
3. Użytkownik uwierzytelniony w punkcie końcowym
4. Uwierzytelnieni użytkownicy Hasło
Gdy pojawi się prośba, wybierz przycisk Install Sample SmartDocuments WADL, aby zainstalować. z przykładowego pliku WADL SmartDocuments. Jeśli pominiesz ten krok, przykładowy interfejs API SmartDocument nie będzie widoczne w portalu.
Uwaga: jeśli portal łączy się z instalacją Apigee Edge for Private gdy masz Google Cloud, a instalacja Edge nie ma zewnętrznego połączenia z internetem, musisz wykonać przed rozpoczęciem korzystania z tej usługi. Więcej Więcej informacji na temat SmartDocuments znajdziesz na http://apigee.com/docs/developer-services/content/using-smartdocs-document-apis.
Skonfiguruj Ustawienia serwera SMTP. Apigee wymaga skonfigurowania Serwer SMTP do wysyłania e-maili z portalu.
Więcej informacji znajdziesz na stronie http://apigee.com/docs/developer-services/content/configuring-email.
Skonfiguruj administratora, wpisując następujące informacje, a następnie wybierz Zapisz. W Drupal zostanie utworzony administrator o nazwie „admin”. domyślnie, więc nie używaj wartości „admin”, jako nazwa użytkownika.
Jeśli pominiesz ten krok, nadal możesz używać Drush do utworzenia administratora w sposób opisany poniżej w 4. Utwórz administratora.
1. Imię i nazwisko dewelopera
2. Nazwa użytkownika w portalu dla deweloperów
3. Hasło
4. Adres e-mail
Po zakończeniu instalacji ustaw uprawnienia do pliku settings.php:
Chmod 640 /var/www/html/sites/default/settings.php
Wejdź na stronę główną portalu pod adresem http://localhost/ lub wpisz nazwę DNS do swojego portalu.
Zaloguj się w portalu za pomocą danych logowania administratora.

4. Utwórz administratora

Za pomocą Drush możesz utworzyć użytkownika z uprawnieniami administratora instalacji usług kanału dewelopera. Drupal automatycznie tworzy administratora o nazwie „admin” domyślnie, więc nie używaj wartości „admin”, jako nazwa użytkownika.

Dysk CD do katalogu drupal_root/sites/default. Standardowa lokalizacja pierwiastka Drupala jest katalog /var/www/html:
> cd <drupal_root>/sites/default
Sprawdź, czy masz uprawnienia do zapisu w prywatnych plikach Drupala:
> 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 adresowi /var/www/html/sites/default/private/. Użyj tego polecenia, aby się upewnić, że W tym katalogu właściciel i grupa mogą zapisywać zmiany w tym katalogu:
chmod -R g+w dirPathAndName
chmod -R o+r dirPathAndName
Wpisz następujące polecenia, aby utworzyć administratora, zastępując polecenia w „< >”. z Twoimi wartościami:
> drush-utwórz użytkownika <nazwa_użytkownika> --mail="<email-address>" --password="<password>"
> drush user-add-role Administrator <nazwa użytkownika>
Zaloguj się w portalu dla deweloperów jako administrator przy użyciu podanej nazwy użytkownika i hasła powyżej.

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

Jeśli MySQL został zainstalowany w ramach instalacji portalu, skrypt instalacyjny pozostawia zmienną Puste hasło roota MySQL ustawiono na wartość domyślną.

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ć, skorzystaj z tego polecenie:

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

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

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

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.

7. Opcjonalnie – wdrażanie w środowisku produkcyjnym serwer

Jeśli wdrażasz portal na serwerze produkcyjnym, musisz wykonać dodatkowe zabezpieczenia kroków, w tym:

Uruchom następujący skrypt, aby zabezpieczyć swoją instalację MySQL:
> /usr/bin/mysql_secure_installation

Ten skrypt ustawia hasło roota i umożliwia ograniczenie dostępu do roota tylko localhost oraz usuń domyślnie utworzone testowe bazy danych i anonimowe konto użytkownika. Uruchamiam jest zdecydowanie zalecany w przypadku serwerów produkcyjnych.
Jeśli jest to wymagane przez zasady obowiązujące w firmie, włącz i skonfiguruj SELinux.

8. Opcjonalnie: skonfiguruj Apache Solr wyszukiwarka

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 Drupal, 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:

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

9. Opcjonalnie – zainstaluj mod_ssl na potrzeby pomocy HTTPS

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

> yum install mod_ssl

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

10. (Opcjonalnie) Zainstaluj Dokumenty Google

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.

Więcej informacji na ten temat znajdziesz w artykule o używaniu Dokumentów Google przy tworzeniu dokumentów. interfejsów API.

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

Zadanie	Opis
Dostosowywanie motyw	Motyw określa wygląd portalu, w tym kolory, styl i inne elementy aspektach wizualnych.
Dostosuj wygląd	Strona główna zawiera menu główne, wiadomość powitalną, nagłówek, stopkę i tytuł.
Dodawanie i zarządzanie kontami użytkowników	Proces rejestracji określa, w jaki sposób nowi deweloperzy rejestrują konto na z portalu. Na przykład czy nowi deweloperzy uzyskują natychmiastowy dostęp do portalu, musi zostać zweryfikowany przez administratora. Ten proces określa też sposób, w jaki portal administrator jest powiadamiany o utworzeniu nowego konta.
Konfigurowanie e-mail	Portal wysyła e-maile w odpowiedzi na określone zdarzenia. Na przykład, gdy nowy plik rejestruje się w portalu, a deweloper utraci hasło.
Dodawanie i zarządzanie kontami użytkowników	Dodaj warunki & Strona z warunkami, które deweloperzy muszą zaakceptować, zanim będą mogli spełnić te warunki. uzyskać dostęp do portalu.
Dodawanie i zarządzanie kontami użytkowników	W portalu stosowany jest model autoryzacji oparty na rolach. Zanim zezwolisz deweloperom na rejestrować i określać uprawnienia i role używane przez portal.
Dodaj bloga i posty na forum	Portal ma wbudowaną obsługę blogów i forów z wątkami. Zdefiniuj uprawnienia wymagane do wyświetlania, dodawania, edytowania i usuwania postów na blogu i forum.
Wykonywanie kopii zapasowych bazy danych	Sprawdź, czy tworzysz kopię zapasową bazy danych Drupal. Pamiętaj, że ponieważ jest inny, to od Ciebie zależy, jak najlepiej utworzyć kopię zapasową w bazie danych.
Skonfiguruj nazwę hosta	Jeśli nie skonfigurujesz nazwy hosta na swoim serwerze DNS, zawsze możesz uzyskać dostęp do witryny za pomocą adres IP serwera. Jeśli chcesz użyć nazwy hosta, możesz skonfigurować DNS dla serwera, które powinno działać prawidłowo bez konieczności wykonywania innych czynności konfiguracyjnych w ramach konfiguracji podstawowej. Jeśli masz skonfigurowany system równoważenia obciążenia lub w przypadku niektórych witryn występują nieprawidłowe adresy URL, Innym powodem możesz ustawić parametr $base_url w pliku settings.php w Portalu deweloperskim. który domyślnie znajduje się pod adresem /var/www/html/sites/default katalogu.