Tutorial: Crear una definición de compilación en Team Foundation Build

Actualización: noviembre 2007

En este tutorial se muestra cómo configurar una definición de compilación para Team Foundation Build. Antes de iniciar este tutorial, es importante tener conocimientos básicos de Team Foundation Build. Para obtener más información, vea Administrar compilaciones con Team Foundation Build.

En este tutorial, se le guiará a través del proceso de configuración de una definición de compilación mediante el cuadro de diálogo Definición de compilación . También establecerá los permisos necesarios para el agente de compilación y para los usuarios que van a ejecutar las definiciones de compilación recién creadas. En este tutorial realizará las tareas siguientes:

• Crear una nueva definición de compilación.

• Seleccionar las soluciones que se van a generar.

• Seleccionar un agente de compilación y una ubicación de destino.

• Seleccionar los pasos de la generación.

• Seleccionar la configuración y las plataformas para la compilación.

• Establecer permisos en el agente de compilación.

• Establecer permisos para los usuarios especificados que les permitan ejecutar la definición de compilación recién creada.

Requisitos previos

• Visual Studio Team System Team Foundation Server.

• Una conexión con un servidor Team Foundation Server y al menos un proyecto de equipo existente. Para obtener más información, vea Tutorial: Unirse a un proyecto de equipo y Cómo: Crear un proyecto de equipo.

• Un área de trabajo en el servidor de control de código fuente que contenga como mínimo una solución para generar. Para obtener más información, vea Cómo: Crear un área de trabajo asignada.

Permisos necesarios

Para completar este tutorial, debe tener el permiso Administrar una compilación establecido en Permitir. Además, la cuenta de servicio del nivel de aplicación y la cuenta de servicio de Team Foundation Build deben tener permisos de lectura y escritura en la ubicación de destino de la compilación. Para obtener más información, consulte Permisos de Team Foundation Server.

Para crear una nueva definición de compilación

1. En Team Explorer, seleccione el proyecto para el que desea crear una nueva definición de compilación.

2. En el menú Generar, seleccione Definición de nueva compilación.

   Aparece el cuadro de diálogo Definición de compilación con la ficha General seleccionada.

   Sugerencia:
   Las fichas que tienen un icono de advertencia junto a ellas requieren que se especifiquen datos.

3. Especifique el nombre que desea asociar a la definición de compilación en el cuadro de texto Nombre de definición de compilación.

   El nombre que escriba debe ser un nombre de archivo de Windows único y válido.

4. Agregue una descripción adecuada en el cuadro de texto Descripción.

   Esta descripción aparece en el cuadro de diálogo Poner en cola compilación "<nombre del proyecto de equipo>". Para obtener más información, consulte Cómo: Poner en cola o iniciar una definición de compilación.

5. Haga clic en la ficha Área de trabajo.

   La tabla Carpetas de trabajo incluye de forma predeterminada la carpeta de control de código fuente del proyecto de equipo para el que se van a crear las nuevas definiciones de compilación. En el agente de compilación se crea una carpeta local que refleja la jerarquía de control de código fuente. En la columna Carpeta local se indica la carpeta local del agente de compilación. Todas las rutas de acceso de área de trabajo del agente de compilación se asignan respecto al directorio raíz predeterminado que se muestra.

6. Para copiar un área de trabajo existente en la lista de carpetas de trabajo, haga clic en el botón Copiar área de trabajo existente para iniciar el cuadro de diálogo Seleccione un área de trabajo que copiar.

   El área de trabajo que selecciona se normaliza en el directorio raíz común del agente de compilación.

   También puede hacer clic en una celda de tabla vacía en la Carpeta de control de código fuente y, a continuación, hacer clic en los puntos suspensivos (…) para buscar la carpeta de control de código fuente que va a agregar como carpeta de trabajo. La carpeta de control de código fuente que selecciona se normaliza también en el directorio raíz común del agente de compilación.

7. Haga clic en la ficha Archivo de proyecto. En el panel Archivo de proyecto puede buscar un archivo de proyecto TFSBuild.proj existente o iniciar el Asistente para crear archivos de proyecto de MSBuild para crear un nuevo archivo TFSBuild.proj.

