Diese Seite wurde von der Cloud Translation API übersetzt.

Befehlszeilenreferenz für Edge Microgateway

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

Edge Microgateway Version 2.4.x

Überblick

Mit der Edge Microgateway-Befehlszeile können Sie alle Aspekte einer Edge Microgateway-Instanz steuern und verwalten.

Zertifikate verwalten

Mit den cert-Befehlen können Sie das öffentliche/private Schlüsselpaar installieren und verwalten, mit dem Inhabertokens signiert werden, die von Clients für sichere Aufrufe über Edge Microgateway verwendet werden. Die Schlüssel werden in Apigee Edge in einer verschlüsselten Schlüssel/Wert-Zuordnung (KVM) gespeichert. Edge Microgateway verwendet den öffentlichen Schlüssel, um signierte Inhabertokens zu validieren. Diese Schlüssel werden generiert, wenn Sie den Edge Microgateway-Befehl konfigurieren, wie unter Edge Microgateway einrichten und konfigurieren erläutert. Sie können die hier beschriebenen cert-Befehle verwenden, um diese Schlüssel bei Bedarf neu zu generieren und zu verwalten.

Ein Zertifikat installieren

Installiert die Schlüssel mithilfe des sicheren Speicherdienstes von Apigee Edge in einer verschlüsselten Schlüssel/Wert-Zuordnung (KVM) und gibt den öffentlichen Schlüssel als Ausgabe zurück. Schlüsselpaare sind auf eine bestimmte Organisation beschränkt.

Nutzung

edgemicro cert install -o [organization] -e [environment] -u [username] -p [password] --force

Parameter

Parameter	Beschreibung
`-o, --org`	Die Apigee-Organisation, für die Sie Edge Microgateway konfiguriert haben.
`-e, --env`	Eine Umgebung, für die Sie Edge Microgateway konfiguriert haben.
`-u, --username`	Ihren Apigee-Nutzernamen. Sie müssen ein Organisationsadministrator für die angegebene Organisation sein.
`-p, --password`	Optional: Ihr Passwort Wenn Sie diesen Parameter nicht in der Befehlszeile angeben, werden Sie zur Eingabe aufgefordert.
`-f, --force`	(Optional) Wenn ein Schlüssel bereits in der verschlüsselten KVM gespeichert ist, erzwingen Sie seine Ersetzung.
`-h, --help`	Nutzungsinformationen ausgeben.

Beispiel

edgemicro cert install -o docs -e test -u jdoe@example.com -f

Ausgabe

current nodejs version is v6.1.0
current edgemicro version is 2.2.4-beta
password:
deleting vault
creating vault
adding private_key
adding public_key
installed cert

Zertifikat löschen

Löscht das Schlüsselpaar für eine Organisation.

Nutzung

edgemicro cert delete -o [organization] -e [environment] -u [username] -p [password]

Parameter

Parameter	Beschreibung
`-o, --org`	Die Apigee-Organisation, für die Sie Edge Microgateway konfiguriert haben.
`-e, --env`	Eine Umgebung, für die Sie Edge Microgateway konfiguriert haben.
`-u, --username`	Ihren Apigee-Nutzernamen. Sie müssen ein Organisationsadministrator für die angegebene Organisation sein.
`-p, --password`	Optional: Ihr Passwort Wenn Sie diesen Parameter nicht in der Befehlszeile angeben, werden Sie zur Eingabe aufgefordert.
`-h, --help`	Nutzungsinformationen ausgeben.

Beispiel

edgemicro cert delete -o docs -e test -u jdoe@example.com

Ausgabe

deleting vault
Vault deleted!

Zertifikat prüfen

Überprüft, ob in Ihrer Organisation ein Zertifikat installiert ist.

Nutzung

edgemicro cert check -o [organization] -e [environment] -u [username] -p [password]

Parameter

Parameter	Beschreibung
`-o, --org`	Die Apigee-Organisation, für die Sie Edge Microgateway konfiguriert haben.
`-e, --env`	Eine Umgebung, für die Sie Edge Microgateway konfiguriert haben.
`-u, --username`	Ihren Apigee-Nutzernamen. Sie müssen ein Organisationsadministrator für die angegebene Organisation sein.
`-p, --password`	Optional: Ihr Passwort Wenn Sie diesen Parameter nicht in der Befehlszeile angeben, werden Sie zur Eingabe aufgefordert.
`-h, --help`	Nutzungsinformationen ausgeben.

