Omówienie instalacji brzegowej

Typowa instalacja Edge składa się z komponentów Edge rozmieszczonych w wielu węzłach. Po zainstalowaniu Edge w węźle musisz zainstalować i skonfigurować w nim co najmniej 1 komponent Edge.

Proces instalacji

Instalowanie Edge w węźle jest procesem wieloetapowym:

  1. Wyłącz SELinux w węźle lub ustaw go w trybie mniej rygorystycznym. Więcej informacji znajdziesz w artykule o instalowaniu narzędzia Edge apigee-setup.
  2. Zdecyduj, czy chcesz włączyć uwierzytelnianie Cassandra.
  3. Zdecyduj, czy chcesz skonfigurować replikację gotowości instancji głównej w Postgres.
  4. Wybierz konfigurację Edge z listy zalecanych topologii. Możesz na przykład zainstalować Edge w jednym węźle do testowania lub w 13 węzłach do środowiska produkcyjnego. Więcej informacji znajdziesz w sekcji Topologie instalacji.
  5. W każdym węźle w wybranej topologii zainstaluj narzędzie Edge apigee-setup:
    • Pobierz plik Edge bootstrap_4.52.01.sh dla usługi /tmp/bootstrap_4.52.01.sh.
    • Zainstaluj narzędzie Edge apigee-service i jego zależności.
    • Zainstaluj narzędzie Edge apigee-setup i jego zależności.

      Więcej informacji znajdziesz w artykule na temat instalowania narzędzia Edge apigee-setup.

  6. Za pomocą narzędzia apigee-setup możesz zainstalować co najmniej 1 komponent Edge w każdym węźle zgodnie z wybraną topologią.

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

  7. W węźle Serwer zarządzania użyj narzędzia apigee-setup, aby zainstalować apigee-provision, czyli narzędzia używane do tworzenia organizacji brzegowych i zarządzania nimi.

    Więcej informacji znajdziesz w artykule Rejestrowanie organizacji.

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

  9. (Zalecane) Po zakończeniu wstępnej instalacji Apigee zaleca zainstalowanie nowego interfejsu użytkownika Edge (o nazwie komponentu edge-management-ui), który jest ulepszonym interfejsem dla programistów i administratorów Apigee Edge dla Private Cloud.

    Więcej informacji znajdziesz w temacie Instalowanie nowego interfejsu użytkownika Edge.

Po zakończeniu instalacji zapoznaj się z tą listą czynności, które są zwykle wykonywane po instalacji.

Kto może przeprowadzić instalację

Pliki dystrybucyjne Apigee Edge są instalowane jako zestaw pakietów RPM i zależności. Aby móc instalować, odinstalować i aktualizować pakiety RPM Edge, polecenia te muszą być uruchamiane przez użytkownika root lub użytkownika z pełnym dostępem do sudo. Pełny dostęp sudo oznacza, że użytkownik ma uprawnienia dostępu sudo umożliwiające wykonywanie tych samych operacji co użytkownik root.

Każdy użytkownik, który chce uruchamiać poniższe polecenia lub skrypty, musi mieć dostęp do 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 instalujący komponenty Edge (chyba że do zainstalowania wymaganych pakietów RPM został użyty plik „apigee-service install”. Następnie poziom dostępu root lub pełny dostęp sudo, jeśli nie jest wymagany).
  • skrypt update.sh, aby zaktualizować komponenty Edge;

Dodatkowo instalator Edge utworzy w systemie nowego użytkownika o nazwie „apigee”. Wiele poleceń Edge wywołuje sudo, które uruchamia się jako użytkownik „apigee”.

Każdy użytkownik, który chce uruchamiać wszystkie inne polecenia niż wymienione powyżej, musi być użytkownikiem z pełnym dostępem do użytkownika „apigee” w sudo. Są to między innymi:

  • polecenia narzędziowe apigee-service, w tym:
    • polecenia apigee-service, takich jak start, stop, restart, configure.
    • apigee-all, np. start, stop, restart, configure.

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

Aby skonfigurować użytkownikowi pełny dostęp sudo do użytkownika „apigee”, za pomocą polecenia „visudo” zmodyfikuj plik sudoers i dodaj go:

installUser        ALL=(apigee)      NOPASSWD: ALL

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

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

Podczas tworzenia pliku konfiguracji możesz zmienić jego właściciela na „apigee:apigee”, aby mieć pewność, że będzie on dostępny dla poleceń Edge:

  1. Utwórz plik w edytorze jako dowolny użytkownik.
  2. chown ustaw właściciela pliku na „apigee:apigee” lub, jeśli zmienisz użytkownika korzystającego z usługi Edge z użytkownika „apigee”, zmień plik na użytkownika korzystającego z usługi Edge.

Rozdzielanie zadań instalacji Edge między użytkownikami root i innymi niż root

