Compartir a través de

Tutorial: Implementación de entornos en CI/CD con Azure Pipelines

  • Artículo

En este tutorial, aprenderá a integrar Azure Deployment Environments (ADE) en la canalización de CI/CD de Azure Pipelines.

La integración continua y entrega continua (CI/CD) es un enfoque de desarrollo de software que ayuda a los equipos a automatizar el proceso de creación, pruebas e implementación de cambios de software. CI/CD le permite liberar cambios de software con mayor frecuencia y con mayor confianza.

Antes de comenzar este tutorial, familiarícese con los recursos y conceptos de Deployment Environments mediante la revisión de Conceptos clave para entornos de implementación de Azure.

En este tutorial, aprenderá a:

  • Crear y configurar un repositorio de Azure Repos
  • Conexión del catálogo al centro de desarrollo
  • Configurar la conexión de servicio
  • Crear una canalización
  • Crear un entorno
  • Prueba de la canalización de CI/CD

Requisitos previos

Crear y configurar un repositorio de Azure Repos

  1. Inicie sesión en su organización de Azure DevOps (https://dev.azure.com/<your-organization>) y vaya a su proyecto. Reemplace el marcador de posición de texto <your-organization> por el identificador del proyecto.
  2. Seleccione Repos>Files (Repositorios > Archivos).
  3. En Importar un repositorio, seleccione Importar.
  4. En Importar un repositorio de Git, seleccione o escriba lo siguiente:

Configuración de tipos de entorno

Los tipos de entorno definen los distintos tipos de entornos que los equipos de desarrollo pueden implementar. Puede aplicar diferentes configuraciones para cada tipo de entorno. Puede crear tipos de entorno en el nivel de centro de desarrollo y hacer referencia a ellos en el nivel de proyecto.

Crear tipos de entorno de centro de desarrollo:

  1. Inicie sesión en Azure Portal.

  2. En Centros de desarrollo, seleccione el centro de desarrollo.

  3. En el menú de la izquierda, en Configuración del entorno, seleccione Tipos de entorno y, luego, elija Agregar.

  4. Siga estos pasos para crear tres tipos de entorno: Espacio aislado, FunctionApp, WebApp. En Crear tipo de entorno, escriba la siguiente información y, luego, seleccione Agregar.

    Nombre Valor
    Nombre Escriba un nombre para el tipo de entorno.
    Etiquetas Escriba un nombre y un valor de etiqueta.

  5. Para confirmar que el tipo de entorno se ha agregado correctamente, compruebe las notificaciones de Azure Portal.

Crear tipos de entorno de proyecto:

  1. En el menú de la izquierda, bajo Administrar, seleccione Proyectos y el proyecto que desea usar.

  2. En el menú de la izquierda, en Configuración del entorno, seleccione Tipos de entorno y Agregar.

  3. Siga estos pasos para agregar los tres tipos de entorno: Espacio aislado, FunctionApp, WebApp. En Agregar tipo de entorno al <nombre> de proyecto, escriba o seleccione la siguiente información:

    Nombre Value
    Tipo Seleccione el tipo de entorno de nivel de centro de desarrollo que desea habilitar para el proyecto concreto.
    Suscripción de implementación Seleccione la suscripción en la que se crea el entorno.
    Identidad de implementación Seleccione la identidad asignada por el sistema o la identidad administrada asignada por el usuario para hacer implementaciones en nombre del usuario.
    Permisos en los recursos del entorno>Roles de creador de entorno Seleccione los roles para dar acceso a recursos del entorno.
    Permisos en recursos del entorno>Acceso adicional Seleccione los usuarios o grupos de Microsoft Entra para asignar a roles específicos en los recursos del entorno.
    Etiquetas Escriba un nombre y un valor de etiqueta. Estas etiquetas se aplicarán a todos los recursos creados como parte de los entornos.

  4. Para confirmar que el tipo de entorno se ha agregado correctamente, compruebe las notificaciones de Azure Portal.

Configurar una conexión de servicio

En Azure Pipelines, creará una conexión de servicio en el proyecto de Azure DevOps para acceder a los recursos de la suscripción de Azure. Al crear la conexión de servicio, Azure DevOps crea un objeto de entidad de servicio de Microsoft Entra.

  1. Inicie sesión en su organización de Azure DevOps (https://dev.azure.com/<your-organization>) y vaya a su proyecto. Reemplace el marcador de posición de texto <your-organization> por el identificador del proyecto.

  2. Seleccione Configuración del proyecto>Conexiones de servicios>+ Nueva conexión de servicio.

  3. En el panel Nueva conexión de servicio, seleccione Azure Resource Manager y, a continuación, seleccione Siguiente.

  4. Seleccione el método de autenticación Entidad de servicio (automática) y Siguiente.

  5. Escriba la información de conexión de servicio y, después, seleccione Guardar para crear la conexión de servicio.

    Campo Value
    Nivel de ámbito Suscripción.
    Suscripción Seleccione la suscripción de Azure que hospeda el recurso de centro de desarrollo.
    Grupo de recursos Seleccione el grupo de recursos que contiene el recurso de centro de desarrollo.
    Nombre de conexión de servicio Escriba un nombre único para la conexión de servicio.
    Concesión de permiso de acceso a todas las canalizaciones Seleccionada.

  6. En la lista de conexiones de servicio, seleccione la que creó anteriormente y, a continuación, seleccione Administrar entidad de servicio. Azure Portal se abre en una pestaña independiente del explorador y muestra los detalles de la entidad de servicio.

  7. En Azure Portal, copie el valor Nombre para mostrar. Use este valor en el paso siguiente para conceder permisos para ejecutar pruebas de carga en la entidad de servicio.

Conceder acceso de conexión de servicio al proyecto de ADE

Azure Deployment Environments usa el control de acceso basado en rol para conceder permisos para realizar actividades específicas en el recurso de ADE. Para realizar cambios desde una canalización de CI/CD, conceda el rol de Usuario de Deployment Environments a la entidad de servicio.

  1. En Azure Portal, vaya al proyecto de ADE.
  2. Seleccione Control de acceso (IAM)>Agregar>Agregar asignación de roles.
  3. En la pestaña Rol, seleccione Usuario de Deployment Environments en la lista de roles de funciones de trabajo.
  4. En la pestaña Miembros, seleccione Seleccionar miembros y, a continuación, use el nombre para mostrar que copió anteriormente para buscar en la entidad de servicio.
  5. Seleccione la entidad de servicio y, a continuación, seleccione Seleccionar.
  6. En la pestaña Revisar + asignar, seleccione Revisar + asignar para agregar la asignación de roles.

Ahora es posible usar la conexión de servicio en la definición de flujo de trabajo de Azure Pipelines para acceder a los entornos de ADE.

Conceder acceso de cuenta al proyecto de ADE

Para ver los entornos creados por otros usuarios, incluida la conexión de servicio, debe conceder a la cuenta acceso de lectura al proyecto de ADE.

  1. En Azure Portal, vaya al proyecto de ADE.
  2. Seleccione Control de acceso (IAM)>Agregar>Agregar asignación de roles.
  3. En la pestaña Rol, seleccione Lector de Deployment Environments en la lista de roles de funciones de trabajo.
  4. En la pestaña Miembros, seleccione Seleccionar miembros y busque su propia cuenta.
  5. Seleccione la cuenta en la lista y, a continuación, Seleccionar.
  6. En la pestaña Revisar + asignar, seleccione Revisar + asignar para agregar la asignación de roles.

Ahora puede ver los entornos creados por el flujo de trabajo de Azure Pipelines.

Configurar una canalización

Edite el archivo azure-pipelines.yml en el repositorio de Azure Repos para personalizar la canalización.

En la canalización, definirá los pasos para crear el entorno. En esta canalización, definirá los pasos para crear el entorno como un trabajo, que es una serie de pasos que se ejecutan secuencialmente como una unidad.

Para personalizar la canalización, haga lo siguiente:

  • Especifique la conexión de servicio que se va a usar y la canalización usará la CLI de Azure para crear el entorno.
  • Use un script insertado para ejecutar un comando de la CLI de Azure que cree el entorno.

La CLI de Azure es una herramienta de línea de comandos que proporciona un conjunto de comandos para trabajar con recursos de Azure. Para conocer más comandos de la CLI de Azure, consulte el centro de desarrollo de Azure.

  1. En el proyecto de Azure DevOps, seleccione Repos>Archivos.

  2. En el panel Archivos, en la carpeta .ado, seleccione el archivo azure-pipelines.yml.

  3. En el archivo azure-pipelines.yml, edite el contenido existente con el código siguiente:

    • Reemplace <AzureServiceConnectionName> por el nombre de la conexión de servicio que creó anteriormente.

    • En Inline script, reemplace cada uno de los siguientes marcadores de posición por los valores adecuados para el entorno de Azure:

      Marcador Valor
      <dev-center-name> El nombre del centro de desarrollo.
      <project-name> Nombre del proyecto.
      <catalog-name> El nombre del catálogo.
      <environment-definition-name> Sin cambio. Define el entorno que se utiliza.
      <environment-type> El tipo de entorno.
      <environment-name> Especifique un nombre para el entorno nuevo.
      <parameters> Sin cambio. Hace referencia al archivo json que define parámetros para el entorno.

  4. Seleccione Confirmar para guardar los cambios.

  5. En el panel Confirmar cambios, escriba un mensaje de confirmación y seleccione Confirmar.

Crear un entorno mediante una canalización

A continuación, ejecute la canalización para crear el entorno de ADE.

  1. En el proyecto de Azure DevOps, seleccione Canalizaciones.
  2. Seleccione la canalización que creó anteriormente y, a continuación, Ejecutar canalización.
  3. Para comprobar el progreso de la ejecución de la canalización, seleccione el nombre de la canalización y, a continuación, Ejecuciones. Seleccione la ejecución para ver los detalles de la ejecución de la canalización.
  4. También puede comprobar el progreso de la creación del entorno en Azure Portal seleccionando el centro de desarrollo, el proyecto y Entornos.

Puede insertar este trabajo en cualquier lugar de una canalización de integración continua (CI) o de entrega continua (CD). Empiece consultando la documentación de Azure Pipelines, para obtener más información sobre la creación y administración de canalizaciones.

Limpieza de recursos

Cuando haya terminado con los recursos que creó en este tutorial, puede eliminarlos para evitar incurrir en cargos.

Use el comando siguiente para eliminar el entorno que creó en este tutorial:

az devcenter dev environment delete --dev-center <DevCenterName> --project-name <DevCenterProjectName> --name <DeploymentEnvironmentInstanceToCreateName> --yes

Contenido relacionado