Gérer Azure Functions dans Azure Container Apps

Vous pouvez gérer vos fonctions déployées dans Azure Container Apps à l’aide d’Azure CLI. Les commandes suivantes vous aident à répertorier, inspecter et interagir avec les fonctions en cours d’exécution dans votre environnement conteneurisé.

Note

Lorsque vous traitez des scénarios multirévisionnement, ajoutez le --revision <REVISION_NAME> paramètre à votre commande pour cibler une révision spécifique.

Fonctions de liste

Affichez toutes les fonctions déployées dans votre application conteneur :

# List all functions
az containerapp function list \
  --resource-group $RESOURCE_GROUP \
  --name $CONTAINERAPP_NAME

Afficher les détails de la fonction

Obtenez des informations détaillées sur une fonction spécifique :

az containerapp function show \
  --resource-group $RESOURCE_GROUP \
  --name $CONTAINERAPP_NAME \
  --function-name <FUNCTIONS_APP_NAME>

Surveiller les appels de fonction

La supervision de votre application de fonction est essentielle pour comprendre ses performances et diagnostiquer les problèmes. Les commandes suivantes vous montrent comment récupérer des URL de fonction, déclencher des appels et afficher des synthèses détaillées de télémétrie et d’appel à l’aide d’Azure CLI. Avant d’appeler les traces, appelez la fonction quelques fois en utilisant curl -X POST "fqdn/api/HttpExample".

  1. Pour afficher les traces d’appel, obtenez des traces détaillées des appels de fonction :

    az containerapp function invocations traces \
  --name $CONTAINERAPP_NAME \
  --resource-group $RESOURCE_GROUP \
  --function-name <FUNCTIONS_APP_NAME> \
  --timespan 5h \
  --limit 3

  2. Affichez un résumé d’appel pour passer en revue les appels réussis et ayant échoué.

    az containerapp function invocations summary \
  --name $CONTAINERAPP_NAME \
  --resource-group $RESOURCE_GROUP \
  --function-name <FUNCTIONS_APP_NAME> \
  --timespan 5h

Gérer les clés de fonction

Azure Functions utilise des clés pour l’authentification et l’autorisation. Vous pouvez gérer les différents types de clés suivants :

  • Clés d’hôte : Accéder à n’importe quelle fonction dans l’application
  • Clés principales : fournir un accès administratif
  • Clés système : utilisées par les services Azure
  • Clés de fonction : Accéder à des fonctions spécifiques

Les commandes suivantes vous montrent comment gérer les clés pour l’hôte. Pour exécuter la même commande pour une application Functions spécifique, ajoutez le --function-name <FUNCTIONS_APP_NAME> paramètre à votre commande.

Afficher la liste des clés

Utilisez les commandes suivantes pour répertorier les clés propres à l’hôte et à la fonction pour vos fonctions Azure s’exécutant dans Container Apps.

Note

Conservez au moins un réplica en cours d’exécution afin que les commandes de gestion des clés suivantes fonctionnent.

az containerapp function keys list \
  --resource-group $RESOURCE_GROUP \
  --name $CONTAINERAPP_NAME \
  --key-type hostKey

Afficher une clé spécifique

Affichez la valeur d’une clé de niveau hôte spécifique pour votre application de fonction à l’aide de la commande suivante :

az containerapp function keys show \
  --resource-group $RESOURCE_GROUP \
  --name $CONTAINERAPP_NAME \
  --key-name <KEY_NAME> \
  --key-type hostKey

Définir une clé

Définissez une clé de niveau hôte spécifique pour votre application de fonction à l’aide de la commande suivante :

az containerapp function keys set \
  --resource-group $RESOURCE_GROUP \
  --name $CONTAINERAPP_NAME \
  --key-name <KEY_NAME> \
  --key-value <KEY_VALUE> \
  --key-type hostKey

Gestion des clés dans Azure Key Vault

Lorsque vous utilisez Azure Key Vault pour stocker des secrets pour Azure Functions sur Container Apps, la génération de clés fonctionne différemment de celle de l’hébergement de fonctions traditionnelles.

Par défaut :

  • L’hôte Functions ne crée pas automatiquement de clés dans Key Vault au démarrage.

  • L’hôte Functions récupère et utilise des clés s’ils existent déjà dans Key Vault.

  • L’hôte Functions démarre correctement même sans clés, et la synchronisation des clés se termine normalement.

Par conséquent, votre application s’exécute correctement, mais les clés au niveau de l’hôte n’apparaissent pas dans Key Vault, sauf si vous les créez manuellement.

Générer manuellement des clés

Pour déclencher la création de clés dans Azure Key Vault, appelez le point de terminaison de gestion Functions à l’aide de la commande CLI suivante.

az containerapp function keys list \
 -n <CONTAINER_APP_NAME> \
 -g <RESOURCE_GROUP> \
 --key-type hostKey

Contenu connexe

  • Last updated on