sample node api

サンプルノードAPI

車とディーラーのアカウントを検索するためのサンプル ノード JS API。ここでは、独自の REST 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 がすでに有効になっています。

パート I: ダウンロードしてローカルに構築する

方法 1: 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]:</usr/lpp/extender>/sample-node-api

次のステップでは、z/OS にノードがインストールされていること、および PATH に nodejs/bin ディレクトリが含まれていることを確認してください。

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

方法 2: Artifactory から

1) artifactory から最新の pax をダウンロードします。

Artifactory から最新のパッケージを入手する

上記のリンクから提供されている最新の pax ビルドを選択し、ローカル ストレージにダウンロードします。

2) z/OS での転送と解凍

sftp [email protected]
put <pax-name>.pax

パート II: Zowe を使用してサーバーにデプロイする

1) ログイン

ssh [email protected]

2) zowe-install-component.sh スクリプトを使用してコンポーネントをインストールします

./<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

3) コンポーネントのライフサイクル スクリプト

サービスフォルダーstart.shには以下が期待されます。この例では、関連するスクリプトが含まれる bin フォルダーです。

start.sh構成されたポートでノード アプリを開始します
env.shのカスタム スクリプトは、ノード アプリのポートを構成するために使用します。お好みの方法を自由に使用してください。

4) 新しくデプロイされた Web サービスにアクセスする

静的定義ファイル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/

5) APIカタログに登録

APIカタログ

ディスカバリーサービスダッシュボード