Desencadenar una versión desde una compilación

Inicie una versión automáticamente cuando compile la aplicación mediante Team Foundation Build. Puede elegir con qué fase del proceso de producción de versiones desea empezar. Para desencadenar una versión desde una compilación, se debe configurar el proceso de compilación y la ruta de acceso de versión.

Si no ha creado todavía la ruta de acceso de versión, vaya aquí para hacerlo.

Además, si aún no ha configurado el sistema de compilación, hágalo ahora.

Configurar el proceso de compilación

1. Si no tiene permisos para editar las definiciones de compilación, obténgalos ahora.

2. Desde Visual Studio Team Explorer, conéctese al proyecto de equipo en el que desea trabajar (teclado: CTRL + 0, C).

3. En la página Compilaciones (teclado: CTRL + 0, B), cree o edite una definición de compilación.

4. En la ficha Proceso de la definición de compilación, seleccione la configuración que desea utilizar para esta versión (por ejemplo, depuración o lanzamiento). Establezca la Compilación de versión en True. Elija la fase concreta que desea desencadenar para la versión, o bien deje este campo en blanco si desea empezar con la primera fase.

   

   Si no aparece la sección Versión:

   • P: Uso la plantilla predeterminada. ¿Qué plantilla de proceso de compilación debo emplear para Release Management y cómo la agrego a TFS?

   • P: Uso la plantilla de actualización. ¿Qué plantilla de proceso de compilación debo usar para Release Management?

   • P: Uso una plantilla de proceso de compilación personalizada. ¿Cómo agrego la lógica del flujo de trabajo para desencadenar una versión?

   Si tiene componentes cuyos archivos de configuración necesitan diferentes valores según el entorno de destino, puede convertir en tokens el archivo de configuración.

5. Especifique cualquier otro valor que requiera el proceso de compilación y guarde la definición de compilación.

Configurar la plantilla de versión

1. Si no ha instalado Release Management Client para Visual Studio 2013 en el servidor de compilación, hágalo ahora. Configure Release Management Client para que se conecte a Release Management Server.

   Después de instalar el cliente en el servidor de compilación, reinicie los servicios de compilación. Puede hacerlo desde la Consola de administración de Team Foundation Server.

2. Desde la plantilla de versión, elija la definición de compilación que ha configurado para desencadenar una compilación y active la casilla para permitir que el proceso de compilación desencadene una versión.

   

   Si no aparece la selección de Definición de compilación, necesita agregar la conexión TFS a Release Management Client. (Agregue la conexión desde la pestaña Administrar TFS de la sección Administración).

   Una vez que se desencadena la versión, continúa por los pasos de la fase que se seleccionó. Si no establece el Paso de aceptación y el Paso de implementación en Automatizada para esta fase, no se inicia la versión. Debe marcar estos pasos como automatizados en la ruta de acceso de versión.

Preguntas y respuestas

P: Uso la plantilla predeterminada.¿Qué plantilla de proceso de compilación debo emplear para Release Management y cómo la agrego a TFS?

R: Si está usando la plantilla predeterminada, basta con reemplazarla con la plantilla de proceso de administración de versiones correspondiente.

1. Si no tiene permisos para contribuir con archivos o para editar definiciones de compilación, obténgalos ahora.

2. Desde Visual Studio Team Explorer, conéctese al proyecto de equipo en el que desea trabajar (teclado: CTRL + 0, C).

3. En la carpeta Unidad:\Archivos de programa (x86)\Microsoft Visual Studio 12.0\ReleaseManagement\bin, busque la plantilla que necesita. O bien, descargue la plantilla en este directorio desde el archivo ZIP adjunto a esta entrada de blog.

   • TFS 2013

     • TFVC: ReleaseTfvcTemplate.12.xaml.

     • Git: ReleaseGitTemplate.12.xaml

   • TFS 2012: ReleaseDefaultTemplate.11.1.xaml

   • TFS 2010: ReleaseDefaultTemplate.xaml

4. Agregue la plantilla al control de versiones. Es conveniente colocar la plantilla en la carpeta BuildProcessTemplates del proyecto de equipo.

   • TFVC: Agregar archivos al servidor

   • Git: Administrar archivos en el equipo de desarrollo

5. Desde la página Compilaciones (teclado: CTRL + 0, B), cree o edite una definición de compilación.

6. En la pestaña Proceso, elija Nuevo para seleccionar la plantilla que desea usar para el Archivo del proceso de compilación. (Debe ser capaz de examinar para seleccionar la plantilla recién agregada).

