Omówienie instalacji brzegowej

Edge dla chmury prywatnej w wersji 4.17.09

Typowa instalacja Edge składa się z komponentów Edge rozproszonych na wielu węzłach. Po zainstalowaniu Edge na węźle instalujesz i konfigurujesz na nim co najmniej 1 komponent Edge.

Proces instalacji

Instalowanie Edge w węźle to proces wieloetapowy:

• Wyłącz SELinux w węźle lub ustaw go w trybie zezwalającym. Więcej informacji znajdziesz w artykule Instalowanie narzędzia apigee-setup w Edge.
• Zdecyduj, czy chcesz włączyć uwierzytelnianie Cassandra.
• Zdecyduj, czy chcesz skonfigurować replikację master-standby dla Postgres.
• Wybierz konfigurację Edge z listy zalecanych topologii. Możesz na przykład zainstalować Edge na jednym węźle do testowania lub na 13 węzłach do środowiska produkcyjnego. Więcej informacji znajdziesz w sekcji Topologie instalacji.
• Na każdym węźle w wybranej topologii zainstaluj narzędzie Edge apigee-setup:
  • Pobierz plik Edge bootstrap_4.17.09.sh do /tmp/bootstrap_4.17.09.sh.
  • Zainstaluj narzędzie Edge apigee-service i zależności.
  • Zainstaluj narzędzie Edge apigee-setup i zależności.
    
    Więcej informacji znajdziesz w artykule Instalowanie narzędzia apigee-setup w Edge.
• Użyj narzędzia apigee-setup, aby zainstalować co najmniej 1 komponent Edge w każdym węźle na podstawie wybranej topologii.
  Zobacz Instalowanie komponentów Edge w węźle.
• Na węźle serwera zarządzania użyj narzędzia apigee-setup, aby zainstalować apigee-provision, czyli narzędzia, których używasz do tworzenia organizacji Edge i zarządzania nimi.
  Więcej informacji znajdziesz w artykule Wprowadzanie organizacji.

Kto może przeprowadzić instalację

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

Każdy użytkownik, który chce uruchomić te polecenia lub skrypty, musi być użytkownikiem root lub użytkownikiem z pełnym dostępem sudo:

• apigee-service:
  • apigee-service commands: install, uninstall, update.
  • Polecenia apigee-all: install, uninstall, update.
• skrypt setup.sh, aby zainstalować komponenty Edge (chyba że do zainstalowania wymaganych pakietów RPM użyto już polecenia „apigee-service install”). Jeśli nie jest wymagany, wystarczy dostęp na poziomie roota lub pełny dostęp sudo).
• skrypt update.sh do aktualizowania komponentów Edge,

Instalator Edge tworzy też w systemie nowego użytkownika o nazwie „apigee”. Wiele poleceń Edge wywołuje sudo, aby działać jako użytkownik „apigee”.

Każdy użytkownik, który chce uruchomić inne polecenia niż te pokazane powyżej, musi mieć pełny dostęp sudo do użytkownika „apigee”. Te polecenia to:

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

Aby skonfigurować użytkownika tak, aby miał pełny dostęp sudo do użytkownika „apigee”, użyj polecenia „visudo”, aby zmodyfikować plik sudoers i dodać:

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 zapewnić dostęp do niego poleceniom Edge:

1. Utwórz plik w edytorze jako dowolny użytkownik.
2. Zmień właściciela pliku na „apigee:apigee” lub, jeśli użytkownik, który uruchamia usługę Edge, został zmieniony z „apigee”, zmień właściciela pliku na użytkownika, który uruchamia usługę Edge.

Rozdzielanie zadań instalacji Edge między użytkownika root i użytkownika innego niż root

Najprościej jest przeprowadzić cały proces instalacji Edge jako użytkownik root lub użytkownik z pełnym dostępem sudo, ale nie zawsze jest to możliwe. Zamiast tego możesz podzielić proces na zadania wykonywane przez użytkownika root i zadania wykonywane przez użytkownika z pełnym dostępem sudo do użytkownika „apigee”.

1. Zadania wykonywane przez użytkownika root:
   1. Pobierz i uruchom plik bootstrap_4.17.09.sh:
      > curl https://software.apigee.com/bootstrap_4.17.09.sh -o /tmp/bootstrap_4.17.09.sh
      > sudo bash /tmp/bootstrap_4.17.09.sh apigeeuser=uName apigeepassword=pWord
      
      Ten krok powoduje zainstalowanie narzędzia apigee-service i utworzenie użytkownika „apigee”.
   2. Skonfiguruj użytkownika tak, aby miał pełny dostęp sudo do użytkownika „apigee” w sposób opisany powyżej.
   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
      
      Pakiety RPM Edge, które instalujesz w węźle, zależą od topologii. Lista dostępnych komponentów obejmuje: apigee-provision, apigee-validate, apigee-zookeeper, apigee-cassandra, apigee-openldap, edge-ui, 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 pakiety RPM Edge na węźle, użytkownik z pełnym dostępem sudo do użytkownika „apigee” kończy proces konfiguracji:
   1. Aby dokończyć konfigurację komponentów Edge w 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 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.
      
      Aby wykonać instalację typu „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 dotyczącym instalacji cichych jest to, że plik konfiguracji musi być dostępny lub możliwy do odczytania przez użytkownika „apigee”. Na przykład umieść plik w katalogu /usr/local/var lub /usr/local/share w węźle i zmień jego właściciela na „apigee:apigee”.

Wszystkie informacje w pliku konfiguracji są wymagane, z wyjątkiem hasła administratora systemu Edge. Jeśli pominiesz hasło, narzędzie apigee-setup poprosi Cię 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 instalacji komponentu Edge wystąpi błąd, możesz spróbować go naprawić, a następnie ponownie uruchomić instalator. Instalator jest przeznaczony do wielokrotnego uruchamiania w przypadku wykrycia błędu lub gdy chcesz zmienić lub zaktualizować komponent po instalacji.

