Informations sur les applications dans les rapports de déploiement

Mise à jour : novembre 2007

Dans le rapport de déploiement XML, l'élément <Applications> contient des informations sur les applications qui doivent être déployées dans un système distribué. Vous avez besoin de ces informations pour configurer ces applications pour le déploiement. Cet élément peut contenir uniquement des informations pour les applications dans ce système ou inclure des informations pour d'autres systèmes dans ce système. Cet élément comprend également des informations sur les paramètres, ressources et points de terminaison pour chaque application. Pour plus d'informations, consultez Vue d'ensemble des sections clés dans les rapports de déploiement.

Par exemple, si le rapport de déploiement a été généré pour un système « par défaut », cet élément contient toutes les applications dans ce système par défaut, mais aucun autre système. Toutefois, le système par défaut représente le mode de connexion et de configuration de ces applications dans l'environnement de développement, et non dans l'environnement de déploiement. Pour plus d'informations, consultez Définitions de déploiement créées à partir des diagrammes d'application et de diagrammes système.

L'élément <Applications> contient un ou plusieurs éléments <Application> qui identifient chaque application dans le rapport de déploiement. Les sections suivantes contiennent des informations supplémentaires sur l'élément <Application> :

• Application Information in the <Application> Element

• Paths to Application Files

• Configuration File Settings for Applications

• IIS Metabase Settings for ASP.NET Applications

• Information about Application Connections

• Web Service and Web Content Absolute URIs

Informations sur les applications dans l'élément &lt;Application&gt;

L'exemple suivant contient un élément <Application> pour une application Windows. L'attribut "Extends" "Microsoft_WindowsApplication:WindowsApplication" identifie l'application Windows :

<Application Name="MyWinAppUse" Definition="MyWinAppDefinition:MyWinAppDefinition" Extends="Microsoft_WindowsApplication:WindowsApplication" InstanceId="ed22d434-f40d-48b1-bbec-0b4e93ad2a9f">
   ...
</Application>

Dans cet élément, vous pouvez rechercher les informations suivantes :

• Chemins d'accès aux fichiers d'application nécessaires au déploiement.

• Paramètres qui doivent être mis à jour dans les fichiers de configuration de l'application.

• Paramètres de métabase IIS (Internet Information Services) requis par les applications ASP.NET pour le déploiement.

• Informations de connexion pour les applications.

• URI absolus (emplacement de déploiement) pour les points de terminaison de service Web et fournisseurs de contenu Web.

Le type d'application détermine les types de fichiers, paramètres et d'autres informations qui figurent dans le rapport de déploiement.

Chemins d'accès aux fichiers d'application

Le rapport de déploiement inclut des informations relatives au chemin d'accès pour les fichiers nécessaires pour déployer vos applications. Par exemple, ces fichiers incluent des bibliothèques, fichiers exécutables, fichiers de contenu et fichiers de configuration. Vous avez besoin de ces informations pour localiser ces fichiers pour le déploiement. Toutefois, vous devez spécifier un emplacement pour copier ces fichiers avant de générer le rapport de déploiement. Vous pouvez spécifier cet emplacement dans la propriété Destination Path sur le diagramme de déploiement utilisé pour générer le rapport de déploiement. Vous devez également indiquer s'il convient d'inclure les fichiers sources, binaires et de contenu à l'aide des propriétés correspondantes. Vous avez ainsi la possibilité d'inclure ces fichiers et de les collecter à partir de l'emplacement que vous spécifiez. Lorsque vous générez le rapport de déploiement, le processus de génération crée les répertoires de projet appropriés et copie les fichiers à cet emplacement. Pour plus d'informations, consultez Comment : générer des rapports de déploiement.

Remarque :

Pour chaque définition d'application qui prend en charge l'implémentation sur le diagramme d'application, un seul projet existe dans la solution pour cette définition. Toutefois, plusieurs utilisations de cette définition peuvent exister dans le système que vous déployez. Par exemple, votre système peut inclure plusieurs utilisations qui ont des paramètres de sécurité différents et qui seront déployées vers différents serveurs. Le rapport de déploiement inclut ces utilisations multiples. Toutefois, le processus de génération crée un seul répertoire de projet pour toutes ces utilisations. Par conséquent, votre processus de déploiement doit créer et configurer chaque utilisation à l'aide des informations du rapport de déploiement.

Pour chaque application ASP.NET, Windows ou Office dans le rapport de déploiement, l'élément <Application> contient un élément <Resource> nommé "Directory". L'élément "Directory" contient des éléments <Resource> qui incluent des informations sur les répertoires à l'emplacement de sortie et les fichiers copiés dans ces répertoires. Pour plus d'informations, consultez Emplacement et structure de répertoires des fichiers de sortie de déploiement.

Chaque élément <Resource> dans l'élément "Directory" référence un fichier ou un répertoire avec le chemin d'accès au système de fichiers à l'emplacement de sortie. Un élément <Resource> qui référence un répertoire peut contenir d'autres éléments <Resource> qui référencent des sous-répertoires. Toutefois, tous les éléments <Resource> qui référencent des fichiers sont situés au niveau feuille.

