Poner en cola una compilación

Después crear una o varias definiciones de compilación para definir los procesos de compilación, puede empezar a cosechar las ventajas del sistema de compilación. La mayoría de los procesos de compilación se definen con desencadenadores automáticos. Para obtener más información, vea Especificar desencadenadores y razones de compilación.

Si la definición de compilación tiene un desencadenador manual o automático, puede poner en cola manualmente una compilación siempre que sea necesario.

Tareas comunes

Contenido adicional

Ponga en cola una compilación pública si desea compilar la versión más reciente del código fuente en el servidor de control de versiones.

Para poner en cola una compilación pública en un símbolo del sistema, use el comando TFSBuild start.

Ponga en cola una compilación privada si desea compilar los cambios que ha colocado en un conjunto de cambios aplazados. Puede usar una compilación privada (también conocida como "compilación relacionada") para validar los cambios en el código antes de protegerlos.

Para poner en cola una compilación privada en un símbolo del sistema, use el comando TFSBuild start con la opción /shelveset.

Compilaciones públicas

Independientemente de que se especifique un desencadenador automático en una definición de compilación, la compilación se puede poner en cola manualmente.

Permisos necesarios

Para realizar este procedimiento, el permiso Poner compilaciones en cola debe estar establecido en Permitir. Para obtener más información, vea Permisos de Team Foundation Server.

Para poner en cola una compilación pública desde Visual Studio

  1. En Team Explorer, haga clic en el proyecto de equipo adecuado.

  2. En el menú Compilación, haga clic en Poner nueva compilación en cola.

    Aparece el cuadro de diálogo Poner en cola compilación NombreProyectoEquipo.

  3. En la lista Definición de compilación, seleccione una definición de compilación.

    Si la definición de compilación seleccionada incluye una descripción, esta se muestra debajo del cuadro Definición de compilación.

  4. En la lista de ¿Qué desea compilar?, deje seleccionado Orígenes más recientes.

  5. (Opcional) En la lista Controlador de compilación, seleccione un controlador de compilación distinto del controlador de compilación predeterminado.

  6. (Opcional) En la lista Prioridad en cola, seleccione uno de los siguientes valores: Alta, Por encima de lo normal, Normal, Por debajo de lo normal o Baja.

    El cuadro Posición muestra la posición calculada de la compilación en la cola.

  7. (Opcional) El cuadro Carpeta de entrega para esta compilación muestra la carpeta donde se almacenan los resultados como binarios cuando se completa la compilación. Si desea almacenar el resultado en una ubicación diferente, escriba la ruta de acceso de convención de nomenclatura universal (UNC) a esa ubicación en este cuadro.

    Nota importanteImportante

    Si modifica este valor, debe especificar una carpeta que se haya preparado para usarla como carpeta de entrega. Para obtener más información, vea Configurar carpetas de entrega.

  8. (Opcional) En la pestaña Parámetros, visualice e invalide otras configuraciones de la definición de compilación solo para esta ejecución.

    Si la definición de compilación se basa en la plantilla predeterminada o en la plantilla de actualización, vea Define Workflow Builds Using the Default Template o Usar compilaciones de MSBuild heredadas mediante la plantilla de actualización para obtener más información sobre estos parámetros.

  9. Haga clic en Cola.

    El Explorador de compilaciones muestra la pestaña Puesta en cola. Para obtener más información, vea Administrar y ver compilaciones completadas.

Compilaciones privadas

Una compilación privada se pone en cola cuando se desea compilar los cambios colocados en un conjunto de cambios aplazados. Puede usar una compilación privada (también conocida como "compilación relacionada") para validar los cambios en el código antes de protegerlos. Al realizar una compilación privada de los cambios antes de protegerlos, puede reducir la probabilidad de que interrumpan cualquier compilación que el equipo ejecute con regularidad (por ejemplo, la compilación nocturna).

Diferencias entre las compilaciones privadas y las compilaciones públicas

