Procédure pas à pas : déploiement d'un projet d'application Web à l'aide d'un package de déploiement Web (partie 4 sur 4)

Article
10/15/2014

Cette procédure pas à pas est la quatrième d'une série de procédures pas à pas qui expliquent comment déployer un projet d'application Web à l'aide d'un package de déploiement Web. Pour plus d'informations sur la série de procédures pas à pas, consultez Procédure pas à pas : déploiement d'un projet d'application Web à l'aide d'un package de déploiement Web (partie 1 sur 4).

Au cours de cette procédure pas à pas, vous utilisez le package que vous avez créé au cours de la troisième procédure pas à pas pour installer l'application Web sur un ordinateur distant. Cette procédure pas à pas décrit les tâches suivantes :

Installation d'un package sur un ordinateur distant à l'aide du fichier deploy.cmd.
Utilisation de paramètres de déploiement personnalisés pour les valeurs de configuration que vous souhaitez pouvoir modifier lorsque le package est installé.

Composants requis

Pour obtenir la liste des composants requis, consultez Procédure pas à pas : déploiement d'un projet d'application Web à l'aide d'un package de déploiement Web (partie 1 sur 4).

Préparation du serveur de destination

Si quelqu'un d'autre configure le serveur de destination pour vous, cette personne doit spécifier la méthode de déploiement à utiliser. Si vous configurez le serveur de destination, vous devez sélectionner une méthode. Les méthodes disponibles sont les suivantes :

Service de gestion Web (WMSvc) et gestionnaire de déploiement Web.
Service de l'agent de déploiement Web (MsDepSvc).
Paramètre de fournisseur tempAgent de Web Deploy.

Pour plus d'informations sur ces méthodes ou sur la configuration d'un serveur de destination pour utiliser l'une de ces méthodes, consultez Comment : installer un package de déploiement à l'aide du fichier deploy.cmd.

Le serveur de destination doit non seulement être configuré pour la méthode de déploiement que vous sélectionnez, mais il doit également répondre aux conditions suivantes :

Il doit être activé pour IIS 7.
ASP.NET 4 doit être inscrit auprès d'IIS 7.
Un pool d'applications ASP.NET 4 doit être assigné au site Web par défaut.

Afin de pouvoir poursuivre cette procédure pas à pas, vous devez configurer le serveur de destination.

Définition de paramètres de déploiement

La procédure suivante vous permet de vous assurer que le fichier SetParameters.xml contient les valeurs appropriées. Cela équivaut à vérifier ou modifier les valeurs de paramètre qui sont affichées dans la boîte de dialogue Entrer les informations sur le package d'application lorsque vous installez un package à l'aide du Gestionnaire des services IIS.

Pour modifier le fichier SetParamters.xml

Ouvrez le projet d'application Web que vous avez créé au cours de la première procédure pas à pas de cette série.
Dans l'Explorateur de solutions, développez le dossier obj, le dossier Release, puis le dossier Package. (Au cours d'une procédure pas à pas précédente, vous avez ouvert le dossier Debug. Assurez-vous que cette fois-ci vous utilisez le dossier Release et non le dossier Debug.)
Ouvrez AdventureWorks.SetParameters.xml.

Le contenu XML du fichier ressemble à ce qui suit :
```
<parameters>
  <setParameter name="IIS Web Application Name" 
    value="Default Web Site/AdventureWorks" /> 
  <setParameter name="machineKey" value="staging" /> 
  <setParameter name="ApplicationServices-Deployment Connection String"
    value="... " /> 
  <setParameter name="AWLTConnectionString-Deployment Connection String"
    value="..." /> 
  <setParameter name="ApplicationServices-Web.config Connection String" 
    value="..." /> 
  <setParameter name="AWLTConnectionString-Web.config Connection String" 
    value="..." /> 
</parameters>
```
Remarquez l'élément setParameter dont la valeur de l'attribut name est machineKey. L'attribut value de cet élément setParameter est staging, ce qui correspond à la valeur par défaut que vous définissez au cours de la troisième procédure pas à pas de cette série pour le déploiement sur un serveur intermédiaire. Si vous vous préparez à installer le package sur un serveur de production, vous pouvez remplacer l'attribut value de cet élément setParameter pour le paramètre machineKey par une valeur de production. Le fichier Web.config déployé est ensuite mis à jour pour contenir la valeur de production à la place de la valeur intermédiaire.

Préparation de l'installation à distance à l'aide du fichier Deploy.cmd

Dans la procédure suivante, vous vous préparez à exécuter le fichier deploy.cmd en ouvrant une invite de commandes et en naviguant jusqu'au dossier qui contient le fichier deploy.cmd.

Pour préparer une installation à distance à l'aide du fichier Deploy.cmd

Dans l'Explorateur de solutions, sélectionnez le fichier AdventureWorks.SetParameters.xml.
Dans la fenêtre Propriétés, notez la valeur de la propriété Chemin d'accès complet.
Dans le menu Démarrer de Windows, cliquez sur Invite de commandes.
Naviguez jusqu'au dossier qui contient le fichier AdventureWorks.SetParameters.xml.

Vous pouvez désormais saisir dans la fenêtre Invite de commandes la commande d'exécution du fichier deploy.cmd.

La syntaxe du fichier deploy.cmd varie en fonction de la méthode de déploiement que vous utilisez. Utilisez la procédure appropriée à la méthode que vous avez choisie.

Les exemples de syntaxe illustrés dans les sections suivantes incluent les espaces réservés suivants :

