Início rápido: Crie uma aplicação Python com o Azure Managed Redis

Neste artigo, aprende a usar uma cache Azure Managed Redis com a linguagem Python e a ligar-se usando o Microsoft Entra ID.

Pré-requisitos

• Subscrição do Azure - crie uma gratuitamente
• Instalar o ambiente de linguagem Python 3.7+
• Adicione essas importações ao seu projeto e ao seu ambiente de desenvolvimento
  • redis - O cliente Redis Python
  • redis-entraid - Extensão de autenticação Redis Microsoft Entra ID
  • azure-identity - Biblioteca de autenticação do Azure

Criar uma instância do Azure Managed Redis

Primeiro, crie um cache. Você pode criar um cache usando o Azure Managed Redis ou o Azure Cache for Redis usando o portal do Azure. Neste Guia de início rápido, usamos o Azure Managed Redis.

Quando você cria o cache, o Microsoft Entra ID é habilitado por padrão, tornando-o seguro desde o início. O seu cache também deve usar um ponto de extremidade público para este QuickStart.

Para criar um cache com o portal, siga um destes procedimentos:

• Redis Gerenciado do Azure
• Azure Cache for Redis

Opcionalmente, você pode criar um cache usando a CLI do Azure, o PowerShell, o que preferir.

Código para se conectar a um cache Redis

Na primeira parte do exemplo de código, defina sua conexão com o cache.

• Portas para caches Redis e Enterprise Managed do Azure: 10000
• Portas para instâncias do Azure Cache para 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
)

Antes de executar esse código, você deve se adicionar como um usuário Redis ao cache.

Você também deve autorizar sua conexão com o Azure a partir da linha de comando usando a linha de comando do Azure ou a linha de comando do desenvolvedor do Azure (azd).

Você também deve adicionar usuários ou um principal do sistema ao cache. Adicione qualquer pessoa que possa executar o programa como um usuário no cache Redis.

O resultado é assim:

PING: True
GET: Hello from Azure Managed Redis!

Aqui, você pode ver este exemplo de código na íntegra. O código contém alguma verificação de erro omitida das explicações de código anteriores para simplificar. A etapa final é fechar a conexão com o 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()

Limpeza de recursos

Se quiser continuar a usar os recursos criados neste artigo, mantenha o grupo de recursos.

Caso contrário, se tiver terminado os recursos, pode eliminar o grupo de recursos do Azure que criou para evitar cobranças.

Importante

A eliminação de um grupo de recursos é irreversível. Quando elimina um grupo de recursos, todos os recursos nele contidos são eliminados permanentemente. Certifique-se de que não elimina acidentalmente grupos de recursos ou recursos errados. Se você criou os recursos dentro de um grupo de recursos existente que contém recursos que deseja manter, poderá excluir cada recurso individualmente em vez de excluir o grupo de recursos.

Para eliminar um grupo de recursos

1. Inicie sessão no Portal do Azure e selecione Grupos de recursos.

2. Selecione o grupo de recursos que pretende eliminar.

   Se houver muitos grupos de recursos, use a caixa Filtrar para qualquer campo... , digite o nome do grupo de recursos criado para este artigo. Selecione o grupo de recursos na lista de resultados.

   

3. Selecione Eliminar grupo de recursos.

4. É-lhe pedido que confirme a eliminação do grupo de recursos. Escreva o nome do grupo de recursos para confirmar e, em seguida, selecione Eliminar.

   

Após alguns instantes, o grupo de recursos e todos os respetivos recursos são eliminados.

Conteúdo relacionado

• Extensão Redis para conexão usando o Microsoft Entra ID
• Guia Redis-py