Si IBM® UrbanCode Deploy ne dispose pas d'un type de configuration de source pour votre système de génération, vous pouvez utiliser le client de ligne de commande
udclient pour gérer les composants.
Pourquoi et quand exécuter cette tâche
Lorsque vous utilisez le client
udclient de cette manière, vous pouvez envoyer au serveur de nouvelles versions de composants, lancer des processus, ajouter des liens à des sources externes et effectuer de nombreuses autres tâches sur le serveur
IBM UrbanCode Deploy dans le cadre de votre processus de génération. De la sorte, vous pouvez travailler avec vos composants dans
IBM UrbanCode Deploy sans avoir à changer de technologie de génération.
Procédure
Suivez ces directives globales pour configurer une composant utilisant le client de ligne de commande :
- Créez un ou plusieurs composants dans IBM UrbanCode Deploy pour représenter les composants de votre génération. Utilisez les paramètres suivants dans la fenêtre Créer un composant :
- Dans la zone Type de configuration source, sélectionnez Aucun.
- Décochez la case Importer automatiquement les versions.
- Renseignez le reste des zones de la fenêtre comme à l'accoutumée.
- Dans les scripts de génération de votre composant, ajoutez du code pour appeler les commandes client
udclient afin de créer une version de composant et de télécharger les artefacts sur le serveur IBM UrbanCode Deploy. Dans la plupart des cas, vous devrez utiliser plusieurs commandes différentes pour créer la version. Les étapes suivantes fournissent des exemples des commandes que vous pourriez utiliser.
Remarque : Ces exemples utilisent du code dans un fichier de génération Apache Ant. Spécifiquement, ils appellent le client udclient avec la commande Ant <exec>, laquelle appelle des programmes externes. Si vous utilisez une technologie de génération différente, vous devez adapter ces exemples à votre technologie pour appeler le client udclient.
- Utilisez la commande createVersion pour créer la nouvelle version. L'exemple de code suivant crée une version d'un composant nommé mycomponent. Le nom de version est généré à partir de l'horodatage de la génération. Les variables ${udclient.weburl}, ${udclient.username},
et ${udclient.password} représentent respectivement l'URL du serveur, le nom d'utilisateur et le mot de passe pour les serveur.
<exec executable="/bin/bash"
outputproperty="mycomponent.component.output">
<arg value="/opt/udclient/udclient"/>
<arg value="-weburl"/>
<arg value="${udclient.weburl}"/>
<arg value="-username"/>
<arg value="${udclient.username}"/>
<arg value="-password"/>
<arg value="${udclient.password}"/>
<arg value="createVersion"/>
<arg value="-component"/>
<arg value="mycomponent"/>
<arg value="-name"/>
<arg value="${buildTimestamp}"/>
</exec>
- Utilisez la commande addVersionFiles pour télécharger les artefacts dans la version du composant. L'exemple de code suivant télécharge les fichiers dans le dossier
${destdir} de la version :
<exec executable="/bin/bash">
<arg value="/opt/udclient/udclient"/>
<arg value="-weburl"/>
<arg value="${udclient.weburl}"/>
<arg value="-username"/>
<arg value="${udclient.username}"/>
<arg value="-password"/>
<arg value="${udclient.password}"/>
<arg value="addVersionFiles"/>
<arg value="-component"/>
<arg value="mycomponent"/>
<arg value="-version"/>
<arg value="${buildTimestamp}"/>
<arg value="-base"/>
<arg value="${destdir}"/>
</exec>
- Facultatif : Ajoutez des liens de la version du composant. A l'aide de la commande addVersionLink, vous pouvez ajouter des liens depuis la version vers des sources de génération externes, comme la page affichant des informations sur le résultat de la génération. Ces liens figurent en haut de la page d'informations de la version du composant. L'illustration suivante présente une version de composant avec un lien vers le travail de génération associé et un lien vers son résultat dans le système de gestion de code source : Par exemple, le code suivant ajoute un lien vers la page de résultat de la génération à l'URL http://build.example.com/projects/mycomponent/${buildResultUUID}:
<exec executable="/bin/bash">
<arg value="/opt/udclient/udclient"/>
<arg value="-weburl"/>
<arg value="${udclient.weburl}"/>
<arg value="-username"/>
<arg value="${udclient.username}"/>
<arg value="-password"/>
<arg value="${udclient.password}"/>
<arg value="addVersionLink"/>
<arg value="-component"/>
<arg value="mycomponent"/>
<arg value="-version"/>
<arg value="${buildTimestamp}"/>
<arg value="-linkName"/>
<arg value="External build result"/>
<arg value="-link"/>
<arg value="http://build.example.com/projects/mycomponent/${buildResultUUID}"/>
</exec>
Résultats
Dorénavant, lorsque vous lancez une génération dans votre outil de génération externe, le processus de génération crée une version du composant et télécharge les artefacts de la version sur le serveur
IBM UrbanCode Deploy.
A partir de ce point, vous pouvez utiliser comme d'habitude le composant et la version sur le serveur (par exemple, pour exécuter des processus avec ceux-ci).
Vous pouvez également ajouter d'autres commandes dans votre script de génération. Par exemple, vous pouvez lancer des processus d'application avec la commande requestApplicationProcess.