Editor de canalizaciones de YAML

Azure Pipelines proporciona un editor de canalizaciones yaml basado en el Editor DeCodas que puede usar para crear y editar las canalizaciones desde Azure DevOps portal. El editor proporciona herramientas como la compatibilidad con IntelliSense y un asistente de tareas para proporcionar instrucciones al editar una canalización.

Importante

El editor de canalizaciones de YAML se introdujo en Azure DevOps Server Update 1 de 2019. 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 yaml con el editor de texto que prefiera y comprobarlo en el repositorio de la canalización.

Edición de una canalización de YAML

Para acceder al editor de canalizaciones de YAML, elija Pipelines, Compilacionesy seleccione la canalización que desea editar.

Azure Pipelines compilaciones en Azure DevOps Server 2019 Update 1.

Elija Editar para editar la canalización en el editor de canalizaciones de YAML.

Azure Pipelines editar YAML en Azure DevOps Server Actualización 1 de 2019.

Edite la canalización mediante métodos abreviados de teclado de Intellisense y el asistente de tareas para obtener instrucciones.

Editor de canalizaciones de YAML Azure DevOps Server 2019.1.

Para acceder al editor de canalizaciones de YAML, elija Pipelines y seleccione la canalización que desea editar. Puede examinar canalizaciones por Recent, Ally Runs. Para obtener más información, vea Pipelines de aterrizaje.

Azure Pipelines de aterrizaje.

Elija Editar para editar la canalización en el editor de canalizaciones de YAML.

Azure Pipelines de edición de YAML.

Edite la canalización mediante IntelliSense y el asistente de tareas para obtener instrucciones.

Editor de canalizaciones de YAML.

Elija Guardar para guardar la canalización. Puede confirmar directamente en la rama o crear una nueva rama y, opcionalmente, iniciar una solicitud de extracción.

Ventana de guardado del editor de canalizaciones de YAML.

Métodos abreviados de teclado

El editor de canalizaciones de YAML proporciona varios tipos de métodos abreviados de teclado.

Presione Ctrl+Espacio para obtener compatibilidad con IntelliSense mientras edita la canalización de YAML.

IntelliSense del editor de canalizaciones de YAML.

Presione 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.

Asistente de tareas

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

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

Mostrar el asistente de preguntas para editar canalizaciones de YAML.

Para ocultar el asistente de tareas, elija Ocultar asistente.

Ocultar el asistente de tareas para editar canalizaciones de YAML.

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

Búsqueda del asistente de tareas.

Seleccione la tarea deseada y configure sus entradas.

Agregar asistente de tareas.

Elija Agregar para insertar la tarea YAML en la canalización.

Asistente de tareas agregado en Azure DevOps Server 2019.

Edite el YAML insertado para realizar cambios de configuración adicionales en la tarea.

Asistente para tareas agregado.

Puede editar el YAML para realizar cambios de configuración adicionales en la tarea, o bien puede 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

Al editar una canalización de YAML, puede validar los cambios si elige Más acciones, Validar. Puede usar esta característica para detectar errores de sintaxis en la canalización que impedirán que se inicie.

Valide y descargue YAML completo.

Descarga de YAML completo

Puede obtener una vista previa del documento YAML totalmente analizada sin confirmar ni ejecutar la canalización si elige Más acciones ,Descargar YAML completo.

Valide y descargue YAML completo.

Download full YAML calls the Runs Azure DevOps REST API for Azure Pipelines e inicia una descarga del YAML representado desde el editor.

Administración de variables de canalización

Use variables para almacenar valores o secretos cifrados por separado del repositorio.

Para administrar variables de canalización, edite la canalización de YAML y elija Variables.

Botón Administrar variables de canalización.

Elija Nueva variable para agregar la primera variable y Agregar para agregar variables posteriores. Elija el nombre de la variable para editar la variable, mantenga el mouse sobre la variable y elija Eliminar para eliminar una variable.

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

Además de administrar las variables directamente desde el editor de canalizaciones de YAML, también puede administrarlas en la interfaz de usuario de configuración de canalización.

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

Para administrar variables de canalización de YAML en la interfaz de usuario de configuración de canalización, edite la canalización y elija Más acciones, Desencadenadores.

Menú de interfaz de usuario de configuración de canalización.

Elija Variables para administrar las variables de canalización.

Interfaz de usuario de configuración de canalización para variables.

Para obtener más información sobre cómo trabajar con variables de canalización, vea Definir variables.

Visualización y edición de plantillas

Las plantillas son una característica que se usa habitualmente en las canalizaciones de YAML. Son una manera sencilla de compartir fragmentos de código de canalización. También son un mecanismo eficaz para comprobar o aplicar la seguridad y la gobernanza a través de la canalización.

Azure Pipelines admite un editor YAML que puede ser útil al editar la canalización. Anteriormente, el editor no era compatible con las plantillas. Los autores de canalizaciones de YAML no pudieron obtener asistencia de IntelliSense al usar una plantilla. Con esta versión, vamos a obtener una vista previa de la compatibilidad con plantillas en el editor de YAML. Para habilitar esta versión preliminar, vaya a las características en versión preliminar de Azure DevOps organización y habilite el editor de plantillas de YAML.

A medida que edita la Azure Pipelines archivo YAML, puede incluir o ampliar una plantilla. A medida que escribe el nombre de la plantilla, es posible que se le pida que valide la plantilla. Una vez validado, el editor de YAML comprende el esquema de la plantilla, incluidos los parámetros de entrada.

Plantilla de YAML.

Después de la validación, puede navegar a la plantilla eligiendo Ver plantilla, que abre la plantilla en una nueva pestaña del explorador. Podrá realizar cambios en la plantilla con todas las características del editor de YAML.

Importante

Esta característica se encuentra en su versión preliminar. Existen limitaciones conocidas. 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. Además, no puede crear una plantilla nueva desde el editor. Solo puede usar o editar plantillas existentes.

Pasos siguientes