Ejercicio: Creación y ejecución de una canalización básica

• 7 minutos

Quiere automatizar la implementación de actualizaciones en el sitio web de su empresa de juguetes. Como primer paso, debe crear una canalización básica en Azure DevOps.

En este ejercicio, aprenderá a:

Creación de un proyecto en Azure DevOps

1. En un explorador, vaya a dev.azure.com. Inicie sesión o cree una cuenta nueva.

2. Si ha creado una cuenta nueva, siga las indicaciones para crear una organización en Azure DevOps. A continuación, Azure DevOps le insta a crear un nuevo proyecto. Continúe con el paso siguiente para configurar el proyecto.

   Si ha iniciado sesión en una organización que ya existía en Azure DevOps, seleccione Nuevo proyecto para crear un proyecto nuevo.

   

3. En el panel Cree un proyecto para empezar, escriba los detalles siguientes para el nuevo proyecto:

   • Nombre del proyecto: use un nombre breve pero descriptivo. Para este ejercicio, escriba toy-website.
   • Descripción: escriba una descripción del propósito del proyecto. Para este ejercicio, escriba Sitio web de la compañía Toy.
   • Visibilidad: puede usar Azure DevOps para crear repositorios públicos y privados. En este caso, el repositorio debe ser privado porque solo las personas de la organización deben acceder a los archivos del sitio web de la empresa. Más adelante, puede conceder acceso a otros usuarios.

   La configuración del proyecto debería ser similar al siguiente ejemplo:

   

4. Seleccione Create project (Crear proyecto).

Clonación del repositorio

1. En el panel de bienvenida, o en el menú de recursos, seleccione Repositorios.

   

2. Si usa macOS, necesita una contraseña especial para clonar el repositorio de Git. Seleccione Generar credenciales de GIT y copie en un lugar seguro el nombre de usuario y la contraseña que se muestran.

3. En la sección Clonar en el equipo, seleccione Clone in VS Code (Clonar en VS Code). Si se le pide que permita que se abra Visual Studio Code, seleccione Abrir.

   

4. Si aparece un cuadro de diálogo en el que se le pide que permita que una extensión abra el URI del repositorio, seleccione Abrir.

5. Cree una carpeta en el dispositivo local a fin de usarla para este repositorio y luego seleccione Select as Repository Location (Seleccionar como ubicación del repositorio).

6. Si es la primera vez que usa este repositorio, se le pedirá que inicie sesión.

   En Windows, escriba las mismas credenciales que ha usado para iniciar sesión en Azure DevOps anteriormente en este ejercicio.

   En macOS, escriba el nombre de usuario y la contraseña de Git que ha generado hace unos instantes.

7. Visual Studio Code le pide que abra el repositorio. seleccione Open(Abrir).

   

Instalación de la extensión Azure Pipelines

Microsoft publica una extensión de Azure Pipelines para Visual Studio Code. La extensión puede ayudarlo a escribir archivos de YAML de canalizaciones. Es aconsejable instalar esta extensión para que los archivos de YAML se validen mientras trabaja.

1. En Visual Studio Code, seleccione Ver>Extensiones (el método abreviado de teclado es Ctrl+Mayús+X).

2. En el cuadro Buscar, escriba Azure Pipelines y, después, seleccione la extensión Azure Pipelines publicada por Microsoft. Seleccione Instalar.

   

Creación de una definición de canalización de YAML

Ahora que ha creado la organización, el proyecto y el repositorio, está listo para crear la definición de una canalización básica.

1. En Visual Studio Code, abra el Explorador.

2. En el explorador mantenga el puntero sobre la carpeta del proyecto TOY-WEBSITE y seleccione Nueva carpeta. Asigne el nombre deploy a esa carpeta.

3. Seleccione la carpeta deploy y seleccione el icono Nuevo archivo en el proyecto TOY-WEBSITE. Asigne el nombre azure-pipelines.yml a ese archivo.

   

4. El archivo YML se abre en el panel principal. Pegue el código de definición de canalización siguiente en el archivo:

   trigger: none
   
   pool:
     vmImage: ubuntu-latest
   
   jobs:
   - job:
     steps:
     - script: echo Hello world!
       displayName: 'Placeholder step'
   

5. Guarde los cambios en el archivo.

6. En Visual Studio Code, abra una nueva ventana del terminal. Para ello, seleccione Terminal>Nuevo terminal.

   Una ventana de terminal se abre, normalmente en la mitad inferior de la pantalla.

