Omówienie instalacji brzegowej

Edge for Private Cloud w wersji 4.18.05

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ć co najmniej 1 komponent Edge węzła.

Proces instalacji

Instalacja Edge w węźle jest procesem wieloetapowym:

  1. Wyłącz SELinux w węźle lub ustaw tryb mniej rygorystyczny. Zobacz Zainstaluj narzędzie Edge apigee-setup dla i innych.
  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. Na przykład: można zainstalować Edge na 1 węźle na potrzeby testów lub w 13 węzłach w środowisku produkcyjnym. Zobacz Topologie instalacji.
  5. W każdym węźle w wybranej topologii zainstaluj narzędzie Edge apigee-setup:
    • Pobierz plik Edge bootstrap_4.18.05.sh do /tmp/bootstrap_4.18.05.sh
    • Zainstaluj narzędzie i zależności Edge apigee-service.
    • Zainstaluj narzędzie i zależności Edge apigee-setup.

      Zobacz Instalowanie narzędzia Edge apigee-setup aby dowiedzieć się więcej.

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

    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ć interfejs apigee-provision. oraz 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 ponownie uruchom komponent interfejsu Edge.

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. Do zainstaluj, odinstaluj i zaktualizuj pakiety RPM Edge, polecenia muszą być uruchamiane przez użytkownika roota lub użytkownika który ma pełny dostęp do sudo. Aby uzyskać pełny dostęp do sudo, oznacza to, że użytkownik ma dostęp do sudo, który może wykonać te same działania co w przypadku roota.

Każdy użytkownik, który chce uruchamiać te polecenia lub skrypty, musi mieć uprawnienia 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 służący do instalowania komponentów Edge (chyba że są już używane „apigee-service install” aby zainstalować wymagany RPM. Następnie uruchom roota lub wykonaj pełne sudo dostęp, jeśli nie jest wymagany).
  • 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łaj sudo, aby uruchomić jako „apigee” użytkownika.

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

  • polecenia 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 „apigee” użytkownik

Aby skonfigurować użytkownika, aby miał pełny dostęp sudo do „apigee” , należy użyć funkcji „visudo”, polecenie do wyedytuj plik sudoers, dodając:

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 „apigee” użytkownika. Ten obejmuje plik licencji Edge i wszystkie pliki konfiguracyjne.

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

  1. Utwórz plik w edytorze jako dowolny użytkownik.
  2. chown właściciel pliku „apigee:apigee” lub uruchamianie usługi Edge z poziomu „apigee” użytkownika, użyj polecenia chown, aby wysłać plik użytkownikowi, który jest uruchomiony z usługi Edge.

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

Najprostszym sposobem jest przeprowadzenie całego procesu instalacji Edge jako użytkownik root lub użytkownik, który ma pełny dostęp sudo, co nie zawsze jest możliwe. Zamiast tego możesz oddzielić parametry na zadania wykonywane przez użytkownika root i zadania wykonywane przez użytkownika pełny dostęp sudo do punktu „apigee” użytkownika.

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

      Ten krok instaluje narzędzie apigee-service i tworzy „apigee” użytkownika.

    2. Skonfiguruj użytkownika, aby miał pełny dostęp sudo do „apigee” użytkownika zgodnie z opisem w Tworzenie użytkownika z pełnym dostępem sudo do „apigee” użytkownika.
    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ć w węźle pakiety RPM Edge: 
      /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ępne komponenty to: 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 pakiety RPM Edge w węźle, użytkownik z pełnym dostępem do sudo „apigee” użytkownik wykonuje proces konfiguracji:
    1. Użyj narzędzia setup.sh, aby dokończyć konfigurację Edge w węźle. Forma polecenia zależy od komponentów, które zostały zainstalowanego w węźle. Pełną listę znajdziesz tutaj Zainstaluj w węźle komponenty Edge.

      Aby na przykład dokończyć instalację ZooKeeper i Cassandra, użyj następującego kodu polecenie:

      /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, który zawiera informacje o instalacji Edge. W przypadku instalacji cichych wymagane jest, aby plik konfiguracji musi być dostępny lub czytelny dla „apigee” użytkownika. Na przykład umieść plik w katalogu /usr/local/var lub /usr/local/share w węźle oraz chown go do „apigee:apigee”.

