Instalowanie Edge microgateway

Wyświetlasz dokumentację Apigee Edge.
Przejdź do dokumentacji Apigee X. info

Edge Microgateway w wersji 3.0.x

Z tego artykułu dowiesz się, jak zainstalować lub odinstalować Edge Microgateway.

Minimalne wymagania sprzętowe

Edge Microgateway wymaga minimalnej konfiguracji sprzętowej:

  • W przypadku maszyny wirtualnej Edge Microgateway wymaga co najmniej 1 rdzenia i co najmniej 256 MB pamięci RAM. Sam proces Edge Microgateway zajmuje mniej niż 128 MB pamięci RAM.
  • W przypadku kontenera Microgateway można używać z obrazem o rozmiarze mniejszym niż 100 MB.

Wymagania wstępne

  • W systemie musi być zainstalowany obiekt Node.js w wersji 8.x LTS lub 12.x zainstalowany w systemie. Wersję możesz sprawdzić, wykonując to polecenie: 
    node -v
v12.5.0
  • W systemie Windows musi być zainstalowany obiekt OpenSSL i dodany do zmiennej PATH.
  • Jeśli do konfiguracji Edge Microgateway używasz Apigee Edge Private Cloud, musisz mieć Private Cloud w wersji 4.18.01 lub nowszej.

Instalowanie Edge Microgateway, gdy masz połączenie z internetem

W tej sekcji dowiesz się, jak zainstalować Edge Microgateway i zainicjować konfigurację domyślną. Jeśli nie masz połączenia z internetem, przeczytaj sekcję Czy mogę zainstalować Edge Microgateway bez połączenia z internetem?.

  1. Zainstaluj najnowszą wersję Edge Microgateway za pomocą npm w ten sposób. To polecenie zainstaluje oprogramowanie i umieści plik wykonywalny edgemicro w Twojej ścieżce. 
    npm install edgemicro -g

    Aby zainstalować konkretną wersję Edge Microgateway, musisz podać numer wersji w poleceniu instalacji. Jeśli nie podasz numeru wersji, zostanie zainstalowana najnowsza wersja. Aby na przykład zainstalować wersję 2.5.7, użyj tego polecenia. 

    npm install edgemicro@3.0.2 -g
  2. Sprawdź numer wersji. Jeśli na przykład zainstalowano wersję 3.0.2: 
    edgemicro --version
current nodejs version is v12.5.0
current edgemicro version is 3.0.2
  3. Wykonaj czynności opisane w sekcji Konfigurowanie Edge Microgateway.

Uaktualnianie Edge Microgateway

Aby uaktualnić wcześniej zainstalowaną wersję Edge Microgateway, przeczytaj sekcję Uaktualnianie Edge Microgateway, gdy masz połączenie z internetem.

Apigee zaleca przetestowanie dotychczasowej konfiguracji z nową wersją przed uaktualnieniem środowiska produkcyjnego.

Uruchamianie Edge Microgateway w systemie Windows jako usługi

Edge Microgateway możesz uruchamiać w systemie Windows jako usługę. Więcej informacji znajdziesz w artykule Best practices for operational management of Microgateway (edgemicro) on Windows (Sprawdzone metody zarządzania operacyjnego Microgateway (edgemicro) w systemie Windows) w społeczności Apigee.

Czy mogę zainstalować Edge Microgateway bez połączenia z internetem?

W witrynach, które nie mają stałego dostępu do internetu, administrator może zainstalować i utrzymywać prywatny rejestr npm w sieci wewnętrznej. Instrukcje konfigurowania prywatnego rejestru npm wykraczają poza zakres tego przewodnika, ale możesz je znaleźć. Po zainstalowaniu prywatnego rejestru npm możesz postępować zgodnie z instrukcjami instalacji lub uaktualnienia podanymi powyżej.

Pierwsze kroki

Jeśli dopiero zaczynasz korzystać z Edge Microgateway, po zakończeniu instalacji najlepiej zacząć od sekcji Konfigurowanie Edge Microgateway. Przewodnik konfiguracji zawiera wszystkie czynności, które musisz wykonać, aby zainstalować, skonfigurować, uruchomić i używać instancji Edge Microgateway.

Gdzie jest zainstalowany Edge Microgateway?

Gdy używasz npm z opcją globalną (npm install -g edgemicro), oprogramowanie jest instalowane w [prefix]/lib/node_modules/edgemicro. Wartość [prefix] możesz znaleźć za pomocą tego polecenia:

npm config get prefix

Domyślnie prefiks jest ustawiony na lokalizację, w której zainstalowany jest obiekt Node.js. W większości systemów jest to /usr/local. W systemie Windows jest to %AppData%\npm. Wartość [prefix] można skonfigurować. Więcej informacji o tym, gdzie domyślnie są instalowane moduły Node.js i jak skonfigurować lokalizację instalacji, znajdziesz w artykule npm-folders.

Odinstalowywanie Edge Microgateway

Jeśli musisz usunąć Edge Microgateway:

  1. Usuń lub zarchiwizuj katalog instalacyjny [prefix]/lib/node_modules/edgemicro, gdzie [prefix] to prefiks npm zgodnie z opisem w sekcji Gdzie jest zainstalowany Edge Microgateway?.
  2. Usuń lub zarchiwizuj pliki dziennika. Domyślnie pliki edgemicro-*.log znajdują się w /var/tmp/, ale tę lokalizację można skonfigurować. W razie wątpliwości sprawdź plik konfiguracji Edge Microgateway.
  3. Usuń lub zarchiwizuj pliki konfiguracji środowiska wykonawczego i konfiguracji pamięci podręcznej: 
    ~/.edgemicro/*.yaml

Obsługa Kubernetes

Edge Microgateway możesz używać do zarządzania interfejsami Apigee API w przypadku usług działających w klastrze Kubernetes. Zapoznaj się z omówieniem integracji Edge Microgateway z Kubernetes.

Obsługa Dockera

Najnowszą wersję Edge Microgateway możesz teraz pobrać jako obraz Dockera:

docker pull gcr.io/apigee-microgateway/edgemicro:latest