Cómo volver a implementar un ensamblado de BizTalk desde Visual Studio

Artículo
05/04/2023

Durante el desarrollo de un ensamblado, suele resultar necesario implementarlo, probarlo, modificarlo y volver a implementarlo varias veces. En versiones anteriores de BizTalk Server, si se quería volver a implementar un ensamblado sin cambiar el número de versión, primero había que detener, dar de baja y separar manualmente los artefactos incluidos en el ensamblado de BizTalk Server y, a continuación, quitar el ensamblado de la base de datos (de configuración) de Administración de BizTalk. Además, después de volver a implementar el ensamblado, había que enlazar, dar de alta e iniciar sus artefactos en BizTalk Server.

Sin embargo, con BizTalk Server, al habilitar la opción Volver a implementar en Visual Studio, BizTalk Server realiza automáticamente todos los pasos para volver a implementar el ensamblado. Aunque se pueda volver a implementar un ensamblado desde el nivel de proyecto (haciendo clic con el botón secundario en el proyecto en el Explorador de soluciones y haciendo clic en Implementar) para volver a implementar un ensamblado individual, recomendamos encarecidamente que siempre se vuelvan a implementar los ensamblados desde el nivel de solución (haciendo clic con el botón secundario en la solución y haciendo clic en Implementar). De este modo, se vuelven a implementar todos los ensamblados de la solución al mismo tiempo y se controlan todos los pasos implicados cuando existen dependencias, como se explica más adelante.

Importante

Aunque hay pocas situaciones en las que sería necesario volver a implementar en el nivel de proyecto, como norma, siempre se debe volver implementar en el nivel de solución.

Al volver a implementar un ensamblado, tenga en cuenta los siguientes puntos importantes:

Debe instalar el nuevo ensamblado en la GAC. Al volver a implementar un ensamblado, siempre debe instalar la nueva versión del ensamblado en la GAC, como se describe en Cómo instalar un ensamblado en la GAC. Puede hacerlo una vez que lo ha vuelto a implementar.
Siempre debe volver a implementar en el nivel de solución cuando existen dependencias. Si una solución cuenta con varios ensamblados y uno o varios tienen una dependencia en el ensamblado que desea volver a implantar, debe volver a implantar los ensamblados en el nivel de solución. Ello se debe a que, al volver a implementar un ensamblado en el nivel de proyecto, BizTalk Server detendrá, dará de baja y quitará los artefactos en todos los ensamblados que dependan o de los que dependa éste. BizTalk Server no llevará a cabo los pasos adicionales para implementar, enlazar, dar de alta e iniciar los artefactos. Sin embargo, al volver a implementar la solución completa, BizTalk Server lleva a cabo automáticamente todos los pasos necesarios para anular la implementación y volver a implementar todos los artefactos en la solución según sus dependencias.
Es posible que tenga que volver a implementar manualmente los ensamblados dependientes. BizTalk Server siempre anula la implementación de ensamblados dependientes, pero debe llevar a cabo los pasos adicionales para implementar, enlazar y dar de alta los artefactos en cada ensamblado dependiente después de volver a implementar el ensamblado del que éste depende en los casos siguientes:
- Si vuelve a implementar un ensamblado en el nivel de proyecto y otro ensamblado de la misma solución depende de él.
- Si vuelve a implementar un ensamblado en el nivel de solución, pero existe un ensamblado dependiente en una solución diferente.
  
  Por ejemplo, si volviera a implementar sólo el Ensamblado 3 que se muestra en el diagrama siguiente, siguiendo la nueva implementación debería implementar, enlazar y dar de alta los artefactos del Ensamblado 2 y, a continuación, hacer lo mismo con los artefactos del Ensamblado 1.
  
  Un enfoque alternativo es evitar la implementación innecesaria de los ensamblados principales que no han cambiado. Por ejemplo, en el diagrama anterior, si hay otros ensamblados que dependen de Ensamblado 2 y Ensamblado 3, y ninguno de ellos se ha actualizado. Desactive la opción Implementar en configuration Manager para los proyectos ensamblado 2 y ensamblado 3. De esta forma, no se anulará la implementación de los ensamblados externos que dependen de ellos, lo que requeriría una nueva implementación. Para obtener más información, vea Cómo establecer propiedades de implementación en Visual Studio.
Debe reiniciar las instancias de host. Al volver a implementar un ensamblado que contiene una orquestación sin cambiar el número de versión del ensamblado, el ensamblado existente se sobrescribe en la base de datos de Administración de BizTalk. Sin embargo, antes de que el cambio se haga efectivo, deberá reiniciar cada instancia de host correspondiente al host al que está enlazada la orquestación. Puede especificar la opción para que todas las instancias de host del equipo local se reinicien automáticamente al volver a implementar un ensamblado. Para obtener instrucciones, consulte Cómo establecer propiedades de implementación en Visual Studio. También puede detener e iniciar manualmente cada instancia de host, como se describe en Cómo detener una instancia de host y Cómo iniciar una instancia de host.

Importante

Puesto que la opción Volver a implementar omite el control de la versión, recomendamos que la utilice únicamente durante el desarrollo.

Requisitos previos

Para realizar el procedimiento descrito en este tema, deberá iniciar sesión con una cuenta que sea miembro del grupo de administradores de BizTalk Server. Además, la cuenta debe tener permisos de lectura y escritura en el sistema de archivos local y en la caché de ensamblados global (GAC). La cuenta de administradores del equipo local tiene estos permisos.

Para volver a implementar una solución de BizTalk

Mediante el Explorador de soluciones de Visual Studio

Asegúrese de que la opción Volver a implementar está habilitada en Propiedades de implementación para cada proyecto de la solución, como se describe en Cómo establecer propiedades de implementación en Visual Studio. Esta opción está habilitada de manera predeterminada.
En Visual Studio Explorador de soluciones, haga clic con el botón derecho en una solución de BizTalk y, a continuación, haga clic en Implementar.

Los ensamblados de la solución se implementan en la aplicación de BizTalk especificada. El estado del proceso de generación e implementación se muestra en la esquina inferior izquierda de la página.

Mediante el símbolo del sistema de Visual Studio

Asegúrese de que la opción Volver a implementar está habilitada en Propiedades de implementación para cada proyecto de la solución, como se describe en Cómo establecer propiedades de implementación en Visual Studio. Esta opción está habilitada de manera predeterminada.
Inicie el símbolo del sistema de Visual Studio.

Escriba el siguiente comando, sustituyendo los valores según corresponda, como se describe en la tabla que se presenta a continuación:

devenv /deploySolnConfigNameSolutionName

Ejemplo:

devenv /deploy Release "C:\Documents and Settings\someuser\Mis documentos\Visual Studio\Projects\MySolution\MySolution.sln"

Parámetro	Value
/Implementar	Implementa una solución después de una compilación o recompilación.
SolnConfigName	Nombre de la configuración de la solución que se utilizará para generar la solución nombrada en NombreSolución.
SolutionName	Ruta completa y nombre del archivo de solución.

Consulte también

Implementación de ensamblados de BizTalk en una aplicación de BizTalk desde Visual Studio

Compartir vía