Configuración de una canalización y actualizaciones de inserción

En este artículo, aprenderá a usar la CLI para desarrolladores de Azure (azd) para insertar cambios de plantilla a través de una canalización de CI/CD, como Acciones de GitHub o Azure DevOps. En este ejemplo, usará React Web App con Node.js API y MongoDB en la plantilla de Azure, pero puede aplicar los principios que aprenderá en este artículo a cualquiera de las plantillas de la CLI para desarrolladores de Azure.

Nota:

El azd pipeline config comando todavía está en versión beta. Obtenga más información sobre la compatibilidad con características alfa y beta en la página de estrategia de versiones y versiones de características.

Requisitos previos

• Instale la CLI para desarrolladores de Azure.
• Implemente la plantilla de Node.js.
• Visual Studio Code instalado.

Todas las azd plantillas incluyen un archivo de configuración de canalización de GitHub y Azure DevOps predeterminado denominado azure-dev.yml, que es necesario para configurar CI/CD. Este archivo de configuración aprovisiona los recursos de Azure e implementa el código en la rama principal. Puede encontrar azure-dev.yml:

• Para Acciones de GitHub: en el .github/workflow directorio .
• Para Azure DevOps: en el .azdo/pipelines directorio .

Para configurar una canalización de CI/CD, usará el azd pipeline config comando , que controla las siguientes tareas:

• Crea y configura una entidad de servicio para la aplicación en la suscripción de Azure.
• Le guiará por un flujo de trabajo para crear y configurar un repositorio de GitHub y confirmar el código del proyecto en él. También puede optar por usar un repositorio de GitHub existente.
• Crea una conexión segura entre Azure y el repositorio mediante secretos de GitHub.
• Ejecuta la acción de GitHub al proteger el archivo de flujo de trabajo.

Para un control más granular sobre este proceso, también puede configurar manualmente una canalización.

Todas las plantillas incluyen un archivo de configuración de canalización de GitHub y Azure DevOps predeterminado denominado azure-dev.yml. Este archivo de configuración aprovisiona los recursos de Azure e implementa el código en la rama principal. Puede encontrar azure-dev.yml:

• Para Acciones de GitHub: en el .github/workflow directorio .
• Para Azure DevOps: en el .azdo/pipelines directorio .

Puede usar el archivo de configuración tal como está o modificarlo para satisfacer sus necesidades.

Seleccione el proveedor de canalización preferido para continuar:

Acciones de GitHub

Autorización de GitHub para implementar en Azure

Para configurar el flujo de trabajo, deberá conceder a GitHub permiso para implementar en Azure en su nombre. Autorice a GitHub mediante la creación de una entidad de servicio de Azure almacenada en un secreto de GitHub denominado AZURE_CREDENTIALS.

1. Ejecute el comando siguiente para crear la entidad de servicio de Azure y configurar la canalización:

   azd pipeline config
   

   Este comando también crea un repositorio privado de GitHub e inserta código en el nuevo repositorio.

   Nota:

   De forma predeterminada, azd pipeline config usa openID Conectar (OIDC), denominada credenciales federadas. Si prefiere no usar OIDC, ejecute azd pipeline config --auth-type client-credentials.

   No se admiten credenciales federadas o OIDC para Terraform.

   Obtenga más información sobre la compatibilidad con OIDC en azd.

2. Proporcione la información solicitada de GitHub.

3. Cuando se le pida que confirme e inserte los cambios locales para iniciar una nueva ejecución de Acciones de GitHub, especifique y.

4. En la ventana del terminal, vea los resultados del azd pipeline config comando. El azd pipeline config comando generará el nombre del repositorio de GitHub para el proyecto.

5. Con el explorador, abra el repositorio de GitHub para el proyecto.

6. Seleccione Acciones para ver el flujo de trabajo en ejecución.

   

Realizar e insertar un cambio de código

1. En el directorio del /src/web/src/layout proyecto, abra header.tsx.

2. Busque la línea <Text variant="xLarge">ToDo</Text>.

3. Cambie el literal ToDo a myTodo.

4. Guarde el archivo.

5. Confirme el cambio. Confirmar el cambio inicia la canalización de acción de GitHub para implementar la actualización.

   

6. Con el explorador, abra el repositorio de GitHub del proyecto para ver lo siguiente:

   • Confirmación
   • Confirmación de Acciones de GitHub que se está configurando.

   

7. Seleccione Acciones para ver la actualización de prueba reflejada en el flujo de trabajo.

   

8. Visite la dirección URL del front-end web para inspeccionar la actualización.

azd como una acción de GitHub

Agregue azd como una acción de GitHub. Esta acción instalará azd. Para usarlo, puede agregar lo siguiente a .github\workflows\azure-dev.yml:

on: [push]

