Tutorial: Implementación de un Aspire proyecto mediante Azure Developer CLI

• Azure organización de DevOps o elegir una organización existente
• Crear un Azure token de acceso personal (PAT) de DevOps y guárdelo para su uso posterior. Configure el token con los permisos siguientes:
  • Grupos de agentes (leer, administrar)
  • Compilar (lectura y ejecución)
  • Código (completo)
  • Proyecto y equipo (leer, escribir y gestionar)
  • Lanzamiento (lectura, escritura, ejecución y administración)
  • Conexiones de servicio (lectura, consulta y administración)

Crear el repositorio GitHub y la canalización

El Azure Developer CLI permite crear automáticamente canalizaciones de CI/CD con las configuraciones y permisos correctos para aprovisionar e implementar recursos en Azure. azd también puede crear un repositorio de GitHub para la aplicación si aún no existe.

1. Ejecute el comando azd pipeline config para configurar la canalización de implementación y conectarla de forma segura a Azure:

   azd pipeline config
   

2. Seleccione la suscripción para aprovisionar e implementar los recursos de la aplicación.

3. Seleccione la ubicación Azure para utilizar los recursos.

4. Cuando se le pida que cree un nuevo repositorio de Git en el directorio, escriba y y presione Entrar.

   Nota:

   La creación de un repositorio de GitHub requiere que haya iniciado sesión en GitHub. Hay algunas selecciones que varían en función de sus preferencias. Después de iniciar sesión, se le pedirá que cree un nuevo repositorio en el directorio actual.

5. Seleccione Crear un nuevo repositorio de GitHub privado para configurar el repositorio git remoto.

6. Escriba un nombre de su elección para el nuevo repositorio de GitHub o presione ENTRAR para usar el nombre predeterminado. azd crea un nuevo repositorio en GitHub y lo configura con los secretos necesarios para autenticarse en Azure.

   

7. Escriba y para continuar cuando azd le pida que confirme e inserte los cambios locales para iniciar la canalización configurada.

Explora el flujo de trabajo de acciones de GitHub y su implementación

1. Vaya al nuevo repositorio de GitHub utilizando el enlace generado por azd.

2. Seleccione la pestaña Acciones para ver los flujos de trabajo del repositorio. Deberías ver el nuevo flujo de trabajo en ejecución o ya completado. Seleccione el flujo de trabajo para ver los pasos del trabajo y los detalles de los registros de la ejecución. Por ejemplo, puede expandir pasos como Implementar aplicación para ver los detalles de la acción completada.

   

3. Seleccione Implementar aplicación para expandir los registros de ese paso. Debería ver dos direcciones URL de punto de conexión impresas para el apiservice y webfrontend. Seleccione cualquiera de estos vínculos para abrirlos en otra pestaña del explorador y explorar la aplicación implementada.

   

¡Felicidades! Implementó correctamente un proyecto Aspire utilizando las Acciones de Azure Developer CLI y GitHub.

Configuración del directorio de trabajo para soluciones de varios proyectos

Al agregar GitHub Acciones a una solución de varios proyectos Aspire existente en la que el proyecto AppHost no está en el directorio raíz, es posible que tenga que configurar el working-directory parámetro para determinados pasos de flujo de trabajo. En esta sección se explica cuándo y cómo realizar estos ajustes.

Cuando se necesita la configuración del directorio de trabajo

El azd pipeline config comando genera un GitHub flujo de trabajo de Actions que asume que tu proyecto Aspire AppHost está en el directorio raíz del repositorio. Sin embargo, en muchos escenarios reales, especialmente al agregar Aspire a aplicaciones existentes, el proyecto AppHost podría estar en un subdirectorio.

Por ejemplo, si la estructura del repositorio tiene este aspecto:

└───📂 MyAspireApp
    ├───📂 MyAspireApp.ApiService
    ├───📂 MyAspireApp.AppHost
    │    ├─── MyAspireApp.AppHost.csproj
    │    └─── AppHost.cs
    ├───📂 MyAspireApp.Web
    └─── MyAspireApp.sln

Los pasos de flujo de trabajo generados para la infraestructura de aprovisionamiento e implementación de la aplicación deben ejecutarse desde el MyAspireApp.AppHost directorio, no desde la raíz del repositorio.