Beispiel

edgemicro cert check -o docs -e test -u jdoe@example.com

Ausgabe (Erfolg)

checked cert successfully

Ausgabe (Fehler)

Wenn das Zertifikat nicht vorhanden ist, wird ein Fehler zurückgegeben.

Rufen Sie den öffentlichen Schlüssel ab

Gibt den öffentlichen Schlüssel für die angegebene Organisation zurück Erfordert keine Authentifizierung.

Nutzung

edgemicro cert public-key -o [organization] -e [environment]

Parameter

Parameter	Beschreibung
`-o, --org`	Die Apigee-Organisation, für die Sie Edge Microgateway konfiguriert haben.
`-e, --env`	Eine Umgebung, für die Sie Edge Microgateway konfiguriert haben.
`-h, --help`	Nutzungsinformationen ausgeben.

Beispiel

edgemicro cert public-key -o docs -e test

Ausgabe (Beispiel)

Edge Microgateway für Apigee Edge Cloud konfigurieren

Ermöglicht Edge Microgateway die Ausführung mit einer Apigee Edge Cloud-Instanz. Es fasst eine Reihe von Befehlen zusammen und führt sie aus, um einen erforderlichen Authentifizierungs-Proxy in Edge bereitzustellen, Authentifizierungstokens zu generieren und Konfigurationsdateien zu aktualisieren. Ein vollständiges Arbeitsbeispiel finden Sie unter Edge Microgateway einrichten und konfigurieren.

Nutzung

edgemicro configure -o [organization] -e [environment] -u [username] -p [password]

Parameter

Parameter	Beschreibung
`-o, --org`	Die Apigee-Organisation, für die Sie Edge Microgateway konfiguriert haben.
`-e, --env`	Eine Umgebung, für die Sie Edge Microgateway konfiguriert haben.
`-u, --username`	Ihren Apigee-Nutzernamen. Sie müssen ein Organisationsadministrator für die angegebene Organisation sein.
`-p, --password`	Optional: Ihr Passwort Wenn Sie diesen Parameter nicht in der Befehlszeile angeben, werden Sie zur Eingabe aufgefordert.
`-r, --url`	Optional:Gibt den Alias des virtuellen Hosts für Ihre Organisationsumgebung an. Weitere Informationen zu virtuellen Hosts finden Sie in der Edge-Dokumentation. Standardwert: `org-env.apigee.net`
`-c, --configDir`	(Optional) Gibt den Pfad zur Edge Microgateway-Konfigurationsdatei an. Die Konfigurationsdatei befindet sich standardmäßig in ./config/config.yaml. (Version 2.4.x hinzugefügt)
`-x, --proxyName`	(Optional) Legt den Basispfad für den Proxy edgemicro-auth fest. Wenn der edgemicro-auth-Proxy unter einem anderen Pfad als dem Standardpfad /edgemicro-auth bereitgestellt wird, können Sie mit dieser Funktion den neuen Pfad in Edge Microgateway festlegen. Standardmäßig ist der Basispfad /edgemicro-auth. (Version 2.4.x wurde hinzugefügt.)
`-t, --token`	Optional: Damit können Sie anstelle von Nutzername/Passwort ein OAuth-Token für die Authentifizierung verwenden. Beispiel: `edgemicro configure -o docs -e test -t <your token>`
`-v, --virtualHosts`	(Optional) Überschreibt die virtuellen Standardhosts „`default,secure`“. Verwenden Sie diese Option, wenn Sie für Ihre Edge-Organisationsumgebung andere virtuelle Hosts als diese Standardeinstellungen angegeben haben. Weitere Informationen zu virtuellen Hosts finden Sie in der Edge-Dokumentation.
`-d, --debug`	(Optional) Enthält Informationen zur Fehlerbehebung.
`-h, --help`	Nutzungsinformationen ausgeben.

Verwendungshinweise

Mit diesem Befehl werden Konfigurationsinformationen in ~/.edgemicro/org-env-config.yaml gespeichert.

Beispiel

edgemicro configure -o docs -e test -u jdoe@example.com

Ausgabe

Bei Erfolg gibt der Befehl eine Reihe von Schlüsseln zurück, die Sie beim Starten von Edge Microgateway verwenden müssen.

...