NomServeur. Remplacez cette valeur par le nom du serveur de destination.
NomUtilisateur et MotDePasse. Le cas échéant, remplacez ces valeurs par les informations d'identification réelles définies pour le déploiement.

Installation à distance à l'aide du gestionnaire de déploiement Web

La procédure suivante explique comment installer le package à l'aide du service de gestion Web (WMSvc) et du gestionnaire de déploiement Web.

Pour effectuer un déploiement à l'aide du service de gestion Web et du gestionnaire de déploiement Web

Tapez la commande suivante pour tester l'installation du package :
```
AdventureWorks.deploy.cmd /t /m:https://ServerName:8172/MSDeploy.axd /u:username /p:password /a:basic
```
Pour le déploiement à l'aide du service de gestion Web, un compte d'utilisateur à utiliser pour le déploiement est généralement indiqué.

L'option t exécute la commande en mode test pour que vous puissiez examiner les résultats de cette commande avant de déployer réellement l'application.

Notes

Pour certains scénarios, il est possible que le déploiement échoue lorsque vous utilisez l'option t, mais qu'il soit réussi lorsque vous utilisez l'option y.(Pour plus d'informations, consultez FAQ sur le déploiement de projet d'application Web ASP.NET).
Si la sortie du test ne correspond pas à vos attentes, effectuez les modifications nécessaires.
Si la sortie du test correspond à vos attentes, répétez la commande en remplaçant l'indicateur t (test) par l'indicateur y (oui), comme illustré dans l'exemple suivant :
```
AdventureWorks.deploy.cmd /y /m:https://ServerName:8172/MSDeploy.axd /u:username /p:password /a:basic
```

Installation à distance à l'aide du service de l'agent de déploiement Web

La procédure suivante explique comment installer le package à l'aide du service de l'agent de déploiement Web (MsDepSvc).

Pour effectuer un déploiement à l'aide du service de l'agent de déploiement Web

Tapez la commande suivante pour tester l'installation du package :
```
AdventureWorks.deploy.cmd /t /m:ServerName
```
Pour le service de l'agent de déploiement Web, vous utilisez généralement l'authentification Windows et vous n'indiquez pas de nom d'utilisateur et de mot de passe.

L'option t exécute la commande en mode test pour que vous puissiez examiner les résultats de cette commande avant de déployer réellement l'application.

Notes

Pour certains scénarios, il est possible que le déploiement échoue lorsque vous utilisez l'option t, mais qu'il soit réussi lorsque vous utilisez l'option y.(Pour plus d'informations, consultez FAQ sur le déploiement de projet d'application Web ASP.NET).
Si la sortie du test ne correspond pas à vos attentes, effectuez les modifications nécessaires.
Si la sortie du test correspond à vos attentes, répétez la commande en remplaçant l'indicateur t (test) par l'indicateur y (oui), comme illustré dans l'exemple suivant :
```
AdventureWorks.deploy.cmd /y /m:ServerName
```

Installation à distance à l'aide du paramètre de fournisseur tempAgent

La procédure suivante explique comment installer le package à l'aide du paramètre de fournisseur tempAgent de Web Deploy.

Pour effectuer un déploiement à l'aide du paramètre de fournisseur tempAgent de Web Deploy

Tapez la commande suivante pour tester l'installation du package :
```
AdventureWorks.deploy.cmd /t /m:ServerName /g:true
```
Pour le paramètre de fournisseur tempAgent, vous utilisez généralement l'authentification Windows et vous ne spécifiez pas de nom d'utilisateur et de mot de passe.

L'option t exécute la commande en mode test pour que vous puissiez examiner les résultats de cette commande avant de déployer réellement l'application.

Notes

Pour certains scénarios, il est possible que le déploiement échoue lorsque vous utilisez l'option t, mais qu'il soit réussi lorsque vous utilisez l'option y.(Pour plus d'informations, consultez FAQ sur le déploiement de projet d'application Web ASP.NET).
Si la sortie du test ne correspond pas à vos attentes, effectuez les modifications nécessaires.
Si la sortie du test correspond à vos attentes, répétez la commande en remplaçant l'indicateur t (test) par l'indicateur y (oui), comme illustré dans l'exemple suivant :
```
AdventureWorks.deploy.cmd /y /m:ServerName /g:true
```

Étapes suivantes

Au cours des deux premières procédures pas à pas de cette série, vous avez déployé un projet d'application Web de système de fichiers sur une application Web IIS à des fins de test sur l'ordinateur de développement. Au cours de la troisième procédure pas à pas, vous avez créé un package à utiliser pour le déploiement sur un serveur intermédiaire ou un serveur de production. Au cours de cette procédure pas à pas, la dernière de cette série, vous avez déployé le package sur un ordinateur distant à l'aide du fichier deploy.cmd généré par Visual Studio lors de la création du package.

Voici quelques scénarios typiques supplémentaires pour le déploiement sur des serveurs intermédiaires et de production :

Utilisez le même package pour le déploiement sur plusieurs serveurs dans une batterie de serveurs Web, en supprimant le déploiement de base de données pour chaque installation après la première installation.
Empêchez le déploiement de certains fichiers (par exemple, les fichiers Web.config) car ils sont mis à jour manuellement sur le serveur de destination et vous ne souhaitez pas que ces modifications soient remplacées.
Pour plus d'informations sur la gestion de ces scénarios, consultez Comment : installer un package de déploiement à l'aide du fichier deploy.cmd.

Voir aussi

Concepts

Organigramme des informations relatives au déploiement ASP.NET

Partager via