Compartir vía


Editor de canalizaciones de YAML

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

Azure Pipelines proporciona un editor de canalizaciones YAML que puede usar para crear y editar las canalizaciones. El editor de YAML se basa en el editor de Monaco. El editor proporciona herramientas como compatibilidad con IntelliSense y un asistente de tareas para que le guíe al editar una canalización.

En este artículo se muestra cómo editar las canalizaciones mediante el editor de canalizaciones de YAML, pero también puede editar canalizaciones modificando el archivo azure-pipelines.yml directamente en el repositorio de la canalización mediante un editor de texto de su elección, o mediante una herramienta como Visual Studio Code y la extensión Azure Pipelines para VS Code.

Importante

El editor de canalizaciones de YAML se introdujo en Azure DevOps Server 2019 Update 1. Si usa Azure DevOps Server 2019 RTW, el editor de canalizaciones de YAML que se describe en este artículo no está disponible, pero puede editar el archivo YAML con el editor de texto que prefiera e insertarlo en el repositorio de la canalización.

Edición de una canalización YAML

Para acceder al editor de canalizaciones de YAML, siga estos pasos.

  1. Inicie sesión en una organización (https://dev.azure.com/{yourorganization}).

  2. Seleccione el proyecto, elija Canalizaciones>Canalizaciones y, a continuación, seleccione la canalización que desea editar.

    Compilaciones de Azure Pipelines en Azure DevOps Server 2019 Update 1.

  3. Elija Editar.

    Botón de edición de YAML de Azure Pipelines en Azure DevOps Server 2019 Update 1.

  4. Realice modificaciones en la canalización con los métodos abreviados de teclado de IntelliSense y el asistente de tareas para instrucciones.

    Editor de canalizaciones de YAML en Azure DevOps Server 2019.1.

Para acceder al editor de canalizaciones de YAML, siga estos pasos.

  1. Inicie sesión en una organización (https://dev.azure.com/{yourorganization}).

  2. Seleccione el proyecto, elija Canalizaciones y, luego, seleccione la canalización que desea editar. Puede examinar las canalizaciones según los criterios Recientes, Todas y Ejecuciones. Para más información, consulte Visualización y administración de las canalizaciones.

    Página de aterrizaje de Azure Pipelines.

  3. Elija Editar.

    Botón de edición de YAML de Azure Pipelines.

  4. Realice modificaciones en la canalización con IntelliSense y el asistente de tareas para instrucciones.

    Editor de canalizaciones de YAML.

  1. Elija Guardar. Puede confirmar directamente en la rama o crear una nueva y, si lo desea, iniciar una solicitud de incorporación de cambios.

    Ventana de guardado del editor de canalizaciones de YAML.

  1. Seleccione Validar y guardar. Puede confirmar directamente en la rama o crear una nueva y, si lo desea, iniciar una solicitud de incorporación de cambios.

    Captura de pantalla que muestra el editor de canalizaciones de YAML validando y guardando la ventana.

Uso de métodos abreviados de teclado

El editor de canalizaciones de YAML proporciona varios métodos abreviados de teclado, los que puede ver en los ejemplos siguientes.

  • Elija Ctrl+Espacio para la compatibilidad con IntelliSense mientras edita la canalización YAML.

    IntelliSense del editor de canalizaciones de YAML.

  • Elija F1 (Fn+F1 en Mac) para mostrar la paleta de comandos y ver los métodos abreviados de teclado disponibles.

    Paleta de comandos del editor de canalizaciones de YAML.

Uso del asistente de tareas

El asistente de tareas proporciona un método para agregar tareas a la canalización YAML.

  • Para mostrar el asistente de tareas, edite la canalización YAML y elija Mostrar asistente.

    Muestre el asistente de solicitud para editar canalizaciones YAML.

  • Para ocultar el asistente de tareas, elija Ocultar asistente.

    Oculte el asistente de tareas para editar canalizaciones YAML.

  • Para usar el asistente de tareas, examine o busque tareas en el panel Tareas.

    Búsqueda del asistente de tareas.

  • Seleccione la tarea deseada y configure sus entradas.

    Incorporación del asistente de tareas.

  • Elija Agregar para insertar el documento YAML de la tarea en la canalización.

Se agregó el asistente de tareas en Azure DevOps Server 2019.

  • Edite el documento YAML que se insertó para realizar más cambios de configuración en la tarea.

Se agregó el asistente de tareas.

  • Puede editar el documento YAML para realizar más cambios de configuración en la tarea, o bien elegir Configuración encima de la tarea en el editor de canalizaciones de YAML para configurar la tarea insertada en el asistente de tareas.

Validación

Valide los cambios para detectar los errores de sintaxis en la canalización que impiden que se inicie. Elija Más acciones>Validar.

Valide y descargue el documento YAML completo.

Azure Pipelines valida sus canalizaciones cada vez que guarda. Seleccione Validar y guardar para validar su canalización antes de guardarla. Si hay algún error, puede Cancelar o Guardar de todos modos. Para guardar su canalización sin validarla, seleccione Guardar sin validar.

Captura de pantalla que muestra el botón Validar y guardar.

Azure Pipelines detecta definiciones de variables incorrectas definidas en el nivel de canalización, fase y trabajo y detecta condiciones YAML incorrectas definidas en el nivel de canalización, fase y trabajo.

Descarga del documento YAML completo

Puede obtener una vista previa del documento YAML completamente analizado sin confirmar ni ejecutar la canalización. Elija Más acciones>Descargar documento YAML completo.

Valide y descargue el documento YAML completo.

Descargue YAML completo Ejecuta la API REST de Azure DevOps para Azure Pipelines e inicia una descarga de YAML representado desde el editor.

Administración de variables de canalización

Puede administrar variables de canalización desde la canalización YAML y desde la interfaz de usuario de configuración de canalizaciones.

Con Azure DevOps 2019 Update 1, puede administrar las variables de canalización mediante la interfaz de usuario de configuración de canalizaciones.

Para administrar las variables de canalización, siga estos pasos.

  1. Edite la canalización YAML y elija Variables para administrar las variables de canalización.

    Botón Administrar variables de canalización.

  2. Elija entre las funciones siguientes:

    • Nueva variable: para agregar la primera variable.
    • Agregar : para agregar variables posteriores.
    • Nombre de variable: para editar una variable.
    • Delete : para eliminar una variable.

    Administre variables de canalización en el editor de YAML.

Para administrar variables de canalizaciones en la interfaz de usuario de configuración de canalización, siga estos pasos.

  1. Edite la canalización y elija Más acciones>Desencadenadores.

    Menú de la interfaz de usuario de la configuración de canalizaciones.

  2. Elija Variables.

    Interfaz de usuario de configuración de canalizaciones para las variables.

Para más información sobre cómo trabajar con variables de canalización, consulte Definición de variables.

Configuración del grupo de agentes predeterminado

Si una canalización YAML no especifica un grupo de agentes, se usa el grupo de agentes configurado en la opción Grupo de agentes predeterminado de YAML. Este grupo también se usa en las tareas de limpieza posteriores a la ejecución.

Para ver y configurar la opción Grupo de agentes predeterminado de YAML:

  1. Edite la canalización y elija Más acciones>Desencadenadores.

    Captura de pantalla del menú de la interfaz de usuario de configuración de canalización.

  2. Elija YAML y seleccione el grupo de agentes deseado en la lista desplegable Grupo de agentes predeterminado de YAML.

    Captura de pantalla del grupo de agentes predeterminado para canalizaciones YAML.

El Grupo de agentes predeterminado de YAML se configura por canalización.

Administración de la configuración mediante la interfaz de usuario de configuración de canalización

Algunas opciones de canalización de YAML se configuran mediante la interfaz de usuario de configuración de canalización en lugar del archivo YAML.

  1. Edite la canalización y elija Más acciones>Desencadenadores.

    Captura de pantalla del menú de la interfaz de usuario de configuración de canalización.

  2. En la interfaz de usuario de configuración de canalización, elija la pestaña de la configuración que se va a configurar.

    Captura de pantalla de la interfaz de usuario de configuración de canalización para desencadenadores.

Visualización y edición de plantillas

Nota:

Esta característica está disponible a partir de Azure DevOps Server 2022.1.

Las plantillas son una característica que se usa habitualmente en las canalizaciones YAML. Son una manera fácil de compartir fragmentos de código de canalizaciones y resultan un mecanismo eficaz para comprobar y aplicar la seguridad y gobernanza en la canalización. Anteriormente, el editor no admitía plantillas, por lo que los autores de canalizaciones YAML no podían obtener ayuda de IntelliSense. Ahora, Azure Pipelines admite un editor de YAML, cuya compatibilidad está en versión preliminar. Para habilitar esta versión preliminar, vaya a características en vista previa (GB) en la organización de Azure DevOps y habilite el editor de plantillas de YAML.

Importante

Esta característica tiene las siguientes limitaciones.

  • Si la plantilla tiene parámetros necesarios que no se proporcionan como entradas en el archivo YAML principal, se produce un error en la validación y se le pide que proporcione esas entradas.

  • No puede crear una nueva plantilla desde el editor. Solo puede usar o editar plantillas existentes.

A medida que edita el archivo YAML principal de Azure Pipelines, puede incluir o extender una plantilla. Al escribir el nombre de la plantilla, es posible que se le pida que valide la plantilla. Una vez que realice la validación, el editor de YAML entiende el esquema de la plantilla, incluidos los parámetros de entrada.

Plantilla de YAML.

Después de la validación, puede ir a la plantilla si elige la opción Ver plantilla, que abre la plantilla en una pestaña nueva del explorador. Puede usar todas las características del editor de YAML para hacer cambios en la plantilla.

Pasos siguientes