The following credentials are required to start edge micro
  key: d2f0a246ad52b5d2a8b04ba65b43c76348aba586691cf6185cd7bb9fb78fe9f
  secret: 59813bc1db4a7ada182705ae40893c28a6fae680c3deb42aefbf1a4db42e372

edgemicro configuration complete!

Schlüssel generieren

Der Befehl genkeys generiert ein Key-Secret-Paar, das von Edge Microgateway verwendet wird, um sich zu authentifizieren, wenn Analysedaten asynchron an Apigee Edge gesendet werden.

Nutzung

edgemicro genkeys -o [organization] -e [environment] -u [username] -p [password]

Parameter

Parameter	Beschreibung
`-o, --org`	Die Apigee-Organisation, für die Sie Edge Microgateway konfiguriert haben.
`-e, --env`	Eine Umgebung, für die Sie Edge Microgateway konfiguriert haben.
`-u, --username`	Ihren Apigee-Nutzernamen. Sie müssen ein Organisationsadministrator für die angegebene Organisation sein.
`-p, --password`	Optional: Ihr Passwort Wenn Sie diesen Parameter nicht in der Befehlszeile angeben, werden Sie zur Eingabe aufgefordert.
`-h, --help`	Nutzungsinformationen ausgeben.

Verwendungshinweise

Bei Erfolg gibt der Befehl drei Elemente zurück. Die erste ist eine URL, die Sie in die Konfigurationsdatei einfügen müssen. Die anderen beiden sind ein Schlüsselpaar, das beim Starten einer Edge Microgateway-Instanz erforderlich ist.

Bootstrap-URL: Diese URL verweist auf einen Apigee Edge-Dienst, der es einer Edge Microgateway-Instanz ermöglicht, Analysedaten an Apigee Edge zu senden. Sie müssen diese URL in die Edge Microgateway-Konfigurationsdatei kopieren: ~/.edgemicro/org-env-config.yaml.
key: Schlüssel. Dieser Schlüssel und das Secret sind als Eingabe in den CLI-Befehl erforderlich, der zum Starten einer Instanz von Edge Microgateway verwendet wird.
secret: Das Secret.

Beispiel

edgemicro genkeys -o docs -e test -u jdoe@example.com

Ausgabe (Beispiel)

Bei Erfolg gibt der Befehl eine Reihe von Schlüsseln zurück, die Sie beim Starten von Edge Microgateway verwenden müssen.

configuring host edgemicroservices-us-east-1.apigee.net for region us-east-1
Please copy the following property to the edge micro agent config
  bootstrap: https://edgemicroservices-us-east-1.apigee.net/edgemicro/bootstrap/organization/jdoe/environment/test

The following credentials are required to start edge micro
  key: db39324077989c75eac34c13d285772ea8e3b982b957b3f52916f3048511443f
  secret: 5bf8da39de0056f88fdd5f25a8602d22f312c1c8c870580a5fef55ac6637b7ae

finished

Edge Microgateway für Apigee Edge Private Cloud konfigurieren

Konfiguriert Edge Microgateway für eine Apigee Edge Private Cloud-Installation.

Nutzung

edgemicro private configure -o [organization] -e [environment] -u [username] -p [password]

Parameter

Parameter	Beschreibung
`-o, --org`	Die Apigee-Organisation, für die Sie Edge Microgateway konfiguriert haben.
`-e, --env`	Eine Umgebung, für die Sie Edge Microgateway konfiguriert haben.
`-u, --username`	Ihren Apigee-Nutzernamen. Sie müssen ein Organisationsadministrator für die angegebene Organisation sein.
`-p, --password`	Optional: Ihr Passwort Wenn Sie diesen Parameter nicht in der Befehlszeile angeben, werden Sie zur Eingabe aufgefordert.
`-r, --runtime-url`	Gibt die Laufzeit-URL für Ihre private Cloud-Instanz an.
`-m, --mgmt-url`	Die URL des Verwaltungsservers für Ihre private Cloud-Instanz.
`-v, --virtualHosts`	Durch Kommas getrennte Liste der virtuellen Hosts für Ihre Organisationsumgebung. Standardeinstellung: „`default,secure`“.
`-c, --configDir`	(Optional) Gibt den Pfad zur Edge Microgateway-Konfigurationsdatei an. Die Konfigurationsdatei befindet sich standardmäßig in ./config/config.yaml. (Version 2.4.x hinzugefügt)
`-t, --token`	Optional: Damit können Sie anstelle von Nutzername/Passwort ein OAuth-Token für die Authentifizierung verwenden. Beispiel: `edgemicro configure -o docs -e test -t <your token>`
`-d, --debug`	(Optional) Enthält Informationen zur Fehlerbehebung.
`-h, --help`	Nutzungsinformationen ausgeben.

