Partager via


Démarrage rapide : Créer une application Python avec Azure Managed Redis

Dans cet article, vous allez apprendre à utiliser un cache Redis managé Azure avec le langage Python et à vous connecter à l’aide de l’ID Microsoft Entra.

Conditions préalables

  • Abonnement Azure : créez-en un gratuitement
  • Installer l’environnement de langage Python 3.7+
  • Ajoutez ces importations à partir de votre projet et à votre environnement de développement
    • redis - Le client Python Redis
    • redis-entraid - Extension d’authentification Redis Microsoft Entra ID
    • azure-identity - Bibliothèque d’authentification Azure

Créer une instance Azure Managed Redis

Tout d’abord, créez un cache. Vous pouvez créer un cache à l’aide d’Azure Managed Redis ou du Cache Azure pour Redis à l’aide du portail Azure. Dans ce guide de démarrage rapide, nous utilisons Azure Managed Redis.

Lorsque vous créez le cache, l’ID Microsoft Entra est activé par défaut pour le sécuriser à partir du démarrage. Votre cache doit également utiliser un point de terminaison public pour ce guide de démarrage rapide.

Pour créer un cache avec le portail, suivez l’une des procédures suivantes :

Si vous le souhaitez, vous pouvez créer un cache à l’aide d’Azure CLI, PowerShell, selon ce que vous préférez.

Code permettant de se connecter à un cache Redis

Dans la première partie de l’exemple de code, définissez votre connexion au cache.

  • Ports pour les caches Redis et Entreprise managés par Azure : 10 000
  • Ports pour les instances du Cache Azure pour Redis : 6380
import redis
from azure.identity import DefaultAzureCredential
from redis_entraid.cred_provider import create_from_default_azure_credential

redis_host = "<host-url>"
redis_port = 10000  # Managed Redis default port

credential_provider = create_from_default_azure_credential(
    ("https://redis.azure.com/.default",),
)

r = redis.Redis(
    host=redis_host,
    port=redis_port,
    ssl=True,
    decode_responses=True,
    credential_provider=credential_provider
)

Avant de pouvoir exécuter ce code, vous devez vous ajouter en tant qu’utilisateur Redis au cache.

Vous devez également autoriser votre connexion à Azure à partir de la ligne de commande à l’aide de la ligne de commande Azure ou de la ligne de commande du développeur Azure (azd).

Vous devez également ajouter des utilisateurs ou une entité système à votre cache. Ajoutez toute personne qui peut exécuter le programme en tant qu’utilisateur sur le cache Redis.

Le résultat ressemble à ceci :

PING: True
GET: Hello from Azure Managed Redis!

Ici, vous pouvez voir cet exemple de code dans son intégralité. Le code contient une vérification des erreurs omise dans les explications de code précédentes pour simplifier. La dernière étape consiste à fermer la connexion au cache.

import redis
from azure.identity import DefaultAzureCredential
from redis_entraid.cred_provider import create_from_default_azure_credential

redis_host = "<host-url>"
redis_port = 10000  # Managed Redis default port

credential_provider = create_from_default_azure_credential(
    ("https://redis.azure.com/.default",),
)

try:
    r = redis.Redis(
        host=redis_host,
        port=redis_port,
        ssl=True,
        decode_responses=True,
        credential_provider=credential_provider,
        socket_timeout=10,
        socket_connect_timeout=10
    )

    print("PING:", r.ping())
    r.set("Message", "Hello from Azure Managed Redis!")
    print("GET:", r.get("Message"))

except Exception as e:
    print(f"Error: {e}")
finally:
    if 'r' in locals():
        r.close()

Nettoyer les ressources

Si vous souhaitez continuer à utiliser les ressources que vous avez créées dans cet article, conservez le groupe de ressources.

Sinon, si vous avez terminé avec les ressources, vous pouvez supprimer le groupe de ressources Azure que vous avez créé pour éviter les frais.

Important

La suppression d’un groupe de ressources est irréversible. Quand vous supprimez un groupe de ressources, toutes les ressources qu’il contient sont supprimées définitivement. Veillez à ne pas supprimer accidentellement des ressources ou un groupe de ressources incorrects. Si vous avez créé les ressources dans un groupe de ressources existant contenant des ressources que vous souhaitez conserver, vous pouvez supprimer chaque ressource individuellement, au lieu de supprimer l’intégralité du groupe de ressources.

Pour supprimer un groupe de ressources

  1. Connectez-vous au Portail Azure, puis sélectionnez Groupes de ressources.

  2. Recherchez le groupe de ressources à supprimer.

    S’il existe de nombreux groupes de ressources, utilisez la zone Filtrer pour n’importe quel champ..., saisissez le nom du groupe de ressources que vous avez créé pour cet article. Sélectionnez le groupe de ressources dans la liste des résultats.

    Capture d’écran présentant une liste de groupes de ressources à supprimer dans le volet de travail.

  3. Sélectionnez Supprimer le groupe de ressources.

  4. Vous êtes invité à confirmer la suppression du groupe de ressources. Saisissez le nom de votre groupe de ressources pour confirmer, puis sélectionnez Supprimer.

    Capture d’écran présentant un formulaire qui demande le nom de la ressource pour confirmer la suppression.

Après quelques instants, le groupe de ressources et toutes ses ressources sont supprimés.