樣本節點 API

用於尋找經銷商的汽車和帳戶的範例 Node js api，此處用於示範使用您自己的其餘 api 擴充 API/ML 的步驟。

步驟

筆記
Only rest api with https support can be deployed behind API/ML, make sure to enable https support in your rest api.
此範例 Express 應用程式已啟用 https。

第一部分：下載並在本地構建

方法一：來自github

1）克隆儲存庫，安裝節點包並在本地驗證路由

//on local
git clone https://github.com/zowe/sample-node-api
cd sample-node-api
npm install
npm start

開啟本機瀏覽器並透過造訪以下內容驗證 Sample-node-api 是否正常運作：
http://localhost:18000/accounts/
http://localhost:18000/accounts/1
http://localhost:18000/accounts/1/cars/

2）將專案文件從本地傳輸到遠端主機

筆記
node_modules資料夾不會被轉移，我們可以稍後在遠端伺服器本身上執行 npm install 來下載所需的節點包

cd sample-node-api
npm run build
scp -r dist [email protected]:/sample-node-api

對於下一步，請確保您已在 z/OS 上安裝了 Node，並且您的 PATH 包含 nodejs/bin 目錄。

ssh [email protected]
. ~/.profile - (Skip if you can already run "npm" on z/OS)
cd /sample-node-api
npm install

方法2：來自Artifactory

1）從artifactory下載最新的pax

從artifactory獲取最新的包

選擇上面連結提供的最新 pax 版本並將其下載到您的本地儲存。

2) 在 z/OS 上傳輸和解包

sftp [email protected]
put .pax

第二部分：在伺服器上使用 Zowe 進行部署

1）登入

ssh [email protected]

2）使用zowe-install-component.sh腳本安裝組件

.//bin/zowe-install-component.sh -d  -i  -o  -l

 - Directory that will hold all external extensions installed onto zowe
 - Current installed Zowe's instance directory
 - The path to the component being installed (the component file transferred from local to z/OS in PART I)
 - Directory that will hold the logs of the component installation

3）組件的生命週期腳本

我們期望在服務資料夾start.sh中包含以下內容。在我們的例子中，它是帶有相關腳本的 bin 資料夾。

start.sh在配置的連接埠上啟動節點應用程式
env.sh其自訂腳本用於為我們的節點應用程式配置端口，請隨意使用您想要的方式

4）存取新部署的webservice

請參閱靜態定義檔sample-node-api.yml
它將服務端點配置為具有serviceId屬性的sample-node-api
我們也在同一檔案中提供 api 閘道基本路徑apiv1和屬性gatewayUrl 。

實際上，可以透過以下 url 存取服務：
https://{host}:{GATEWAY_PORT}/{gatewayUrl}/{serviceId}/*

其中GATEWAY_PORT在 $INSTANCE_DIR/instance.env 中配置

透過造訪以下內容進行驗證：
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/