Verwendungshinweise

Mit diesem Befehl werden Konfigurationsinformationen in ~/.edgemicro/org-env-config.yaml gespeichert.

Beispiel

edgemicro private configure -o docs -e test -u jdoe@example.com -r http://192.162.55.100:9002 -m http://192.162.55.100:8080

Ausgabe

Bei Erfolg gibt der Befehl eine Reihe von Schlüsseln zurück, die Sie beim Starten von Edge Microgateway verwenden müssen.

...

The following credentials are required to start edge micro
  key: d2f0a246ad52b5d2a8b04ba65b43c76348aba586691cf6185cd7bb9fb78fe9f
  secret: 59813bc1db4a7ada182705ae40893c28a6fae680c3deb42aefbf1a4db42e372

edgemicro configuration complete!

Edge Microgateway starten

Bevor Sie Edge Microgateway starten, müssen Sie zuerst edgemicro configure (Public Cloud) oder edgemicro private config (Private Cloud) ausführen. Der Befehl „config“ gibt die Schlüssel- und Secret-Werte zurück, die zum Starten von Edge Microgateway erforderlich sind.

Nutzung

edgemicro start -o [organization] -e [environment] -k [public-key] -s [secret-key]

Parameter

Parameter	Beschreibung
`-o, --org`	Die Apigee-Organisation, für die Sie Edge Microgateway konfiguriert haben.
`-e, --env`	Eine Umgebung, für die Sie Edge Microgateway konfiguriert haben.
`-k, --key`	Der zurückgegebene Schlüsselwert, der zurückgegeben wird, wenn Sie den Befehl "`edgemicro configure`" ausführen.
`-s, --secret`	Der zurückgegebene Secret-Wert, der beim Ausführen des Befehls „`edgemicro configure`“ zurückgegeben wird.
`-p, --processes`	(Optional) Die Anzahl der zu startenden Prozesse. Standardeinstellung: Die Anzahl der Kerne in Ihrem System.
`-d, --pluginDir`	(Optional) Absoluter Pfad zum Plug-in-Verzeichnis.
`-r, --port`	(Optional) Überschreibt die in der Datei ~`/.edgemicro/org-env-config.yaml` angegebene Portnummer. Standardeinstellung: 8.000
`-c, --cluster`	(Optional) Startet Edge Microgateway im Clustermodus. Hinweis:Ab Version 2.3.1 wurde diese Option entfernt. In v2.3.1 und höher startet Edge Micro immer im Clustermodus.
`-c, --configDir`	(Optional) Gibt den Pfad zur Edge Microgateway-Konfigurationsdatei an. Die Konfigurationsdatei befindet sich standardmäßig in ./config/config.yaml. (Version 2.4.x hinzugefügt)
`-d, --debug`	(Optional) Enthält Informationen zur Fehlerbehebung.
`-h, --help`	Nutzungsinformationen ausgeben.

Port einrichten

Mit dem Befehl start können Sie eine Portnummer angeben, um den in der Konfigurationsdatei angegebenen Port zu überschreiben. Sie können auch mit der Umgebungsvariable PORT eine Portnummer angeben. Beispiel:

edgemicro start -o docs -e test -k abc123 -s xyz456 -p 2 --port 8002

oder

export PORT=8002 
edgemicro start -o org -e test -k key -s secret -p 2

Wenn der Port verwendet wird, gibt Edge Microgateway einen Fehler zurück.

Clustering

Edge Microgateway verwendet das Node.js-Clustermodul, um das Clustering zu aktivieren. Clustering ermöglicht es Edge Microgateway, Mehrkernsysteme zu nutzen. Weitere Informationen finden Sie in dieser Node.js-Dokumentation.

Hinweis: In v2.2.4-beta und höher wird Edge Microgateway immer im Clustermodus gestartet. Wenn Sie eine ältere Version verwenden, können Sie das Mikrogateway mit der Option --cluster im Clustermodus starten. Beispiel:

edgemicro start -o docs -e test -k abc123 -s xyz456 --cluster

Beispiel