Najłatwiej jest wykonać cały proces instalacji Edge jako użytkownik root lub przez użytkownika z pełnym dostępem do sudo, jednak nie zawsze jest to możliwe. Zamiast tego proces ten można podzielić na zadania wykonywane przez użytkownika root i zadania wykonywane przez użytkownika z pełnym dostępem sudo do użytkownika „apigee”.

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

      Spowoduje to zainstalowanie narzędzia apigee-service i utworzenie użytkownika „apigee”.

    2. Skonfiguruj użytkownika, aby miał pełny dostęp sudo do użytkownika „apigee” zgodnie z opisem w sekcji 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. Za pomocą narzędzia apigee-setup zainstaluj pakiety RPM Edge w węźle: 
      /opt/apigee/apigee-service/bin/apigee-service compName install

      Wskaźniki RPM instalowane w węźle zależą od topologii. Lista dostępnych komponentów obejmuje: 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 root zainstaluje RPM Edge w węźle, użytkownik z pełnym dostępem sudo do użytkownika „apigee” ukończy proces konfiguracji:
    1. Dokończ konfigurację komponentów Edge w węźle za pomocą narzędzia setup.sh. Forma tego polecenia zależy od komponentów zainstalowanych w węźle. Pełną listę znajdziesz w artykule o instalowaniu komponentów Edge w węźle.

      Aby na przykład ukończyć instalację ZooKeeper i Cassandra, użyj tego polecenia:

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

      Gdzie configFile to plik konfiguracji Edge.

      Jeśli chcesz przeprowadzić instalację „wszystko w jednym”, 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 dyskretnych jest to, aby plik konfiguracji był dostępny i czytelny dla użytkownika „apigee”. Na przykład umieść plik w katalogu /usr/local/var lub /usr/local/share w węźle, a chown do „apigee:apigee”.

Wymagane są wszystkie informacje z pliku konfiguracji oprócz hasła administratora systemu Edge. Jeśli pominiesz hasło, narzędzie apigee-setup poprosi o jego wpisanie w wierszu poleceń.

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

Postępowanie w przypadku niepowodzenia instalacji

Jeśli podczas instalowania komponentu Edge wystąpi błąd, możesz spróbować rozwiązać problem, a następnie ponownie uruchomić instalator. Instalator uruchamiał się wielokrotnie, gdy wykryje błąd albo gdy zechcesz zmienić lub zaktualizować komponent po instalacji.

Po zainstalowaniu lub uaktualnieniu pamiętaj, aby ponownie uruchomić komponent interfejsu Edge w każdym węźle, w którym jest on uruchomiony.

Instalacja przez internet lub bez połączenia z internetem

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, aby zainstalować RPM i zależności Edge.

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

    Węzły bez zewnętrznego połączenia internetowego mają dostęp do powielanej wersji repozytorium Apigee skonfigurowanego wewnętrznie. To repozytorium zawiera wszystkie RPM brzegowy, ale musisz się upewnić, że dostępne są wszystkie inne zależności w repozytoriach w sieci wewnętrznej.

    Aby utworzyć wewnętrzne repozytorium Apigee, musisz mieć węzeł z zewnętrznym dostępem do internetu, który będzie mógł pobrać RPM i zależności Edge. Po utworzeniu wewnętrznego repozytorium możesz je przenieść do innego węzła lub udostępnić go węzłom brzegowym do instalacji.

Używanie lokalnego repozytorium Edge do utrzymania wersji Edge

Jednym z powodów, dla których warto używać repozytorium lokalnego lub powielanego, jest zainstalowanie Edge w węzłach bez zewnętrznego połączenia z internetem. Więcej informacji na ten temat można znaleźć w poprzedniej sekcji.

Rozwiązywanie zależności dotyczących instalacji RPM

Pliki dystrybucji Apigee Edge są instalowane jako zestaw plików RPM, z których każdy może mieć własny łańcuch zależności instalacji. Wiele z tych zależności jest zdefiniowanych przez komponenty innych firm, które są poza kontrolą Apigee i mogą się zmienić w dowolnym momencie. Dlatego w dokumentacji nie podano wyraźnego numeru wersji każdej zależności.

Jeśli przeprowadzasz instalację na komputerze z dostępem do internetu, węzeł może pobrać niezbędne pakiety RPM i zależności. Jeśli jednak przeprowadzasz instalację z węzła bez dostępu do internetu, zwykle konfiguruje się wewnętrzne repozytorium zawierające wszystkie niezbędne zależności. Jedynym sposobem na zagwarantowanie uwzględnienia wszystkich zależności w lokalnym repozytorium jest wykonanie próby instalacji, zidentyfikowanie brakujących zależności i skopiowanie ich do lokalnego repozytorium do czasu ukończenia instalacji.

Typowe polecenia Yum

Narzędzia instalacyjne Edge dla systemu Linux korzystają z Yam do instalowania i aktualizowania komponentów. Do zarządzania instalacją w węźle może być konieczne 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 brzegowych główny katalog instalacji jest oznaczony jako:

/opt/apigee

Do wdrożenia Apigee Edge dla Private Cloud w instalacji używana jest ta struktura systemu plików.

Pliki dziennika

Plik logu dla apigee-setup i skryptu setup.sh jest zapisywany pod adresem /tmp/setup-root.log.

Pliki dziennika dla każdego komponentu znajdują się w katalogu /opt/apigee/var/log. Każdy komponent ma własny podkatalog. Na przykład logi serwera zarządzania znajdują się w katalogu:

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

W tych tabelach 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 brzegowy został zaimplementowany za pomocą protokołu Nginx. Dodatkowe logi 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 Apigee Qpid

 /opt/apigee/var/log/edge-qpid-server
Serwer Apigee Postgres /opt/apigee/var/log/edge-postgres-server
Klasyczny interfejs użytkownika (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 Apigee Qpid /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 brzegowej obsługuje tę właściwość:

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. Domyślną wartością jest „n”, która wyłącza sprawdzanie.