Uwagi dotyczące instalacji

Edge dla chmury prywatnej w wersji 4.16.05

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.
• 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.16.05.sh do /tmp/bootstrap_4.16.05.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.

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.

Skonfiguruj replikację Postgres master-standby

Domyślnie Edge instaluje wszystkie węzły Postgres w trybie głównym. Jednak w systemach produkcyjnych z wieloma węzłami Postgres konfiguruje się je tak, aby korzystały z replikacji master-standby, dzięki czemu w przypadku awarii węzła głównego węzeł rezerwowy może nadal obsługiwać ruch. Więcej informacji znajdziesz w artykule Konfigurowanie replikacji master-standby w Postgres.

Kto może przeprowadzić instalację

Pliki dystrybucyjne Apigee Edge są instalowane jako zestaw pakietów RPM i zależności. Aby zainstalować, odinstalować i zaktualizować Edge, polecenia Edge muszą być uruchamiane przez użytkownika root lub użytkownika, który ma pełny dostęp 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.

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

installUser        ALL=(apigee)      NOPASSWD: ALL

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

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.

Instalacja dyskretna komponentów Edge

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”. Możesz na przykład umieścić plik w katalogu /tmp w węźle i zmienić 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 o jego wpisanie w wierszu poleceń.

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

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.

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.

Konfigurowanie hosta wirtualnego

Host wirtualny w Edge definiuje domeny i porty routera Edge, na których jest udostępniany serwer proxy interfejsu API, a także adres URL, którego aplikacje używają do uzyskiwania dostępu do serwera proxy interfejsu API. Host wirtualny określa też, czy dostęp do serwera proxy interfejsu API jest uzyskiwany za pomocą protokołu HTTP czy zaszyfrowanego protokołu HTTPS.

W ramach procesu wprowadzania do Edge musisz utworzyć organizację, środowisko i hosta wirtualnego. Edge udostępnia polecenie setup-org, które ułatwia ten proces nowym użytkownikom.

Podczas tworzenia hosta wirtualnego musisz podać te informacje:

• Nazwa hosta wirtualnego, której używasz do odwoływania się do niego w serwerach proxy interfejsów API.
• Port na routerze dla hosta wirtualnego. Zwykle te porty zaczynają się od 9001 i zwiększają się o 1 dla każdego nowego hosta wirtualnego.
• Alias hosta hosta wirtualnego. Zwykle jest to nazwa DNS hosta wirtualnego.

Router Edge porównuje nagłówek Host przychodzącego żądania z listą dostępnych aliasów hosta, aby określić, który serwer proxy interfejsu API obsługuje żądanie. Podczas wysyłania żądania przez hosta wirtualnego podaj nazwę domeny, która pasuje do aliasu hosta wirtualnego, lub podaj adres IP routera i nagłówek Host zawierający alias hosta.

Jeśli na przykład utworzysz hosta wirtualnego z aliasem hosta myapis.apigee.net na porcie 9001, żądanie cURL do interfejsu API przez tego hosta wirtualnego może mieć jedną z tych form:

• Jeśli masz wpis DNS dla myapis.apigee.net:
  
  curl http://myapis.apigee.net:9001/{proxy-base-path}/{resource-path}
• Jeśli nie masz wpisu DNS dla myapis.apigee.net:
  
  curl http://<routerIP>:9001/{proxy-base-path}/{resource-path} -H 'Host: myapis.apigee.net'
  
  W tym formularzu podajesz adres IP routera i przekazujesz alias hosta w nagłówku Host.
  
  Uwaga: polecenie curl, większość przeglądarek i wiele innych narzędzi automatycznie dołącza nagłówek Host z domeną jako część żądania, więc możesz użyć polecenia curl w postaci:
  
  curl http://<routerIP>:9001/{proxy-base-path}/{resource-path}

Opcje, gdy nie masz wpisu DNS dla hosta wirtualnego

Jeśli nie masz wpisu DNS, możesz ustawić alias hosta na adres IP routera i port hosta wirtualnego, np. <routerIP>:port. Na przykład:

192.168.1.31:9001

Następnie utwórz polecenie curl w poniższym formacie:

curl http://<routerIP>:9001/{proxy-base-path}/{resource-path} 

Ta opcja jest preferowana, ponieważ dobrze współpracuje z interfejsem Edge.

Jeśli masz wiele routerów, dodaj alias hosta dla każdego z nich, podając adres IP każdego routera i port hosta wirtualnego.

Możesz też ustawić alias hosta na wartość, np. temp.hostalias.com. Następnie musisz przekazać nagłówek Host w każdym żądaniu:

curl -v http://<routerIP>:9001/{proxy-base-path}/{resource-path}  -H 'host: temp.hostalias.com'

Możesz też dodać alias hosta do pliku /etc/hosts. Na przykład dodaj ten wiersz do pliku /etc/hosts:

192.168.1.31   temp.hostalias.com

Następnie możesz wysłać żądanie, tak jakby wpis DNS istniał:

curl -v http://myapis.apigee.net:9001/{proxy-base-path}/{resource-path}

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.

Sprawdź, czy router brzegowy ma dostęp do /etc/rc.d/init.d/functions

Router Edge i portal BaaS używają routera Nginx i wymagają dostępu do odczytu do pliku /etc/rc.d/init.d/functions.

Jeśli proces zabezpieczeń wymaga ustawienia uprawnień w pliku /etc/rc.d/init.d/functions, nie ustawiaj ich na 700, ponieważ router nie będzie mógł się uruchomić. Możesz ustawić uprawnienia na 744, aby zezwolić na dostęp do odczytu do /etc/rc.d/init.d/functions.

Wywoływanie poleceń w 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

Uzyskiwanie dostępu do plików 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

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:

<inst_root>/apigee

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

Pliki dziennika

Dane