Cree su primera canalización

Esta es una guía paso a paso para usar Azure Pipelines para compilar una aplicación de ejemplo desde un repositorio de Git. En esta guía, se usan canalizaciones YAML configuradas con el editor de canalizaciones YAML.

Para más información sobre las distintas secciones de una canalización YAML, consulte canalización en el esquema YAML de Azure Pipelines y Personalización de la canalización de YAML.

Si quiere usar canalizaciones clásicas en su lugar, consulte Definición de la canalización clásica. Para obtener instrucciones sobre el uso de TFVC, consulte Compilación de repositorios de TFVC.

Requisitos previos: Azure DevOps

Asegúrese de que dispone de lo siguiente:

• Una cuenta de GitHub en la que pueda crear un repositorio. cree una de forma gratuita.

• Una organización de Azure DevOps. cree una de forma gratuita. Si el equipo ya tiene una, asegúrese de que usted es el administrador del proyecto de Azure DevOps que desea usar.

• Tener capacidad para ejecutar canalizaciones en agentes hospedados por Microsoft. Para usar agentes hospedados por Microsoft, la organización de Azure DevOps debe tener acceso a trabajos paralelos hospedados por Microsoft. Puede comprar un trabajo paralelo o solicitar una concesión gratuita.

Cree su primera canalización

https://github.com/MicrosoftDocs/pipelines-java

https://github.com/MicrosoftDocs/pipelines-dotnet-core

https://github.com/Microsoft/python-sample-vscode-flask-tutorial

https://github.com/Azure-Samples/js-e2e-express-server

Visualización y administración de las canalizaciones

Para ver y administrar las canalizaciones, elija Canalizaciones en el menú de la izquierda para ir a la página de aterrizaje de canalizaciones.

En la página de aterrizaje de canalizaciones, puede ver canalizaciones y ejecuciones de canalización, crear e importar canalizaciones, administrar la seguridad, y explorar en profundidad los detalles de la canalización y la ejecución.

Elija Recientes para ver las canalizaciones de ejecución reciente (la vista predeterminada) o elija Todo para ver todas las canalizaciones.

Seleccione una canalización para administrar esa canalización y ver las ejecuciones. Seleccione el número de compilación de la última ejecución para ver los resultados de esa compilación, seleccione el nombre de la rama para ver la rama de esa ejecución, o seleccione el menú contextual para ejecutar la canalización y realizar otras acciones de administración.

Seleccione Ejecuciones para ver todas las ejecuciones de canalización. Opcionalmente, puede filtrar las ejecuciones mostradas.

Seleccione una ejecución de canalización para ver información sobre esa ejecución.

Puede elegir Retener o Eliminar una ejecución en el menú contextual. Para obtener más información sobre la retención de una ejecución, consulte Directivas de retención de compilación y versión.

Ver los detalles de la canalización

La página de detalles de una canalización permite ver y administrar esa canalización.

Elija Editar para editar la canalización. Para más información, consulte el editor de canalizaciones de YAML. También puede editar la canalización modificando el archivo azure-pipelines.yml directamente en el repositorio que hospeda la canalización.

Visualización de los detalles de la ejecución de la canalización

En el resumen de ejecución de la canalización, puede ver el estado de la ejecución, tanto mientras se ejecuta como cuando se completa.

En el panel de resumen, puede ver los detalles del trabajo y la fase, descargar artefactos y navegar a las confirmaciones vinculadas, los resultados de pruebas y los elementos de trabajo.

Trabajos y fases

En el panel de trabajos, se muestra información general sobre el estado de las fases y los trabajos. Este panel puede tener varias pestañas en función de si la canalización tiene fases y trabajos, o simplemente trabajos. En este ejemplo, la canalización tiene dos fases llamadas Compilar e Implementar. Puede explorar en profundidad los pasos de canalización eligiendo el trabajo en el panel Fases o Trabajos.

Seleccione un trabajo para ver los pasos de ese trabajo.

En la vista de pasos, puede revisar el estado y los detalles de cada paso. Desde Más acciones, puede alternar marcas de tiempo o ver un registro sin procesar de todos los pasos de la canalización.

Cancelar y volver a ejecutar una canalización

Si la canalización se está ejecutando, puede cancelarla si elige Cancelar. Si la ejecución se ha completado, puede volver a ejecutar la canalización seleccionando Ejecutar nuevo.

Menú Ejecutar más acciones de canalización

En el menú Más acciones, puede descargar registros, agregar etiquetas, editar la canalización, eliminar la ejecución y configurar la retención de la ejecución.

Adición de una notificación de estado al repositorio

Muchos desarrolladores desean mostrar que mantienen la calidad de su código en un nivel alto y muestran una notificación de estado en su repositorio.

Para copiar la notificación de estado en el Portapapeles:

1. En Azure Pipelines, vaya a la página Canalizaciones para ver la lista de canalizaciones. Seleccione la canalización que creó en la sección anterior.

