Propriétés

Vous pouvez définir des propriétés pour divers éléments, notamment des composants, des environnements, des processus et des applications. Vous pouvez aussi définir des propriétés globales pour le système.

Les propriétés disponibles dépendent du contexte. Par exemple, dans un processus de composant, vous pouvez accéder aux propriétés de composant du composant courant. Dans un processus d'application, vous pouvez accéder aux propriétés d'application et aux propriétés d'environnement, mais pas aux propriétés de composant. Le tableau ci-dessous répertorie les processus dans lesquels chaque type de propriété est disponible.

Pour afficher les propriétés qui sont disponibles pour un processus, exécutez le processus. Une fois le processus terminé, accédez à l'onglet Propriétés de la demande de processus. Cet onglet répertorie toutes les propriétés qui sont disponibles pour le processus.

Le tableau ci-après répertorie les types de propriété qui sont disponibles pour les processus et indique quels sont les processus qui ont accès à chaque type de propriété.
Tableau 1. Propriétés et processus dans lesquels elles sont disponibles
Type de propriété Processus pouvant accéder à la propriété Exemple de syntaxe
Propriétés de processus générique Processus génériques ${p:ProcessProp1}
Propriétés de processus d'application Processus d'application et processus de composant ${p:ProcessProp1}
Propriétés de processus de composant Processus de composant ${p:componentProcess/ProcessProp1}
Propriétés de version de composant Types de processus de composant qui incluent les versions, par exemple Déploiement et Opérationnel (avec version) ${p:version/VersionProp1}
Propriétés de ressource Tous les processus ${p:resource/ResourceProp1}
Propriétés d'environnement Processus de composant et processus d'application ${p:environment/EnvProp1}
Propriétés d'application Processus d'application et processus de composant ${p:application/AppProp1}
Propriétés système Tous les processus ${p:system/SystemProp1}
Propriétés de demande Tous les processus
  • ${p:request.user.id}
  • ${p:request.user.name}
  • ${p:request.user.displayName}
Tableau 2. Contextes de propriété
Contexte Description
environnement

Disponible dans l'onglet Propriétés du composant ou de l'environnement.

Référence :${p:environment/nomPropriété}.

Les deux versions utilisent la même syntaxe. Une valeur définie pour un environnement de composant remplace toute valeur du même nom définie directement dans une propriété d'environnement. Les propriétés d'environnement de composant permettent de centraliser les propriétés, pour effectuer un suivi du type et des valeurs par défaut, par exemple. Les propriétés d'environnement fournissent des listes ad hoc de paires propriété=valeur.

ressource Sélectionne toutes les propriétés associées à la même valeur dans un environnement.
rôle de ressource Sélectionne toutes les propriétés associées à la même valeur dans une ressource.
application

Disponible dans l'onglet Propriétés de l'application (Application > [application sélectionnée] > Propriétés).

Référence : ${p:application/nomPropriété}.

composant Sélectionne toutes les propriétés associées à la même valeur dans un système.
processus

Disponible dans l'onglet Propriétés de l'application (Application > [application sélectionnée] > Propriétés).

Référence : ${p:application/nomPropriété}.

Une étape de processus a accès aux propriétés définies précédemment par d'autres étapes dans le processus, aux propriétés définies par l'application qui a démarré le processus de composant et aux propriétés dans la ressource et l'environnement cible. Les valeurs de propriété d'étape ne sont plus disponibles une fois le processus de composant terminé.

Référence : ${p:nomPropriété}.

système

Les propriétés système (globales) sont disponibles dans l'onglet Paramètres (Paramètres > Propriétés).

Référence : ${p:system/nomPropriété}.

