Instalowanie Edge microgateway

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

Edge Microgateway w wersji 2.3.x

Odbiorcy

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

Wymagania wstępne

  • W systemie musi być zainstalowana wersja 4.5 LTS lub nowsza Node.js. Poniżej znajdziesz dodatkowe instrukcje dotyczące Node.js.
  • W systemie Windows musi być zainstalowany OpenSSL i dodany do PATH.
  • Jeśli używasz Apigee Edge Private Cloud do konfigurowania Edge Microgateway, musisz mieć Private Cloud w wersji 4.15.07 lub nowszej.

Instalowanie Node.js

W systemie musi być zainstalowana wersja 4.5 lub nowsza Node.js. Możesz to sprawdzić, wykonując to polecenie:

node -v

Istnieje wiele sposobów na pobranie lub zaktualizowanie Node.js. Możesz na przykład użyć HomeBrew, yum lub pobrać go bezpośrednio ze strony Node.js: https://nodejs.org/download.

Instalowanie Edge Microgateway, gdy 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 za pomocą npm używając tego polecenia. To polecenie instaluje oprogramowanie i umieszcza plik wykonywalny edgemicro w ścieżce. Aby dowiedzieć się, gdzie dokładnie to polecenie instaluje Edge Microgateway, przeczytaj sekcję Gdzie jest zainstalowany Edge Microgateway?.
    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.3.1, użyj tego polecenia.

    npm install edgemicro@2.3.1 -g
  2. Sprawdź numer wersji. Jeśli na przykład zainstalowano 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ć domyślny plik konfiguracyjny w katalogu głównym.
    edgemicro init
  4. (Opcjonalnie) Plik konfiguracyjny o nazwie 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 do katalogu głównego odwołujemy się za pomocą tyldy (~), która jest skrótem w systemie UNIX. Jeśli używasz systemu Windows i powłoki, która nie obsługuje tyldy, musisz zastąpić tyldę odpowiednią zmienną środowiskową w poleceniach odwołujących się do katalogu głównego. Na przykład: %USERPROFILE%/.edgemicro.

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

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źć. Po zainstalowaniu prywatnego rejestru npm możesz postępować zgodnie z instrukcjami instalacji podanymi powyżej.

Pierwsze kroki

Jeśli dopiero zaczynasz korzystać z Edge Microgateway, po zakończeniu instalacji najlepiej zacząć od artykułu Instalowanie Edge Microgateway. Przewodnik po konfiguracji i 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

Wartość [prefix] można skonfigurować. Więcej informacji 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 , jak wyjaśniono 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 konfiguracyjny, jak opisano w sekcji „Zarządzanie plikami dziennika”.
  3. Usuń lub zarchiwizuj pliki konfiguracji środowiska wykonawczego i konfiguracji pamięci podręcznej:
    ~/.edgemicro/*.yaml