Omówienie instalacji brzegowej

Typowa instalacja Edge składa się z komponentów Edge rozmieszczonych na wielu węzłach. Po zainstalowaniu Edge na węźle zainstaluj i skonfiguruj co najmniej jeden komponent Edge na węźle.

Proces instalacji

Instalowanie przeglądarki Edge na węźle to proces wieloetapowy:

  1. Wyłącz SELinux na węźle lub ustaw go w trybie permisywnym. Więcej informacji znajdziesz w artykule Instalowanie narzędzia apigee-setup w Edge.
  2. Zdecyduj, czy chcesz włączyć uwierzytelnianie Cassandra.
  3. Zdecyduj, czy chcesz skonfigurować replikację typu master-standby dla Postgresa.
  4. Wybierz konfigurację Edge z listy zalecanych topologii. Możesz na przykład zainstalować Edge na jednym węźle na potrzeby testów lub na 13 węzłach na potrzeby produkcji. Więcej informacji znajdziesz w sekcji Topologie instalacji.
  5. Na każdym węźle w wybranej topologii zainstaluj narzędzie Edge apigee-setup:
    • Pobierz plik bootstrap_4.50.00.sh Edge do folderu /tmp/bootstrap_4.50.00.sh.
    • Zainstaluj narzędzie apigee-service i zależne od niego komponenty.
    • Zainstaluj narzędzie apigee-setup i zależne od niego komponenty.

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

  6. Użyj narzędzia apigee-setup, aby zainstalować co najmniej 1 komponent Edge na każdym węźle na podstawie wybranej topologii.

    Zobacz Instalowanie komponentów Edge na węźle.

  7. Na węźle serwera zarządzania użyj narzędzia apigee-setup, aby zainstalować apigee-provision, czyli narzędzia służące do tworzenia organizacji Edge i zarządzania nimi.

    Więcej informacji znajdziesz w artykule Rejestrowanie organizacji.

  8. Po zakończeniu instalacji uruchom ponownie komponent klasycznego interfejsu na każdym węźle, jak w tym przykładzie: 
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

  9. (Zalecane) Po zakończeniu początkowej instalacji Apigee zaleca zainstalowanie nowego interfejsu Edge (którego nazwa komponentu to edge-management-ui). Jest to ulepszony interfejs użytkownika przeznaczony dla programistów i administratorów Apigee Edge for Private Cloud.

    Więcej informacji znajdziesz w artykule Instalowanie nowego interfejsu Edge.

Po zakończeniu instalacji zapoznaj się z tą listą typowych działań po zainstalowaniu.

Kto może przeprowadzić instalację

Pliki dystrybucji Apigee Edge są instalowane jako zestaw RPM-ów i zależnych komponentów. Aby zainstalować, odinstalować i zaktualizować RPM-y Edge, musisz uruchomić odpowiednie polecenia jako użytkownik root lub użytkownik z pełnym dostępem sudo. W przypadku pełnego dostępu sudo oznacza to, że użytkownik ma dostęp sudo do wykonywania tych samych operacji co użytkownik root.

Każdy użytkownik, który chce uruchamiać poniższe polecenia lub skrypty, musi mieć konto roota lub być użytkownikiem z pełnym dostępem do sudo:

  • Narzędzie apigee-service:
    • Polecenia apigee-service: install, uninstall, update.
    • Polecenia apigee-all: install, uninstall, update.
  • skrypt setup.sh do instalowania komponentów Edge (chyba że już użyłeś/użyłaś opcji „apigee-service install” do zainstalowania wymaganych pakietów RPM); Następnie dostęp root lub pełny dostęp sudo, jeśli nie jest wymagany.
  • skrypt update.sh służący do aktualizowania komponentów Edge

Instalator Edge tworzy też w systemie nowego użytkownika o nazwie „apigee”. Wiele poleceń Edge wywołuje sudo, które są uruchamiane przez użytkownika „apigee”.

Każdy użytkownik, który chce wykonywać inne polecenia niż te wymienione powyżej, musi mieć pełny dostęp sudo do użytkownika „apigee”. Do tych poleceń należą:

  • polecenia narzędzia apigee-service, w tym:
    • polecenia apigee-service, takie jak start, stop, restart, configure;
    • polecenia apigee-all, takie jak start, stop, restart, configure.

Tworzenie użytkownika z pełnym dostępem sudo do konta „apigee”

Aby skonfigurować użytkownika tak, aby miał pełny dostęp sudo do użytkownika „apigee”, użyj polecenia „visudo” w celu edycji pliku sudoers i dodania:

installUser        ALL=(apigee)      NOPASSWD: ALL

Gdzie installUser to nazwa użytkownika osoby korzystającej z Edge.

Konfigurowanie uprawnień do plików konfiguracji

Wszystkie pliki i zasoby używane przez polecenia Edge muszą być dostępne dla użytkownika „apigee”. Obejmuje to plik licencji Edge i wszystkie pliki konfiguracyjne.