Tableau 3. Propriétés d'IBM UrbanCode Deploy
Propriété Description
version.name Nom défini par l'utilisateur permettant de distinguer les versions entre elles. Un nom de version est entré lorsqu'une nouvelle version est importée.
version.id Numéro affecté à la version. Un ID de version est créé lorsqu'une nouvelle version est importée dans CodeStation.
component.name Nom défini par l'utilisateur permettant de distinguer les composants entre eux. Un nom de composant est entré lorsque vous créez un composant.
component.id Numéro unique affecté par IBM® UrbanCode Deploy pour distinguer les composants entre eux. L'ID de composant est créé lorsqu'un composant est créé dans IBM UrbanCode Deploy.
resource.name Nom défini par l'utilisateur pour distinguer les ressources entre elles. Le nom de ressource est entré lorsque vous éditez ou créez une ressource.
resource.id Numéro unique attribué à une ressource. Un ID de ressource est affecté lorsqu'une ressource est créée.
application.name Nom défini par l'utilisateur pour distinguer les applications entre elles. Un nom d'application est entré lorsque vous éditez ou créez une application.
application.id Numéro unique attribué à une application. Un ID d'application est affecté lorsqu'une application est créée dans IBM UrbanCode Deploy.
environment.name Nom défini par l'utilisateur pour distinguer les versions entre elles. Un nom d'environnement est entré lorsque vous éditez ou créez un environnement.
environment.id Numéro unique attribué à un environnement. Un ID d'environnement est affecté lorsqu'un environnement est créé.
agent.id Numéro unique attribué par IBM UrbanCode Deploy à l'agent afin de le distinguer des autres agents portant des noms similaires. Un ID d'agent est affecté lorsque l'agent est installé sur le système.
agent.name Nom défini par l'utilisateur permettant de distinguer les agents entre eux. Le nom de l'agent peut être entré en éditant le fichier conf/agent/installed.properties de l'agent et en redémarrant l'agent.
stepname, propertyname

Toutes les étapes possèdent les propriétés suivantes : exitCode, status, lines of interest (LOI, éléments que le script de post-traitement recherche dans le journal sortant de l'étape).

Vous pouvez afficher les propriétés en utilisant le panneau Journal du composant afin d'examiner le journal sortant de l'étape (Composants > [composant sélectionné] > [Action Afficher la demande] > [Action Propriétés d'entrée/sortie]).

Les états d'inventaire et de version, qui sont définis avec la propriété status, peuvent être utilisés dans les portes d'approbation d'application (voir Portes d'environnement). Les autres propriétés peuvent être utilisées par les scripts de post-traitement. Voir Création de plug-ins.

Vous pouvez utiliser des scripts de post-traitement pour définir des propriétés de sortie pouvant être utilisées dans d'autres étapes du même processus, ce qui permet des flux de travail complexes. Référencez les propriétés de sortie d'étape précédentes de la façon suivante :

${p:nomEtape/Nomprop}

Pour définir une propriété d'environnement à partir d'un script de post-traitement par exemple, vous définissez la propriété de sortie pour l'étape dans le script de post-traitement. Ensuite, vous utilisez une étape Set Environment Property qui utilise la propriété de sortie.

nom_propriété Propriété de processus d'application ou de composant ; définie dans l'onglet Propriétés du processus. L'utilisateur qui exécute le processus lui attribue une valeur.
component/nom_propriété Propriété personnalisée de composant ; définie dans l'onglet Propriétés du composant.
environment/nom_propriété Propriété d'environnement. Définie dans l'onglet Propriétés du composant ou de l'environnement. Bien que les deux utilisent la même syntaxe, le dernier n'est associé à aucun composant spécifique. Les valeurs sont fournies dans l'environnement ou le composant associé. Une valeur définie pour un environnement de composant remplace toute valeur du même nom définie directement dans une propriété d'environnement.
resource/nom_propriété Propriétés de ressource. Ces propriétés peuvent inclure les propriétés d'agent intégrées et toute propriété personnalisée. Chaque propriété possède un onglet dans la ressource.
resource/nom_rôle/nom_propriété Propriétés de rôle de ressource. Ces propriétés sont définies dans les rôles de ressource et les valeurs sont définies lorsque vous ajoutez un rôle à une ressource.
application/nom_propriété Propriétés personnalisées d'application. Ces propriétés sont définies dans l'onglet des propriétés de l'application.
system/nom_propriété Propriétés systèmes globales. Ces propriétés sont définies dans l'onglet Propriétés système de la zone Paramètres.

Tous les éléments suivants sont des séries de paires nom=valeur séparées par une virgule, incluant chaque propriété de l'objet. Ils sont utiles pour le remplacement de jeton.

Tableau 4. Paires nom-valeur
Propriété Description
component/allProperties Sélectionne toutes les propriétés associées à la même valeur dans un composant.
environment/allProperties Sélectionne toutes les propriétés associées à la même valeur dans un environnement.
resource/allProperties Sélectionne toutes les propriétés associées à la même valeur dans une ressource.
system/allProperties Sélectionne toutes les propriétés associées à la même valeur dans un système.

Commentaires en retour