Grupos de tareas para compilaciones y versiones (clásico)

Azure DevOps Services | Azure DevOps Server 2022 | Azure DevOps Server 2019

Nota:

Los grupos de tareas no son compatibles con canalizaciones de YAML. En su lugar, en ese caso puede usar plantillas. Consulte Referencia de esquema de YAML.

Un grupo de tareas permite encapsular una secuencia de tareas (ya definidas en una canalización de compilación o versión) en una tarea reutilizable que se puede agregar a cualquier canalización de compilación o versión, como cualquier otra tarea. Puede elegir extraer los parámetros desde las tareas encapsuladas como variables de configuración y abstraer el resto de la información de la tarea.

El grupo de tareas nuevo se agrega automáticamente al catálogo de tareas, listo para agregarse a otras canalizaciones de compilación o versión. Los grupos de tareas se almacenan en el nivel de proyecto y no son accesibles fuera del ámbito del proyecto.

Los grupos de tareas son una manera de estandarizar y administrar de forma centralizada los pasos de implementación de todas las aplicaciones. Cuando se incluye un grupo de tareas en las definiciones y, luego, se realiza un cambio de forma centralizada en el grupo de tareas, el cambio se refleja automáticamente en todas las definiciones que usan el grupo de tareas. No es necesario cambiar cada una individualmente.

Antes de crear un grupo de tareas...

• Asegúrese de que todas las tareas que quiere incluir en un grupo de tareas tienen los parámetros definidos como variables, como $(MyVariable), donde desea poder configurar estos parámetros al usar el grupo de tareas. Las variables usadas en las tareas se extraen y convierten automáticamente en parámetros para el grupo de tareas. Los valores de estas variables de configuración se convertirán en valores predeterminados para el grupo de tareas.

• Si especifica un valor (en lugar de una variable) para un parámetro, se convierte en un valor de parámetro fijo y no se puede exponer como parámetro al grupo de tareas.

• Los parámetros de las tareas encapsuladas para las que especificó un valor (en lugar de una variable), o para los que no proporcionó un valor, no se pueden configurar en el grupo de tareas cuando se agregan a una canalización de compilación o versión.

