Instalowanie Edge microgateway

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

Edge Microgateway w wersji 2.4.x

Odbiorcy

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

Wymagania wstępne

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

Instalowanie Node.js

Na komputerze musi być zainstalowana wersja Node.js 4.5 lub nowsza. 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. Zobacz też 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 zainstalujesz 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ć ją 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 Konfigurowanie 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 npm rejestru 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 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ść of [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 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 konfiguracyjny zgodnie z opisem w sekcji „Zarządzanie plikami dziennika”.
  3. Usuń lub zarchiwizuj pliki konfiguracji środowiska wykonawczego i konfiguracji pamięci podręcznej: 
    ~/.edgemicro/*.yaml