Edge Microgateway installieren

Sie sehen die Dokumentation zu Apigee Edge.
Zur Apigee X-Dokumentation
weitere Informationen

Edge Microgateway Version 3.1.5 und höher

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

Mindestanforderungen an die Hardware

Edge Microgateway erfordert die folgende Mindesthardwarekonfiguration:

  • Auf einer virtuellen Maschine (VM) benötigt Edge Microgateway mindestens 1 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 Bildgröße von weniger als 100 MB verwendet werden.

Voraussetzungen

  • Apigee unterstützt aktive LTS- oder Wartungs-LangTS-Releases unter Windows, macOS und Linux. Weitere Informationen finden Sie unter Unterstützte Software für Apigee Edge Microgateway.
  • Für Windows muss OpenSSL installiert und dem PATH hinzugefügt werden.
  • Wenn Sie Apigee Edge Private Cloud für die Konfiguration mit Edge Microgateway verwenden, müssen Sie Private Cloud Version 4.18.01 oder höher ausführen.

Edge Microgateway installieren, wenn eine Internetverbindung besteht

In diesem Abschnitt wird erläutert, wie Sie Edge Microgateway installieren und eine Standardkonfiguration initialisieren. Wenn Sie ohne Internetverbindung arbeiten, finden Sie weitere Informationen unter Kann ich Edge Microgateway ohne Internetverbindung installieren?.

  1. Installieren Sie die neueste Version von Edge Microgateway mit npm wie unten beschrieben. Mit diesem Befehl wird die Software installiert und die ausführbare edgemicro-Datei in Ihrem Pfad abgelegt.
    npm install edgemicro -g
    

    Wenn Sie eine bestimmte Version von Edge Microgateway installieren, müssen Sie im Installationsbefehl die Versionsnummer angeben. Wenn Sie keine Versionsnummer angeben, wird die neueste Version installiert. Verwenden Sie beispielsweise den folgenden Befehl, um Version 3.1.5 zu installieren.

    npm install edgemicro@3.1.5 -g
    
  2. Prüfen Sie die Versionsnummer. Wenn Sie beispielsweise Version 3.1.5 installiert haben:
    edgemicro --version
    current nodejs version is v12.5.0
    current edgemicro version is 3.1.5
    
  3. Führen Sie die Einrichtungs- und Konfigurationsschritte unter Edge Microgateway einrichten und konfigurieren aus.

Edge Microgateway aktualisieren

Informationen zum Upgrade einer zuvor installierten Version von Edge Microgateway finden Sie unter Edge Microgateway upgraden, wenn Sie eine Internetverbindung haben.

Apigee empfiehlt, dass Sie Ihre vorhandene Konfiguration mit der neuen Version testen, bevor Sie ein Upgrade der Produktionsumgebung ausführen.

Edge Microgateway unter Windows als Dienst ausführen

Sie können Edge Microgateway unter Windows als Dienst ausführen. Weitere Informationen finden Sie in der Apigee-Community unter Best Practices for Operational Management of Microgateway (edgemicro) on Windows (Best Practices für die operative Verwaltung von Microgateway (edgemicro) unter Windows).

Kann ich Edge Microgateway ohne Internetverbindung installieren?

Auf Websites, die keinen geeigneten Internetzugang haben, kann ein Administrator eine private npm-Registry in Ihrem internen Netzwerk installieren und verwalten. Eine Anleitung zum Einrichten einer privaten npm-Registry wird in diesem Leitfaden nicht behandelt. Sie können aber nach hilfreichen Anleitungen suchen. Wenn eine private npm-Registry installiert ist, können Sie die oben beschriebene Installations- oder Upgrade-Anleitung ausführen.

Erste Schritte

Wenn Sie Edge Microgateway noch nicht kennen, sollten Sie nach der Installation mit Edge Microgateway einrichten und konfigurieren beginnen. Die Einrichtungs- und Konfigurationsanleitung umfasst 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. Mit dem folgenden Befehl ermitteln Sie den Wert von [prefix]:

npm config get prefix

Die Präfixkonfiguration ist standardmäßig der Standort, an dem der Knoten installiert ist. Bei den meisten Systemen ist dies /usr/local. Unter Windows ist es %AppData%\npm. Der Wert von [prefix] ist konfigurierbar. Unter npm-folders finden Sie weitere Informationen dazu, wo Node.js-Module standardmäßig installiert sind und wie Sie den Installationsort konfigurieren.

Edge Microgateway deinstallieren

Wenn Sie Edge Microgateway entfernen müssen:

  1. Löschen oder archivieren Sie das Installationsverzeichnis [prefix]/lib/node_modules/edgemicro, wobei [Präfix] das npm-Präfix ist, wie unter Wo wird Edge Microgateway installiert erläutert?
  2. Löschen oder archivieren Sie die Protokolldateien. Standardmäßig befinden sich edgemicro-*.log-Dateien in /var/tmp/, aber dieser Speicherort ist konfigurierbar. Prüfen Sie im Zweifelsfall die Konfigurationsdatei von Edge Microgateway.
  3. Löschen oder archivieren Sie die Laufzeitkonfigurationsdatei und speichern Sie die Konfigurationsdateien im Cache:
    ~/.edgemicro/*.yaml
    

Kubernetes-Unterstützung

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

Docker-Support

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

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