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

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

La integración y entrega continuas (CI/CD) es un enfoque de desarrollo de software que ayuda a los equipos a automatizar el proceso de creación, prueba 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 conceptos y recursos de los entornos de implementación revisando Conceptos clave de Azure Deployment Environments.

En este tutorial, aprenderá a:

• Crear y configurar un repositorio de Azure Repos
• Configuración de tipos de entorno
• Configurar una conexión de servicio
• Creación de una canalización
• Creación de un entorno

Prerrequisitos

• Una cuenta de Azure con una suscripción activa.
  • Cree una cuenta gratuita.
• Permisos de propietario en la suscripción a Azure.
• Una suscripción de Azure DevOps.
  • Cree una cuenta gratuita.
  • Una organización y proyecto de Azure DevOps.
• En Azure Deployment Environments:
  • Un centro de desarrollo y un proyecto.
  • Un catálogo de ejemplo adjunto al centro de desarrollo.

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>). Reemplace <your-organization> por el identificador del proyecto.
2. Seleccione su proyecto.
3. Seleccione Repos>Archivos.
4. En Importar un repositorio, seleccione Importar.
5. En Importar un repositorio de Git, seleccione o escriba lo siguiente:
   • Tipo de repositorio: Git
   • URL de clonación: https://github.com/Azure/deployment-environments

Configuración de tipos de entorno

Los tipos de entorno definen los 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 del centro de desarrollo y en el nivel de proyecto.

Para crear tipos de entorno del 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, a continuación, seleccione Crear.

4. Siga estos pasos para crear tres tipos de entorno: Sandbox, FunctionApp y WebApp.

   1. En Crear tipo de entorno, escriba la siguiente información y, luego, seleccione Agregar.

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

   2. Confirme que el tipo de entorno aparece en la lista.

Para crear tipos de entorno de proyecto:

1. En el menú de la izquierda, en Administrar, seleccione Proyectos y, a continuación, seleccione el proyecto que desea usar.
2. En el menú de la izquierda, en Configuración del entorno, seleccione Tipos de entorno y, a continuación, seleccione Agregar.
3. Siga estos pasos para agregar los tres tipos de entorno: Sandbox, FunctionApp y WebApp.

   1. En Agregar tipo de entorno al <nombre> de proyecto, escriba o seleccione la siguiente información:

      Nombre	Importancia
      Tipo	Seleccione un tipo de entorno de nivel de centro de desarrollo para habilitarlo para el proyecto específico.
      Suscripción de implementación	Seleccione la suscripción en la que se crea el entorno.
      Identidad de implementación	Seleccione una identidad administrada asignada por el sistema o asignada por el usuario para realizar 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 de etiqueta y un valor de etiqueta. Estas etiquetas se aplicarán a todos los recursos creados como parte de los entornos.

   2. Confirme que el tipo de entorno aparece en la lista.

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.

1. Si no tiene una identidad administrada asignada por el usuario para el proyecto, agregar una.

   Nota:

   Puede usar una de las tres opciones de identidad: registro de aplicaciones, identidad administrada asignada por el usuario e identidad administrada asignada por el sistema. El Registro de aplicaciones es la opción más segura. Para usar el registro de aplicaciones, debe tener los permisos adecuados. Para obtener más información, consulte Casos especiales de conexión del servicio Azure Resource Manager.

2. Inicie sesión en su organización de Azure DevOps https://dev.azure.com/<your-organization>). Reemplace <your-organization> por el identificador del proyecto.

3. Seleccione su proyecto.

4. Seleccione Configuración de proyecto>Conexiones de servicio>Crear conexión de servicio.

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

6. Escriba los siguientes detalles de conexión de servicio y, a continuación, seleccione Guardar para crear la conexión de servicio.

   Campo	Importancia
   Tipo de identidad	Identidad administrada
   Suscripción a identidad administrada	Escriba la suscripción de Azure que contiene la identidad administrada.
   Grupo de recursos de identidad administrada	Escriba el grupo de recursos que contiene la identidad administrada.
   Identidad administrada	Escriba el nombre de la identidad administrada.
   Nivel de ámbito para la conexión de servicio	Suscripción
   Suscripción para la conexión de servicio	Escriba el id. de la suscripción de Azure que hospeda el recurso del centro de desarrollo.
   Nombre de la conexión de servicio	Escriba un nombre único para la conexión de servicio.
   Conceder permiso de acceso a todas las canalizaciones	Seleccione esta casilla de verificación.

7. Haga clic en Guardar.

Concesión de acceso de conexión de servicio al proyecto de entornos de implementación

Los entornos de implementación usan el control de acceso basado en roles para conceder permisos para realizar actividades específicas en el recurso de entornos de implementación. Para realizar cambios desde una canalización de CI/CD, conceda el rol de usuario Entornos de implementación a la identidad administrada.

1. En Azure Portal, vaya al proyecto de entornos de implementación.
2. Seleccione Control de acceso (IAM)>Agregar>Agregar asignación de roles.
3. En la pestaña Rol, seleccione Usuario de entornos de implementación en la lista de roles de función de trabajo.
4. En la pestaña Miembros, seleccione Identidad administrada y Seleccionar miembros.
5. En la pestaña Seleccionar identidades administrada, en Identidad administrada, seleccione la identidad Proyecto, seleccione el nombre de proyecto y, a continuación, elija Seleccionar.
6. En la pestaña Revisar + asignar, seleccione Revisar + asignar para agregar la asignación de rol.

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

Concesión de acceso a la cuenta al proyecto de entornos de implementación

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 entornos de implementación.

1. En Azure Portal, vaya al proyecto de entornos de implementación.
2. Seleccione Control de acceso (IAM)>Agregar>Agregar asignación de roles.
3. En la pestaña Rol, seleccione Lector de entornos de implementación en la lista de roles de función 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 rol.

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.
• Use un script insertado para ejecutar un comando de la CLI de Azure que cree el entorno.

CLI de Azure es una herramienta de línea de comandos que proporciona un conjunto de comandos para trabajar con recursos de Azure. Para obtener más información sobre los comandos de CLI de Azure, consulte az devcenter.

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:

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

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

     Marcador de posición	Importancia
     <DevCenterName>	El nombre del centro de desarrollo.
     <project-name>	Nombre del proyecto.
     <catalog-name>	El nombre del catálogo.
     <environment-definition-name>	Sin cambio. Define la definición de entorno que se usa.
     <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.

Creación de un entorno mediante una canalización

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

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, seleccione 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 el Azure Portal seleccionando el Centro de desarrollo, seleccionando el proyecto y, a continuación, seleccionando Entornos.

Puede insertar este trabajo en cualquier lugar de una canalización de CI y/o CD. Consulte la documentación de Azure Pipelines para obtener más información sobre cómo crear y administrar 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

• Instalación de la extensión de la CLI de Azure
• Creación y acceso a un entorno mediante la CLI de Azure
• Documentación de la CLI de Azure y componentes comunes de Microsoft Dev Box y Azure Deployment Environments