Instalowanie Edge microgateway

Wyświetlasz dokumentację Apigee Edge.
Otwórz dokumentację Apigee X. info

Edge Microgateway w wersji 3.1.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

  • Apigee obsługuje aktywne wersje LTS lub wersje LTS z obsługą w systemach Windows, macOS i Linux. Więcej informacji znajdziesz w artykule Obsługiwane oprogramowanie w przypadku Apigee Edge Microgateway.
  • W systemie Windows należy zainstalować OpenSSL i dodać go do zmiennej PATH.
  • Jeśli do konfiguracji Edge Microgateway używasz Apigee Edge Private Cloud, musisz mieć wersję Private Cloud 4.18.01 lub nowszą.

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 artykuł 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ę 3.1.0, użyj tego polecenia. 

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

Uaktualnianie Edge Microgateway

Aby uaktualnić wcześniej zainstalowaną wersję Edge Microgateway, przeczytaj artykuł 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 dotyczące konfigurowania prywatnego rejestru npm wykraczają poza zakres tego przewodnika, ale możesz je znaleźć w internecie. 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 artykułu Konfigurowanie Edge Microgateway. Przewodnik po 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 zainstalowano 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 artykule 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. Więcej informacji znajdziesz w artykule Integracja Edge Microgateway z Kubernetes – omówienie.

Obsługa Dockera

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

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