Los resultados de una compilación privada completada difieren de los de una compilación pública completada en lo siguiente:

  • Una compilación privada se asemeja a una compilación de entrada validada en que el código que se compila incluye los cambios en un conjunto de cambios aplazados. Sin embargo, los cambios no se protegen automáticamente después de una compilación privada mientras que sí se guardan después de una compilación de entrada validada.

  • Se supone que los siguientes parámetros del proceso de compilación son False y, por lo tanto, no tienen ningún efecto, independientemente de la configuración especificada en la definición de compilación:

    • Etiquetar orígenes

    • Crear elemento de trabajo tras error

    • Conjuntos de cambios y elementos de trabajo asociados

  • En el Explorador de compilaciones, la compilación completada aparece junto al icono siguiente: ms181722.Icon_BldPrivateBuild(es-es,VS.100).gif

  • A la compilación completada se le asigna un nombre con el formato Build N donde N es un valor entero único. Este formato es diferente al de las compilaciones públicas, que se especifica mediante el parámetro Formato del número de compilación.

  • En cada definición de compilación, especifique una directiva de retención independiente (y opcionalmente distinta) para limitar el número de compilaciones privadas completadas que se almacenan en el sistema.

Poner en cola una compilación privada

Permisos necesarios

Para realizar este procedimiento, el permiso Poner compilaciones en cola debe estar establecido en Permitir. Para obtener más información, vea Permisos de Team Foundation Server.

Para poner en cola una compilación privada desde Visual Studio

  1. En Team Explorer, haga clic en el proyecto de equipo adecuado.

  2. En el menú Compilación, haga clic en Poner nueva compilación en cola.

    Aparece el cuadro de diálogo Poner en cola compilación NombreProyectoEquipo.

  3. En la lista Definición de compilación, seleccione una definición de compilación.

    Si la definición de compilación seleccionada incluye una descripción, esta se muestra debajo del cuadro Definición de compilación.

  4. En la lista ¿Qué desea compilar?, seleccione Orígenes más recientes con conjunto de cambios aplazados.

    Aparece el cuadro Nombre del conjunto de cambios aplazados.

  5. Realice uno de estos pasos:

    • Si ya tiene un conjunto de cambios aplazados, escriba su nombre en el cuadro Nombre del conjunto de cambios aplazados o haga clic en el botón de puntos suspensivos (...) para buscar el conjunto de cambios aplazados.

    • Si desea incluir algunos cambios pendientes de su área de trabajo en un conjunto de cambios aplazados para compilarlos a continuación, haga clic en Crear.

  6. (Opcional) Cuando desee proteger los cambios en el conjunto de cambios aplazados si la compilación es correcta, active la casilla Proteger los cambios tras una compilación correcta.

    Nota importanteImportante

    Si activa esta casilla, la compilación se ejecuta como una compilación de entrada validada, no como una compilación privada. Para obtener más información sobre las compilaciones de entrada validada, vea Definir una compilación de entrada validad para validar los cambios.

  7. (Opcional) En la lista Controlador de compilación, seleccione un controlador de compilación distinto del controlador de compilación predeterminado.

  8. (Opcional) En la lista Prioridad en cola, seleccione uno de los siguientes valores: Alta, Por encima de lo normal, Normal, Por debajo de lo normal o Baja.

    El cuadro Posición muestra la posición calculada de la compilación en la cola.

  9. (Opcional) Realice los pasos siguientes para especificar la carpeta donde se descargarán los resultados de la compilación, como, por ejemplo, los binarios:

    Nota

    Omita el cuadro Carpeta de entrega para esta compilación porque no tiene ningún efecto en una compilación privada.

    1. Haga clic en la pestaña Parámetros y, a continuación, expanda el grupo Avanzadas.

    2. En el cuadro Ubicación de destino privada, escriba la ruta UNC a la carpeta en la que desea almacenar los resultados cuando se complete la compilación.

      Nota

      • Si no especifica esta carpeta, la compilación no producirá un error, pero aparecerá una advertencia en el registro de compilación.

      • Si modifica este valor, debe especificar una carpeta que se haya preparado para usarla como carpeta de entrega. Para obtener más información, vea Configurar carpetas de entrega.

  10. (Opcional) En la pestaña Parámetros, visualice e invalide otras configuraciones de la definición de compilación solo para esta ejecución.

    Si la definición de compilación se basa en la plantilla predeterminada o en la plantilla de actualización, vea Define Workflow Builds Using the Default Template o Usar compilaciones de MSBuild heredadas mediante la plantilla de actualización para obtener más información sobre estos parámetros.

  11. Haga clic en Cola.

    El Explorador de compilaciones muestra la pestaña Puesta en cola. Para obtener más información, vea Administrar y ver compilaciones completadas.

Vea también

Tareas

Crear una definición de compilación básica

Conceptos

Definir una compilación con la plantilla predeterminada

Trabajar con conjuntos de cambios aplazados

Definir una compilación de entrada validad para validar los cambios