P: Uso una plantilla de proceso de compilación personalizada.¿Cómo agrego la lógica del flujo de trabajo para desencadenar una versión?

R: Agregue secciones a la plantilla de proceso de compilación personalizada para proporcionar la lógica del flujo de trabajo. Descargue aquí el archivo de fragmentos de código que contiene estas secciones. Use los fragmentos de código para agregar estos argumentos a la plantilla de proceso de compilación: ConfigurationsToRelease, ReleaseBuild, ReleaseTargetStage, DropBuild.

Guarde la plantilla de proceso de compilación. Si usa el control de versiones de Team Foundation, protéjala. Si emplea Git, confirme e inserte la plantilla de proceso de compilación.

P: Uso la plantilla de actualización.¿Qué plantilla de proceso de compilación debo usar para Release Management?

R: Obtenga aquí información sobre lo que necesita hacer.

P: ¿Puedo implementar componentes de mi aplicación en equipos diferentes?

R: Sí, cree los componentes mediante Release Management Client y agréguelos a la plantilla de versión.

Después puede agregar estos componentes a la compilación.

Cuando aparezca la ventana Componentes, haga doble clic en el componente que desea agregar.

Todos los componentes que agregue deben configurarse como Se compila con aplicación o Se compila externamente.

Un carácter '\' en Ubicación de destino de compilación indica que la compilación se encuentra en la raíz de la carpeta de entrega.

P: ¿Qué herramientas puedo usar para implementar un componente?

R: Para cada componente que defina, puede seleccionar la herramienta que desea usar en la pestaña Implementación. Puede obtener aquí más información sobre cada herramienta.

Reemplace los Argumentos con información específica para implementar este componente.

Si desea usar una herramienta personalizada, agréguela primero mediante la página Inventario y, a continuación, selecciónela en la pestaña Implementación.

Asegúrese de que todos los archivos a los que hace referencia el comando estarán disponibles en la ubicación del paquete en el momento de la implementación.

P: ¿Por qué no se ha iniciado mi versión?

Estas son algunas causas posibles:

• Si configura la compilación para desencadenar una versión (Compilación de versión=True) y no activa la casilla ¿Puede desencadenar una versión desde una compilación? para la plantilla de versión. Esto hace que se produzca un error en la compilación y, por tanto, no se inicia la versión.

• Si configura la plantilla de versión para usar una definición de compilación que no está configurada para desencadenar una versión (Compilación de versión=False) o no contiene la lógica de versión correcta.

• Si una plantilla de versión contiene algún componente que está configurado para compilarse independientemente.

• Si no establece el Paso de aceptación y el Paso de implementación en Automatizada para la fase que seleccionó desencadenar desde la versión, la versión no se iniciará. Debe establecer estos pasos para que se automaticen en esta ruta de acceso de versión.

• Si no ha instalado Release Management Client en el equipo en el que se está ejecutando el servidor de Team Foundation Build.

• Si el tiempo necesario para completarse una implementación supera los 10 minutos. Puede cambiar el valor asignado a Tiempo de espera de implementación desencadenada por TFS en la pestaña Administración de la página Configuración.

P: ¿Cómo puedo controlar los archivos de configuración que necesitan diferentes valores según el entorno de destino?

R: Use archivos de configuración con tokens.

Para cada archivo de configuración de la solución que necesite distintos valores en entornos diferentes, cree una versión con tokens de ese archivo.

Por ejemplo, si la solución contiene un archivo denominado web.config, haga una copia de ese archivo y asígnele el nombre web.config.token. El archivo web.config no cambia y se emplea cuando se ejecuta la aplicación localmente. El archivo web.config.token contiene tokens en lugar de valores reales.

Por ejemplo, si el archivo web.config contiene esta línea:

<add key="SMTPHostServer" value="mysmtp.myserver.domain"/>

el archivo web.config.token contendrá esta línea, donde SMTPHostServer es el token:

<add key="SMTPHostServer" value="SMTPHostServer"/>

Mantenga sincronizados los archivos locales y los archivos con tokens.

P: ¿Cómo defino qué archivos se deben examinar para reemplazar tokens con variables?

R: Para cada componente que defina, puede especificar el filtro de extensión de archivo en la pestaña Variables de configuración.

El Deployment Agent que especificó para el componente emplea coincidencia de patrones para examinar el conjunto de archivos en los que es necesario reemplazar los tokens con variables. Separe dos o más extensiones de archivo mediante un signo de punto y coma (;).