Configurer Dapr sur une application conteneur existante

Vous pouvez configurer Dapr à l’aide de différents arguments et annotations en fonction du contexte d’exécution. Les configurations Dapr disponibles dans Azure Container Apps sont considérées comme des modifications d’étendue d’application . Lorsque vous exécutez une application conteneur en mode de révision multiple, les modifications apportées à ces paramètres ne créent pas de révision. Au lieu de cela, toutes les révisions existantes sont redémarrées pour s’assurer qu’elles sont configurées avec les valeurs les plus à jour.

Azure Container Apps fournit trois canaux via lesquels vous pouvez activer et configurer Dapr :

L'interface de ligne de commande Azure
Modèles Infrastructure as Code (IaC), comme les modèles Bicep ou Azure Resource Manager (ARM)
Le portail Azure

Le tableau suivant présente la liste actuellement prise en charge des configurations side-car Dapr pour l’activation de Dapr dans Azure Container Apps :

Interface CLI de Container Apps	Champ de modèle	Descriptif
`--enable-dapr`	`dapr.enabled`	Active Dapr sur l’application de conteneur.
`--dapr-app-port`	`dapr.appPort`	Port sur lequel votre application écoute et qui est utilisé par Dapr pour communiquer avec votre application
`--dapr-app-protocol`	`dapr.appProtocol`	Indique à Dapr quel protocole votre application utilise. Les options valides sont `http` ou `grpc`. Le paramètre par défaut est `http`.
`--dapr-app-id`	`dapr.appId`	Identificateur Dapr unique pour votre application conteneur utilisée pour la découverte de service, l’encapsulation d’état et l’ID du consommateur Pub/Sub.
`--dapr-max-request-size`	`dapr.httpMaxRequestSize`	Définissez la taille maximale des serveurs http et grpc du corps de la demande pour gérer le chargement de fichiers volumineux. Le paramètre par défaut est `4 MB`.
`--dapr-read-buffer-size`	`dapr.httpReadBufferSize`	Définissez la taille maximale de la mémoire tampon de lecture d’en-tête HTTP à gérer lors de l’envoi d’en-têtes de plusieurs Ko. Le paramètre par défaut est `4 KB`.
`--dapr-api-logging`	`dapr.enableApiLogging`	Permet d’afficher les appels d’API de votre application au side-car Dapr.
`--dapr-log-level`	`dapr.logLevel`	Définissez le niveau du journal pour le side-car Dapr. Valeurs autorisées : débogage, erreur, informations, avertissement. Le paramètre par défaut est `info`.
`--dapr-app-health-enabled`	`dapr.appHealth.enabled`	Configuration facultative pour activer les vérifications d’intégrité de l’application pour votre application conteneur à l’aide du format booléen. Le paramètre par défaut est `false`. La santé du sidecar Dapr est liée à ce paramètre d’état de santé de l’application.
`--dapr-app-health-path`	`dapr.appHealth.path`	Définissez le chemin que Dapr appelle pour les sondes de vérification d'intégrité lorsque le canal d'application est HTTP. Cette valeur est ignorée si le canal d’application utilise gRPC. Le paramètre par défaut est `/healthz`.
`--dapr-app-health-probe-interval`	`dapr.appHealth.probeIntervalSeconds`	Nombre de secondes entre chaque sonde d’intégrité. Le paramètre par défaut est `3`.
`--dapr-app-health-probe-timeout`	`dapr.appHealth.probeTimeoutMilliseconds`	Délai d’expiration en millisecondes pour les demandes de sonde d’intégrité. Cette valeur doit être inférieure à la `probeIntervalSeconds` valeur. Le paramètre par défaut est `500`.
`--dapr-app-health-threshold`	`dapr.appHealth.threshold`	Nombre maximal d’échecs consécutifs avant que l’application ne soit considérée comme non saine. Le paramètre par défaut est `3`.
`--dapr-max-concurrency`	`dapr.maxConcurrency`	Limitez l’accès concurrentiel de votre application. Une valeur valide est un nombre supérieur à `0`. `-1` signifie qu’aucune limite n’est appliquée à la concurrence.

Utilisation de l’CLI

Vous pouvez activer Dapr sur votre application conteneur à l’aide d’Azure CLI.

az containerapp dapr enable

Pour plus d’informations et des exemples, consultez la documentation de référence.

Utilisation de Bicep ou d’ARM

Lorsque vous utilisez un modèle IaC, spécifiez les arguments suivants dans la section properties.configuration de la définition de ressource de l’application conteneur.

Biceps
ARM

 dapr: {
   enabled: true
   appId: 'nodeapp'
   appProtocol: 'http'
   appPort: 3000
   httpReadBufferSize: 30
   httpMaxRequestSize: 10
   logLevel: 'debug'
   enableApiLogging: true
   appHealth: {
     enabled: true
     path: '/health'
     probeIntervalSeconds: 3
     probeTimeoutMilliseconds: 1000
     threshold: 3
   },
   maxConcurrency: 10
  }

  "dapr": {
    "enabled": true,
    "appId": "nodeapp",
    "appProtocol": "http",
    "appPort": 3000,
    "httpReadBufferSize": 30,
    "httpMaxRequestSize": 10,
    "logLevel": "debug",
    "enableApiLogging": true,
    "appHealth": {
      "enabled": true,
      "path": "/health",
      "probeIntervalSeconds": 3,
      "probeTimeoutMilliseconds": 1000,
      "threshold": 3,
    },
    "maxConcurrency": 10
  }

Utilisation du portail Azure

Vous pouvez également activer Dapr via l’affichage portail de vos applications conteneur.

Remarque

Avant de commencer, vérifiez que vous avez déjà créé vos propres composants Dapr. Vous pouvez connecter des composants Dapr via votre environnement d’application conteneur dans le portail.

Accédez à votre application conteneur dans le portail Azure et sélectionnez Dapr sous Paramètres dans le menu de gauche.

Par défaut, Dapr est désactivé. Sélectionnez Activé pour développer les paramètres Dapr.

Capture d’écran de Dapr désactivé par défaut et de l’endroit où il faut cliquer pour l’activer.

Entrez l’ID d’application du composant et sélectionnez les titres appropriés. Le cas échéant, sous l’en-tête Composants, sélectionnez le lien pour ajouter et gérer vos composants Dapr dans l’environnement de l’application conteneur.

Capture d’écran montrant certains paramètres de base pour activer Dapr sur l’application conteneur.

Étapes suivantes

En savoir plus sur les composants Dapr dans Azure Container Apps.

Commentaires

Cette page a-t-elle été utile ?

Last updated on 2025-12-23