Edge Microgateway installieren

Sie lesen gerade die Apigee Edge -Dokumentation.
Zur Apigee X -Dokumentation. info

Edge Microgateway, Version 3.1.x

In diesem Thema wird erläutert, wie Sie Edge Microgateway installieren oder deinstallieren.

Hardwareanforderungen

Für Edge Microgateway ist die folgende Mindesthardwarekonfiguration erforderlich:

  • Auf einer VM (Virtual Machine) benötigt Edge Microgateway mindestens einen Kern und mindestens 256 MB RAM. Der Edge Microgateway-Prozess selbst benötigt weniger als 128 MB RAM.
  • In einem Container kann Microgateway mit einer Imagegröße von weniger als 100 MB verwendet werden.

Vorbereitung

  • Apigee unterstützt Active LTS- oder Maintenance LTS-Releases unter Windows, macOS und Linux. Weitere Informationen finden Sie unter Unterstützte Software für Apigee Edge Microgateway.
  • Unter Windows muss OpenSSL installiert und dem PATH hinzugefügt werden.
  • Wenn Sie Apigee Edge Private Cloud für die Konfiguration mit Edge Microgateway verwenden, muss die Private Cloud-Version 4.18.01 oder höher ausgeführt werden.

Edge Microgateway installieren, wenn eine Internetverbindung besteht

In diesem Abschnitt wird erläutert, wie Sie Edge Microgateway installieren und eine Standard Konfiguration initialisieren. Wenn Sie ohne Internetverbindung arbeiten, lesen Sie Kann ich Edge Microgateway ohne Internetverbindung installieren?.

  1. Installieren Sie die aktuelle Version von Edge Microgateway mit npm wie folgt. Mit diesem Befehl wird die Software installiert und die ausführbare Datei edgemicro in Ihren Pfad eingefügt. 
    npm install edgemicro -g

    Wenn Sie eine bestimmte Version von Edge Microgateway installieren möchten, müssen Sie die Versionsnummer im Installationsbefehl angeben. Wenn Sie die Versionsnummer nicht angeben, wird die aktuelle Version installiert. Verwenden Sie beispielsweise den folgenden Befehl, um Version 3.1.0 zu installieren. 

    npm install edgemicro@3.1.0 -g
  2. Prüfen Sie die Versionsnummer. Beispiel: Wenn Sie Version 3.1.0 installiert haben: 
    edgemicro --version
current nodejs version is v12.5.0
current edgemicro version is 3.1.0
  3. Folgen Sie der Anleitung unter Einrichten und Konfigurieren von Edge Microgateway.

Edge Microgateway aktualisieren

Informationen zum Aktualisieren einer zuvor installierten Version von Edge Microgateway finden Sie unter Edge Microgateway aktualisieren, wenn eine Internetverbindung besteht.

Apigee empfiehlt, die vorhandene Konfiguration mit der neuen Version zu testen, bevor Sie die Produktionsumgebung aktualisieren.

Edge Microgateway unter Windows als Dienst ausführen

Sie können Edge Microgateway unter Windows als Dienst ausführen. Weitere Informationen finden Sie unter Best Practices for operational management of Microgateway (edgemicro) on Windows in der Apigee-Community.

Kann ich Edge Microgateway ohne Internetverbindung installieren?

An Standorten ohne direkten Internetzugang kann ein Administrator eine private `npm`-Registrierung in Ihrem internen Netzwerk installieren und verwalten. Eine Anleitung zum Einrichten einer privaten npm Registrierung ist nicht Teil dieser Anleitung. Sie können aber danach suchen. Wenn eine private npm Registrierung installiert ist, können Sie der oben beschriebenen Installations- oder Aktualisierungsanleitung folgen.

Erste Schritte

Wenn Sie Edge Microgateway noch nicht kennen, ist die Anleitung Edge Microgateway einrichten und konfigurieren der beste Ort, um nach der Installation zu beginnen. Die Einrichtungs- und Konfigurationsanleitung enthält alle Schritte, die Sie zum Installieren, Konfigurieren, Starten und Verwenden einer Instanz von Edge Microgateway ausführen müssen.

Wo wird Edge Microgateway installiert?

Wenn Sie npm mit der globalen Option (npm install -g edgemicro) verwenden, wird die Software in [prefix]/lib/node_modules/edgemicro installiert. Sie können den Wert von [prefix] mit diesem Befehl ermitteln:

npm config get prefix

Die Präfixkonfiguration wird standardmäßig auf den Speicherort festgelegt, an dem Node installiert ist. Auf den meisten Systemen ist dies /usr/local. Unter Windows ist es %AppData%\npm. Der Wert von [prefix] ist konfigurierbar. Weitere Informationen dazu, wo Node.js Module standardmäßig installiert werden und wie Sie den Installationsort konfigurieren, finden Sie unter npm-folders.

Edge Microgateway deinstallieren

So entfernen Sie Edge Microgateway:

  1. Löschen oder archivieren Sie das Installationsverzeichnis [prefix]/lib/node_modules/edgemicro. Dabei ist [prefix] das `npm` Präfix, wie unter Wo wird Edge Microgateway installiert? erläutert.
  2. Löschen oder archivieren Sie die Logdateien. Standardmäßig befinden sich die Dateien edgemicro-*.log in /var/tmp/. Dieser Speicherort ist jedoch konfigurierbar. Prüfen Sie im Zweifelsfall die Edge Microgateway-Konfigurationsdatei.
  3. Löschen oder archivieren Sie die Konfigurationsdateien für die Laufzeit und den Cache: 
    ~/.edgemicro/*.yaml

Kubernetes-Unterstützung

Mit Edge Microgateway können Sie die Apigee API-Verwaltung für Dienste bereitstellen, die in einem Kubernetes Cluster ausgeführt werden. Weitere Informationen finden Sie unter Edge Microgateway in Kubernetes einbinden – Übersicht.

Docker-Support

Sie können die aktuelle Version von Edge Microgateway jetzt als ein Docker-Image herunterladen:

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