edgemicro start -o docs -e test -k abc123 -s xyz456

Beispielausgabe:

...

PROCESS PID : 54709
installed plugin from analytics
installed plugin from analytics
installed plugin from oauth
installed plugin from oauth
installed plugin from analytics
installed plugin from oauth
5a86b570-a142-11e6-aa1f-6730e9065d6c edge micro listening on port 8000
5a86dc80-a142-11e6-962c-43d9cc723190 edge micro listening on port 8000
5a8751b0-a142-11e6-8241-cf1c517c91eb edge micro listening on port 8000
installed plugin from analytics
installed plugin from oauth
5a924e30-a142-11e6-8740-2944162ce275 edge micro listening on port 8000

Tokens verwalten

Mit den token-Befehlen können Sie signierte OAuth2-Zugriffstokens abrufen, decodieren und prüfen. Siehe auch API-Aufrufe mit einem OAuth2-Zugriffstoken sichern.

Token decodieren

Decodiert ein signiertes, codiertes Inhabertoken in dessen Nur-Text-JSON-JWT-Darstellung (Java Web Token). Ein Token überträgt Informationen über die Apigee Edge-Entwickleranwendung, die die zum Erstellen des Tokens verwendeten Schlüssel bereitgestellt hat, einschließlich Anwendungsname, client_id, Produktliste und mehr.

Nutzung

edgemicro token decode -f [filename]

Parameter

Parameter	Beschreibung
`-f, --file`	Der Name einer Datei, die das zu decodierende JWT-Token enthält.
`-h, --help`	Nutzungsinformationen ausgeben.

Beispiel

edgemicro token decode -f token.jwt

Ausgabe (Stichprobe)

{ header: { typ: 'JWT', alg: 'RS256' },

  payload:
   { application_name: 'b43342ef-86f6-4666-a121-b9ac2025d217',
     client_id: 'O9ZQRZKnn1rdgcKQgsABSMdOsKS',
     scopes: [],
     api_product_list: [ 'MicroTest' ],
     iat: 1436280566,
     exp: 1436282365 },
  signature: ... }

Token generieren

Generiert ein signiertes Inhabertoken. Mit dem Token können Client-Apps authentifizierte API-Aufrufe an Edge Microgateway senden. Das Token ist ein OAuth 2.0-kompatibles JSON Web Token (JWT). Sie erfordert als Eingabe die Werte für den Consumer-Key (Client-ID) und das Consumer-Secret (Client-Secret) einer registrierten Entwickler-App in Apigee Edge. Siehe auch API-Aufrufe mit einem OAuth2-Zugriffstoken sichern.

Nutzung

edgemicro token get -o [org] -e [env] -i [client_id] -s [client_secret]

Parameter

Parameter	Beschreibung
`-o, --org`	Die Apigee-Organisation, für die Sie Edge Microgateway konfiguriert haben.
`-e, --env`	Eine Umgebung, für die Sie Edge Microgateway konfiguriert haben.
`-1, --key`	Die Client-ID aus der Entwickler-App, die Ihrem Microgateway-fähigen Proxy zugeordnet ist.
`-s, --secret`	Der Clientschlüssel aus der Entwickler-App, der Ihrem Microgateway-Aware Proxy zugeordnet ist.
`-h, --help`	Nutzungsinformationen ausgeben.

Beispiel

edgemicro token get -o docs -e test -i 5UzOwAXGoOeo60aew94PPG5MAZE3aJp -s 6vahKFGS9a3qMLwz

Ausgabe (Stichprobe)