Wymagane są wszystkie informacje w pliku konfiguracji oprócz systemu Edge hasło administratora. Jeśli pominiesz hasło, narzędzie apigee-setup poprosi o to. aby wpisać 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 awarii podczas instalowania komponentu Edge możesz spróbować go rozwiązać. i ponownie uruchom instalator. Instalator jest zaprojektowany do wielokrotnego uruchamiania gdy wykryje awarię lub gdy zechcesz później zmienić lub zaktualizować komponent instalacji.

Po zainstalowaniu lub uaktualnieniu uruchom ponownie komponent interfejsu Edge w każdym węźle, który jest uruchomiony.

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 w celu zainstalowania Edge wskaźniki RPM i zależności.

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

    Węzły bez zewnętrznego połączenia internetowego mogą korzystać z powielonej wersji Apigee skonfigurowanego wewnętrznie. To repozytorium zawiera wszystkie szybkości RPM w Edge, ale musisz Sprawdź, czy wszystkie pozostałe zależności są dostępne w repozytoriach wewnętrznych

    Do utworzenia wewnętrznego repozytorium Apigee potrzebujesz węzła z zewnętrznym internetem aby pobrać RPM i zależności Edge. Po utworzeniu pliku repozytorium wewnętrzne, możesz je przenieść do innego węzła lub udostępnić go sieci Edge węzłów do instalacji.

Korzystanie z lokalnego repozytorium Edge do zachowania wersji Edge

Jednym z powodów, dla których warto używać repozytorium lokalnego lub powielanego, jest możliwość zainstalowania Edge na 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łasnego łańcucha zależności instalacji. Wiele z tych zależności jest zdefiniowanych przez inne firmy komponenty, które są poza kontrolą Apigee i mogą się w każdej chwili zmienić. Dlatego dokumentacja nie zawiera jednoznacznego numeru wersji każdej zależności.

Jeśli instalujesz komputer z dostępem do internetu, węzeł może pobrać w przypadku niezbędnych wskaźników RPM i zależności. Jeśli jednak instalujesz się z węzła bez internetu dostępu, zwykle konfigurujesz wewnętrzne repozytorium zawierające wszystkie niezbędne zależności. Jedyny sposób aby zagwarantować, że wszystkie zależności są uwzględnione w lokalnym repozytorium, jest próba instalacji, Zidentyfikuj brakujące zależności i skopiuj je do lokalnego repozytorium do czasu instalacji sukces.

Typowe polecenia Yum

Narzędzia do instalacji Edge w systemie Linux wykorzystują Yum do instalowania i aktualizowania komponentów. Możesz muszą użyć kilku poleceń Yum do zarządzania instalacją w węźle.

  • 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 prywatnych instalacji wykorzystywana jest następująca struktura systemu plików Google Cloud.

Pliki dziennika

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

Pliki dzienników każdego komponentu znajdują się w folderze /opt/apigee/var/log katalogu. Każdy komponent ma własny podkatalog. Na przykład dzienniki zarządzania Serwer znajduje się w 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
Interfejs Edge /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
Qpidd /opt/apigee/var/log/apigee-qpidd
Baza danych PostgreSQL /opt/apigee/var/log/apigee-postgresql

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

Po wykonaniu zadań instalacyjnych

Po zakończeniu instalacji możesz wykonać dodatkowe działania na komponentach Edge.

Ponowne uruchamianie interfejsu Edge składnik

Po zakończeniu instalacji musisz ponownie uruchomić komponent interfejsu Edge w każdym węźle:

/opt/apigee/apigee-service/bin/apigee-service edge-ui restart

