образец-узел-API

Пример узла js API для поиска автомобилей и учетных записей для дилерского центра. Он используется здесь для демонстрации шагов по расширению API/ML с помощью собственного API для отдыха.

Шаги

Примечание
Only rest api with https support can be deployed behind API/ML, make sure to enable https support in your rest api.
В этом примере экспресс-приложения уже включен 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 на самом удаленном сервере, чтобы получить необходимые пакеты узлов.

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

На следующем шаге убедитесь, что узел node установлен в z/OS и ваш 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) Загрузите последнюю версию Pax с сайта Artifactory.

Получить последний пакет от артефакта

Выберите последнюю версию pax, предоставленную по ссылке выше, и загрузите ее в свое локальное хранилище.

2) Перенос и распаковка на z/OS

sftp [email protected]
put .pax

ЧАСТЬ II. Развертывание с помощью Zowe на сервере

1) войти

ssh [email protected]

2) установите компонент с помощью скрипта zowe-install-comenter.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) Доступ к недавно развернутому веб-сервису

См. файл статического определения sample-node-api.yml
Он настраивает конечную точку службы как sample-node-api со свойством serviceId
Мы также предоставляем базовый путь 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/