Comment : générer des rapports de déploiement
Mise à jour : novembre 2007
Dans le Concepteur de déploiements, vous pouvez définir des propriétés pour un rapport de déploiement, puis générer le rapport de déploiement à partir d'un diagramme de déploiement. Les rapports de déploiement sont conçus pour vous aider à créer un script d'installation à partir d'informations XML structurées dans le rapport. Le rapport contient les paramètres de configuration requis pour l'application et le centre de données ainsi qu'une liste de toutes les métadonnées du modèle de définition de système (SDM) comprises dans la validation du déploiement. Ces métadonnées SDM sont fournies par l'application ainsi que par les couches d'hébergement d'application et décrivent la plupart des informations requises pour déployer une application. Pour plus d'informations, consultez Vue d'ensemble des rapports de déploiement.
.gif "Remarque") Remarque : |
|---|
La finalisation d'une définition de déploiement à partir de diagrammes de déploiement ou de rapports de déploiement générés à partir de systèmes par défaut n'est pas recommandée. Les systèmes par défaut sont utiles pour évaluer rapidement le déploiement d'applications individuelles dans le centre de données, mais ne doivent pas être utilisés pour le déploiement final. Pour plus d'informations, consultez Définitions de déploiement créées à partir des diagrammes d'application et de diagrammes système. |
Pour définir les propriétés d'un rapport de déploiement
Cliquez sur la surface du diagramme de déploiement pour le sélectionner.
Dans la fenêtre Propriétés, définissez la propriété Chemin d'accès de destination.
Conseil :Si la fenêtre Propriétés n'est pas ouverte, appuyez sur F4 ou sélectionnez Fenêtre Propriétés dans le menu Affichage.
Ce chemin d'accès indique où les fichiers projet seront copiés si les propriétés Inclure les fichiers de contenu, Inclure les fichiers sources ou Inclure les fichiers binaires ont la valeur True.
Remarque :Vous êtes tenu de définir la propriété Chemin d'accès de destination uniquement si vous affectez également la valeur True aux propriétés Inclure les fichiers de contenu, Inclure les fichiers sources ou Inclure les fichiers binaires. La propriété Chemin d'accès de destination n'a aucune valeur par défaut.
Définissez la propriété Inclure les fichiers de contenu.
Cette propriété indique quels fichiers de contenu seront inclus dans le rapport de déploiement et copiés vers le répertoire du chemin d'accès de destination pour être utilisés dans des scripts.
Si vous choisissez True, les types de fichiers suivants sont inclus :
Projets Web - fichiers de code, fichiers projet, fichiers de ressources, fichiers .config, assemblys référencés, fichiers SDM ainsi que tous les autres fichiers non binaires et ceux qui ne sont pas des fichiers sources. Cela inclut les fichiers .xsd, .disco et .wsdl.
Projets Windows - fichiers SDM, assemblys qui existent dans le dossier de solution et tous les autres fichiers non binaires et ceux qui ne sont pas des fichiers sources.
Projets Office - fichiers SDM, assemblys qui existent dans le dossier de solution et tous les autres fichiers non binaires et ceux qui ne sont pas des fichiers sources.
Définissez la propriété Inclure les fichiers sources.
Cette propriété indique quels fichiers sources seront inclus dans le rapport de déploiement et copiés vers le répertoire du chemin d'accès de destination.
Si vous choisissez True, les types de fichiers suivants sont inclus :
Projets Web - Aucun.
Projets Windows - fichiers de code, fichiers projet, fichiers de ressources et fichiers .config.
Projets Office - fichiers de code, fichiers projet, fichiers de ressources et fichiers .config.
Définissez la propriété Inclure les fichiers binaires.
Cette propriété indique quels fichiers binaires seront inclus dans le rapport de déploiement et copiés vers le répertoire du chemin d'accès de destination.
Si vous choisissez True, les types de fichiers suivants sont inclus :
Projets Web - Aucun.
Projets Windows - Fichiers exécutables et fichiers App.config qui sont également inclus si vous affectez la valeur True à Inclure les fichiers sources.
Projets Office - Fichiers App.config et assemblys générés, également inclus si vous affectez la valeur True à Inclure les fichiers sources.
Pour inclure des images de diagramme dans le rapport de déploiement HTML, affectez True (valeur par défaut) à l'option Inclure les diagrammes.
Pour éviter d'être invité à remplacer des fichiers, affectez Oui à la propriété Action de remplacement des fichiers.
Affectez les valeurs Demander, Ignorer ou Abandonner à la propriété Résolution d'erreur.
Si vous générez le rapport de déploiement à l'aide de l'automation, affectez la valeur Ignorer à cette propriété si vous souhaitez créer le rapport même en présence d'erreurs. Si vous souhaitez que la création du rapport échoue en cas d'erreur, affectez Abandonner à la propriété.
Affectez l'une des valeurs suivantes à la propriété Erreurs uniquement :
True
Le rapport HTML contiendra uniquement une liste d'avertissements et d'erreurs de validation.
False
Le rapport HTML contiendra une liste avec toutes les autres informations (points de terminaison, paramètres, ressources, etc.).
Remarque :Dans certains cas, le texte des erreurs dans le rapport de déploiement diffère du texte des erreurs dans la fenêtre Liste d'erreurs.
Vous pouvez maintenant générer un rapport de déploiement.
Pour générer un rapport de déploiement
Une fois toutes les propriétés du rapport de déploiement définies, choisissez Générer un rapport de déploiement dans le menu Diagramme.
Conseil :Vous pouvez également cliquer avec le bouton droit sur la surface du diagramme de déploiement et choisir Générer un rapport de déploiement.
Si un rapport existe déjà pour le diagramme de déploiement et que la propriété Action de remplacement des fichiers n'a pas la valeur Oui, vous serez invité à remplacer le rapport existant.
Remarque :Seuls les rapports existants sont remplacés. Les fichiers restants et la structure de répertoires restent intacts. Les éventuels fichiers supplémentaires que vous avez écrits dans la structure de répertoires sont donc conservés. Pour éviter que des fichiers soient remplacés dans le futur, affectez Oui à la propriété Action de remplacement des fichiers.
Lorsque vous y êtes invité, choisissez un des éléments suivants :
Oui - Remplace le fichier actif et demande à l'utilisateur de confirmer si la même situation se produit de nouveau.
Non - Ne remplace pas le fichier actif et demande à l'utilisateur de confirmer si la même situation se produit de nouveau.
Annuler - Interrompt le processus de génération du rapport.
Le Concepteur de déploiements génère deux rapports de déploiement dans l'Explorateur de solutions, un au format HTML (.html) et un au format XML (.xml). Lorsque la génération du rapport est terminée, les fichiers .html et .xml sont ajoutés au dossier de solution du système associé au diagramme de déploiement.
Les rapports HTML et XML contiennent tous les deux à peu près les mêmes informations. Toutefois, le rapport HTML contient également des images de diagrammes dans la solution et une liste de propriétaires. De plus, le rapport HTML ne contient pas les ressources dans lesquelles les valeurs par défaut ont la valeur NULL et n'ont pas été modifiées, tandis que le fichier XML contient ces ressources pour permettre la création de scripts.
Vous pouvez également générer des rapports de déploiement via l'automation à l'aide de Visual Studio ou les créer à l'aide d'une entrée de ligne de commande. Pour plus d'informations, consultez Comment : utiliser l'automation avec les rapports de déploiement et Comment : créer des rapports de déploiement à partir de la ligne de commande.
| Remarque : |
|---|
Lors de l'exécution d'une application, il recherche des paramètres dans le fichier nommé <nomapp>.exe.config. Si ce fichier n'est pas présent, l'application ne peut pas fonctionner correctement. Le rapport de déploiement ne copie ni ne répertorie le fichier <nomapp>.exe.config : il inclut seulement le fichier app.config qui est une copie du fichier <nomapp>.exe.config. Pour éviter ce problème, assurez-vous que votre script de déploiement renomme le fichier app.config de manière appropriée. |
Sécurité
Les données que contient un rapport de déploiement peuvent inclure des données d'entreprises ou institutionnelles sensibles ou confidentielles. Prenez cet élément en compte avant de distribuer ou de supprimer le rapport.
| Remarque : |
|---|
Lorsque les propriétés Inclure les fichiers sources ou Inclure les fichiers de contenu ont la valeur True, un avertissement s'affiche pour indiquer que le répertoire de sortie ne peut pas être sécurisé. |
Voir aussi
Tâches
Comment : personnaliser des rapports de déploiement