2. Seleccione y, a continuación, seleccione Notificación de estado.

3. Seleccione Notificación de estado.

4. Copie el Markdown de ejemplo de la sección Markdown de ejemplo.

Ahora, con el Markdown de la notificación en el Portapapeles, siga estos pasos en GitHub:

1. Vaya a la lista de archivos y seleccione Readme.md. Seleccione el icono de lápiz para editarlo.

2. Pegue el Markdown de la notificación de estado al principio del archivo.

3. Confirme el cambio en la rama main.

4. Observe que la notificación de estado aparece en la descripción del repositorio.

Para configurar el acceso anónimo a las notificaciones para proyectos privados:

1. Navegar a Configuración del proyectoen la esquina inferior izquierda de la página

2. Abra la pestaña Configuración en Canalizaciones.

3. Cambie el control deslizante Deshabilitar el acceso anónimo a las notificaciones en General.

Dado que acaba de cambiar el archivo Readme.md de este repositorio, Azure Pipelines compila automáticamente el código, según la configuración del archivo azure-pipelines.yml en la raíz del repositorio. De nuevo en Azure Pipelines, observe que aparece una nueva ejecución. Cada vez que realice una edición, Azure Pipelines inicia una nueva ejecución.

Le mostraremos cómo usar el editor clásico en Azure DevOps Server 2019 para crear una compilación y una versión que imprima "Hola mundo".

1. Vaya a Azure Repos. (La central de código fuente en la navegación anterior)

   

2. Si el proyecto está vacío, se le mostrará una pantalla que le ayudará a agregar código al repositorio. Elija la opción inferior para inicializar el repositorio con un archivo readme:

   

1. Vaya a Azure Repos.

2. Agregue un archivo.

   

3. En el cuadro de diálogo, asigne un nombre al nuevo archivo y créelo.

   HelloWorld.ps1
   

4. Copie y pegue este script.

   Write-Host "Hello world"
   

5. Confirme (guarde) el archivo.

1. Seleccione Azure Pipelines, lo que le llevará automáticamente a la página Compilaciones.

   

2. Crear una canalización.

   

   Para los nuevos usuarios de Azure DevOps, esto le llevará automáticamente a la experiencia de creación de canalizaciones de YAML. Para ir al editor clásico y completar esta guía, debe desactivar la característica en vista previa para la nueva experiencia de creación de canalizaciones YAML:

   

   

3. Asegúrese de que el origen, el proyecto, el repositorio y la rama predeterminada coincidan con la ubicación en la que creó el script.

4. Comience con un trabajo vacío.

5. En el lado izquierdo, seleccione Canalización y especifique el nombre que quiera usar. En Grupo de agentes, seleccione VS2017 hospedado.

6. En el lado izquierdo, seleccione el signo más ( + ) para agregar una tarea al Trabajo 1. En el lado derecho, seleccione la categoría Utilidad, seleccione la tarea PowerShell en la lista y, a continuación, elija Agregar.

   

7. En el lado izquierdo, seleccione la nueva tarea de script de PowerShell.

8. En el argumento Ruta de acceso del script, seleccione el botón para examinar el repositorio y seleccione el script que ha creado.

   

9. Seleccione Guardar y poner en cola y, después, seleccione Guardar.

1. En la pestaña Tareas, seleccione el signo más ( + ) para agregar una tarea al Trabajo 1.

2. Seleccione la categoría Utilidad, seleccione la tarea Publicar artefactos de compilación y, a continuación, seleccione Agregar.

   

   Ruta de acceso para publicar: seleccione el botón para examinar y seleccionar el script que ha creado.

   Nombre del artefacto: escriba drop.

   Ubicación de publicación de artefactos: seleccione Azure Artifacts/TFS.

1. Seleccione Guardar y poner en cola y, después, seleccione Guardar y poner en cola.

2. En el cuadro de diálogo, seleccione Guardar y poner en cola una vez más.

   Esto pone en cola una nueva compilación en el agente hospedado por Microsoft.

3. Aparece un vínculo a la nueva compilación en la parte superior de la página.

   

   Seleccione el vínculo para ver la nueva compilación en directo. Una vez asignado el agente, empezará a ver los registros en directo de la compilación. Observe que el script de PowerShell se ejecuta como parte de la compilación y que se imprime "Hello world" en la consola.

   

4. Vaya al resumen de compilación. En la pestaña Artefactos de la compilación, observe que el script se ha publicado como un artefacto.

   

Ahora, puede ver los resultados de los cambios. Vaya a Azure Pipelines y seleccione En cola. Observe en la sección En cola o en ejecución que se desencadena automáticamente una compilación mediante el cambio que ha confirmado.

1. Vaya a la pestaña Canalizaciones y, a continuación, seleccione Versiones.

2. Seleccione la acción para crear una Nueva canalización. Si ya se ha creado una canalización de versión, seleccione el signo más ( + ) y, a continuación, seleccione Crear una canalización de versión.

