Ce gabarit est un modèle de projet Gradle pour l'installation sur un AS/400 des parties serveur d'une application Adélia.
Cette construction impose que les objets Adélia faisant partie de cette application soient regroupés sous la forme d'artéfacts produits par un projet Adélia build.
Le gabarit ne prend pas en charge l'installation le runtime AS/400 serveur d'Adélia.
Création d'un projet AS/400 server installation
La création du projet s'obtient en décompressant le fichier %ADELIWS%\Build\templates\AS400 server installation.zip : le répertoire AS400 server installation obtenu peut être déplacé et renommé à volonté.
Le poste de construction de l'installation et le poste de build Adélia peuvent être deux postes différents. De même l'AS/400 ayant servi au build Adélia et l'AS/400 utilisé pour l'installation peuvent être différents. ↑ Haut de page
Configuration d'un projet AS/400 server installation
Après avoir créé un projet, il est nécessaire de le configurer avant de pouvoir l'exécuter.
La configuration et l'initialisation d'un projet de build se basent sur les paramètres renseignés dans le fichier gradle.properties, à savoir :
Paramètres généraux
instalLibrary (obligatoire)
Chaîne alphanumérique représentant le nom de la bibliothèque dans laquelle seront placés les objets serveur AS/400. Si cette bibliothèque n'existe pas elle sera créée.
buildSavlib (obligatoire)
Chaîne alphanumérique représentant le nom de la bibliothèque utilisée pour la sauvegarde des objets par le build adélia.
Actuellement la sauvegarde se fait toujours dans HA2SBUILD.
as400Host (obligatoire)
Chaîne alphanumérique représentant le nom d'host ou l'adresse IP de l'AS/400 où seront installés les objets.
as400User (obligatoire)
Chaîne alphanumérique représentant le nom du profil utilisateur AS/400 qui sera utilisé pour la connexion ssh à l'AS/400.
publicKeyAuthentication (obligatoire)
- "Y" (pour "yes") si l'on souhaite utiliser une clé publique d'authentification pour la connexion SSH afin de ne pas avoir à indiquer un mot de passe en clair. Cliquez ici pour plus de détails.
- "N" (pour "no") si l'on souhaite établir la connexion SSH avec le mot de passe du profil utilisateur AS/400.
as400Password (optionnels)
Chaîne alphanumérique représentant le mot de passe du profil utilisateur AS/400 qui sera utilisé pour la connexion SSH à l'AS/400.
Cette valeur est obligatoire si vous avez indiqué la valeur "N" pour le paramètre publicKeyAuthentication. ↑ Haut de page
Paramètres des gestionnaires de référentiels
L'utilisation des référentiels d'artéfacts lors de l'exécution d'un build AS/400 server installation se fait lors de la phase suivante :
- Dans la phase du déploiement de vos objets serveur sur l'AS/400, le build utilise un référentiel pour télécharger (référentiel de download) les artéfacts nécessaires à la récupération des objets.
Ces artéfacts sont vos propres artéfacts d'objets Adélia composant les objets serveurs AS/400 de votre application. Ceux-ci sont issus de l'exécution d'un projet Adélia build.
downloadArtifactsReleaseRepo (optionnels)
URL d'accès au référentiel de download des artéfacts dépendants nécessaires au build.
Ce référentiel doit permettre d'accéder à vos propres artéfacts d'objets Adélia composant votre application. Ces artéfacts sont ceux en version release si vous avez construit votre application en version release.
downloadArtifactsReleaseRepo.username / downloadArtifactsReleaseRepo.password (optionnels)
Définit le profil utilisateur et le mot de passe utilisés pour la connexion au référentiel de download.
Comme on accède à ce référentiel en lecture seule, Nexus autorise une connexion anonyme. Dans ce cas, laissez les champs "username" et "password" non renseignés.
downloadArtifactsSnapshotRepo (optionnel)
URL d'accès au référentiel de download des artéfacts dépendants nécessaires au build.
Ce référentiel doit permettre d'accéder à vos propres artéfacts d'objets Adélia composant votre application. Ces artéfacts sont ceux en version snapshot si vous avez construit votre application en version snapshot.
downloadArtifactsSnapshotRepo.username / downloadArtifactsSnapshotRepo.password (optionnels)
Définit le profil utilisateur et le mot de passe utilisés pour la connexion au référentiel de download.
Ce profil doit permettre d'accéder à votre propre référentiel privé de groupe (cf. downloadArtifactsSnapshotRepo ci-dessus).
Comme on accède à ce référentiel en lecture seule, Nexus autorise une connexion anonyme. Dans ce cas, laissez les champs "username" et "password" non renseignés. ↑ Haut de page
Configuration des composants de l'application serveur AS/400 à installer
Ces composants sont les artéfacts d'objets Adélia issus de l'exécution d'un projet Adélia build.
Il est nécessaire de les déclarer dans le projet pour qu'ils soient déployés sur l'AS/400.
Pour cela :
- ouvrez le fichier build.gradle avec un éditeur texte, puis;
- dans la section "dependencies" ("AS400 server artifact declaration"), déclarez vos artéfacts.
Artéfacts de type as400server
Ces artéfacts doivent être déclarés en insérant l'instruction suivante :
as400savf '<nom du groupe de l'artéfact>:<nom du fichier de l'artéfact sans la version>: <numéro de version de l'artéfact> '
Exemple de déclaration d'artéfact issu d'un build par domaines :
Pour l'artéfact de type as400server dont le nom de fichier est myapp-_app_area_1_as400server-1.1.0-SNAPSHOT.zip, il faut saisir as400savf 'my.company:myapp-_app_area_1_as400server :1.1.0-SNAPSHOT '.
La valeur de group est celle du paramètre "group" dans le fichier gradle.properties du projet Adélia build ayant construit l'artéfact.
Exemple de déclaration d'artéfact issu d'un build par composants :
Pour l'artéfact de type as400server dont le nom de fichier est prefix_compo_1_as400server-1.1.0-SNAPSHOT.zip, il faut saisir as4000savf 'my.company:prefix_compo_1_as400server:'1.1.0-SNAPSHOT '.
La valeur de group est celle du paramètre "groupId" du composant dont est issu l'artéfact.
Exécution d'un projet AS/400 server installation
Ce gabarit utilise une connexion SSH pour transférer les objets sur l'AS/400 et donc vous devez au préalable démarrer le serveur SSHD de votre AS/400 (cf. commande AS/400 : STRTCPSVR SERVER(*SSHD) ).
Liste des tâches Gradle du build AS/400 server installation
deploy
Tâche d'installation (déploiement) des objets serveur AS/400 dans une bibliothèque de l'AS/400. ↑ Haut de page