8. Para buscar un archivo TFSBuild.proj existente, haga clic en Examinar. En el cuadro de diálogo Buscar carpeta, seleccione una definición de compilación existente en la carpeta TeamBuildTypes y, a continuación, haga clic en Aceptar.

   El archivo TFSBuild.proj se comparte ahora entre la nueva definición de compilación y la existente.

   Si se encuentra un archivo TFSBuild.proj, se muestra el texto Se encontró archivo de proyecto de MSBuild: TFSBuild.proj en el panel Archivo de proyecto. Si no se encuentra un archivo de proyecto, se muestra en el panel Archivo de proyecto un texto de advertencia y se aconseja crear un nuevo archivo de proyecto de MSBuild.

   Nota importante:
   Cualquier cambio que realice en un archivo TFSBuild.proj compartido se aplica a todas las definiciones de compilación a las que está asociado el archivo. Para obtener más información, consulte Personalizar Team Foundation Build.

9. Para crear un nuevo archivo de proyecto para la definición de compilación, haga clic en Crear.

   Aparece el Asistente para crear archivos de proyecto de MSBuild.

   1. En la página Seleccione y ordene las soluciones que desea generar, seleccione las soluciones que va a generar. Para ordenar las soluciones, seleccione una de ellas y utilice las teclas de flecha situadas a la derecha de la lista para cambiar su ubicación en el orden de compilación.

      Precaución:
      Tenga en cuenta si una solución tiene dependencias en otra cuando determine el orden en el que se generan. Por ejemplo, si la solución 2 depende de la solución 1, establezca la solución 1 de modo que se genere antes que la solución 2.

   2. Haga clic en Siguiente.

      Aparece la página Seleccione las configuraciones para generar.

   3. En la cuadrícula situada debajo de ¿Qué configuraciones desea generar?, seleccione la configuración y las plataformas que desee incluir en las definiciones de compilación. La configuración de compilación indica la configuración y la plataforma (por ejemplo, Release y cualquier CPU).

      Nota:
      Si va a crear una definición de compilación para proyectos web, seleccione Plataformas mixtas.

   4. Haga clic en Siguiente.

      Aparece la página Seleccione las opciones de la compilación.

   5. Indique las opciones de compilación que desea habilitar activando las casillas Ejecutar prueba (p. ej. ejecutar BVT, etc.) y Ejecutar análisis de código, según corresponda. Si activa la casilla Ejecutar prueba (p. ej. ejecutar BVT, etc.), puede utilizar las opciones desplegables para especificar Archivo de metadatos de prueba y Lista de pruebas para ejecutar, según corresponda.

      Para obtener más información, vea Usar listas de pruebas y Escribir código de calidad.

      Nota importante:
      Para ejecutar las pruebas, Test Edition debe estar instalado en el agente de compilación. Para ejecutar el análisis de código, Development Edition debe estar instalado en el agente de compilación.

   6. Haga clic en Finalizar.

      Aparece el panel Archivo de proyecto del cuadro de diálogo Definición de compilación. El archivo TFSBuild.proj que se crea se almacena debajo de $<Proyecto de equipo>\TeamBuild Types\<Nombre de tipo de compilación>\TFSBuild.proj en el control de código fuente.

10. Haga clic en la ficha Directiva de retención.

    1. En la lista Especifique cómo desea retener las compilaciones, puede seleccionar la directiva de retención para las compilaciones con error, detenidas, parcialmente correctas y totalmente correctas.

    2. Seleccione una directiva de retención de la lista desplegable.

       Si selecciona <Especifique el número que desea mantener>, aparece el cuadro de diálogo Número de compilaciones.

    3. En el cuadro de texto Especifique el número de compilaciones que deben retenerse, indique cuántas compilaciones deben mantenerse para el resultado de la compilación especificado.

11. Haga clic en la ficha Valores predeterminados de compilación.

    1. En el panel Valores predeterminados de compilación puede elegir un agente de compilación existente en la lista desplegable Agente de compilación.

    2. Si no existe ningún agente de compilación o desea crear uno nuevo, haga clic en Nuevo.

       Aparece el cuadro de diálogo Propiedades de agente de compilación.

    3. Rellene los cuadros de texto Nombre para mostrar, Descripción y Nombre del equipo, y haga clic en Aceptar.

       Para obtener más información, vea Cómo: Crear y administrar agentes de compilación.

    En el cuadro de texto Las compilaciones se almacenarán en el siguiente recurso compartido (por ejemplo, \\servidor\recurso compartido), escriba la ubicación UNC (\\servidor\recurso compartido). Los archivos binarios generados y los archivos de registro se almacenarán en esta carpeta en cuanto finalice la compilación.

    Nota importante:
    Antes de completar este paso, debe haber creado una carpeta pública en el equipo del agente de compilación en la que la cuenta TFSService tenga todos los permisos. Para obtener más información sobre las cuentas de servicio de Team Foundation, vea Cómo: Ver los servicios de Team Foundation Server.

    Nota:
    Cada generación creada se colocará en un directorio independiente. Deberá asegurarse de que la cuenta con la que está configurado el equipo de compilación dispone de acceso de escritura a esta ubicación UNC.

