Omówienie instalacji brzegowej

Edge for Private Cloud w wersji 4.17.09

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:

• Wyłącz SELinux w węźle lub ustaw tryb mniej rygorystyczny. Zobacz Instalowanie Edge apigee-setup .
• Zdecyduj, czy chcesz włączyć uwierzytelnianie Cassandra.
• Określ, czy chcesz skonfigurować replikację w trybie gotowości do instancji głównej dla Postgres.
• 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 dla: i innych.
• W każdym węźle w wybranej topologii zainstaluj narzędzie Edge apigee-setup:
  • Pobierz plik Edge bootstrap_4.17.09.sh do /tmp/shoestrap_4.17.09.sh.
  • zainstalować narzędzie Edge apigee-service, zależności.
  • Zainstaluj narzędzie Edge apigee-setup oraz zależności.
    
    Patrz sekcja Instalowanie Narzędzie do konfiguracji Edge apigee.
• Użyj parametru apigee-setup narzędzie umożliwiające zainstalowanie co najmniej jednego komponentu Edge w każdym węźle na podstawie wybranego i topologii.
  Zobacz Instalowanie komponentów Edge w węźle.
• 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.
  Zapoznaj się z artykułem na temat rejestrowania organizacji dla: i innych.

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, odinstalowania, update.
  • Polecenia apigee-all: install, odinstalowania, update.
