Déploiement d'un assembly BizTalk à partir de Visual Studio

  • Article

Cette rubrique fournit des instructions sur l’utilisation de Visual Studio Explorateur de solutions ou de l’invite de commandes Visual Studio pour déployer les assemblys BizTalk à partir de Visual Studio dans une application BizTalk. Bien que vous puissiez déployer un assembly unique au niveau du projet (par exemple, en cliquant avec le bouton droit sur le projet, puis en cliquant sur Déployer), ou déployer tous les assemblys de la solution en une seule opération au niveau de la solution (par exemple, en cliquant avec le bouton droit sur la solution, puis en cliquant sur Déployer), il est fortement conseillé de déployer tous les assemblys simultanément au niveau de la solution.

Avec les versions antérieures de BizTalk Server, si vous souhaitiez déployer plusieurs assemblys en une solution, et que certains d'entre eux présentaient des dépendances par rapport à d'autres assemblys, vous deviez déployer les assemblys individuellement, dans l'ordre inverse de leurs dépendances. Par exemple, si l'Assembly1 présentait une dépendance vis à vis de l'Assembly2, vous deviez déployer l'Assembly2 d'abord, puis l'Assembly1.

C'est toujours le cas si vous déployez les assemblys au niveau du projet. Avec BizTalk Server, toutefois, lorsque vous déployez des assemblys à partir du niveau de la solution plutôt que du niveau projet, BizTalk Server prend automatiquement en charge toutes les étapes de déploiement, y compris le déploiement des assemblys dans le bon ordre. Par conséquent, pour simplifier le déploiement, si un autre assembly dépend de celui que vous déployez, vous avez intérêt à effectuer le déploiement des assemblys au niveau de la solution.

Lorsque vous sélectionnez l'option de déploiement d'un projet ou d'une solution à partir de Visual Studio, le ou les assemblys sont automatiquement compilés et déployés dans l'application BizTalk spécifiée dans le groupe BizTalk local. Si l'application n'existe pas encore dans le groupe, le déploiement la crée automatiquement. Les assemblys et les artefacts qu'ils contiennent sont enregistrés et leurs données sont stockées dans la base de données (de configuration) de gestion BizTalk pour ce groupe BizTalk. En outre, si vous spécifiez cette option dans les propriétés de déploiement pour le projet, les assemblys sont ajoutés au GAC (Global Assembly Cache).

Un « artefact » est un élément inclus dans une application BizTalk, y compris les ressources avec lesquelles vous travaillez dans Visual Studio, par exemple les assemblys et orchestrations ainsi que les autres éléments que vous créez ou ajoutez après avoir déployé l'application, comme les ports d'envoi et de réception, les certificats et les scripts. Une fois l'assembly déployé, vous pouvez afficher et gérer ses artefacts dans le nœud Applications de la console Administration de BizTalk Server. Chaque application est stockée dans son propre dossier, les sous-dossiers contenant les artefacts de l'application. Pour plus d’informations, consultez Utilisation de la console d’administration BizTalk Server. Pour plus d’informations sur la création et la gestion d’applications, consultez Déploiement et gestion d’applications BizTalk.

Avant de déployer un assembly, vous devez procédez comme suit :

Important

Vous ne devez jamais exécuter les tâches décrites dans cette rubrique sur un ordinateur de production. En phase de développement, les développeurs redéploient souvent les assemblys à partir de Visual Studio. Pour activer le redéploiement, Visual Studio peut annuler le déploiement, supprimer la liaison, arrêter et dés inscrire les artefacts existant dans les mêmes ou dans différentes applications. Bien que tout ceci soit nécessaire et approprié à l'environnement de développement, cela peut entraîner des conséquences inattendues et indésirables dans l'environnement de production. En outre, afin d'éviter qu'un développeur ne tente de déployer un assembly à partir de Visual Studio sur un ordinateur de production, nous vous recommandons de ne pas installer Visual Studio sur les ordinateurs de ce type.

Notes

La stratégie de sécurité d'exécution de .NET Framework empêche le déploiement des assemblys à partir d'un partage réseau par défaut. Si vous tentez de déployer un assembly à partir d’un partage réseau et rencontrez des difficultés, consultez votre administrateur de sécurité .NET Framework ou consultez « Gestion des stratégies de sécurité » dans la collection combinée Visual Studio.

Prérequis

Pour exécuter les procédures décrites dans cette rubrique, vous devez être connecté avec un compte membre du groupe d'administrateurs BizTalk Server. Si, dans Propriétés de déploiement , vous avez activé l’option d’installation d’un assembly dans le global assembly cache (GAC), vous avez également besoin d’autorisations en lecture/écriture sur le GAC. Le compte des administrateurs de l'ordinateur local dispose de cette autorisation. Pour plus d’informations sur les autorisations, consultez Autorisations requises pour le déploiement et la gestion d’une application BizTalk.

Déploiement d'un ou plusieurs assemblys BizTalk

Utilisation de l'Explorateur de solutions de Visual Studio

  • Dans Visual Studio Explorateur de solutions, cliquez avec le bouton droit sur un projet ou une solution BizTalk, puis cliquez sur Déployer.

    L'assembly du projet ou les assemblys de la solution sont déployés dans l'application BizTalk spécifiée. L'état du processus de compilation et de déploiement s'affiche dans l'angle inférieur gauche de la page.

Utilisation de l'invite de commandes Visual Studio

  1. Démarrez l’invite de commandes Visual Studio.

  2. Tapez la commande suivante en utilisant les valeurs appropriées, comme décrit dans le tableau suivant :

    devenv /deploySolnConfigNameSolutionName [/projectProjName] [/projectconfigProjConfigName]

    Exemple :

    devenv /deploy Release "C:\Documents and Settings\someuser\My Documents\Visual Studio\Projects\MySolution\MySolution.sln" /project "MyBizTalkApp\MyBizTalkApp.csproj" projectconfig Release

    Paramètre Valeur
    /Déployer Déploie une solution après une génération ou une regénération.
    SolnConfigName Nom de la configuration de solution qui sera utilisée pour générer la solution nommée dans SolutionName.
    SolutionName Chemin d'accès complet et nom du fichier de la solution.
    /projectProjName Chemin d'accès et nom du fichier projet dans la solution. Vous pouvez entrer un chemin d'accès relatif du dossier SolutionName au fichier projet, le nom complet du projet ou le chemin d'accès complet et le nom du fichier projet.
    /projectconfigProjConfigName Nom d'une configuration de génération de projet à utiliser lors de la génération du projet.

    Lorsque vous déployez pour la première fois un assembly contenant une orchestration, il est possible que vous receviez un message d'avertissement signalant que l'orchestration n'est pas contenue dans le fichier de liaison. Cela est dû au fait que les orchestrations ne sont pas automatiquement liées à l'hôte lors du déploiement. Vous devez dans ce cas effectuer cette étape manuellement.

Voir aussi

Déploiement des assemblys BizTalk à partir de Visual Studio dans une application BizTalk