Referencia de tareas de Azure Pipelines

Una tarea realiza una acción en una canalización. Por ejemplo, una tarea puede compilar una aplicación, interactuar con los recursos de Azure, instalar una herramienta o ejecutar una prueba. Las tareas son los bloques de creación para definir la automatización en una canalización.

Los artículos de esta sección describen las tareas integradas para Azure Pipelines y especifican la semántica de los atributos que contienen un significado especial para cada tarea.

Consulte la referencia de yaML de para steps.task para obtener más información sobre los atributos generales admitidos por las tareas.

Para ver tutoriales y procedimientos sobre la creación de canalizaciones mediante tareas, incluida la creación de tareas personalizadas, extensiones personalizadas y la búsqueda de tareas en Visual Studio Marketplace, consulte Conceptos de tareas y documentación de Azure Pipelines.

Código abierto

Estas tareas son de código abierto en GitHub. Comentarios y contribuciones son bienvenidos. Consulte registro de cambios de tareas de canalización para obtener una lista de cambios de tareas, incluido un registro histórico de actualizaciones de tareas.

Preguntas más frecuentes

¿Qué son los alias de entrada de tareas?

Las entradas de una tarea se identifican mediante una label, namey pueden incluir una o varias aliasesopcionales. El ejemplo siguiente es un extracto del código fuente de para la entrada Entrada de hosts conocidos de de la tarea InstallSSHKey@0.

{
    "name": "hostName",
    "aliases": [
        "knownHostsEntry"
    ],
    "label": "Known Hosts Entry"
    ...
}

Antes de que las canalizaciones yaML se introdujeran en 2019, las canalizaciones se crearon y editaron mediante un editor de canalizaciones basado en la interfaz de usuario, y solo los autores de canalizaciones usaron la label para hacer referencia a una entrada de tarea.

Cuando las canalizaciones de YAML se introdujeron en 2019, los autores de canalizaciones que usan YAML comenzaron a usar la entrada de tarea name para hacer referencia a una entrada de tarea. En algunos casos, los nombres de entrada de la tarea no eran descriptivos, por lo que aliases se agregaron para proporcionar nombres descriptivos adicionales para las entradas de tarea.

Por ejemplo, la tarea InstallSSHKey@0 tiene un entrada de entrada de hosts conocidos denominada hostName que espera una entrada de un archivo known_hosts. La etiqueta Entrada de hosts conocidos en el diseñador de canalizaciones clásicas lo hace claro, pero no es tan claro cuando se usa el nombre de hostName en una canalización YAML. Los alias de entrada de tareas se introdujeron para permitir que los autores de tareas proporcionen nombres de descriptivos para sus tareas creadas anteriormente y para la tarea de InstallSSHKey@0, se agregó un alias de knownHostsEntry, al tiempo que se mantiene el nombre del hostName original para la compatibilidad con las canalizaciones existentes con ese nombre.

Los elementos de la aliases de una entrada de tarea son intercambiables con el name en una canalización YAML. Los dos fragmentos de código YAML siguientes son funcionalmente idénticos, con el primer ejemplo mediante el alias de knownHostsEntry y el segundo ejemplo mediante hostName.

- task: InstallSSHKey@0
  inputs:
    # Using knownHostsEntry alias
    knownHostsEntry: 'sample known hosts entry line'
    # Remainder of task inputs omitted

- task: InstallSSHKey@0
  inputs:
    # Using hostName name
    hostName: 'sample known hosts entry line'
    # Remainder of task inputs omitted

A partir de Azure DevOps Server 2019.1, el editor de canalizaciones de YAML de se introdujo, que proporciona una funcionalidad de tipo intellisense.

El editor de canalizaciones de YAML usa el Yamlschema - Get API REST para recuperar el esquema usado para la validación en el editor. Si una entrada de tarea tiene un alias, el esquema promueve el alias al nombre de YAML principal para la entrada de tarea y el alias lo sugiere intellisense.

En el ejemplo siguiente se muestra la entrada de la tarea entrada de hosts conocidos para la tarea del esquema YAML, con enumerados en la posición de nombre y de la colección .

"properties": {
    "knownHostsEntry": {
      "type": "string",
      "description": "Known Hosts Entry",
      "ignoreCase": "key",
      "aliases": [
        "hostName"
      ]
    },

Dado que intellisense en el editor de canalizaciones de YAML muestra knownHostsEntryy yaml generado por el asistente de tareas usa knownHostsEntry en el YAML generado, la referencia de tarea muestra el alias desde el código fuente de la tarea como el nombre YAML para una entrada de tarea. Si una tarea tiene más de un alias (hay algunos que tienen dos alias), el primer alias se usa como nombre.

¿Por qué cambió la referencia de la tarea?

La documentación de referencia de tareas de Azure Pipelines se ha movido a su ubicación actual para admitir las siguientes mejoras.

• Los artículos de tareas se generan mediante el código fuente de la tarea desde repositorio de código abierto de tareas de Azure Pipelines.
• Los nombres y alias de entrada de tareas se generan a partir del origen de la tarea, por lo que siempre están actualizados.
• Los bloques de sintaxis de YAML se generan a partir del origen de la tarea para que estén actualizados.
• Admite contribuciones de la comunidad con contenido de usuario integrado, como descripciones de entrada de tareas mejoradas, comentarios y ejemplos.
• Proporciona cobertura de tareas para todas las versiones de Azure DevOps admitidas.
• Se han actualizado todos los sprints para cubrir las actualizaciones más recientes.

Para contribuir, consulte Contribución al contenido de tareas.

¿Dónde puedo aprender paso a paso cómo compilar mi aplicación?

Compilación de la aplicación

¿Puedo agregar mis propias tareas de compilación?

Sí: Agregar una tarea de compilación

¿Qué son las tareas del instalador?

Para obtener más información sobre las tareas del instalador de herramientas, consulte Instaladores de herramientas.