Inicio rápido: Implementación de una aplicación Dapr en Azure Container Apps mediante la CLI de Azure
Artículo
Dapr (Distributed Application Runtime) ayuda a los desarrolladores a crear microservicios resistentes y de confianza. En este inicio rápido, aprenderá a habilitar los sidecars de Dapr para que se ejecuten junto con sus aplicaciones de contenedores de microservicios. Hará lo siguiente:
Cree un entorno de Container Apps y un almacén de estado de Azure Blog Storage para las aplicaciones de contenedor.
Implemente una aplicación de contenedor de Python que publique mensajes.
Implemente una aplicación contenedora de Node.js que se suscriba a los mensajes y las conserve en un almacén de estado.
Compruebe la interacción entre los dos microservicios mediante Azure Portal.
Este inicio rápido refleja las aplicaciones que implementa en el inicio rápido de código abierto de Dapr Hola mundo.
Configurar
Para iniciar sesión en Azure desde la CLI, ejecute el siguiente comando y siga las indicaciones para completar el proceso de autenticación.
Install-Module -Name Az -Scope CurrentUser -Repository PSGallery -Force
Omita las advertencias sobre los módulos en uso.
Luego, instale o actualice la extensión de Azure Container Apps para la CLI.
Si recibe errores sobre los parámetros que faltan al ejecutar az containerapp comandos en la CLI de Azure o cmdlets del Az.App módulo en Azure PowerShell, asegúrese de que tiene instalada la versión más reciente de la extensión Azure Container Apps.
A partir de mayo de 2024, las extensiones de la CLI de Azure ya no habilitan las características en versión preliminar de forma predeterminada. Para acceder a las características de la versión preliminar de Container Apps, instale la extensión Container Apps con --allow-preview true.
az extension add --name containerapp --upgrade --allow-preview true
Install-Module -Name Az.App
Asegúrese de actualizar el Az.App módulo a la versión más reciente.
Update-Module -Name Az.App
Ahora que la extensión o módulo actualizado está instalado, registre los espacios de nombre Microsoft.App y Microsoft.OperationalInsights.
Un entorno de Azure Container Apps crea un límite seguro alrededor de un grupo de aplicaciones de contenedor. Las aplicaciones de contenedor implementadas en el mismo entorno se implementan en la misma red virtual y escriben registros en la misma área de trabajo de Log Analytics.
Para crear el entorno, ejecute el comando siguiente:
Se requiere un área de trabajo de Log Analytics para el entorno de Container Apps. Los siguientes comandos crean un área de trabajo de Log Analytics y guardan el id. del área de trabajo y la clave compartida principal en variables de entorno.
Con el entorno implementado, implemente una cuenta de Azure Blob Storage que usa la aplicación contenedora de Node.js para almacenar datos. Antes de implementar el servicio, elija un nombre para la cuenta de almacenamiento. Los nombres de las cuentas de almacenamiento deben ser únicos en Azure, deben tener entre 3 y 24 caracteres y deben contener solo números y letras en minúscula.
Configuración de una identidad asignada por el usuario para la aplicación de nodo
Aunque Container Apps admite tanto identidades administradas asignadas por el usuario como por el sistema, una identidad asignada por el usuario proporciona a la aplicación Node.js habilitada para Dapr permisos para acceder a la cuenta de Blob Storage.
Configuración del componente del almacén de estado
Aunque tiene varias opciones para autenticarse en recursos externos a través de Dapr. Este ejemplo usa un almacén de estado basado en Azure, por lo que puede proporcionar acceso directo desde la aplicación Node.js al almacén de Blob usando Identidad administrada.
En un editor de texto, cree un archivo denominado statestore.yaml con las propiedades de origen de los pasos anteriores.
Este archivo ayuda a permitir que la aplicación Dapr acceda al almacén de estado.
Vaya al directorio en el que almacenó el archivo yaml y ejecute el siguiente comando para configurar el componente Dapr en el entorno de Container Apps.
Si usa una instancia de Azure Container Registry, incluya la marca RegistryServer = '<REGISTRY_NAME>.azurecr.io' en el comando.
Verificación de los resultados
Confirmación de la persistencia de estado correcta
Puede confirmar que los servicios funcionan correctamente mediante la visualización de datos en la cuenta de Azure Storage.
Abra Azure Portal en el navegador y vaya a la cuenta de almacenamiento.
Seleccione Almacenamiento de datos>Contenedores en el menú izquierdo.
Seleccione la aplicación contenedora.
Compruebe que puede ver el archivo denominado order en el contenedor.
Seleccione el archivo .
Seleccione la pestaña Editar.
Seleccione el botón Actualizar para ver cómo se actualizan automáticamente los datos.
Ver registros
Los registros de una aplicación de contenedor se almacenan en la tabla personalizada ContainerAppConsoleLogs_CL del área de trabajo de Log Analytics. Puede ver los registros mediante Azure Portal o la CLI. Inicialmente, la tabla puede tardar un breve período de tiempo en aparecer en el área de trabajo.
Vea los registros mediante la línea de comandos mediante el siguiente comando de la CLI.
LOG_ANALYTICS_WORKSPACE_CLIENT_ID=`az containerapp env show --name $CONTAINERAPPS_ENVIRONMENT --resource-group $RESOURCE_GROUP --query properties.appLogsConfiguration.logAnalyticsConfiguration.customerId --out tsv`
az monitor log-analytics query \
--workspace $LOG_ANALYTICS_WORKSPACE_CLIENT_ID \
--analytics-query "ContainerAppConsoleLogs_CL | where ContainerAppName_s == 'nodeapp' and (Log_s contains 'persisted' or Log_s contains 'order') | project ContainerAppName_s, Log_s, TimeGenerated | sort by TimeGenerated | take 5" \
--out table
$queryResults = Invoke-AzOperationalInsightsQuery -WorkspaceId $WorkspaceId -Query "ContainerAppConsoleLogs_CL | where ContainerAppName_s == 'nodeapp' and (Log_s contains 'persisted' or Log_s contains 'order') | project ContainerAppName_s, Log_s, TimeGenerated | take 5 "
$queryResults.Results
En la salida siguiente, se muestra el tipo de respuesta que se espera del comando de la CLI.
ContainerAppName_s Log_s TableName TimeGenerated
-------------------- ------------------------------- ------------- ------------------------
nodeapp Got a new order! Order ID: 61 PrimaryResult 2021-10-22T21:31:46.184Z
nodeapp Successfully persisted state. PrimaryResult 2021-10-22T21:31:46.184Z
nodeapp Got a new order! Order ID: 62 PrimaryResult 2021-10-22T22:01:57.174Z
nodeapp Successfully persisted state. PrimaryResult 2021-10-22T22:01:57.174Z
nodeapp Got a new order! Order ID: 63 PrimaryResult 2021-10-22T22:45:44.618Z
Limpieza de recursos
Puesto que pythonapp realiza llamadas continuas a nodeapp con mensajes que se conservan en el almacén de estado configurado, es importante completar estos pasos de limpieza para evitar las operaciones facturables en curso.
Si quiere eliminar los recursos creados como parte de este tutorial, ejecute el siguiente comando.
Precaución
Este comando elimina el grupo de recursos especificado y todos los recursos que contiene. Si existen recursos en el grupo de recursos especificado que están fuera del ámbito de este tutorial, también se eliminarán.
Cree soluciones de un extremo a otro en Microsoft Azure para crear Azure Functions, implementar y administrar aplicaciones web, desarrollar soluciones que usen Azure Storage, etc.