Instalacja z dostępem do internetu lub bez niego

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

• Węzły z zewnętrznym połączeniem z internetem
  
  Węzły z zewnętrznym połączeniem z internetem uzyskują dostęp do repozytorium Apigee, aby zainstalować pakiety 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 kopii lustrzanej repozytorium Apigee skonfigurowanej wewnętrznie. To repozytorium zawiera wszystkie pakiety RPM Edge, ale musisz upewnić się, że wszystkie inne zależności są dostępne w repozytoriach w sieci wewnętrznej.
  
  Uwaga: Apigee nie hostuje wszystkich zależności innych firm w naszych publicznych repozytoriach. Musisz pobrać i zainstalować te zależności z publicznie dostępnych repozytoriów.
  
  Aby utworzyć wewnętrzne repozytorium Apigee, potrzebujesz węzła z zewnętrznym dostępem do internetu, aby móc pobierać pliki RPM Edge i zależności. Po utworzeniu repozytorium wewnętrznego możesz przenieść je do innego węzła lub udostępnić ten węzeł węzłom Edge na potrzeby instalacji.

Używanie lokalnego repozytorium Edge do utrzymywania wersji Edge

Jednym z powodów korzystania z lokalnego lub kopii lustrzanej repozytorium jest instalowanie Edge na węzłach bez zewnętrznego połączenia z internetem, jak opisano w poprzedniej sekcji.

Istnieje jednak jeszcze jedna zaleta korzystania z lokalnego repozytorium, nawet w przypadku węzłów z zewnętrznym połączeniem z internetem. Podczas instalowania Edge z publicznego repozytorium Apigee zawsze instalujesz najnowsze pakiety RPM Edge. Dlatego jeśli chcesz pobrać i zapisać pakiety RPM Edge dla konkretnej wersji Edge, utwórz lokalne repozytorium dla tej wersji Edge. Następnie możesz użyć tego lokalnego repozytorium do przeprowadzenia instalacji dowolnej wersji Edge.

Możesz na przykład najpierw użyć lokalnego repozytorium, aby zainstalować środowisko programistyczne Edge. Następnie, gdy będziesz gotowy do przejścia do środowiska produkcyjnego, ponownie zainstalujesz Edge z lokalnego repozytorium. Instalując z lokalnego repozytorium, masz pewność, że środowiska programistyczne i produkcyjne są zgodne.

Zduplikowane repozytorium jest bardzo elastyczne. Możesz na przykład utworzyć repozytorium kopii lustrzanej z najnowszych pakietów RPM Edge lub z określonej wersji Edge. Po utworzeniu repozytorium możesz je też zaktualizować, aby dodać pakiety RPM z różnych wersji Edge. Więcej informacji znajdziesz w artykule Instalowanie narzędzia apigee-setup w Edge.

Rozwiązywanie problemów z zależnościami 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 innych firm, które są poza kontrolą Apigee i mogą się zmienić w dowolnym momencie. Dlatego w dokumentacji nie podano konkretnego 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 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 są uwzględnione w lokalnym repozytorium, jest próba instalacji, zidentyfikowanie brakujących zależności i skopiowanie ich do lokalnego repozytorium, aż instalacja się powiedzie.

Najczęstsze polecenia Yum

Narzędzia instalacyjne Edge dla Linuksa korzystają z 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 w katalogu /opt/apigee.

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

/opt/apigee

Instalacja używa tej struktury systemu plików do wdrażania Apigee Edge dla chmury prywatnej.

Pliki dziennika

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

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

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

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

Dane

Zadania po instalacji

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

Konfigurowanie komponentów Edge po instalacji

Aby skonfigurować Edge po instalacji, użyj kombinacji plików .properties i narzędzi Edge. Na przykład aby skonfigurować TLS/SSL w interfejsie Edge, zmodyfikuj pliki .properties, aby ustawić niezbędne właściwości. Zmiany w plikach .properties wymagają ponownego uruchomienia odpowiedniego komponentu Edge.

Pliki .properties znajdują się 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, a następnie uruchom ponownie komponent:

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

Na przykład:

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

Podczas aktualizowania Edge odczytywane są pliki .properties w katalogu /opt/apigee/customer/application. Oznacza to, że aktualizacja zachowuje wszystkie właściwości ustawione w komponencie.

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

Wywoływanie poleceń na komponentach Edge

Edge instaluje narzędzia do zarządzania w katalogu /opt/apigee/apigee-service/bin, których możesz używać do zarządzania instalacją Edge. Możesz na przykład użyć narzędzia apigee-all, aby uruchomić, zatrzymać, ponownie uruchomić lub określić stan wszystkich komponentów Edge w węźle:

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

Użyj narzędzia apigee-service, aby kontrolować i konfigurować poszczególne komponenty. Narzędzie apigee-service ma postać:

/opt/apigee/apigee-service/bin/apigee-service component action

Aby na przykład ponownie uruchomić router brzegowy:

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

Listę komponentów zainstalowanych w węźle możesz sprawdzić w katalogu /opt/apigee. Ten katalog zawiera podkatalog dla każdego komponentu Edge zainstalowanego w węźle. Każdy podkatalog ma prefiks:

• apigee – komponent innej firmy używany przez Edge. Na przykład apigee-cassandra.
• edge – komponent Edge z Apigee. Na przykład edge-management-server.
• edge-mint – komponent zarabiania. Na przykład edge-mint-management-server.
• baas – komponent API BaaS. Na przykład baas-usergrid.

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
• instalowanie, odinstalowywanie