12. Haga clic en la ficha Desencadenador.

    1. En el panel Desencadenador, active Las protecciones no desencadenan una nueva compilación para generar una compilación solo cuando se solicite.

    2. Active Generar cada protección (más compilaciones) para generar una compilación continuamente cada vez que se proteja un cambio en los archivos que va a generar la definición de compilación.

    3. Active Acumular protecciones hasta que finalice la compilación anterior (menos compilaciones) para crear compilaciones acumuladas.

       Si ha activado la casilla Acumular protecciones hasta que finalice la compilación anterior (menos compilaciones), puede indicar la frecuencia de realización de compilaciones activando la casilla No generar compilaciones con una frecuencia superior a y escribiendo un número en el cuadro de texto minutos. El intervalo válido para el cuadro de texto minutos es de 0 a 2147483647 (Int32 MaxValue).

    4. Seleccione Generar compilación cada semana, los días siguientes para crear compilaciones programadas. Seleccione los días en que desea generar la compilación mediante las casillas que se proporcionan para cada día de la semana. Escriba la hora de compilación en el cuadro de texto Poner la compilación en cola en el agente de compilación predeterminado en.

       Nota:
       Las compilaciones programadas no tendrán lugar si no se ha protegido ningún cambio desde la compilación anterior.

13. Haga clic en Aceptar para crear la definición de compilación una vez especificada toda la información necesaria.

    La definición de compilación creada se muestra en la carpeta Compilaciones de Team Explorer.

14. Para revisar la información almacenada en el servidor de la definición de compilación, haga clic con el botón secundario del mouse en ella en Team Explorer y haga clic en Editar definición de compilación.

    Se muestra el cuadro de diálogo Definición de compilación con la información que ha especificado. También puede cambiar esa información. Para obtener más información, vea Cómo: Editar una definición de compilación.

    Nota importante:
    Si la definición de compilación comparte un archivo TFSBuild.proj con otra compilación, la definición de compilación y los archivos asociados no se muestran en el Explorador de control de código fuente en la ubicación predeterminada (la carpeta TeamBuildTypes). Sólo se muestra la definición de compilación original. También puede almacenar el archivo TFSBuild.proj en otra ubicación.

Para establecer permisos de generación

1. Póngase en contacto con el administrador del equipo de compilación anteriormente seleccionado y determine el nombre de la cuenta en la que se ejecuta el servicio Visual Studio Team Foundation Build.

2. En menú Equipo, seleccione Configuración del proyecto de equipo y, a continuación, seleccione Pertenencia a grupo.

   Aparecerá el cuadro de diálogo Grupos de proyectos.

3. En Grupos de proyectos, en la lista Usuarios y grupos, localice el grupo denominado Build Services y haga clic en Propiedades.

   Se muestra el cuadro de diálogo Propiedades del grupo de Team Foundation Server.

4. Seleccione la ficha Miembros.

   Si el nombre de la cuenta del paso anterior figura en la lista de miembros, el equipo de compilación seleccionado puede crear esta definición de compilación. En caso contrario, siga estos pasos:

5. En la sección Agregar miembro, elija Grupo o usuario de Windows y haga clic en Agregar.

   Aparecerá el cuadro de diálogo Seleccionar usuarios o grupos.

6. En el cuadro de diálogo Seleccionar usuarios o grupos, escriba el nombre de la cuenta que está asociada al servicio Visual Studio Team Foundation Build en el equipo de compilación que se utiliza para esta definición de compilación.

   Nota:
   Si esta definición de compilación se genera en varios agentes de compilación, todas las cuentas del servicio Visual Studio Team Foundation Build se deberán agregar como miembros del grupo 'Build Services' de este proyecto.

7. Configure qué usuarios van a ejecutar las definiciones de compilación; para ello, concédales permiso para iniciar o reanudar una compilación.

Vea también

Tareas

Tutorial: Ejecutar una definición de compilación en Team Foundation Build

Cómo: Configurar e instalar Team Foundation Build

Cómo: Crear una definición de compilación

Cómo: Establecer permisos para el agente de Team Foundation Build

Referencia

Comando start (Team Foundation Build)