Instalowanie Edge microgateway

Przeglądasz dokumentację Apigee Edge.
Otwórz dokumentację Apigee X.
Informacje

Edge Microgateway wersja 2.3.x

Odbiorcy

Skorzystaj z tego przewodnika, jeśli musisz zainstalować lub odinstalować Edge Microgateway.

Wymagania wstępne

  • W systemie musisz mieć zainstalowany Node.js w wersji 4.5 LTS lub nowszej. Poniżej znajdziesz dodatkowe instrukcje dotyczące Node.js.
  • Windows wymaga zainstalowania OpenSSL i dodania do PATH.
  • Jeśli do konfiguracji z Edge Microgateway używasz usługi Private Cloud Apigee Edge, musisz korzystać z Private Cloud w wersji 4.15.07 lub nowszej.

Instalowanie Node.js

W systemie musisz mieć zainstalowany Node.js w wersji 4.5 lub nowszej. Możesz to sprawdzić, wykonując:

node -v

Istnieje wiele sposobów pobierania lub aktualizowania środowiska Node.js. Możesz na przykład użyć HomeBrew, yum lub pobrać ją bezpośrednio z witryny Node.js: https://nodejs.org/download.

Instalowanie Edge Microgateway, jeśli masz połączenie z internetem

W tej sekcji dowiesz się, jak zainstalować Edge Microgateway i zainicjować konfigurację domyślną.

  1. Zainstaluj najnowszą wersję Edge Microgateway z użyciem npm za pomocą tego polecenia. To polecenie instaluje oprogramowanie i umieszcza w ścieżce plik wykonywalny edgemicro. Aby dowiedzieć się, gdzie dokładnie zainstalowane jest polecenie Edge Microgateway, zapoznaj się z artykułem Gdzie jest zainstalowana Edge Microgateway?.
    npm install edgemicro -g
    

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

    npm install edgemicro@2.3.1 -g
    
  2. Sprawdź numer wersji. Jeśli na przykład masz zainstalowaną wersję 2.3.5:
    edgemicro --version
    current nodejs version is v6.1.0
    current edgemicro version is 2.3.5
    
  3. Uruchom to polecenie, aby utworzyć w katalogu głównym plik konfiguracji domyślnej.
    edgemicro init
    
  4. (Opcjonalnie) Plik konfiguracyjny default.yaml został umieszczony w katalogu głównym w podkatalogu o nazwie .edgemicro. Sprawdź teraz, czy ten plik istnieje:
    ls ~/.edgemicro
    default.yaml
    

    Uwaga: w dokumentacji Edge Microgateway odwołuje się do katalogu głównego oznaczonego tyldą (~), która jest skrótem UNIX. Jeśli używasz systemu Windows, a uruchamiasz powłokę, która nie obsługuje tyldy, w poleceniach odwołujących się do katalogu głównego musisz zastąpić odpowiednią zmienną środowiskową dla tyldy. Na przykład: %USERPROFILE%/.edgemicro.

  5. Wykonaj czynności opisane w artykule Instalowanie Edge Microgateway.

Obsługa Edge Microgateway w systemie Windows jako usługa

Możesz obsługiwać Edge Microgateway w systemie Windows jako usługę. Więcej informacji znajdziesz w artykule na temat sprawdzonych metod zarządzania operacyjnego protokołem 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ą gotowego dostępu do internetu, administrator może zainstalować i obsługiwać prywatny rejestr npm w sieci wewnętrznej. Instrukcje konfigurowania prywatnego rejestru npm wykraczają poza zakres tego przewodnika, ale możesz samodzielnie wyszukać i znaleźć przydatne instrukcje. Jeśli masz zainstalowany prywatny rejestr npm, możesz wykonać podane wyżej instrukcje instalacji.

Pierwsze kroki

Jeśli dopiero zaczynasz korzystać z Edge Microgateway, po ukończeniu instalacji najlepiej zacząć od instalowania Edge Microgateway. Przewodnik konfiguracji i konfiguracji obejmuje wszystkie kroki potrzebne do zainstalowania, skonfigurowania, uruchomienia i używania instancji Edge Microgateway.

Gdzie jest zainstalowana Edge Microgateway?

Jeśli 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

Wartość [prefix] można skonfigurować. Więcej informacji znajdziesz w sekcji npm-folders.

Odinstalowywanie Edge Microgateway

Jeśli musisz usunąć Edge Microgateway:

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