Eine Beispielknoten-JS-API zum Suchen von Autos und Konten für einen Händler. Sie wird hier verwendet, um die Schritte zum Erweitern von API/ML mit Ihrer eigenen Rest-API zu demonstrieren.
Notiz
Only rest api with https support can be deployed behind API/ML, make sure to enable https support in your rest api.
Für diese Beispiel-Express-App ist https bereits aktiviert.
//on local git clone https://github.com/zowe/sample-node-api cd sample-node-api npm install npm start
Öffnen Sie Ihren lokalen Browser und überprüfen Sie, ob die Beispielknoten-API funktioniert, indem Sie auf Folgendes zugreifen:
http://localhost:18000/accounts/
http://localhost:18000/accounts/1
http://localhost:18000/accounts/1/cars/
Notiz
Der Ordner node_modules
wird nicht übertragen. Wir können die NPM-Installation später auf dem Remote-Server selbst durchführen, um die erforderlichen Knotenpakete herunterzuladen
cd sample-node-api npm run build scp -r dist [email protected]:</usr/lpp/extender>/sample-node-api
Stellen Sie im nächsten Schritt sicher, dass Sie den Knoten unter z/OS installiert haben und Ihr PATH das Verzeichnis „nodejs/bin“ enthält.
ssh [email protected] . ~/.profile - (Skip if you can already run "npm" on z/OS) cd </usr/lpp/extender>/sample-node-api npm install
Holen Sie sich das neueste Paket von artifactory
Wählen Sie über den obigen Link den neuesten Pax-Build aus und laden Sie ihn in Ihren lokalen Speicher herunter.
sftp [email protected] put <pax-name>.pax
ssh [email protected]
./<zowe-runtime-dir>/bin/zowe-install-component.sh -d <zowe-extensions-dir> -i <zowe-instance-dir> -o <component-file-path> -l <log-folder>
<zowe-extensions-dir> - Directory that will hold all external extensions installed onto zowe <zowe-instance-dir> - Current installed Zowe's instance directory <component-file-path> - The path to the component being installed (the component file transferred from local to z/OS in PART I) <log-file> - Directory that will hold the logs of the component installation
Wir erwarten Folgendes im Serviceordner start.sh
. In unserem Fall ist es der Ordner „bin“ mit relevanten Skripten.
start.sh
startet die Knoten-App auf dem konfigurierten Port
env.sh
verwendet sein benutzerdefiniertes Skript zum Konfigurieren des Ports für unsere Knoten-App. Sie können es gerne auf die von Ihnen gewünschte Weise verwenden
Bitte sehen Sie sich die statische Definitionsdatei sample-node-api.yml
an
Es konfiguriert den Dienstendpunkt als sample-node-api
mit der Eigenschaft serviceId
Wir stellen auch den API-Gateway-Basispfad apiv1
mit der Eigenschaft gatewayUrl
in derselben Datei bereit.
Tatsächlich kann auf den Dienst mit der folgenden URL zugegriffen werden:
https://{host}:{GATEWAY_PORT}/{gatewayUrl}/{serviceId}/*
wobei GATEWAY_PORT
in $INSTANCE_DIR/instance.env konfiguriert ist
Überprüfen Sie dies, indem Sie auf Folgendes zugreifen:
https://my.mainframe.com:7554/api/v1/sample-node-api/accounts/
https://my.mainframe.com:7554/api/v1/sample-node-api/accounts/1/
https://my.mainframe.com:7554/api/v1/sample-node-api/accounts/1/cars/
API-Katalog
Discovery-Service-Dashboard