7. Para confirmar e insertar el archivo azure-pipelines.yml en el repositorio de Git, pegue este código en el panel del terminal y después presione Entrar.

   git add deploy/azure-pipelines.yml
   git commit -m "Add initial pipeline definition"
   git push
   

Configuración de la canalización en Azure Pipelines

Ha creado la definición de una canalización. Ahora debe registrar la canalización en Azure Pipelines.

1. En el menú de recursos de la sesión de Azure DevOps, seleccione Pipelines y, en el panel Cree su primera canalización, seleccione Crear canalización.

   

2. En el panel ¿Dónde está su código? de la pestaña Conectar, seleccione Repositorio Git de Azure Repos.

   

3. En el panel Seleccionar un repositorio de la pestaña Seleccionar, seleccione toy-website.

   

4. En el panel Configure su canalización de la pestaña Configurar, seleccione Archivo YAML de Azure Pipelines existente.

   

5. En la lista desplegable Ruta del panel Seleccionar un archivo YAML existente, seleccione /deploy/azure-pipelines.yml y después Continuar.

   

   En el panel Revisar YAML de la canalización de la pestaña Revisar se muestra la definición de la canalización de YAML como una nueva canalización.

   Sugerencia

   La interfaz web de Azure Pipelines proporciona un editor que puede usar para administrar la definición de la canalización. En este módulo, trabaja con el archivo de definición en Visual Studio Code, pero puede explorar el editor de Azure Pipelines para ver cómo funciona.

6. Seleccione Run (Ejecutar).

   

   Azure Pipelines crea la canalización e inicia una primera ejecución.

Comprobación de la ejecución de canalización

1. Cuando se inicia la ejecución de la canalización, una página muestra información sobre la ejecución.

   

   Cada ejecución de canalización incluye un identificador. Puede usar este identificador como ayuda para buscar una ejecución específica de una canalización.

   El estado del trabajo se muestra inicialmente como En cola. Es posible que la canalización no se inicie inmediatamente. El trabajo se agrega a una cola a la espera de un agente. Cuando hay un agente disponible, Azure Pipelines lo asigna e inicia el trabajo. A continuación, el estado del trabajo cambia a En ejecución.

   La página incluye el nombre de la rama y el identificador de la confirmación de Git que ha usado la ejecución. Esta información indica la versión del contenido del repositorio que ha usado la canalización.

2. Actualice la página hasta que el estado del trabajo cambie a Correcto. Después, en Trabajos, seleccione Trabajo.

   

3. La página de información del trabajo muestra el registro de los pasos que la canalización ha ejecutado. El paso Marcador de posición se muestra en los pasos del menú de la izquierda.

   

   La lista de pasos del trabajo incluye pasos que no ha creado. Azure Pipelines los crea automáticamente. En algunas organizaciones, también puede ver los pasos que su organización incluye automáticamente en todas las canalizaciones. Puede seleccionar cualquier paso para ver el archivo de registro de ese paso.

4. Seleccione Extraer del repositorio website@main en s.

   

   En los registros de cada paso se proporcionan detalles sobre lo que ha ocurrido exactamente durante la ejecución de canalización. La información de registro es útil si tiene que diagnosticar un problema con una canalización. No tiene acceso directo al agente que ejecutó los pasos.

   En este caso, el contenido del repositorio se descargó de Azure Repos en el sistema de archivos del agente.

5. Seleccione Placeholder step (Paso del marcador de posición).

   

   En los registros de este paso se incluye el contenido del script tal como lo ha creado en el archivo YAML de la canalización y la salida de texto Hello world! de la ejecución del script.

Vinculación de la ejecución de la canalización a una confirmación

Conviene saber cómo hacer una referencia cruzada de la ejecución de canalización a la confirmación que contenía la ejecución. Vincular una ejecución de canalización a una confirmación puede facilitar el seguimiento del historial de la implementación y el diagnóstico de problemas. Azure DevOps proporciona varias formas de vincular la ejecución de una canalización a una confirmación. En este procedimiento se inspecciona manualmente el historial de confirmaciones.

1. Para volver a la información general del repositorio, seleccione Repositorios>Confirmaciones en el menú de recursos de DevOps.

   

   El identificador de la confirmación es el mismo que anotó en la ejecución de la canalización. Además, Azure Pipelines muestra el estado de la ejecución de la canalización asociada a la confirmación.

2. Seleccione la confirmación. La lista de archivos que se han cambiado y los cambios de la confirmación se muestran resaltados en color verde, lo que indica que todo el texto es nuevo.