3. Seleccione la acción para empezar con un Trabajo vacío.

4. Asigne a la fase el nombre QA.

5. En el panel Artefactos, seleccione + Agregar y especifique un Origen (canalización de compilación). Seleccione Agregar.

6. Seleccione el símbolo del rayo para desencadenar la implementación continua y, a continuación, habilite el desencadenador de implementación continua a la derecha.

   

7. Seleccione la pestaña Tareas y seleccione la fase QA.

8. Seleccione el signo más ( + ) del trabajo para agregar una tarea al trabajo.

9. En el cuadro de diálogo Agregar tareas, seleccione Utilidad, busque la tarea PowerShell y, a continuación, seleccione el botón Agregar.

10. En el lado izquierdo, seleccione la nueva tarea de script de PowerShell.

11. En el argumento Ruta de acceso del script, seleccione el botón para examinar los artefactos y seleccione el script que ha creado.

12. Agregue estos argumentos:

    -greeter "$(Release.RequestedFor)" -trigger "$(Build.DefinitionName)"
    

13. En la pestaña Canalización, seleccione la fase QA y seleccione Clonar.

    

14. Cambie el nombre de la fase clonada a Producción.

15. Cambie el nombre de la canalización de versión Hola mundo.

    

16. Guarde la canalización de versión.

1. Cree una nueva versión.

   

   Cuando aparezca Crear nueva versión, seleccione Crear.

2. Abra la versión que ha creado.

   

3. Examine los registros para obtener datos en tiempo real sobre la versión.

   

Ha aprendido cómo crear su primera canalización en Azure. Ahora, obtenga más información sobre la configuración de canalizaciones en el lenguaje que prefiera:

• .NET Core
• Go
• Java
• Node.js
• Python
• Contenedores

O puede continuar con la personalización de la canalización que acaba de crear.

Para ejecutar la canalización en un contenedor, consulte Trabajos de contenedor.

Para más información sobre cómo compilar repositorios de GitHub, consulte Compilación de repositorios de GitHub.

Para obtener información sobre cómo publicar los artefactos de la canalización, consulte Publicación de artefactos de canalización.

Para averiguar qué más puede hacer en las canalizaciones de YAML, consulte Referencia del esquema de YAML.

Limpiar

Si ha creado canalizaciones de prueba, son fáciles de eliminar cuando haya terminado con ellas.

az pipelines list [--detect {false, true}]
                  [--folder-path]
                  [--name]
                  [--org]
                  [--project]
                  [--query-order {ModifiedAsc, ModifiedDesc, NameAsc, NameDesc, None}]
                  [--repository]
                  [--repository-type {bitbucket, git, github, githubenterprise, svn, tfsgit, tfsversioncontrol}]
                  [--top]

az pipelines delete --id
                    [--detect {false, true}]
                    [--org]
                    [--project]
                    [--yes]

az pipelines list --output table

ID    Path    Name           Status    Default Queue
----  ------  -------------  --------  ------------------
6     \       FabrikamFiber  enabled   Hosted Ubuntu 1604

az pipelines delete --id 6

Are you sure you want to delete this pipeline? (y/n): y
Pipeline 6 was deleted successfully.

• Clientes

  • Visual Studio Code para Windows, macOS y Linux
  • Visual Studio con Git para Windows o Visual Studio para Mac
  • Eclipse
  • Xcode
  • IntelliJ
  • Línea de comandos

• Servicios

  • Azure Pipelines
  • Proveedores de servicios de Git, como Git Repos de Azure Repos, GitHub y Bitbucket Cloud
  • Subversion

¿Cómo puedo replicar una canalización?

Si la canalización tiene un patrón que desea replicar en otras canalizaciones, puede clonarla, exportarla o guardarla como plantilla.

Después de clonar una canalización, puede realizar cambios y guardarlos.

Después de exportar una canalización, puede importarla desde la pestaña Todas las canalizaciones.

Después de crear una plantilla, los miembros del equipo pueden usarla para seguir el patrón en las nuevas canalizaciones.

¿Cómo puedo trabajar con borradores?

Si está editando una canalización de compilación y desea probar algunos cambios que aún no están listos para producción, puede guardarla como un borrador.

¿Qué más puedo hacer cuando pongo en cola una compilación?

Puede poner en cola compilaciones de forma automática o manual.

Al poner en cola manualmente una compilación, para una sola ejecución de la compilación, puede hacer lo siguiente:

• Especificar el grupo al que va la compilación.

• Agregar y modificar algunas variables.

• Agregar demandas.

• En un repositorio de Git

  • Cree una rama o una etiqueta.

  • Compile una confirmación.

Para obtener más información sobre la configuración de la canalización, consulte:

• Obtención de código fuente
• Tareas
• Variables
• Desencadenadores
• Retención
• Historial

¿Cómo puedo crear mediante programación una canalización de compilación?

Referencia de la API REST: creación de una canalización de compilación