• Las condiciones de tarea (como "Ejecutar esta tarea solo cuando se ha producido un error en una tarea anterior" para una tarea de script de PowerShell se pueden configurar en un grupo de tareas y estas opciones se conservan con el grupo de tareas.

• Al guardar el grupo de tareas, puede proporcionar un nombre y una descripción para el nuevo y seleccionar una categoría donde quiera que aparezca en el cuadro de diálogo Catálogo de tareas. También puede cambiar los valores predeterminados de cada uno de los parámetros.

• Al poner en cola una compilación o una versión, las tareas encapsuladas se extraen y los valores especificados para los parámetros del grupo de tareas se aplican a las tareas.

• Los cambios realizados en un grupo de tareas se reflejan en cada instancia.

Creación de un grupo de tareas

1. Asegúrese de que todas las tareas que quiere incluir no contienen ningún parámetro vinculado. La manera más fácil de hacerlo es elegir Desvincular todo en el panel de configuración para todo el proceso.

   

2. Seleccione una secuencia de tareas en una canalización de compilación o versión, abra el menú contextual y seleccione Crear grupo de tareas.

   

3. Especifique un nombre y una descripción para el nuevo grupo de tareas y la categoría (pestaña en el panel Agregar tareas) a la que desea agregarlo.

4. Después de seleccionar Crear, se crea el nuevo grupo de tareas y reemplaza las tareas seleccionadas en la canalización.

5. Todas las "$(vars)" de las tareas subyacentes, excepto las variables predefinidas, se mostrarán como parámetros obligatorios para el grupo de tareas recién creado.

   Por ejemplo, supongamos que tiene una entrada de tarea $(foobar), que no pretende parametrizar. Sin embargo, al crear un grupo de tareas, la entrada de la tarea se convierte en el parámetro de grupo de tareas "foobar". Puede proporcionar el valor predeterminado para el parámetro del grupo de tareas "foobar" como $(foobar). Esto garantiza que, en tiempo de ejecución, la tarea expandida obtiene la misma entrada a la que está destinado.

6. Guarde la canalización actualizada.

Administrar grupos de tareas

Todos los grupos de tareas que cree en el proyecto actual aparecen en la página Grupos de tareas de Azure Pipelines.

Use el comando de acceso directo Exportar para guardar una copia del grupo de tareas como canalización JSON y el icono Importar para importar definiciones de grupo de tareas guardadas anteriormente. Use esta característica para transferir grupos de tareas entre proyectos y empresas, o bien replicar y guardar copias de los grupos de tareas.

Seleccione un nombre de grupo de tareas para abrir la página de detalles.

• En la página Tareas puede editar las tareas que componen el grupo de tareas. Para cada tarea encapsulada, puede cambiar los valores de parámetro de los que no son variables, editar las variables existentes o convertir los valores de parámetro a y desde variables. Al guardar los cambios, todas las definiciones que usan este grupo de tareas recogerán los cambios.

Todos los parámetros variables del grupo de tareas se mostrarán como parámetros obligatorios en la definición de canalización. También puede establecer el valor predeterminado para los parámetros del grupo de tareas.

• En la pestaña Historial, puede ver el historial de cambios en el grupo.

• En la pestaña Referencias, puede expandir listas de todas las canalizaciones de compilación y versión, y otros grupos de tareas, que usan (referencia) este grupo de tareas. Esto resulta útil para garantizar que los cambios no tengan efectos inesperados en otros procesos.

Creación de versiones preliminares y versiones actualizadas de grupos de tareas

Todas las tareas integradas en Azure Pipelines y TFS tienen versiones. Esto permite que las canalizaciones de compilación y versión sigan usando la versión existente de una tarea mientras se desarrollan, prueban y publican nuevas versiones. En Azure Pipelines, puede crear versiones de sus propios grupos de tareas personalizados para que se comporten de la misma manera y proporcionar las mismas ventajas.

1. Después de terminar de editar un grupo de tareas, seleccione Guardar como borrador en lugar de Guardar.

   

2. La cadena -test se anexa al número de versión del grupo de tareas. Cuando esté satisfecho con los cambios, seleccione Publicar borrador. Puede elegir si desea publicarlo como versión preliminar o como una versión preparada para producción.

   

3. Ahora puede usar el grupo de tareas actualizado en los procesos de compilación y versión; ya sea cambiando el número de versión del grupo de tareas en una canalización existente o agregándolo desde el panel Agregar tareas .

   

   Al igual que con las tareas integradas, el valor predeterminado al agregar un grupo de tareas es la versión sin versión preliminar más alta.

4. Una vez haya terminado de probar el grupo de tareas actualizado, elija Publicar versión preliminar. La cadena Versión preliminar se quita de la cadena de número de versión. Ahora aparecerá en las definiciones como una versión "lista para producción".

   

5. En una canalización de compilación o versión que ya contiene este grupo de tareas, ahora puede seleccionar la nueva versión "lista para producción". Al agregar el grupo de tareas desde el panel Agregar tareas, selecciona automáticamente la nueva versión "lista para producción".

   

Trabajar con versiones de grupo de tareas

Cualquier actualización del grupo de tareas puede ser una actualización de versión secundaria o principal.

Versión secundaria

Acción: guarda directamente el grupo de tareas después de editarlo en lugar de guardarlo como borrador.

Efecto: el número de versión no cambia. Supongamos que tiene un grupo de tareas de la versión 1.0. Puede tener cualquier número de actualizaciones de versiones secundarias, es decir 1.1, 1.2, 1.3, etc. En la canalización, la versión del grupo de tareas se muestra como 1.* Los cambios más recientes se mostrarán automáticamente en la definición de canalización.

Motivo: se supone que se trata de un pequeño cambio en el grupo de tareas y espera que las canalizaciones usen este nuevo cambio sin editar la versión en la definición de canalización.

Versión principal

Acción: guarda el grupo de tareas como borrador y, a continuación, crea una versión preliminar, valida el grupo de tareas y, a continuación, publica la versión preliminar como una versión principal.

Efecto: el grupo de tareas aumenta a una nueva versión. Supongamos que tiene un grupo de tareas de la versión 1.*. Una nueva versión se publica como 2.*, 3.*, 4.*, etc. Además, se muestra una notificación sobre la disponibilidad de la nueva versión en todas las definiciones de canalización en las que se usa este grupo de tareas. El usuario tiene que actualizar explícitamente a la nueva versión del grupo de tareas en las canalizaciones.

Motivo: tiene un cambio sustancial que podría interrumpir las canalizaciones existentes, le gustaría probarlo y implementarlo como una nueva versión. Los usuarios pueden optar por actualizar a una nueva versión o elegir permanecer en la misma. Esta funcionalidad es la misma que una actualización normal de la versión de la tarea.

Sin embargo, si la actualización del grupo de tareas no es un cambio importante, pero le gustaría validar primero y, a continuación, aplicar canalizaciones para consumir los cambios más recientes, puede seguir los siguientes pasos.

1. Actualice el grupo de tareas con los cambios deseados y guárdelo como borrador. Se creará un nuevo grupo de tareas de borrador "<Taskgroupname>-Draft", que contiene los cambios que ha realizado. Y este grupo de tareas de borrador es accesible para que lo consuma en las canalizaciones.
2. Ahora, en lugar de publicar como versión preliminar, puede consumir directamente este grupo de tareas de borrador en la canalización de prueba.
3. Valide este nuevo grupo de tareas de borrador en la canalización de prueba y, una vez que esté seguro, vuelva al grupo de tareas principal y realice los mismos cambios y guárdelo directamente. Esto se tomará como actualización de la versión secundaria.
4. Los nuevos cambios se mostrarán ahora en todas las canalizaciones en las que se usa este grupo de tareas.
5. Ahora puede eliminar el grupo de tareas de borrador.

Temas relacionados

• Tareas
• Trabajos de tarea

Ayuda y soporte técnico

• Busque y consulte sugerencias para la resolución de problemas.
• Vea consejos sobre Stack Overflow.
• Publique sus preguntas, busque respuestas o sugiera una característica en la Comunidad de desarrolladores de Azure DevOps.
• Reciba soporte técnico para Azure DevOps.