Actualización del flujo de trabajo de GitHub acciones

Después de ejecutar azd pipeline config, examine el archivo de flujo de trabajo generado en .github/workflows/azure-dev.yml. Busque los pasos que ejecutan azd comandos y agregan el working-directory parámetro según sea necesario.

Este es un ejemplo de los pasos generados originalmente:

- name: Provision Infrastructure
  run: azd provision --no-prompt
  env:
    AZURE_ENV_NAME: ${{ vars.AZURE_ENV_NAME }}
    AZURE_LOCATION: ${{ vars.AZURE_LOCATION }}
    AZURE_SUBSCRIPTION_ID: ${{ vars.AZURE_SUBSCRIPTION_ID }}

- name: Deploy Application
  run: azd deploy --no-prompt
  env:
    AZURE_ENV_NAME: ${{ vars.AZURE_ENV_NAME }}
    AZURE_LOCATION: ${{ vars.AZURE_LOCATION }}
    AZURE_SUBSCRIPTION_ID: ${{ vars.AZURE_SUBSCRIPTION_ID }}

Actualice estos pasos para incluir el working-directory parámetro :

- name: Provision Infrastructure
  run: azd provision --no-prompt
  working-directory: ./MyAspireApp.AppHost
  env:
    AZURE_ENV_NAME: ${{ vars.AZURE_ENV_NAME }}
    AZURE_LOCATION: ${{ vars.AZURE_LOCATION }}
    AZURE_SUBSCRIPTION_ID: ${{ vars.AZURE_SUBSCRIPTION_ID }}

- name: Deploy Application
  run: azd deploy --no-prompt
  working-directory: ./MyAspireApp.AppHost
  env:
    AZURE_ENV_NAME: ${{ vars.AZURE_ENV_NAME }}
    AZURE_LOCATION: ${{ vars.AZURE_LOCATION }}
    AZURE_SUBSCRIPTION_ID: ${{ vars.AZURE_SUBSCRIPTION_ID }}

Búsqueda del directorio de trabajo correcto

El directorio de trabajo debe apuntar a la carpeta que contiene su proyecto Aspire AppHost (el proyecto que contiene el archivo azure.yaml generado por azd init). Para identificar este directorio, haga lo siguiente:

1. Busque el proyecto con la referencia de paquete Aspire.AppHost en el archivo .csproj.
2. Busque el directorio que contiene el archivo azure.yaml .
3. Busque el proyecto al que se hace referencia en la solución que organiza otros servicios.

Crea el repositorio y el pipeline de Azure DevOps

El Azure Developer CLI permite crear automáticamente canalizaciones con las configuraciones y permisos correctos para aprovisionar e implementar recursos en Azure. azd también puede crear un repositorio de Azure pipelines para tu aplicación si aún no existe.

1. Ejecute el comando azd pipeline config para configurar la canalización de implementación y conectarla de forma segura a Azure. Incluya la opción --provider azdo para usar Azure Pipelines en lugar de la configuración predeterminada de GitHub Actions.

   azd pipeline config --provider azdo
   

   Importante

   Antes de ejecutar azd pipeline config, asegúrese de que se ha ejecutado azd init correctamente para inicializar el proyecto. Si encuentra errores como "no existe ningún proyecto" durante la ejecución de la canalización, consulte la sección de solución de problemas de soluciones.

2. Seleccione la suscripción para aprovisionar e implementar los recursos de la aplicación.

3. Seleccione la ubicación Azure para utilizar los recursos.

4. Pegue el token de acceso personal que creó anteriormente.

5. Escriba el Azure nombre de la organización de DevOps que creó o seleccionó.

6. Cuando se le pida que cree un nuevo repositorio en el directorio actual, escriba y y presione Intro.

7. Cuando se le pida que configure el git remoto, seleccione Crear una nueva Azure DevOps Project.

8. Escriba un nombre único de su elección para el nuevo repositorio, como aspireazd. azd crea un nuevo repositorio en Azure Repos y lo configura con los secretos necesarios para autenticarse en Azure.

   

9. Escriba y para continuar cuando azd le pida que confirme e inserte los cambios locales para iniciar la canalización configurada.