Podczas tworzenia pliku konfiguracyjnego możesz zmienić jego właściciela na „apigee:apigee”, aby był on dostępny dla poleceń Edge:

  1. Utwórz plik w edytorze jako dowolny użytkownik.
  2. chown właściciela pliku na „apigee:apigee” lub, jeśli zmieniłeś użytkownika obsługującego usługę Edge z „apigee”, zmień właściciela pliku na użytkownika obsługującego usługę Edge.

Rozdzielanie zadań instalacji przeglądarki Edge między użytkownikiem root i niebędącym rootem

Najłatwiej jest przeprowadzić cały proces instalacji Edge jako użytkownik root lub użytkownik, który ma pełny dostęp sudo, ale nie zawsze jest to możliwe. Zamiast tego możesz podzielić proces na zadania wykonywane przez roota i zadania wykonywane przez użytkownika z pełnym dostępem sudo do konta „apigee”.

  1. Zadania wykonywane przez użytkownika root:
    1. Pobierz i uruchom plik bootstrap_4.50.00.sh: 
      curl https://software.apigee.com/bootstrap_4.50.00.sh -o /tmp/bootstrap_4.50.00.sh
sudo bash /tmp/bootstrap_4.50.00.sh apigeeuser=uName apigeepassword=pWord

      W tym kroku instalujesz narzędzie apigee-service i tworzysz użytkownika „apigee”.

    2. Skonfiguruj użytkownika, aby miał pełny dostęp sudo do użytkownika „apigee”, zgodnie z opisem w artykule Tworzenie użytkownika z pełnym dostępem sudo do użytkownika „apigee”.
    3. Zainstaluj narzędzie apigee-setup: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
    4. Aby zainstalować RPM-y Edge na węźle, użyj narzędzia apigee-setup: 
      /opt/apigee/apigee-service/bin/apigee-service compName install

      Typy RPM Edge instalowane na węźle zależą od topologii. Lista dostępnych komponentów zawiera: apigee-provision, apigee-validate, apigee-zookeeper, apigee-cassandra, apigee-openldap, edge-management-server, edge-ui, edge-router, edge-message-processor, apigee-postgresql, apigee-qpidd, edge-postgres-server, edge-qpid-server.

  2. Gdy użytkownik główny zainstaluje w węźle Edge RPM, użytkownik z pełnym dostępem sudo do użytkownika „apigee” wykona proces konfiguracji:
    1. Aby skonfigurować komponenty Edge na węźle, użyj narzędzia setup.sh. Forma polecenia zależy od komponentów zainstalowanych w węźle. Pełną listę znajdziesz w artykule Instalowanie komponentów Edge na węźle.

      Aby na przykład zainstalować ZooKeeper i Cassandra, użyj tego polecenia:

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

      Gdzie configFile to plik konfiguracji Edge.

      Aby przeprowadzić instalację kompleksową, użyj tego polecenia:

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

Lokalizacja plików konfiguracji instalacji

Do narzędzia apigee-setup musisz przekazać plik konfiguracji zawierający informacje o instalacji Edge. Jedynym wymaganiem w przypadku instalacji bez interfejsu jest to, że plik konfiguracji musi być dostępny lub czytelny dla użytkownika „apigee”. Umieść na przykład plik w katalogu /usr/local/var lub /usr/local/share w węźle i chown go do „apigee:apigee”.

Wszystkie informacje w pliku konfiguracyjnym są wymagane, z wyjątkiem hasła administratora systemu Edge. Jeśli pominiesz hasło, narzędzie apigee-setup wyświetli prośbę o jego podanie w wierszu poleceń.

Więcej informacji znajdziesz w artykule o instalowaniu komponentów Edge w węźle.

Radzenie sobie z błędami instalacji

W przypadku niepowodzenia instalacji komponentu Edge możesz spróbować rozwiązać problem, a potem ponownie uruchomić instalator. Instalator jest przeznaczony do wielokrotnego uruchamiania w przypadku wykrycia błędu lub gdy chcesz zmienić lub zaktualizować komponent po instalacji.

Po zainstalowaniu lub uaktualnieniu Edge UI należy ponownie uruchomić komponent na każdym węźle, na którym jest on uruchamiany.

Instalacja przez internet lub bez internetu

Aby zainstalować Edge w węźle, musi on mieć dostęp do repozytorium Apigee:

  • Węzły z zewnętrznym połączeniem internetowym

    Węzły z zewnętrznym połączeniem internetowym uzyskują dostęp do repozytorium Apigee w celu zainstalowania pakietów RPM i zależności Edge.

  • Węzły bez zewnętrznego połączenia z internetem

    Węzły bez zewnętrznego połączenia z internetem mogą uzyskać dostęp do lustrzanej wersji repozytorium Apigee skonfigurowanego wewnętrznie. To repozytorium zawiera wszystkie pakiety RPM Edge, ale musisz sprawdzić, czy dostępne są wszystkie inne zależności w repozytoriach w sieci wewnętrznej.

    Aby utworzyć wewnętrzne repozytorium Apigee, potrzebujesz węzła z dostępem do zewnętrznego internetu, aby móc pobrać RPM-y i zależności Edge. Po utworzeniu repozytorium wewnętrznego możesz je przenieść do innego węzła lub udostępnić ten węzeł do instalacji przez węzły Edge.

