Extension Dapr pour Azure Functions

Article
02/06/2024

Important

L’extension Dapr pour Azure Functions est actuellement en préversion et uniquement prise en charge dans les environnements Azure Container Apps.

L’extension Dapr pour Azure Functions est un ensemble d’outils et de services qui permettent aux développeurs d’intégrer facilement Azure Functions à la plateforme de l’application distribuée Dapr (Distributed Application Runtime).

Azure Functions est un service de calcul basé sur les événements qui fournit un ensemble de déclencheurs et de liaisons pour se connecter facilement à d’autres services Azure. Dapr fournit un ensemble de blocs de construction et de bonnes pratiques pour la création d’applications distribuées, notamment les microservices, la gestion de l’état, la publication/la messagerie secondaire, et plus encore.

Avec l’intégration entre Dapr et Functions, vous pouvez créer des fonctions qui réagissent aux événements à partir de Dapr ou de systèmes externes.

Action	Sens	Type
Déclencheur sur une liaison d’entrée Dapr	N/A	daprBindingTrigger
Déclencheur sur un appel de service Dapr	N/A	daprServiceInvocationTrigger
Déclencher sur un abonnement à une rubrique Dapr	N/A	daprTopicTrigger
Extraire l’état Dapr pour une exécution	Dans	daprState
Extraire des secrets Dapr pour une exécution	Dans	daprSecret
Enregistrer une valeur dans un état Dapr	Out	daprState
Appeler une autre application Dapr	Out	daprInvoke
Publier un message dans une rubrique Dapr	Out	daprPublish
Envoyer une valeur à une liaison de sortie Dapr	Out	daprBinding

Installer l’extension

Le package NuGet d’extension que vous installez dépend du mode C# in-process ou processus worker isolé que vous utilisez dans votre application de fonction :

In-process
Processus isolé

Cette version de l’extension est disponible via l’installation du package NuGet, version 0.17.0-preview01.

Utilisation de l’interface CLI .NET :

dotnet add package Microsoft.Azure.WebJobs.Extensions.Dapr --prerelease

Ajoutez l’extension à votre projet en installant le package NuGet, version 0.17.0-preview01.

Utilisation de l’interface CLI .NET :

dotnet add package Microsoft.Azure.Functions.Worker.Extensions.Dapr --prerelease

Installer le bundle

Bundle v4.x (préversion)

Vous pouvez ajouter l’extension en préversion en ajoutant ou en remplaçant le code suivant dans votre fichier host.json :

{
  "version": "2.0",
  "extensionBundle": {
    "id": "Microsoft.Azure.Functions.ExtensionBundle.Preview",
    "version": "[4.*, 5.0.0)"
  }
}

Activation de Dapr

Vous pouvez configurer Dapr à l’aide de différents [arguments et annotations][dapr-args] en fonction du contexte d’exécution. Vous pouvez configurer Dapr pour Azure Functions via deux canaux :

Modèles Infrastructure as Code (IaC), comme dans les modèles Bicep ou Azure Resource Manager (ARM)
Le portail Azure

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

Bicep
ARM

DaprConfig: {
  enabled: true
  appId: '${envResourceNamePrefix}-funcapp'
  appPort: 3001
  httpReadBufferSize: ''
  httpMaxRequestSize: ''
  logLevel: ''
  enableApiLogging: true
}

"DaprConfig": {
  "enabled": true,
  "appId": "${envResourceNamePrefix}-funcapp",
  "appPort": 3001,
  "httpReadBufferSize": "",
  "httpMaxRequestSize": "",
  "logLevel": "",
  "enableApiLogging": true
}

Les valeurs de configuration Dapr ci-dessus 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.

Lorsque vous configurez Dapr à l’aide du portail Azure, accédez à votre application de fonction et sélectionnez Dapr dans le menu de gauche :

Screenshot demonstrating where to find Dapr enablement for a Function App in the Azure portal.

Ports et écouteurs Dapr

Lorsque vous déclenchez une fonction à partir de Dapr, l’extension expose automatiquement le port 3001 pour écouter les requêtes entrantes à partir du side-car Dapr.

Important

Le port 3001 est exposé uniquement et écouté si un déclencheur Dapr est défini dans l’application de fonction. Lors de l’utilisation de Dapr, le sidecar attend de recevoir une réponse du port défini avant de terminer l’instanciation. Ne pas définir l’annotation dapr.io/port ou --app-port , sauf si vous avez un déclencheur. Cela peut verrouiller votre application à partir du side-car Dapr.

Si vous utilisez uniquement des liaisons d’entrée et de sortie, le port 3001 n’a pas besoin d’être exposé ou défini.

Par défaut, quand Azure Functions tente de communiquer avec Dapr, il appelle Dapr sur le port résolu à partir de la variable d’environnement DAPR_HTTP_PORT. Si cette variable a la valeur Null, elle est définie par défaut sur le port 3500.

Vous pouvez remplacer l’adresse Dapr utilisée par les liaisons d’entrée et de sortie en définissant la propriété DaprAddress dans function.json pour la liaison (ou l’attribut). Par défaut, il utilise http://localhost:{DAPR_HTTP_PORT}.

L’application de fonction expose toujours un autre port et point de terminaison pour des éléments tels que les déclencheurs HTTP, qui sont localement par défaut 7071, mais dans un conteneur, la valeur par défaut est 80.

Types de liaisons

Les types de liaisons pris en charge pour .NET dépendent à la fois de la version de l’extension et du mode d’exécution C#, qui peut être l’un des suivants :

Bibliothèque de classes In-process
Processus isolé

Une bibliothèque de classes in-process est une fonction C# compilée exécutée dans le même processus que le runtime Functions.

L’extension Dapr prend en charge les types de paramètres en fonction du tableau ci-dessous.

Liaison	Types de paramètres
Déclencheur Dapr	daprBindingTrigger daprServiceInvocationTrigger daprTopicTrigger
Entrée Dapr	daprState daprSecret
Sortie Dapr	daprState daprInvoke daprPublish daprBinding

Pour obtenir des exemples d’utilisation de ces types, consultez le dépôt GitHub pour l’extension.