Konfigurowanie Edge komponenty po instalacji

Aby skonfigurować Edge po instalacji, użyj kombinacji plików .properties i narzędzia Edge. Aby na przykład skonfigurować TLS/SSL w interfejsie Edge, edytuj .properties, aby ustawić niezbędne właściwości. .properties – zmiany wymagają ponownego uruchomienia komponentu Edge, którego dotyczy problem.

Pliki (.properties) znajdują się w: w katalogu /opt/apigee/customer/application. Każdy komponent ma w tym katalogu własny plik .properties. Na przykład: router.properties i management-server.properties.

Aby ustawić właściwość komponentu, zmodyfikuj odpowiedni plik .properties, i ponownie uruchom komponent:

/opt/apigee/apigee-service/bin/apigee-service component restart

Na przykład:

/opt/apigee/apigee-service/bin/apigee-service edge-router restart

Gdy zaktualizujesz Edge, pliki .properties w Katalog /opt/apigee/customer/application został odczytany. Oznacza to, że aktualizacja zachowuje we wszystkich właściwościach ustawionych w komponencie.

Więcej informacji znajdziesz w artykule Jak skonfigurować Edge. Konfiguracja Edge.

Wywoływanie poleceń w komponentach Edge

Narzędzia do zarządzania instalacjami brzegowymi w ramach /opt/apigee/apigee-service/bin, które są dostępne którego można używać do zarządzania instalacją Edge. Możesz na przykład użyć narzędzia apigee-all aby uruchomić, zatrzymać, uruchomić ponownie lub określić stan wszystkich komponentów Edge w węźle:

/opt/apigee/apigee-service/bin/apigee-all stop|start|restart|status|version

Korzystanie z narzędzia apigee-service do sterowania i konfigurowania poszczególnych komponentów. Narzędzie apigee-service ma postać:

/opt/apigee/apigee-service/bin/apigee-service component_name action

Gdzie component_name identyfikuje komponent. Komponent musi znajdować się w węźle który wykonujesz apigee-service. W zależności od konfiguracji wartości funkcji component_name może zawierać:

  • apigee-cassandra (Cassandra)
  • apigee-openldap (OpenLDAP)
  • apigee-postgresql (baza danych PostgreSQL)
  • apigee-qpidd (kwartał)
  • apigee-sso (SSO – logowanie jednokrotne)
  • apigee-zookeeper (ZooKeeper)
  • edge-management-server (serwer zarządzania)
  • edge-management-ui (nowy interfejs Edge)
  • edge-message-processor (procesor wiadomości)
  • edge-postgres-server (serwer Postgres)
  • edge-qpid-server (serwer Qpid)
  • edge-router (router brzegowy)
  • edge-ui (klasyczny interfejs)

Oprócz tych komponentów możesz również wywołać funkcję apigee-service w apigee-provision i apigee-validate komponentów w zależności od konfiguracji.

Aby na przykład ponownie uruchomić router brzegowy, uruchom to polecenie:

/opt/apigee/apigee-service/bin/apigee-service edge-router restart

Listę komponentów zainstalowanych w węźle możesz ustalić, sprawdzając Katalog /opt/apigee. Ten katalog zawiera podkatalog dla każdej krawędzi zainstalowany w węźle. Każdy podkatalog jest poprzedzony prefiksem:

  • apigee: komponent innej firmy używany przez Edge. Przykład: apigee-cassandra
  • edge: komponent brzegowy z Apigee. Przykład: edge-management-server
  • edge-mint: komponent do generowania przychodu. Przykład: edge-mint-management-server

Pełna lista działań dla komponentu zależy od samego komponentu, ale wszystkie komponenty obsługują te działania:

  • start, stop, restart
  • status, version
  • backup, restore
  • install, uninstall

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 procesora i danych wymagania dotyczące pamięci dla instalowanego komponentu. Wartość domyślna to „n”. aby wyłączyć sprawdzić.