Omówienie instalacji brzegowej

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

Proces instalacji

Instalacja Edge w węźle składa się z kilku etapów:

  1. Wyłącz SELinux w węźle lub ustaw tryb mniej rygorystyczny. Więcej informacji znajdziesz w artykule o instalowaniu narzędzia Edge apigee-setup.
  2. Zdecyduj, czy chcesz włączyć uwierzytelnianie Cassandra.
  3. Określ, czy chcesz skonfigurować replikację w trybie gotowości do instancji głównej dla Postgres.
  4. Wybierz konfigurację Edge z listy zalecanych topologii. Możesz na przykład zainstalować Edge w 1 węźle na potrzeby testów lub w 13 węzłach produkcyjnych. 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.02.sh na adres /tmp/bootstrap_4.52.02.sh.
    • Zainstaluj narzędzie i zależności Edge apigee-service.
    • Zainstaluj narzędzie i zależności Edge apigee-setup.

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

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

    Zapoznaj się z artykułem Instalowanie komponentów Edge w węźle.

  7. W węźle serwera zarządzania użyj narzędzia apigee-setup, aby zainstalować apigee-provision – narzędzia służące 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, jak pokazano w tym przykładzie: 
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

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

Kto może przeprowadzić instalację

Pliki dystrybucyjne Apigee Edge są instalowane jako zbiór przychodów z tysiąca wyświetleń i zależności. Aby zainstalować, odinstalować i zaktualizować RPM Edge, polecenia muszą być uruchomione przez użytkownika roota lub użytkownika z pełnym dostępem do sudo. Pełny dostęp sudo oznacza, że użytkownik ma dostęp sudo i może wykonywać te same operacje 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 został już użyty plik „apigee-service install” do zainstalowania wymaganych pakietów RPM. Następnie, jeśli nie jest wymagany, dostęp do roota lub pełnego sudo).
  • skrypt update.sh służący do aktualizowania komponentów Edge

Dodatkowo instalator Edge utworzy 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 uruchamiać wszystkie inne polecenia niż wymienione powyżej, musi być użytkownikiem z pełnym dostępem sudo do użytkownika „apigee”. Do tych poleceń należą:

  • poleceń narzędzia apigee-service, w tym:
    • apigee-service, np. start, stop, restart, configure.
    • apigee-all, np. start, stop, restart, configure.

Tworzenie użytkownika z pełnym dostępem sudo do użytkownika „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 przeglądarki 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 konfiguracyjne.

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

  1. Utwórz plik w edytorze jako dowolny użytkownik.
  2. chown właścicielem pliku jest „apigee:apigee”, a jeśli użytkownik uruchamiający usługę Edge został zmieniony z użytkownika „apigee”, użyj polecenia chown, aby przenieść plik do użytkownika, który uruchamia usługę Edge.

Oddzielenie zadań instalacji Edge między użytkownikiem root i użytkownika bez dostępu do roota

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 użytkownika roota i zadania wykonywane przez użytkownika z pełnym dostępem sudo do użytkownika „apigee”.

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

      W tym kroku instaluje się narzędzie apigee-service i tworzy użytkownika „apigee”.

    2. Skonfiguruj użytkownika tak, 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 dla użytkownika „apigee”.
    3. Zainstaluj narzędzie apigee-setup: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
    4. Użyj narzędzia apigee-setup, aby zainstalować pakiety RPM Edge w węźle: 
      /opt/apigee/apigee-service/bin/apigee-service compName install

      RPM urządzeń brzegowych, które instalujesz w węźle, zależy 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. Użyj narzędzia setup.sh, aby dokończyć konfigurację komponentów Edge w węźle. Forma 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 dokoń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.

      Możesz też przeprowadzić instalację „wszystko w jednym” za pomocą 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ęzła, a chown go w katalogu „apigee:apigee”.

Wymagane są wszystkie informacje w pliku konfiguracji oprócz hasła administratora systemu Edge. Jeśli pominiesz hasło, narzędzie apigee-setup wyświetli prośbę o wpisanie go 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 błędu podczas instalacji komponentu Edge możesz spróbować rozwiązać ten problem, a następnie ponownie uruchomić instalator. Instalator jest zaprojektowany do wielokrotnego uruchamiania w przypadku wykrycia awarii albo gdy po instalacji zechcesz zmienić lub zaktualizować komponent.

Po zainstalowaniu lub uaktualnieniu komponentu Edge ponownie uruchom komponent interfejsu Edge w każdym węźle, w którym działa.

Instalacja przez internet lub bez

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 mogą uzyskiwać dostęp do powielonej wersji repozytorium Apigee, które zostało przez Ciebie skonfigurowane 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.

    Do utworzenia wewnętrznego repozytorium Apigee potrzebujesz węzła z zewnętrznym dostępem do internetu, który będzie mógł pobrać RPM i zależności brzegowe. Po utworzeniu wewnętrznego repozytorium możesz przenieść je do innego węzła lub udostępnić je węzłach brzegowych do instalacji.

Korzystanie z lokalnego repozytorium Edge do zachowania wersji Edge

Jednym z powodów korzystania z lokalnego lub powielanego repozytorium jest możliwość zainstalowania Edge w węzłach bez zewnętrznego połączenia z internetem, jak opisano w poprzedniej sekcji.

Rozwiązywanie zależności instalacji pakietu RPM

Pliki dystrybucyjne Apigee Edge są instalowane jako zbiór 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ę w każdej chwili zmienić. Dlatego w dokumentacji nie ma jawnego numeru wersji każdej zależności.

Jeśli instalujesz maszynę z dostępem do internetu, węzeł może pobrać niezbędne pakiety RPM i zależności. Jeśli jednak instalujesz oprogramowanie z węzła bez dostępu do internetu, zazwyczaj konfigurujesz wewnętrzne repozytorium 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 instalacji Edge w systemie Linux wykorzystują Yum 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 z katalogu /opt/apigee.

W tym przewodniku i w przewodniku Edge Operations Service główny katalog instalacji jest oznaczony jako:

/opt/apigee

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

Pliki dziennika

Plik logu dla apigee-setup i skrypt setup.sh jest zapisywany w folderze /tmp/setup-root.log.

Pliki logów 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 tym katalogu:

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

W tabelach poniżej znajdziesz lokalizacje plików dziennika:

Komponent Lokalizacja

Serwer zarządzania

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

Router

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

Router brzegowy jest zaimplementowany za pomocą Nginx. Dodatkowe logi znajdziesz tutaj:

/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 (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 Edge obsługuje tę właściwość:

ENABLE_SYSTEM_CHECK=y

Jeśli ustawisz tę właściwość na wartość „y”, instalator sprawdzi, czy system spełnia wymagania dotyczące procesora i pamięci przez instalowany komponent. Domyślna wartość to „n”, aby wyłączyć sprawdzanie.