{ token: 'eyJ0eXAiOiJKV1JhbGciOiJSUzI1NiJ9Glvbl9uYW1lIjoiNWNiMGY0NTV6TV3
EtOWMzOC00YmJjLWIzNzEtZGMxZTQzOGMxIiwiY2xpZW50X2lkIjoiNVV6T3dBWEdvSU9lbz
YwYWV3OTRQN0c1TUFaRTNhSnAiLCJzY2MiOltdLCJhcGlfcHJvZHVjdF9saXN0IjpbIkVkZ2
VNaWNyb1Rlc3RQcm9kdWN0Il0sImlhdCI3ODEyMzQ2MSwiZXhwIjoxNDc4MTI1MjYwfQ.Dx5
f5U7PXm8koNGmFX4N6VrxKMJnpndKgoJ5zWSJvBZ6Ccvhlpd85ipIIA5S2A5nx4obYWp_rpY
RJpIGYwyxP6Oq2j0rxnVjdCC4qyYMgthZjhKgEBVBe3s1ndP72GP2vV6PsSA9RQ2-yzsy9r0
TzhAZ3NJTxT1tS0XKqKngE-OhR3fJHVLAzdMDT0AmS9H0Z2NAJtQOuK6RTpCjG9B6Bc48AEM
sj7QSM-1LWiQ8LdY8k_BoC06qsTI7bCQGWwTuqL-ismbcx2bxovUxSemZIaoROfuF-dCZHG3
2aTP75WxBvvNgBBvPvQtPzbeSOtEaww' }

HTTP-Anfrage zum Abrufen eines Tokens stellen

Sie können das Token auch mit einer unformatierten HTTP-Anfrage abrufen. Hier ein curl-Beispiel. Ersetzen Sie einfach Ihre Organisations- und Umgebungsnamen in der URL und die Werte für "client_id" und "client_secret" durch die Werte für Nutzer-ID und Consumer-Secret durch die Parameter client_id und client_secret:

curl -i -X POST "http://<org>-<test>.apigee.net/edgemicro-auth/token" -d '{"grant_type": "client_credentials", "client_id": "4t8X137pOUUtMR7wag3M1yZTcRxeK", "client_secret": "RAcOFVOvO0jns"}' -H "Content-Type: application/json"

Token verifizieren

Überprüft ein signiertes Inhabertoken anhand des öffentlichen Schlüssels, der in Apigee Edge für die angegebene Organisation und Umgebung gespeichert ist.

Nutzung

edgemicro token verify -o [org] -e [env] -f [filename]

Parameter

Parameter	Beschreibung
`-o, --org`	Die Apigee-Organisation, für die Sie Edge Microgateway konfiguriert haben.
`-e, --env`	Eine Umgebung, für die Sie Edge Microgateway konfiguriert haben.
`-f, --file`	Der Name einer Datei, die das zu überprüfende JWT enthält.
`-h, --help`	Nutzungsinformationen ausgeben.

Beispiel

edgemicro token get -o docs -e test -f token.jwt

Beispielausgabe für gültiges Token

{ application_name: 'b43342ef-86f6-4666-a121-b9ac2025d217',

  client_id: 'O9ZQRZKnn1rdgcKQsAZUBkQSMdOsKS',

  scopes: [],

  api_product_list: [ 'MicroTest' ],

  iat: 1436396155,

  exp: 1436397954 }

Beispielausgabe für ungültiges Token

{ [JsonWebTokenError: invalid token] name: 'JsonWebTokenError', message: 'invalid token' }

Beispielausgabe für abgelaufenes Token

{ [TokenExpiredError: jwt expired]

  name: 'TokenExpiredError',

  message: 'jwt expired',

  expiredAt: Tue Jul 07 2015 09:19:25 GMT-0600 (MDT) }

Inhabertoken direkt abrufen

Möglicherweise ziehen Sie es vor, Inhabertokens direkt zu erhalten, indem Sie eine HTTP-Anfrage an den Token-Endpunkt auf Apigee Edge senden. Der tatsächliche Tokenendpunkt ist in dem Proxy implementiert, der mit dem CLI-Befehl deploy-edge-service bereitgestellt wird.

Hier ein curl-Beispiel. Ersetzen Sie einfach Ihre Organisations- und Umgebungsnamen in der URL und die Werte für Consumer-ID und Consumer Secret, die Sie von einer Entwickleranwendung in Apigee Edge erhalten haben, durch die Parameter client_id und client_secret:

curl -i -X POST "http://<org>-<test>.apigee.net/edgemicro-auth/token" -d '{"grant_type": "client_credentials", "client_id": "4t8X137pOUUtMR7wag3M1yZTcRxeK", "client_secret": "RAcOFVOvO0jns"}' -H "Content-Type: application/json"

Beispielausgabe:

HTTP/1.1 200 OK

X-Powered-By: Express

Cache-Control: no-store

Pragma: no-cache

Content-Type: application/json; charset=utf-8

Content-Length: 640

ETag: W/"280-ze/g/k+c9taqp110vjYQ"

Date: Fri, 17 07 2015 15:49:24 GMT

Connection: keep-alive

"<long string of numbers and letters>"

Neue Edge Microgateway-Konfiguration initialisieren

Führen Sie diesen Befehl nach der ersten Installation von Edge Microgateway einmal aus. Erstellt eine neue Standardkonfigurationsdatei: ~/.edgemicro/default.yaml.

Nutzung

edgemicro init

Parameter

Parameter	Beschreibung
`-c, --configDir`	(Optional) Gibt den Pfad zur Edge Microgateway-Konfigurationsdatei an. Die Konfigurationsdatei befindet sich standardmäßig in ./config/config.yaml. (Version 2.4.x hinzugefügt)
`-h, --help`	Nutzungsinformationen ausgeben.

Beispiel

edgemicro init

Ausgabe (Erfolg)

config initialized to /MyHome/.edgemicro/default.yaml

Edge Microgateway-Konfiguration prüfen

Überprüft, ob Edge Microgateway ordnungsgemäß konfiguriert ist.

Nutzung

edgemicro verify -o [organization] -e [environment] -k [public-key] -s [secret-key]

Parameter

Beispiel

edgemicro verify -o docs -e test -k abc123 -s xyz456

Ausgabe (Erfolg)

logging to /var/tmp/edgemicro-My-Machine.local-a0c48610-a148-11e6-8466-93f081b05988
installed plugin from analytics
installed plugin from oauth
a0c48610-a148-11e6-8466-93f081b05988 edge micro listening on port 8000
verifying analytics negative case: OK
verifying bootstrap url availability:OK
verifying jwt_public_key availability: OK
verifying products availability: OK
verifying quota with configured products: OK
verifying analytics with payload: OK
verification complete

Status des Mikrogateway-Clusters prüfen

Hinzugefügt: v2.2.4-beta

Edge Microgateway wird standardmäßig im Clustermodus gestartet. Mit diesem Befehl können Sie den Status des Clusters prüfen.

Hinweis: Sie müssen diesen Befehl in demselben Verzeichnis ausführen, in dem Sie Edge Microgateway gestartet haben. Für diesen Befehl muss eine edgemicro.sock-Datei vorhanden sein. Mit dem Befehl ls -rtl können Sie prüfen, ob diese Datei vorhanden ist.

Nutzung

edgemicro status

Parameter

Parameter	Beschreibung
`-h, --help`	Nutzungsinformationen ausgeben.

Beispiel

edgemicro status

Ausgabe (Erfolg)

current nodejs version is v6.1.0
current edgemicro version is 2.2.4-beta
edgemicro is running with 4 workers

Mikrogateway-Cluster beenden

Hinzugefügt: v2.2.4-beta

Stoppt den Edge Microgateway-Cluster.

Hinweis: Sie müssen diesen Befehl in demselben Verzeichnis ausführen, in dem Sie Edge Microgateway gestartet haben. Für diesen Befehl ist eine Datei „edgemicro.sock“ erforderlich. Mit dem folgenden Befehl können Sie prüfen, ob diese Datei vorhanden ist: ls -rtl.

Nutzung

edgemicro stop

Parameter

Parameter	Beschreibung
`-h, --help`	Nutzungsinformationen ausgeben.

Beispiel

edgemicro stop

Ausgabe (Erfolg)

current nodejs version is v6.1.0
current edgemicro version is 2.2.4-beta
Stop Completed Successfully

Microgateway-Cluster aktualisieren

Hinzugefügt: v2.2.4-beta

Bietet nach einer Konfigurationsänderung einen Neustart ohne Ausfallzeiten. Das Edge Microgateway wird durch Abrufen einer neuen Konfiguration aktualisiert.

Nutzung

edgemicro reload -o [organization] -e [environment] -k [public-key] -s [secret-key]

Parameter

Parameter	Beschreibung
`-o, --org`	Die Apigee-Organisation, für die Sie Edge Microgateway konfiguriert haben.
`-e, --env`	Eine Umgebung, für die Sie Edge Microgateway konfiguriert haben.
`-k, --key`	Der zurückgegebene Schlüsselwert, der zurückgegeben wird, wenn Sie den Befehl "`edgemicro configure`" ausführen.
`-s, --secret`	Der zurückgegebene Secret-Wert, der beim Ausführen des Befehls „`edgemicro configure`“ zurückgegeben wird.
`-h, --help`	Nutzungsinformationen ausgeben.

Beispiel

edgemicro reload -o docs -e test -k abc123 -s xyz456

Ausgabe (Erfolg)

...

Reload Completed Successfully