Explora la canalización y la aplicación desplegada

1. Vaya a su nuevo pipeline de Azure utilizando el enlace de estado generado por azd.

   

2. Seleccione la ejecución del pipeline completado para ver el resumen.

   

3. Seleccione el vínculo del trabajo en la parte inferior de la vista para ir a los detalles del trabajo.

   

4. La página de detalles del trabajo muestra el estado de todas las fases individuales. Seleccione Aprovisionar infraestructura para ver los registros de esa fase, que detallan todos los pasos de aprovisionamiento completados por azd. En la parte inferior de los registros, tome nota del mensaje de estado final y vincule al grupo de recursos Azure aprovisionado.

5. Seleccione el vínculo situado en la parte inferior de los registros de salida de aprovisionamiento para ir al nuevo grupo de recursos Azure.

   

   Nota:

   También puede navegar directamente a su nuevo grupo de recursos buscándolo en el Portal de Azure. El nombre del grupo de recursos será el nombre del entorno que proporcionó a azd, prefijado con rg-.

6. Seleccione la aplicación contenedora webfrontend, que hospeda la parte pública de tu sitio.

7. En la página de detalles de webfrontend, seleccione el enlace url de la aplicación para abrir el sitio en el navegador.

¡Felicidades! Implementó correctamente un proyecto Aspire utilizando los Azure Developer CLI y Azure Pipelines.

Solución de problemas de implementación de Azure canalización de DevOps

En esta sección se tratan los problemas comunes que pueden surgir al implementar Aspire proyectos mediante Azure canalizaciones de DevOps.

ERROR: no existe ningún proyecto; para crear un nuevo proyecto, ejecute azd init.

Problema: durante el paso de aprovisionamiento de la canalización de Azure DevOps, aparece el mensaje de error:

ERROR: no project exists; to create a new project, run azd init

Causa: Este error se produce porque el azd init comando genera archivos (azure.yaml y la carpeta) que normalmente no se confirman en el .azure repositorio. Cuando la canalización se ejecuta en un entorno limpio, estos archivos no existen, lo que provoca un error en los azd comandos.

Solución: Hay varios enfoques para resolver este problema:

Opción 1: Ejecutar azd init en la canalización (recomendado)

Agregue un paso azd init a su canalización de DevOps Azure antes del paso de aprovisionamiento. Puede usar las marcas --from-code y --no-prompt para ejecutar el comando de forma no interactiva:

- task: AzureCLI@2
  displayName: 'Initialize Azure Developer CLI'
  inputs:
    azureSubscription: '$(AZURE_SERVICE_CONNECTION)'
    scriptType: 'bash'
    scriptLocation: 'inlineScript'
    inlineScript: |
      azd init --from-code --no-prompt
      azd env new $(AZURE_ENV_NAME) --location $(AZURE_LOCATION) --subscription $(AZURE_SUBSCRIPTION_ID)

Asegúrese de definir las siguientes variables en la canalización:

• AZURE_ENV_NAME: el nombre del entorno (por ejemplo, dev o prod).
• AZURE_LOCATION: su Azure región (por ejemplo, eastus2).
• AZURE_SUBSCRIPTION_ID: Su identificación de suscripción Azure.

Opción 2: Confirmar los archivos necesarios en el repositorio

Si prefiere confirmar los archivos generados en el repositorio:

1. Ejecute azd init localmente en el directorio del proyecto.
2. Agregue el archivo generado azure.yaml al repositorio.
3. Opcionalmente, agregue la .azure carpeta al repositorio si desea conservar la configuración específica del entorno.

Opción 3: Utilizar la configuración del pipeline azd con la inicialización adecuada

Asegúrese de ejecutar azd pipeline config --provider azdo después de ejecutar localmente azd init correctamente. Este comando debe configurar la canalización con la configuración correcta que controla la inicialización automáticamente.

Si sigue experimentando problemas, compruebe que:

• La estructura del proyecto coincide con lo que azd espera para Aspire proyectos.
• Está ejecutando los comandos desde el directorio correcto (normalmente donde se encuentra el .sln archivo).
• La Azure conexión del servicio DevOps tiene los permisos necesarios para aprovisionar recursos.