Libérer des actions pour déployer une application destinée à Release Management
Vous ajoutez des actions de version pour définir la séquence de déploiement pour chaque phase de votre version. Chaque action utilise un outil spécifique pour exécuter une commande avec un jeu d'arguments.
Si vous n'avez pas encore créé votre chemin d'accès, allez ici pour le créer
Faites glisser une action de version de la boîte à outils pour l'ajouter à votre séquence de déploiement. Utilisez l'une des actions de version prédéfinies répertoriées dans la boîte à outils, ou créez vos propres actions de version personnalisées.
Après avoir ajouté une action de version à la séquence, vous pouvez modifier les variables de configuration si nécessaire. Pour plus d'informations sur les actions de version prédéfinies et leurs variables de configuration, cliquez ici. Découvrez un peu plus sur les outils utilisés par les actions de Release ici.
Ajoutez une action de version personnalisée
Ajoutez une nouvelle action de version et choisissez l'outil que vous voulez que cette action utilise. Ou bien, vous pouvez copier une action existante et l'utiliser comme base pour créer une action de version personnalisée. Vous ne pouvez pas modifier une action de version existante.
À partir de Release Management Client, ouvrez la page Stock. (Si la page ne s'affiche pas, demandez l'autorisation Peut gérer les stocks.)
Copiez l'action que vous souhaitez modifier ou ajoutez une nouvelle action.
Sélectionnez l'outil que vous souhaitez utiliser en fonction de vos besoins pour l'action. Choisissez Nouveau pour ajouter votre propre outil personnalisé si les outils prédéfinis ne peuvent pas faire ce dont vous avez besoin pour cette étape dans votre séquence de déploiement.
Dans la section Exécution, entrez tous les arguments nécessaires avec leurs jetons au format requis. Vous devez ajouter ce préfixe et suffixe à chaque paramètre : __. Chaque fois que vous supprimez ou ajoutez des arguments avec leurs jetons, ils apparaissent dans la liste Paramètres.
Par exemple, ajoutez les arguments avec des jetons suivants : -servername __servername__ -switch __onoff__. À présent, servername et onoff sont affichés dans la liste des paramètres.
Pour désactiver une action de version
- S'il existe des actions que vous ne souhaitez pas que votre équipe utilise, désactivez-les. Ouvrez l'action à partir de la page Stock, puis choisissez le bouton Désactiver.
Pour réactiver une action de version
Ouvrez la liste Inactif, ouvrez l'action et choisissez Activer.
Q & R
Q : Quelles sont les autorisations nécessaires pour modifier des actions de version ?
A : Pour modifier ou ajouter des actions de version, les utilisateurs doivent avoir l'autorisation Peut gérer les stocks. Si l'autorisation n'est pas activée, la page Stock ne s'affiche pas.
Lorsque l'option Aucun outil est sélectionnée, les champs Commande et Arguments ne sont pas modifiables, sauf si vous avez l'autorisation Peut utiliser un outil personnalisé dans les actions et les composants. Dans Configurer les applications, Composants, lorsqu'un utilisateur n'a pas l'autorisation Peut utiliser un outil personnalisé dans les actions et les composants, les champs Commande et Arguments ne sont pas modifiables lorsque l'option Aucun outil est sélectionnée.
Actions et variables de Configuration pour les actions de version
Gérer des sites Web et des pools d'applications
Créer ou modifier des fichiers .ini
Gérer des bases de données SQL Server
Configurer vos serveurs
Gérer des services Windows
Gérer des sites Web et des pools d'applications
Ces actions utilisent l'outil prédéfini IIS Deployer pour gérer les pools d'applications, les sites Web, les applications web et les répertoires virtuels. Ces actions sont prises en charge dans IIS 7.0, 7.5, 8.0 et 8.5. Pour plus d'informations sur cet outil, allez ici.
Action |
Conditions d'utilisation et d'échec du déploiement |
---|---|
|
Créer un pool d'applications : cette action crée un nouveau pool d'applications sous IIS. Pour IIS 7.0, 7.5, 8.0 et 8.5. Si le pool d'applications existe déjà, il sera reconfiguré pour correspondre aux valeurs des variables de configuration définies (les variables de configuration non définies n'affecteront pas la configuration réelle du pool d'applications). Sous les versions d'IIS antérieures à la version 7.0, si le pool d'applications existe déjà, le déploiement échouera. Configurer un pool d'applications, Recycler un pool d'applications, Démarrer un pool d'applications ou Arrêter un pool d'applications : ces actions vont reconfigurer, recycler, démarrer ou arrêter un pool d'applications. Le déploiement échoue si le pool d'applications n'existe pas. |
|
Créer un site Web: crée un nouveau site Web sous IIS. Pour IIS 7.0, 7.5, 8.0 et 8.5. Si le site Web existe déjà, il sera reconfiguré pour correspondre aux valeurs des variables de configuration définies (les variables de configuration non définies n'affecteront pas la configuration réelle du site Web). Sous les versions d'IIS antérieures à la version 7.0, si le pool d'applications existe déjà, le déploiement échouera. Configurer un site Web, Redémarrer un site Web, Démarrer un site Web, Arrêter un site Web : ces actions vont reconfigurer, redémarrer, démarrer ou arrêter un site Web. Le déploiement échoue si le site Web n'existe pas. |
|
Créer une application Web : crée une application Web sous IIS. Pour IIS 7.0, 7.5, 8.0 et 8.5. Si l'application Web existe déjà, elle sera reconfigurée pour correspondre aux valeurs des variables de configuration définies (les variables de configuration non définies n'affecteront pas la configuration réelle de l'application Web). Sous les versions d'IIS antérieures à la version 7.0, si le pool d'applications existe déjà, le déploiement échouera. Configurer une application Web permet de reconfigurer une application Web. Le déploiement échoue si l'application Web n'existe pas. |
|
Créer un répertoire virtuel: crée un répertoire virtuel sous IIS. Pour IIS 7.0, 7.5, 8.0 et 8.5. Si le répertoire virtuel existe déjà, il sera reconfiguré pour correspondre aux valeurs des variables de configuration définies (les variables de configuration non définies n'affecteront pas la configuration réelle du répertoire virtuel). Configurer un répertoire virtuel permet de reconfigurer un répertoire virtuel. Le déploiement échoue si le répertoire virtuel n'existe pas. |
Variables de configuration
Paramètres |
Obligatoire |
Description |
---|---|---|
AppPoolName |
Oui [actions des pools d'applications] Non [actions des sites Web] |
Nom du pool d'applications à configurer, créer, recycler, supprimer, démarrer ou arrêter. [Action de pool d'application] Nom du pool d'applications à utiliser pour un site Web nouveau ou modifié. [Action de site Web] |
DotNetVersion |
Non |
Version .NET Framework à utiliser pour le pool d'applications. Ce paramètre est autorisé uniquement pour IIS 7.5, 8.0 et 8.5. Les valeurs autorisées sont : v1.0, v1.1, v2.0 ou v4.0. |
IdentityUserDomain |
Non |
Domaine de l'utilisateur à utiliser comme identité du pool d'applications. S'il n'est pas défini et qu'IdentityUserName est défini, l'utilisateur sera considéré comme un utilisateur local (c'est-à-dire, .\localuser). |
IdentityUserName |
Non |
Nom d'utilisateur à utiliser comme identité du pool d'applications. S'ils ne sont pas définis, les paramètres IdentityUserDomain et IdentityUserPassword sont ignorées et la valeur par défaut d'IIS est utilisée (c'est-à-dire, ApplicationPoolIdentity). |
IdentityUserPassword |
Non |
Mot de passe de l'utilisateur à utiliser comme identité du pool d'applications. |
Is32BitsAllowed |
Non |
Indicateur permettant d'autoriser ou d'interdire aux applications 32 bits de s'exécuter dans le pool d'applications. Les valeurs autorisées sont :
|
IsAutoStart |
Non |
Indicateur qui spécifie si le pool d'applications ou le site Web doit démarrer automatiquement au démarrage de Windows. Les valeurs autorisées sont :
|
IsPreloadEnabled |
Non |
Indicateur qui spécifie si la fonctionnalité de préchargement est activée pour une application Web ou un site Web. Les valeurs autorisées sont :
|
PhysicalPath |
Oui [action de création] Aucun [toutes les autres actions des répertoires virtuels, sites Web et application Web] |
Chemin d'accès physique complet du répertoire virtuel, du site Web ou de l'application Web. |
PipeLineMode |
Non |
Mode pipeline géré à utiliser dans le pool d'applications. Les valeurs autorisées sont :
|
PortNumber |
Oui [action de création uniquement] |
Numéro de port à utiliser pour un site Web nouveau ou modifié. |
ProcessIdleTimeOut |
Non |
Nombre de minutes pendant lequel un processus peut être inactif dans le pool d'applications. |
RecycleAfterMinutes |
Non |
Nombre de minutes fixé avant le recyclage du pool d'applications. |
RecycleFixedTime |
Non |
Moment fixé auquel le pool d'applications est recyclé. Le format requis est HH:MM, par exemple 23:58 ou 01:23. |
RecycleKbMemory |
Non |
Nombre maximal de kilo-octets de mémoire à utiliser avant le recyclage du pool d'applications. |
SiteName |
Oui [action de site Web] Non [action de répertoire virtuel] |
Nom du site Web à créer, configurer, supprimer démarrer ou arrêter. [Action de site Web] Nom du site Web sous lequel le répertoire virtuel réside. S'il n'est pas défini, le site Web par défaut est utilisé. [Action de répertoire virtuel] |
StartMode |
Non |
Mode de démarrage à utiliser pour le pool d'applications. Les valeurs autorisées sont :
|
VirtualDirectoryName |
Oui |
Nom du répertoire virtuel à créer, configurer ou supprimer. |
WebApplicationName |
Non |
Nom de l'application Web sous laquelle le répertoire virtuel existe. S'il n'est pas défini, l'application Web racine du site Web est utilisée. |
WebAppName |
Oui |
Nom de l'application Web à configurer, créer ou supprimer. |
WebSiteName |
Oui [action de site Web] Non [action d'application Web] |
Nom du site Web à configurer, créer, supprimer, démarrer ou arrêter. [Action de site Web] Nom du site Web sous lequel l'application Web réside. S'il n'est pas défini, le site Web par défaut est utilisé. [Action d'application Web] |
Créer ou modifier des fichiers .ini
Ces actions de fichier .ini utilisent l'outil Gestionnaire du fichier INI pour ajouter, modifier ou supprimer des sections et des clés du fichier. Pour plus d'informations sur cet outil, allez ici.
Action |
Description |
---|---|
Créer une clé |
Crée une clé avec une valeur dans une section spécifique d'un fichier .ini. Si le fichier spécifié n'existe pas, l'action le crée. Si la section spécifiée n'existe pas, l'action la crée. Si la clé existe déjà dans la section spécifiée, l'action remplace sa valeur. |
Modifier une clé |
Modifie une clé existante par une nouvelle valeur dans une section spécifique d'un fichier .ini. Si le fichier spécifié n'existe pas, l'action le crée. Si la section spécifiée n'existe pas, l'action la crée. Si la clé existe déjà dans la section spécifiée, l'action l'ajoute. |
Modifier une valeur |
Modifie la valeur d'une clé existante dans une section spécifique d'un fichier .ini. Si le fichier spécifié n'existe pas, l'action le crée. Si la section spécifiée n'existe pas, l'action la crée. Si la clé n'existe pas dans la section spécifiée, l'action l'ajoute. |
Supprimer une clé |
Supprime une clé et ses valeurs d'une section spécifique d'un fichier .ini. Si le fichier spécifié n'existe pas, l'action échoue. Si la section spécifiée ou la clé n'existe pas, l'action réussit quand même. Si vous spécifiez de supprimer toutes les clés d'une section, l'action supprime également la section. |
Modifier une section |
Modifie le nom d'une section dans un fichier .ini. Si le fichier spécifié n'existe pas, l'action le crée. Si la section spécifiée n'existe pas, l'action réussit quand même. |
Supprimer une section |
Supprime une section et toutes ses clés et valeurs dans un fichier .ini. Si le fichier spécifié n'existe pas, l'action échoue. Si la section spécifiée n'existe pas, l'action réussit quand même. |
Variables de configuration
Paramètres |
Obligatoire |
Description |
---|---|---|
INIFile |
Oui |
Nom et chemin d'accès, si nécessaire, du fichier .ini à modifier. |
KeyName |
Oui |
Nom de la clé à créer, modifier ou supprimer. |
KeyValue |
Non |
Nouvelle valeur à affecter à une clé. Si la valeur n'est pas spécifiée et que NewKeyName est spécifié, le système utilisera la valeur réelle. Si la valeur n'est pas spécifiée et que NewKeyName n'est pas spécifié, la valeur est vidée. |
NewKeyName |
Non |
Nouveau nom à affecter à une clé. S'il n'est pas spécifié, le nom de la clé ne sera pas modifié. |
NewSectionName |
Non |
Nouveau nom à affecter à un nom de section. S'il n'est pas spécifié, les clés de l'ancienne section seront placées sous la section racine (toutes les clés se trouvant au début du fichier avant la première section sont prises en compte dans la racine). |
SectionName |
Non |
[Action de création ou de modification d'une clé] Nom de la section où une clé doit être ajoutée ou modifiée. S'il n'est pas spécifié, l'action met à jour la section racine.
Remarque
Toutes les clés qui se trouvent au début du fichier avant la première section sont considérées comme étant dans la racine.
[Action de changement de nom] Nom de la section à renommer. S'il n'est pas spécifié, les clés de l'ancienne section sont placées sous la section racine. [Action de suppression] Nom de la section à supprimer. S'il n'est pas spécifié, la section racine est supprimée. |
Gérer des bases de données SQL Server
Ces actions utilisent l'outil Système déploiement base données - Exécuter script pour créer, supprimer, sauvegarder et restaurer une base de données SQL Server. Pour plus d'informations sur cet outil, allez ici.
Actions |
Description |
---|---|
Créer une base de données SQL |
Crée une base de données. Si la base de données existe déjà, l'action échoue. |
Supprimer une base de données SQL |
Supprime une base de données. Si la base de données n'existe pas, l'action échoue. |
Sauvegarder une base de données SQL |
Sauvegarde une base de données existante à un chemin d'accès spécifié. |
Restaurer une base de données SQL |
Restaure une base de données à partir d'une source spécifiée. |
Variables de configuration
Paramètres |
Obligatoire |
Description |
---|---|---|
DatabaseName |
Oui |
Nom de la base de données SQL Server à créer, supprimer, sauvegarder ou restaurer. |
Path |
Oui |
Chemin d'accès et nom de fichier à utiliser pour stocker la sauvegarde de la base de données. Par exemple, \\server\filename.bak. |
ServerName |
Oui |
Nom du serveur où la base de données SQL doit être créée, sauvegardée, restaurée ou supprimée. |
Source |
Oui |
Chemin d'accès et nom de fichier de la sauvegarde de la base de données à utiliser pour restaurer la base de données. |
Configurer vos serveurs
Ces actions peuvent être utilisées pour configurer votre ordinateur serveur s'il exécute tout système d'exploitation Windows. Vous pouvez exécuter des commandes et supprimer des processus, ainsi que gérer les fichiers, dossiers, variables d'environnement et les valeurs et clés de Registre Windows. Le système exécute ces actions à l'aide de plusieurs outils de gestion des versions prédéfinis, notamment Exécuteur de la ligne de commande, Processus Windows et Système de déploiement XCopy. Pour plus d'informations sur ces outils, allez ici.
Action |
Remarques et conditions d'échec du déploiement |
---|---|
|
Utilisez Exécuter la ligne de commande pour exécuter une commande à l'aide de l'identité de l'Agent de déploiement. Utilisez Exécuter la ligne de commande en tant qu'utilisateur pour exécuter une commande avec des informations d'identification de l'utilisateur spécifiques. |
|
Ces actions prennent en charge la création, la modification et la suppression de fichiers, de dossiers et de certains attributs. Lorsque vous créez des fichiers ou des dossiers, tout répertoire parent inexistant du dossier à créer sera également créé. |
|
Ces actions prennent en charge la création, la modification et la suppression des variables d'environnement. |
|
Ces actions prennent en charge la création, la modification et la suppression des clés de Registre et de leurs valeurs. La séquence de déploiement échoue seulement lorsque vous essayez de modifier une clé de Registre qui n'existe pas. |
Variables de configuration permettant d'exécuter des commandes ou de supprimer un processus
Paramètres |
Obligatoire |
Description |
---|---|---|
Arguments |
Non |
Arguments requis pour exécuter la ligne de commande. |
command |
Oui |
Valeur fixe ./WindowsProcess.ps1. |
FilePath |
Non |
Domaine de l'utilisateur à utiliser comme identité du pool d'applications. S'il n'est pas défini et que IdentityUserName est défini, l'utilisateur sera considéré comme un utilisateur local (c'est-à-dire, .\localuser). |
IsKillProcessTree |
Non |
Indique s'il faut supprimer l'arborescence du processus. Les valeurs autorisées sont :
|
ProcessName |
Oui |
Nom du processus Windows à terminer. |
UserDomain |
Non |
Domaine de l'utilisateur à utiliser pour exécuter l'exécutable. Lorsque rien n'est spécifié,. \localuser est affecté. |
UserName |
Oui [action d'exécution de commande] Non [action de suppression du processus] |
Nom de l'utilisateur à utiliser pour exécuter l'exécutable. Compte d'utilisateur exécutant le processus. S'il n'est pas spécifié, le processus sera terminé pour tous les utilisateurs. |
UserPassword |
Non |
Mot de passe de l'utilisateur à utiliser pour exécuter l'exécutable. |
Variables de configuration permettant de gérer les fichiers et les dossiers
Paramètres |
Obligatoire |
Description |
---|---|---|
Archive |
Non |
Permet de définir ou de réinitialiser l'attribut d'archivage des fichiers ou du dossier.
|
DestinationFileFolder |
Version .NET Framework à utiliser pour le pool d'applications. Ce paramètre est autorisé uniquement pour IIS 7.5, 8.0 et 8.5. Les valeurs autorisées sont : v1.0, v1.1, v2.0 ou v4.0. |
|
DestinationName |
Oui |
Chemin de destination vers lequel copier ou déplacer des fichiers ou des dossiers. Ou bien, nouveau nom à attribuer au fichier ou dossier qui est renommé. |
FileFolderName |
Oui |
Fichier ou dossier source à supprimer, modifier, déplacer ou renommer. Pour l'action de suppression, vous pouvez utiliser des caractères génériques, par exemple, c:, temp ou *.log. |
FolderName |
Oui |
Nom et chemin d'accès du dossier à créer. |
Hidden |
Non |
Permet de définir ou redéfinir l'attribut masqué des fichiers ou des dossiers.
|
OwnerDomain |
Non |
Domaine du nouveau propriétaire des fichiers ou du dossier. Lorsque rien n'est spécifié,. \localuser est affecté. |
OwnerDomain |
Oui |
Nom du nouveau propriétaire des fichiers ou du dossier. |
ReadOnly |
Permet de définir ou redéfinir l'attribut lecture seule des fichiers ou du dossier.
|
|
SourceFileFolder |
Oui |
Fichiers sources ou dossier à copier. Vous pouvez utiliser des caractères génériques, par exemple, c:, temp ou *.log. |
System |
Permet de définir ou de réinitialiser l'attribut système des fichiers ou du dossier.
|
Variables de configuration pour les actions sur les variables d'environnement
Paramètres |
Obligatoire |
Description |
---|---|---|
VariableName |
Oui |
Nom de la variable à créer, modifier ou supprimer. |
VariableValue |
Non |
Valeur à donner à la variable ajoutée ou modifiée. Si aucune valeur n'est définie, la valeur sera supprimée. |
Variables de configuration pour les actions sur le Registre Windows
Paramètres |
Obligatoire |
Description |
---|---|---|
NewRegistryKey |
Oui |
Nom complet de la clé de Registre de destination, par exemple, HKLM, Software, ou NEWKEY. |
OperatingSystemType |
Non |
Type de système d'exploitation dans lequel créer la clé de Registre. Les valeurs autorisées sont :
|
RegistryData |
Non |
Données à affecter à la valeur de Registre. |
RegistryKey |
Oui |
Nom complet de la clé de Registre à créer, modifier ou supprimer. Par exemple, HKLM, Software ou NEWKEY. |
RegistryValue |
Oui |
Nom de la valeur de registre à ajouter ou modifier. |
ValueType |
Non |
Type de données de la valeur de Registre. Les valeurs autorisées sont :
|
Gérer des services Windows
Ces actions utilisent l'outil Gestionnaire des services Windows prédéfini pour créer, configurer, supprimer, redémarrer, démarrer et arrêter un service Windows. Pour plus d'informations sur cet outil, allez ici.
Action |
Conditions d'utilisation et d'échec du déploiement |
---|---|
|
Utilisez Créer un service pour créer un nouveau service. La séquence de déploiement échouera si le service existe déjà. Utilisez Configurer le Service pour configurer un service existant. La séquence de déploiement échouera si le service n'existe pas. Utilisez Configurer les informations d'identification du service pour configurer un service existant avec de nouvelles informations d'identification. La séquence de déploiement échouera si le service n'existe pas. En outre, la séquence de déploiement échouera si le paramètre ServiceName spécifié n'existe pas lorsque vous spécifiez de démarrer, arrêter ou redémarrer un service. Il n'échouera pas si le service est déjà démarré ou arrêté. |
Variables de configuration
Paramètres |
Obligatoire |
Description |
---|---|---|
BinPath |
Non |
Chemin d'accès et nom binaires du service. |
Description |
Oui |
Description du service à créer ou configurer. |
DisplayName |
Non |
Nom du service à créer ou configurer. |
Password |
Non |
Mot de passe du nom d'utilisateur spécifié pour démarrer le service. |
ServiceName |
Oui |
Nom du service à créer, configurer, supprimer, recycler, démarrer ou arrêter. |
StartMode |
Non |
Mode de démarrage du service. Les valeurs autorisées sont :
|
UserName |
Oui |
Nom d'utilisateur qui sera utilisé dans les informations d'identification pour démarrer le service. Utilisez le format DOMAIN\USER, par exemple, NT AUTHORITY\NETWORK SERVICE. Si vous spécifiez le paramètre UserName, vous devez également spécifier le paramètre Password. Pour réinitialiser les informations d'identification sur LocalSystem, entrez LocalSystem pour l'utilisateur et "" pour le mot de passe. |