Partager via


Vue d’ensemble des fonctions Azure pour Azure Redis

Cet article explique comment utiliser Azure Managed Redis ou Azure Cache pour Redis avec Azure Functions pour créer des architectures serverless et pilotées par les événements optimisées.

Azure Functions fournit un modèle de programmation piloté par les événements où les déclencheurs et les liaisons sont des fonctionnalités clés. Avec Azure Functions, vous pouvez facilement créer des applications serverless pilotées par les événements. Les services Azure Redis (Azure Managed Redis et Azure Cache pour Redis) fournissent 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/sous-messagerie, etc.

Azure Redis peut être utilisé comme déclencheur pour Azure Functions, ce qui vous permet de lancer un flux de travail serverless. Cette fonctionnalité peut être très utile dans les architectures de données telles qu’un cache en écriture-behind ou toutes les architectures basées sur les événements.

Vous pouvez intégrer Azure Redis et Azure Functions pour créer des fonctions qui réagissent aux événements d’Azure Redis ou de systèmes externes.

Action Sens
Déclencheur sur les sous-messages de publication Redis Déclencheur
Déclencheur sur les listes Redis Déclencheur
Déclencheur sur les flux Redis Déclencheur
Lire une valeur mise en cache Input
Écrire des valeurs dans le cache Sortie

Étendue de la disponibilité pour les déclencheurs et liaisons de fonctions

Niveau Azure Cache pour Redis (De base, Standard, Premium, Enterprise, Enterprise Flash) Azure Managed Redis (mémoire optimisée, de base, optimisée pour le calcul, mémoire optimisée, mémoire optimisée)
Pub/Sub Oui Oui
Listes Oui Oui
Flux Oui Oui
Liaisons Oui Oui

Important

Les déclencheurs Redis sont actuellement pris en charge uniquement pour les fonctions s’exécutant dans un plan Elastic Premium ou un plan App Service dédié.

Installer l’extension

Les fonctions s’exécutent dans un processus de travail C# isolé. Pour en savoir plus, consultez Guide pour l’exécution d’Azure Functions C# dans un processus Worker isolé.

Ajoutez l’extension à votre projet en installant ce package NuGet.

dotnet add package Microsoft.Azure.Functions.Worker.Extensions.Redis

Installer le bundle

  1. Créer un projet de fonction Java. Vous pouvez utiliser Maven : mvn archetype:generate -DarchetypeGroupId=com.microsoft.azure -DarchetypeArtifactId=azure-functions-archetype -DjavaVersion=8

  2. Ajoutez 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.11.*, 5.0.0)"
      }
    }
    

    Avertissement

    L’extension Redis est actuellement disponible uniquement dans une préversion de l’offre groupée.

  3. Ajoutez la bibliothèque Java pour les liaisons Redis au pom.xml fichier :

    <dependency>
      <groupId>com.microsoft.azure.functions</groupId>
      <artifactId>azure-functions-java-library-redis</artifactId>
      <version>${azure.functions.java.library.redis.version}</version>
    </dependency>
    

Ajoutez 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.11.*, 5.0.0)"
  }
}

Avertissement

L’extension Redis est actuellement disponible uniquement dans une préversion de l’offre groupée.

Chaîne de connexion Redis

Les déclencheurs et liaisons Redis Azure ont une propriété requise qui indique le paramètre d’application ou le nom de collection qui contient des informations de connexion de cache. Vous trouverez chaîne de connexion dans le menu Touches d’accès dans le portail Redis managé Azure ou Azure Cache pour Redis portail. Le déclencheur ou la liaison Redis recherche une variable d’environnement contenant la chaîne de connexion avec le nom passé au Connection paramètre .

Dans le développement local, le Connection peut être défini à l’aide du fichier local.settings.json. Lors du déploiement sur Azure, les paramètres d’application peuvent être utilisés.

Lors de la connexion à une instance de cache avec une fonction Azure, vous pouvez utiliser trois types de connexions dans vos déploiements : chaîne de connexion, identité managée affectée par le système et identité managée affectée par l’utilisateur.

Pour le développement local, vous pouvez également utiliser des secrets de principal de service.

Important

Pour une sécurité optimale, votre application de fonction doit utiliser l’ID Microsoft Entra avec des identités managées pour autoriser les demandes sur votre cache, si possible. L’autorisation avec Microsoft Entra ID et les identités managées offre davantage de sécurité et de facilité d’utilisation que l’autorisation par clé d’accès partagée. Pour plus d’informations sur l’utilisation d’identités managées avec votre cache, consultez Utiliser Microsoft Entra ID pour l’authentification du cache.

Utilisez la appsettings commande pour configurer chacun des types d’authentification client suivants, en supposant que le Connection paramètre a été défini Redis dans la fonction.

Chaîne de connexion

"Redis": "<cacheName>.<region>.redis.azure.net:10000,password=..."

Identité managée affectée par le système

"Redis__redisHostName": "<cacheName>.<region>.redis.azure.net",
"Redis__principalId": "<principalId>"

Identité managée affectée par l’utilisateur

"Redis__redisHostName": "<cacheName>.<region>.redis.azure.net",
"Redis__principalId": "<principalId>",
"Redis__clientId": "<clientId>"

Secret du principal de service

Les connexions utilisant les secrets du principal de service sont disponibles uniquement pendant le développement local.

"Redis__redisHostName": "<cacheName>.<region>.redis.azure.net",
"Redis__principalId": "<principalId>",
"Redis__clientId": "<clientId>"
"Redis__tenantId": "<tenantId>"
"Redis__clientSecret": "<clientSecret>"