Remarque :

Ce groupe d'éléments <Resource> a la même hiérarchie que la structure de projet dans la solution. Toutefois, les éléments <Resource> qui représentent des répertoires au même niveau peuvent apparaître dans un ordre différent des dossiers dans la solution ou sur le disque. De plus, le fait de renommer les projets dans une solution ne modifie pas leurs noms de dossiers sur le disque. Toutefois, le nom de dossier du projet sur le disque, et non le nom du projet dans la solution, est utilisé pour créer le répertoire de projet à l'emplacement de sortie. Par conséquent, le nom du répertoire de projet à l'emplacement de sortie ne peut pas être le même que le nom du projet dans la solution.

De plus, chaque élément <Resource> qui représente un répertoire ou fichier contient un élément <Setting> nommé "Path". Cet élément "Path" contient trois éléments <Facet> : "Assigned", "Parent" et "Current".

Le tableau suivant contient des informations sur ces éléments.

Élément <Facet>	Description
"Assigned"	Contient le chemin d'accès à l'emplacement de sortie spécifié par la propriété Destination Path sur le rapport de déploiement. Toutefois, seul l'élément "Path" dans l'élément "Directory" contient cette valeur.
"Parent"	Contient le chemin d'accès du répertoire de projet au répertoire parent d'un sous-répertoire ou fichier. Toutefois, seul l'élément "Path" de ce sous-répertoire ou fichier contient cette valeur. Remarque : Si le projet a un répertoire parent, l'élément "Parent" de l'élément "Path" dans l'élément "Directory" n'inclut pas le chemin d'accès à ce répertoire parent.
"Current"	Contient le chemin d'accès du répertoire de projet à un sous-répertoire ou fichier. L'élément "Path" pour le répertoire de projet, un sous-répertoire ou un fichier contient cette valeur.

Par conséquent, vous pouvez récupérer le chemin d'accès complet à un sous-répertoire ou fichier en associant l'élément "Assigned" de l'élément "Path" dans l'élément "Directory" à l'élément "Current" d'un sous-répertoire ou fichier.

Remarque :
Il est possible que vous deviez ajouter une barre oblique inverse (\) le cas échéant pour créer un chemin d'accès valide.

Pour plus d'informations, consultez Comment : rechercher des chemins d'accès à des fichiers de sortie de déploiement dans les rapports de déploiement et Emplacement et structure de répertoires des fichiers de sortie de déploiement.

Paramètres du fichier de configuration pour les applications

Vous devez mettre à jour le fichier de configuration (Web.config pour les applications ASP.NET ou App.config pour les applications Windows ou Office) pour chaque utilisation d'une application dans le système avec les paramètres de déploiement corrects. Initialement, les paramètres dans le fichier de configuration représentent la configuration de l'application dans l'environnement de développement, et non dans l'environnement de déploiement. Toutefois, vous pouvez récupérer les paramètres de fichier de configuration requis pour le déploiement à partir du rapport de déploiement.

L'élément <Application> pour une application contient un élément <Resource> nommé "Directory". Pour plus d'informations, consultez Paths to Application Files. Cet élément "Directory" contient un autre élément <Resource> nommé "Configuration". Cet élément "Configuration" contient des éléments <Setting> et <Resource> qui identifient les paramètres de fichier de configuration nécessaires au déploiement. Pour plus d'informations, consultez Comment : rechercher les paramètres du fichier de configuration d'application dans les rapports de déploiement.

Remarque :

Les paramètres de fichier de configuration dans le rapport de déploiement doivent avoir les mêmes noms que leurs équivalents dans le fichier de configuration. Toutefois, les noms de ressources sous lesquels les paramètres apparaissent dans le rapport de déploiement peuvent différer des sections correspondantes dans le fichier de configuration. Pour plus d'informations, consultez Sections du fichier de configuration dans les rapports de déploiement.

Paramètres de métabase IIS pour les applications ASP.NET

L'élément <Application> pour une application ASP.NET contient un élément <Resource> nommé "WebApplication". Cet élément "WebApplication" contient des éléments <Setting> qui décrivent les paramètres de métabase IIS requis pour le déploiement. Toutefois, certains de ces noms de paramètres, valeurs ou types diffèrent de leurs équivalents IIS et nécessitent une traduction avant de les configurer sur le serveur cible. Pour plus d'informations, consultez les rubriques suivantes :

• Comment : rechercher les paramètres de métabase IIS pour les applications ASP.NET dans les rapports de déploiement

• Noms de paramètres qui diffèrent de la métabase IIS

• Types de paramètres qui diffèrent de la métabase IIS

Informations sur les connexions d'application

L'élément <Application> contient un élément <Endpoint> pour chaque point de terminaison sur une application. Un élément <Endpoint> contient un élément <Setting> nommé "ConnectedToEndpoints" lorsqu'un point de terminaison se connecte à un autre point de terminaison. Vous pouvez utiliser l'élément "ConnectedToEndpoints" pour identifier tous les points de terminaison connectés à ce point de terminaison. L'élément "ConnectedToEndpoints" contient un identificateur global unique (GUID) qui correspond à l'attribut "InstanceId" pour le point de terminaison connecté. D'autres éléments <Setting> dans l'élément <Endpoint> contiennent des informations sur les paramètres du point de terminaison.

