4.4. Configurer les propriétés globales

La section Propriétés globales (voir Figure 4.3, “Configurer les variables d'environnement dans Jenkins”) vous permet de définir des variables de façon centralisée et de les utiliser dans toutes vos tâches de build. Vous pouvez ajouter autant de propriétés que vous voulez, et les utiliser dans vos tâches. Jenkins les rendra disponible à l'intérieur de l'environnement de vos tâches de build, vous permettant de les utiliser facilement dans vos scripts Ant ou Maven. A noter que vous ne devez pas mettre de points (“.”) dans les noms de propriétés, parce qu'ils ne seront pas traités correctement. Utilisez donc ldapserver ou ldap_server, mais pas ldap.server.

Configurer les variables d'environnement dans Jenkins

Figure 4.3. Configurer les variables d'environnement dans Jenkins


Il y a deux façons principales d'utiliser ces variables. Premièrement, vous pouvez les utiliser directement dans votre script de build, en utilisant la notation ${key} ou $key (donc ${ldapserver} ou $ldapserver dans l'exemple donné ci-dessus). C'est l'approche la plus simple, mais cela signifie qu'il y a un couplage fort entre la configuration de votre tâche et vos scripts de build.

Si votre script utilise un nom de propriété différent (un contenant des points, par exemple), vous pouvez aussi passer la valeur à votre script de build dans la configuration de votre tâche de build. Dans Figure 4.4, “Utiliser une variable d'environnement configurée” nous passons la valeur de la propriété ldapserver définie dans Figure 4.3, “Configurer les variables d'environnement dans Jenkins” à une tâche de build Maven. Utiliser l'option -D signifie que cette valeur sera accessible à l'intérieur du script. C'est une approche flexible, parce qu'on peut assigner les propriétés globales définies dans Jenkins à des variables spécifiques à nos scripts de build. Dans Figure 4.4, “Utiliser une variable d'environnement configurée”, par exemple, la propriété ldapserver sera disponible à l'intérieur du build Maven via la propriété ${ldap.server}.

Utiliser une variable d'environnement configurée

Figure 4.4. Utiliser une variable d'environnement configurée