• skrypt setup.sh służący do instalowania komponentów Edge (chyba że są już używane „apigee-service install” do i zainstalować wymagane pakiety 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ł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:
  • poleceń apigee-service, takich jak start, stop, restart, configure.
  • poleceń apigee-all, takich jak start, stop, restart, configure.

Tworzenie użytkownika z: pełny dostęp 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 osoby pracującej z kontem. Edge.

Ustawianie uprawnień pliki 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. Przyznanie właścicielowi pliku uprawnienia „apigee:apigee” (jeśli użytkownik korzysta z Edge) z interfejsu „apigee” użytkownika, użyj polecenia chown, aby wysłać plik do użytkownika korzystającego z Edge posprzedażna.

Rozdzielanie Zadania instalacji brzegowej między użytkownikiem root a użytkownikiem innym niż root

Najprostszym sposobem jest przeprowadzenie całego procesu instalacji Edge jako użytkownik root lub użytkownik, który pełny dostęp sudo, który nie zawsze jest możliwy. Zamiast tego możesz podzielić proces na zadania wykonywane przez użytkownika root oraz zadania wykonywane przez użytkownika z pełnym dostępem sudo do „apigee” użytkownika.

1. Zadania wykonywane przez roota:
   1. Pobierz i uruchom plik bootstrap_4.17.09.sh:
      curl https://software.apigee.com/shoestrap_4.17.09.sh -o /tmp/shoestrap_4.17.09.sh
      > sudo bash /tmp/shoestrap_4.17.09.sh apigeeuser=uName apigeepassword=pWord
      
      W tym kroku instaluje się narzędzie apigee-service i tworzy „apigee” użytkownika.
   2. Skonfiguruj użytkownika, aby miał pełny dostęp sudo do „apigee” użytkownika 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 parametru apigee-setup narzędzie do instalowania pakietów RPM Edge w węźle:
      /opt/apigee/apigee-service/bin/apigee-service compName zainstaluj
      
      RPM urządzeń brzegowych, które instalujesz w węźle, zależy od topologii. Lista dostępnych funkcji Komponenty obejmują: 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 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 pliku setup.sh. do ukończenia konfiguracji komponentów Edge w węźle. Format zależy od komponentów zainstalowanych w węźle. Pełną listę znajdziesz tutaj Instalowanie komponentów Edge w węźle.
      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 konfiguracji instalacji pliki

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 pliku /usr/local/var lub /usr/local/share węzeł i zmienić go na „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 wyświetli prośbę o jego podanie. w wierszu poleceń.

Patrz: Instalowanie 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.

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 w repozytoriach w sieci wewnętrznej dostępne są wszystkie pozostałe zależności.
  
  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.
  
  Uwaga: Apigee nie hostuje wszystkich zależności zewnętrznych repozytoriów. Musisz pobrać i zainstalować te zależności z publicznie dostępnych źródeł repozytoriów.

Korzystanie z lokalnego repozytorium Edge do zachowaj wersję 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.

Użycie lokalnego repozytorium ma jednak dodatkową zaletę, nawet w przypadku węzłów z zewnętrznym i połączenia z internetem. Gdy instalujesz Edge z publicznego repozytorium Apigee, zawsze instalowany jest najnowszego współczynnika RPM w Edge. Jeśli więc chcesz pobrać i zapisać RPM dla określonej Edge, utwórz lokalne repozytorium dla tej wersji. Możesz użyć tej formy płatności, lokalnego repozytorium, aby przeprowadzić instalację dowolnej wersji Edge.

Na przykład najpierw użyj lokalnego repozytorium, aby zainstalować środowisko programistyczne Edge. Następnie: Jeśli chcesz przejść do środowiska produkcyjnego, ponownie zainstaluj Edge z repozytorium. Instalując aplikacje z lokalnego repozytorium, gwarantujesz, że środowisko programistyczne i produkcyjne środowiska.

Powielone repozytorium jest bardzo elastyczne. Możesz na przykład utworzyć powielane repozytorium z najnowszej wersji Przychód z tysiąca wyświetleń (RPM) na krawędziach lub z określonej wersji Edge. Po utworzeniu repozytorium możesz je też zaktualizować. aby dodać RPM z różnych wersji Edge. Zobacz Instalowanie Edge apigee-setup .

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 mniam czyszczenie wszystkiego
• Aby zaktualizować komponent Edge:
  Aktualizacja sudo yum componentName
  Przykład:
  sudo yum update apigee-setup
  sudo yum update brzeg-management-server

Struktura systemu plików

Edge instaluje wszystkie pliki w katalogu /opt/apigee.

W tym przewodniku i w przewodniku Edge Operations Guide podany jest główny katalog instalacji. 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 apigee-setup a skrypt setup.sh to zapisane w katalogu /tmp/setup-root.log.

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

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

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

Dane

Po wykonaniu zadań instalacyjnych

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

Konfigurowanie Edge komponenty po instalacji

Aby skonfigurować Edge po instalacji, użyj plików .properties i narzędzi Edge. Dla: Aby na przykład skonfigurować TLS/SSL w interfejsie Edge, edytuj pliki .properties i ustaw niezbędne usług. Zmiany w plikach .properties wymagają ponownego uruchomienia z komponentu Edge, którego dotyczy problem.

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

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

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

Na przykład:

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

Po zaktualizowaniu Edge pliki .properties znajdują się w katalogu /opt/apigee/customer/application zostaną przeczytane. Oznacza to, że aktualizacja zachowuje wszystkie właściwości ustawione w komponencie.

Zobacz Jak skonfigurować Edge dla Dowiedz się więcej o konfiguracji Edge.

Wywołuję polecenia w Edge komponenty

Narzędzia do zarządzania instalacjami brzegowymi w /opt/apigee/apigee-service/bin, którego można używać do zarządzania instalacją Edge. Można na przykład użyć narzędzia apigee-all do uruchamiania, zatrzymywania, ponownego uruchamiania, lub określenie stanu 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. do sterowania i konfigurowania poszczególnych komponentów. 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 poprzedzone prefiksem:

• apigee – firma zewnętrzna który jest używany przez Edge. Na przykład apigee-cassandra.
• edge – komponent Edge z Apigee. Na przykład edge-management-server.
• edge-mint – mechanizm zarabiania . Na przykład edge-mint-management-server.
• baas – interfejs 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:

• uruchamianie, zatrzymanie, ponowne uruchamianie
• stan, wersja
• kopia zapasowa, przywracanie
• instalować, odinstalować