exemple de nœud-api

Un exemple d'API de nœud js pour rechercher des voitures et des comptes pour un concessionnaire, il est utilisé ici pour démontrer les étapes d'extension de l'API/ML avec votre propre API de repos.

Mesures

Note
Only rest api with https support can be deployed behind API/ML, make sure to enable https support in your rest api.
Cet exemple d'application express a déjà activé https.

PARTIE I : Télécharger et construire en local

Méthode 1 : depuis github

1) Clonez le référentiel, installez les packages de nœuds et vérifiez les routes localement

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

Ouvrez votre navigateur local et vérifiez que sample-node-api fonctionne en accédant :
http://localhost:18000/accounts/
http://localhost:18000/accounts/1
http://localhost:18000/accounts/1/cars/

2) Transférer les fichiers de projet de l'hôte local vers l'hôte distant

Note
Le dossier node_modules ne sera pas transféré, nous pouvons effectuer npm install plus tard sur le serveur distant lui-même pour extraire les packages de nœuds requis

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

Pour l'étape suivante, assurez-vous que le nœud est installé sur z/OS et que votre PATH inclut le répertoire nodejs/bin.

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

Méthode 2 : à partir d’Artifactory

1) Téléchargez la dernière pax depuis l'artefact

Obtenez le dernier package d'artefactory

Choisissez la dernière version de pax fournie à partir du lien ci-dessus et téléchargez-la sur votre stockage local.

2) Transférer et dépaxer sur z/OS

sftp [email protected]
put .pax

PARTIE II : Déployer avec Zowe sur le serveur

1) connectez-vous

ssh [email protected]

2) installer le composant à l'aide du script 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) Scripts de cycle de vie du composant

Nous attendons la suite dans le dossier de service start.sh . Dans notre cas, son dossier bin avec les scripts pertinents.

start.sh démarre l'application de nœud sur le port configuré
env.sh son script personnalisé est utilisé pour configurer le port de notre application de nœud, n'hésitez pas à utiliser la méthode de votre choix

4) Accédez au service Web nouvellement déployé

Veuillez consulter le fichier de définition statique sample-node-api.yml
Il configure le point de terminaison du service en tant que sample-node-api avec la propriété serviceId
Nous fournissons également le chemin de base de la passerelle API apiv1 avec la propriété gatewayUrl dans le même fichier.

En effet, le service est accessible avec l'url suivante :
https://{host}:{GATEWAY_PORT}/{gatewayUrl}/{serviceId}/*

où GATEWAY_PORT est configuré dans $INSTANCE_DIR/instance.env

Vérifiez en accédant à ce qui suit :
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/