Używanie lokalnego repozytorium Edge do utrzymywania wersji Edge

Jednym z powodów, dla których warto używać repozytorium lokalnego lub zwierciadła, jest instalowanie Edge na węzłach bez zewnętrznego połączenia z internetem, jak opisano w poprzedniej sekcji.

Rozwiązywanie zależności instalacji RPM

Pliki dystrybucyjne Apigee Edge są instalowane jako zestaw plików RPM, z których każdy może mieć własny łańcuch zależności instalacyjnych. Wiele z tych zależności jest definiowanych przez komponenty firm zewnętrznych, które nie podlegają kontroli Apigee i mogą się w dowolnym momencie zmienić. Dlatego dokumentacja nie zawiera dokładnego numeru wersji każdej zależności.

Jeśli instalacja jest wykonywana na komputerze z dostępem do internetu, węzeł może pobrać niezbędne RPM-y i zależności. Jeśli jednak instalujesz z węzła bez dostępu do internetu, zwykle konfigurujesz repozytorium wewnętrzne zawierające wszystkie niezbędne zależności. Jedynym sposobem na zagwarantowanie, że wszystkie zależności będą uwzględnione w lokalnym repozytorium, jest próba instalacji, zidentyfikowanie brakujących zależności i skopiowanie ich do lokalnego repozytorium, dopóki instalacja się nie powiedzie.

Typowe polecenia Yum

Narzędzia do instalowania Edge na Linuksie korzystają z Yum do instalowania i aktualizowania komponentów. Aby zarządzać instalacją na węźle, konieczne może być użycie kilku poleceń Yum.

  • Wyczyść wszystkie pamięci podręczne Yum: 
    sudo yum clean all
  • Aby zaktualizować komponent Edge: 
    sudo yum update componentName

    Na przykład:

    sudo yum update apigee-setup
sudo yum update edge-management-server

Struktura systemu plików

Edge instaluje wszystkie pliki w katalogu /opt/apigee.

W tym przewodniku i w Przewodniku po operacjach w Edge katalog główny instalacji jest oznaczony jako:

/opt/apigee

Instalacja używa tej struktury systemu plików do wdrażania Apigee Edge for Private Cloud.

Pliki dziennika

Plik dziennika apigee-setup i skrypt setup.sh są zapisywane w pliku /tmp/setup-root.log.

Pliki dziennika dotyczące poszczególnych komponentów znajdują się w katalogu /opt/apigee/var/log. Każdy komponent ma swój podkatalog. Na przykład dzienniki serwera zarządzania znajdują się w katalogu:

/opt/apigee/var/log/edge-management-server

W tabeli poniżej znajdziesz lokalizację plików dziennika:

Komponent Lokalizacja

Serwer zarządzania

 /opt/apigee/var/log/edge-management-server

Router

 /opt/apigee/var/log/edge-router

Router Edge jest implementowany za pomocą Nginx. Dodatkowe dzienniki znajdziesz w tych artykułach:

/opt/apigee/var/log/edge-router/nginx
/opt/nginx/logs

procesor komunikatów

 /opt/apigee/var/log/edge-message-processor

Serwer Qpid Apigee

 /opt/apigee/var/log/edge-qpid-server
Serwer Apigee Postgres /opt/apigee/var/log/edge-postgres-server
Klasyczny interfejs (nie nowy interfejs Edge, którego nazwa komponentu to edge-management-ui). /opt/apigee/var/log/edge-ui
ZooKeeper /opt/apigee/var/log/apigee-zookeeper
OpenLDAP /opt/apigee/var/log/apigee-openldap
Cassandra /opt/apigee/var/log/apigee-cassandra/system.log
Qpidd /opt/apigee/var/log/apigee-qpidd
Baza danych PostgreSQL /opt/apigee/var/log/apigee-postgresql
apigee-monit /opt/apigee/var/log/apigee-monit

Dane

Komponent Lokalizacja
Serwer zarządzania /opt/apigee/data/edge-management-server
Router /opt/apigee/data/edge-router
procesor komunikatów /opt/apigee/data/edge-message-processor
Agent Qpid Apigee /opt/apigee/data/edge-qpid-server
Agent Apigee Postgres /opt/apigee/data/edge-postgres-server
ZooKeeper /opt/apigee/data/apigee-zookeeper
OpenLDAP /opt/apigee/data/apigee-openldap
Cassandra /opt/apigee/data/apigee-cassandra/data
Qpidd /opt/apigee/data/apigee-qpid/data
Baza danych PostgreSQL /opt/apigee/data/apigee-postgres/pgdata
apigee-monit /opt/apigee/data/apigee-monit

Włącz sprawdzanie systemu podczas instalacji

Plik konfiguracji instalacji przeglądarki Edge obsługuje te właściwości:

ENABLE_SYSTEM_CHECK=y

Jeśli ustawisz tę właściwość na „y”, instalator sprawdzi, czy system spełnia wymagania dotyczące procesora i pamięci dla instalowanego komponentu. Wartość domyślna to „n”, co oznacza wyłączenie sprawdzania.