Compartir vía

Migración de la canalización clásica a YAML

  • Artículo

Azure DevOps Services

Para comenzar con Azure Pipelines, convierta la canalización clásica existente para usar YAML. Con una canalización basada en YAML, puede implementar la estrategia de CI/CD como código y ver su historial, comparar versiones, culpar, anotar, etc.

Al convertir la canalización clásica, el producto final son dos canalizaciones. Tendrá una nueva canalización YAML y una canalización clásica que se puede retirar. El historial de ejecución de la canalización clásica permanece en la canalización clásica.

Requisitos previos

Asegúrese de que dispone de los siguientes elementos antes de empezar.

  • Una cuenta de Azure con una suscripción activa. Cree una cuenta gratuita.
  • Una organización activa de Azure DevOps. Suscribirse a Azure Pipelines.
  • Una canalización de trabajo que usa el editor de la interfaz de usuario (UI) clásica.
  • Un archivo de canalización YAML de ejemplo en el código. Cree una canalización YAML de ejemplo en la sección siguiente.

Creación de una canalización YAML de ejemplo

Siga estos pasos para crear una canalización YAML de ejemplo, que actualizará más adelante con el código exportado desde el editor de UI clásica.

  1. Inicie sesión en la organización (https://dev.azure.com/{yourorganization}) y seleccione el proyecto.

  2. Seleccione Canalizaciones y, luego, Nueva canalización.

    Dos botones para seleccionar la creación de una nueva canalización.

  3. Seleccione la ubicación del código fuente como GitHub o Git de Azure Repos.

    Lista de posibles selecciones para el código fuente.

  4. Seleccione uno.

    Página en la que se selecciona un repositorio para la canalización de código fuente.

  5. En la página Configurar la canalización, seleccione Canalización inicial.

    Lista de plantillas entre las que elegir para configurar la nueva canalización.

  6. Seleccione Guardar y ejecutar.

    Página Revisar donde seleccione Guardar y ejecutar.

  7. Escriba el mensaje de confirmación, seleccione Confirmar directamente en la rama principaly, a continuación, elija Guardar y ejecutar de nuevo. Se inicia una nueva ejecución y se confirma en el repositorio. Espere a que finalice.

    Mensaje de confirmar para confirmar en la rama principal y, a continuación, seleccionar el botón Guardar y ejecutar.

Exportación de la canalización clásica

Realice los pasos siguientes para exportar la canalización clásica a un archivo YAML que puede usar en el editor.

  1. Vaya a Canalizaciones>Canalizaciones.

  2. Abra la canalización clásica en el diseñador de compilación clásica.

  3. Seleccione los puntos suspensivos (...) y, a continuación, seleccione Exportar a YAML.

    Captura de pantalla del menú contextual para exportar la canalización a YAML.

  4. Abra el archivo YAML descargado en el editor de código.

  5. Si la canalización YAML incluye variables definidas en la UI clásica, defina las variables de nuevo en la UI de configuración de la canalización o en el archivo YAML. Para obtener más información, consulte Definición de variables.

  6. Revise las programaciones cron del archivo YAML. De forma predeterminada, las programaciones cron en YAML están en UTC. En canalizaciones clásicas, se encuentran en la zona horaria de la organización. Para más información, consulte Configuración de programaciones para las canalizaciones.

  7. Use el Asistente para tareas para realizar cualquier otro cambio en el archivo YAML. El Asistente para tareas es un panel en el lado derecho de la pantalla, lo que le ayuda a crear y modificar correctamente los pasos de YAML.

    Configurar la tarea de canalización con el asistente de tareas.

  8. Guarde y ejecute la canalización.

Limpieza de recursos

Si ya no va a usar esta canalización de ejemplo, elimínela del proyecto. La eliminación es permanente e incluye todas las compilaciones y artefactos asociados.

  1. Seleccione los puntos suspensivos (...) y seleccione Eliminar.

  2. Escriba el nombre de la canalización para eliminarla permanentemente y, a continuación, seleccione Eliminar.

Preguntas más frecuentes

¿Hay alguna tarea en las canalizaciones YAML para crear elementos de trabajo cuando se produce un error de compilación?

Las canalizaciones YAML no tienen la configuración Crear elemento de trabajo en caso de error, como las canalizaciones de compilación clásicas. Tiene un par de opciones para crear esta funcionalidad usted mismo.

Pasos siguientes

Obtenga información sobre las diferencias de características entre las canalizaciones YAML y clásicas.

Use Azure Pipelines