Partager via

Vue d’ensemble des fonctions Azure pour Azure Redis

  • Article

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 fournissent 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 Niveau de support
Déclencheur sur les sous-messages de publication Redis Déclencheur Aperçu
Déclencheur sur les listes Redis Déclencheur Aperçu
Déclencheur sur les flux Redis Déclencheur Aperçu
Lire une valeur mise en cache Input Aperçu
Écrire des valeurs dans le cache Sortie Aperçu

É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 pour la chaîne de connexion du 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.

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>"

Contenu connexe