样本节点 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/