jobs:
   build:
      runs-on: ubuntu-latest
      steps:
         - name: Install azd
         uses: Azure/setup-azd@v0.1.0

Azure DevOps

Nota:

Si usa Azure DevOps para una plantilla de Java en Windows, consulte la sección correspondiente en la guía de solución de problemas.

Creación o uso de una organización de Azure DevOps existente

Para ejecutar una canalización en Azure DevOps, necesitará una organización de Azure DevOps. Puede crear uno mediante el portal de Azure DevOps: https://dev.azure.com.

Creación de un token de acceso personal

La CLI para desarrolladores de Azure se basa en un token de acceso personal (PAT) de Azure DevOps para configurar un proyecto de Azure DevOps. Cree un nuevo PAT de Azure DevOps.

Al crear el PAT, establezca los ámbitos siguientes:

• Grupos de agentes (leer, administrar)
• Compilación (lectura y ejecución)
• Código (completo)
• Proyecto y equipo (lectura, escritura y administración)
• Versión (lectura, escritura, ejecución y administración)
• Conectar de servicio (lectura, consulta y administración)

Invocación del comando Pipeline configure

1. (Opcional) Para actualizar el proveedor de canalización predeterminado de Acciones de GitHub a Azure DevOps, edite azure.yaml ubicado en la raíz del proyecto y agregue lo siguiente:

   pipeline: 
      provider: azdo 
   

2. Ejecute el comando siguiente para configurar un proyecto y un repositorio de Azure DevOps con una canalización de implementación.

   azd pipeline config --provider azdo
   

   Si realizó la actualización de configuración en el paso 1, puede omitir la --provider marca :

   azd pipeline config
   

Nota:

De forma predeterminada, azd pipeline config en Azure DevOps usa client-credentials. Las credenciales federadas o OIDC no se admiten para Azure DevOps.

Obtenga más información sobre la compatibilidad con OIDC en azd.

1. Proporcione sus respuestas a las siguientes indicaciones:

   Token de acceso personal (PAT)

   • Copie o pegue el PAT.

   • Ejecute el siguiente comando para exportar el PAT como entorno del sistema. De lo contrario, se le pedirá cada vez que configure una canalización de Azure:

     export AZURE_DEVOPS_EXT_PAT=<PAT>
     

   Escriba un nombre de organización de Azure DevOps.

   Escriba su organización de AzDo. Una vez que presione Entrar, AZURE_DEVOPS_ORG_NAME="<your Azure DevOps Org Name>" se agrega automáticamente al archivo .env para el entorno actual.

   No se encontró un remoto denominado "origen". ¿Desea configurar una?

   Sí

   ¿Cómo desea configurar el proyecto?

   Creación de un proyecto de Azure DevOps

   Escriba el nombre del nuevo proyecto de Azure DevOps O presione entrar para usar este nombre: ( {nombre predeterminado} )

   Seleccione Entrar o cree un nombre de proyecto único.

   ¿Desea confirmar e insertar los cambios locales para iniciar la canalización de CI configurada?

   Sí

2. Vaya al portal de Azure DevOps (https://dev.azure.com) para buscar el proyecto y comprobar la compilación.

Realizar e insertar un cambio de código

1. En el directorio del /src/web/src/layout proyecto, abra header.tsx.

2. Busque la línea <Text variant="xLarge">ToDo</Text>.

3. Cambie el literal ToDo a myTodo.

4. Guarde el archivo.

5. Cree una rama y confirme el cambio. La main rama de Azure DevOps está protegida frente a la inserción directa. Debe insertar los cambios de una nueva rama y crear un Pull Request en Azure DevOps. La solicitud de incorporación de cambios iniciará automáticamente la canalización y evitará la combinación si se produce un error en la canalización.

6. Apruebe y combine la solicitud de incorporación de cambios para iniciar la canalización de nuevo.

   

7. Con el explorador, abra el repositorio del proyecto para ver lo siguiente:

   • Confirmación
   • Canalización de Azure

   

8. Visite la dirección URL del front-end web para inspeccionar la actualización.

azd como una tarea de Azure DevOps

Agregue azd como una tarea de Azure DevOps. Esta tarea instalará azd. Para usarlo, puede agregar lo siguiente a .azdo\pipelines\azure-dev.yml:

trigger:
   - main
   - branch

pool:
   vmImage: ubuntu-latest
   # vmImage: windows-latest

steps:
   - task: setup-azd@0
   displayName: Install azd

Limpieza de recursos

Cuando ya no necesite los recursos de Azure creados en este artículo, ejecute el siguiente comando:

azd down

Solicitar ayuda

Para obtener información sobre cómo archivar un error, solicitar ayuda o proponer una nueva característica para la CLI para desarrolladores de Azure, visite la página de solución de problemas y soporte técnico .

Pasos siguientes

Supervisión de la aplicación mediante la CLI para desarrolladores de Azure (azd)