Variables de configuration et variables système

Quand vous déployez votre application, vous avez souvent besoin d'accéder aux paramètres système ou de configuration pour votre script. De cette façon, vous n'avez pas à coder en dur les valeurs dans plusieurs emplacements, car elles peuvent changer selon la configuration, la build, le serveur ou la version. Pour éviter les valeurs codées en dur, avec Release Management pour Visual Studio 2013 Update 4, vous pouvez utiliser les variables système ou de configuration dans vos scripts pour les versions vNext.

Variables de configuration

Les variables de configuration fournissent des paramètres réutilisables et personnalisables disponibles pendant l'exécution de l'action. Vous pouvez définir des variables de configuration et des valeurs par défaut sur des serveurs, des composants et globalement, puis les utiliser dans les scripts PowerShell et les scripts de configuration. Par ailleurs, si vous ne voulez pas utiliser une valeur par défaut dans un déploiement, vous pouvez la remplacer. Un exemple d'utilisation de variables de configuration est la définition du nom d'utilisateur et du mot de passe utilisés pour déployer votre application sur le serveur.

Les variables de configuration peuvent être définie aux niveaux global, du serveur, du composant et de l'action.

• Variables de configuration globales : définies via Administration > Paramètres > Variables de configuration. Disponibles partout.

• Variables de configuration de serveur : définies via Configurer les chemins d'accès > Serveur, choisissez un serveur, puis Variables de configuration. Disponible pour les actions qui déploient votre application sur le serveur. À utiliser pour les variables propres aux serveurs, comme un nom d'utilisateur ou un mot de passe.

• Variables de configuration de composant : définies via Configurer les applications > Composant, choisissez un composant, puis Variables de configuration. Disponibles pour les actions qui utilisent le composant.

• Variables de configuration d'action : définies dans le concepteur de modèles de version, disponibles pour les actions.

Quand un nom de variable de configuration est utilisé dans plusieurs niveaux, l'ordre de priorité (du plus haut au plus bas) est le suivant : Fichier de script de configuration > Action > Composant > Serveur > Global.

Pour gérer les variables de configuration, en bas à gauche des vues Modèles de version et Versions, se trouvent les onglets Variables de configuration et Variables de ressource.

L'onglet Variables de configuration indique les variables de configuration actives pour l'action, à chaque phase.

L'onglet Variables de ressource indique les variables de configuration et les valeurs définies globalement, pour les serveurs et pour les composants. (Ce sont les valeurs actuelles et non l'instantané d'un moment précédent.) Les modifications des variables de ressource prennent effet quand les versions en cours démarrent un nouveau déploiement.

Pour ajouter une variable de configuration dans une action, ouvrez une activité dans le concepteur de modèles de version, cliquez sur la flèche de menu déroulant de la section Configuration personnalisée et spécifiez Standard ou Chiffré pour le type de variable de configuration. (Si vous utilisez Chiffré, assurez-vous que l'écouteur HTTPS est configuré sur le serveur sur lequel vous déployez votre application.)

Tapez le nom de la nouvelle variable et indiquez sa valeur.

Pour remplacer une valeur dans une variable de ressource, cliquez sur le signe +, puis sur la flèche de menu déroulant de la section Configuration personnalisée. Sélectionnez la variable à personnaliser et indiquez une valeur.

Variables système

Outre les paramètres de configuration, votre script peut également nécessiter un accès aux paramètres système. Par exemple, si votre script doit effectuer une action spéciale quand vous déployez votre application dans un environnement de production, le script peut examiner la variable d'environnement. Les variables système disponibles sont les suivantes :

• ApplicationPath Chemin d'accès de destination, incluant le nom du composant, où est copié le composant.

• ApplicationPathRoot Chemin d'accès de destination où le composant est copié.

• BuildDefinition Définition de build pour le composant.

• BuildDirectory Répertoire de build pour le composant.

• BuildNumber Numéro de build pour le composant.

• Environment Environnement de la version.

• PackageLocation Chemin d'accès du code source d'où le composant est copié. Pour les builds déployées sur un serveur standard, le chemin d'accès pointe sur l'ID du conteneur. Pour les builds déployées sur Azure, le chemin d'accès pointe sur le GUID de l'objet blob de stockage.

• ReleaseId ID de la version, assigné par Release Management.

• ReleaseNumber Numéro de la version.

• Stage Phase de la version.

• Tag Balise utilisée pour grouper le serveur exécutant l'action.

• TeamProject Projet d'équipe pour le composant.

• TFSUrl URL TFS pour le composant.

Quand vous utilisez des variables système ou de configuration dans des scripts, ajoutez le préfixe $ au nom de la variable. Par exemple : $Stage.

Notez qu'une valeur peut être non assignée. Par exemple, si vous déployez votre application sur un serveur qui n'a pas été groupé par une balise, la valeur de la variable $Tag sera non assignée.