Conseil :
Vous pouvez afficher ces paramètres en sélectionnant le point de terminaison sur le diagramme d'application ou sur le diagramme système (à partir duquel le diagramme de déploiement a été créé). Ensuite, dans l'Éditeur de paramètres et de contraintes, affichez le nœud Paramètres de point de terminaison d'application. Pour plus d'informations, consultez Éditeur de paramètres et de contraintes.

L'exemple suivant contient un élément "ConnectedToEndpoints" pour un point de terminaison consommateur de service Web sur une application Windows. Cet élément contient un GUID qui identifie le point de terminaison fournisseur de services Web connecté sur une application Web ASP.NET. À son tour, l'élément <Endpoint> pour le point de terminaison fournisseur de services Web a un élément "ConnectedToEndpoints" qui contient la valeur GUID pour le point de terminaison consommateur de service Web connecté :

<Application Name="MyWinAppUse" Definition="MyWinAppDefinition:MyWinAppDefinition" Extends="Microsoft_WindowsApplication:WindowsApplication" InstanceId="6b36995a-a6cf-47d6-9dcb-679d07db23ef">
   <Endpoint Name="MyWebServiceConsumer" Definition="MyWinAppDefinition:MyWinAppDefinition.WebServiceConsumer1" Extends="Microsoft_Web:WebServiceClient" InstanceId="a18fb424-c1a4-49e3-b4af-e6d7e2e9d063"><Setting Name="ConnectedToEndpoints" Definition="System:Guid" State="Set" List="true"><Value>9c4e0dc0-a29d-4bb7-8061-a9d3e2075581</Value></Setting>
      ...
   </Endpoint>
...
</Application>
<Application Name="MyWebApp1" Definition="MyWebApp1:MyWebApp1" Extends="Microsoft_WebApplication:WebApplication" InstanceId="1a912802-d7f3-4b53-89a5-b8bc7f378411">
   ...
   <Endpoint Name="WebService1" Definition="MyWebApp1:MyWebApp1.WebService1" Extends="Microsoft_Web:WebService" InstanceId="9c4e0dc0-a29d-4bb7-8061-a9d3e2075581"><Setting Name="ConnectedToEndpoints" Definition="System:Guid" State="Set" List="true"><Value>a18fb424-c1a4-49e3-b4af-e6d7e2e9d063</Value></Setting>
      ...
   ...
   </Endpoint>
...
</Application>

URI absolus de service Web et de contenu Web

Vous devez configurer les points de terminaison consommateurs pour chaque application qui utilise un service Web ou contenu Web avec l'emplacement de déploiement du service Web ou contenu Web. L'élément <Application> pour une application ASP.NET qui expose un service Web ou contenu Web comprend un élément <Endpoint>. Cet élément <Endpoint> contient un élément <Setting> "Uri" qui comprend trois éléments <Facet> : "Relative", "Base" et "Absolute".

Le tableau suivant contient des informations supplémentaires sur ces éléments.

Élément <Facet>	Description
"Relative"	Contient le paramètre Service URL d'un point de terminaison fournisseur de services Web. Ce paramètre peut contenir une URL de service Web relative ou absolue. - ou - Contient le paramètre Relative Path d'un point de terminaison fournisseur de contenu Web. Ce paramètre contient un chemin d'accès relatif qui référence le contenu à un emplacement autre que le répertoire racine de l'application.
"Base"	Contient le paramètre URL d'un point de terminaison de site Web. Ce point de terminaison de site Web se trouve sur le serveur Web IIS qui héberge le service ou contenu Web.
"Absolute"	Contient l'URI absolu du point de terminaison fournisseur de contenu Web ou de service Web. Remarque : Si le paramètre Service URL ou Relative Path contient une URL ou un chemin d'accès relatif, cet élément associe le paramètre URL et le paramètre Service URL ou le paramètre Relative Path. Toutefois, si le paramètre Service URL ou Relative Path contient une URL ou un chemin d'accès absolu, cet élément contient cette URL ou ce chemin d'accès absolu. Pour plus d'informations, consultez Comment : rechercher les URI absolus de service Web et de contenu Web dans les rapports de déploiement.

Conseil :

Vous pouvez consulter les paramètres d'un point de terminaison fournisseur de contenu Web ou de service Web en le sélectionnant sur le diagramme d'application et en affichant le nœud Paramètres de point de terminaison d'application dans l'Éditeur de paramètres et de contraintes. Vous pouvez consulter les paramètres d'un point de terminaison de site Web en le sélectionnant sur le diagramme de centre de données logique et en affichant le nœud Paramètres de point de terminaison de serveur logique dans l'Éditeur de paramètres et de contraintes. Pour plus d'informations, consultez Éditeur de paramètres et de contraintes.

Voir aussi

Concepts

Vue d'ensemble du déploiement à l'aide des rapports de déploiement