Démarrage rapide : Créer une application Durable Functions Python

3. En suivant les invites, saisissez les informations suivantes :

   Prompt	Action	Description
   Sélectionner un langage pour votre projet d’application de fonction	Sélectionnez Python.	Crée un projet Functions Python local.
   Sélectionner une version	Sélectionnez Azure Functions v4.	Vous voyez cette option seulement quand Core Tools n’est pas déjà installé. Dans ce cas, Core Tools est installé la première fois que vous exécutez l’application.
   Version de Python	Sélectionnez Python 3.7, Python 3.8, Python 3.9 ou Python 3.10.	Visual Studio Code crée un environnement virtuel en utilisant la version que vous sélectionnez.
   Sélectionner un modèle pour la première fonction de votre projet	Sélectionnez Ignorer pour le moment.
   Sélectionner la façon dont vous souhaitez ouvrir votre projet	Sélectionnez Ouvrir dans la fenêtre actuelle.	Ouvre Visual Studio Code dans le dossier que vous avez sélectionné.

3. En suivant les invites, saisissez les informations suivantes :

   Prompt	Valeur	Description
   Sélectionner une langue	Sélectionnez Python (Modèle de programmation V2).	Crée un projet Functions Python local en utilisant le modèle de programmation V2.
   Sélectionner une version	Sélectionnez Azure Functions v4.	Vous voyez cette option seulement quand Core Tools n’est pas déjà installé. Dans ce cas, Core Tools est installé la première fois que vous exécutez l’application.
   Version de Python	Sélectionnez Python 3.7, Python 3.8, Python 3.9 ou Python 3.10.	Visual Studio Code crée un environnement virtuel en utilisant la version que vous sélectionnez.
   Sélectionner la façon dont vous souhaitez ouvrir votre projet	Sélectionnez Ouvrir dans la fenêtre actuelle.	Ouvre Visual Studio Code dans le dossier que vous avez sélectionné.

Fonction d’orchestrateur

Vous utilisez un modèle pour créer le code de l’application Durable Functions dans votre projet.

1. Dans la palette de commandes, entrez puis sélectionnez Azure Functions : Créer une fonction.

2. En suivant les invites, saisissez les informations suivantes :

   Prompt	Action	Description
   Sélectionner un modèle pour votre fonction	Sélectionnez Orchestrateur Durable Functions.	Crée une orchestration d’application Durable Functions.
   Fournir un nom de fonction	Sélectionnez HelloOrchestrator.	Un nom pour votre fonction durable.

Vous avez ajouté un orchestrateur pour coordonner les fonctions d’activité. Ouvrez HelloOrchestrator/__init__.py pour voir la fonction d’orchestrateur. Chaque appel à context.call_activity appelle une fonction d’activité nommée Hello.

Ensuite, vous ajoutez la fonction d’activité Hello référencée.

Fonction d’activité

1. Dans la palette de commandes, entrez puis sélectionnez Azure Functions : Créer une fonction.

2. En suivant les invites, saisissez les informations suivantes :

   Prompt	Action	Description
   Sélectionner un modèle pour votre fonction	Sélectionnez Activité Durable Functions.	Crée une fonction d’activité.
   Fournir un nom de fonction	Entrez Hello.	Le nom de votre fonction d’activité.

Vous avez ajouté la fonction d’activité Hello qui est appelée par l’orchestrateur. Ouvrez Hello/__init__.py pour voir qu’elle accepte un nom comme entrée et retourne un message d’accueil. Une fonction d’activité vous permet d’effectuer des actions, comme faire un appel de base de données ou exécuter un calcul.

Pour terminer, vous ajoutez une fonction déclenchée par HTTP qui démarre l’orchestration.

Fonction de client (démarrage HTTP)

1. Dans la palette de commandes, entrez puis sélectionnez Azure Functions : Créer une fonction.

2. En suivant les invites, saisissez les informations suivantes :

   Prompt	Action	Description
   Sélectionner un modèle pour votre fonction	Sélectionnez Démarrage HTTP Durable Functions.	Crée une fonction de démarrage HTTP.
   Fournir un nom de fonction	Entrez DurableFunctionsHttpStart.	Le nom de votre fonction cliente
   Niveau d’autorisation	Sélectionnez Anonyme.	À des fins de démonstration, cette valeur permet à la fonction d’être appelée sans utiliser d’authentification.

Vous avez ajouté une fonction déclenchée par HTTP qui démarre une orchestration. Ouvrez DurableFunctionsHttpStart/__init__.py pour voir qu’elle se sert de client.start_new pour démarrer une nouvelle orchestration. Elle utilise ensuite client.create_check_status_response pour retourner une réponse HTTP contenant des URL qui peuvent être utilisées pour superviser et gérer la nouvelle orchestration.

Vous disposez maintenant d’une application Durable Functions qui peut être exécutée localement, et déployée sur Azure.

Spécifications

La version 2 du modèle de programmation Python nécessite les versions minimales suivantes :

• Azure Functions Runtime v4.16+
• Azure Functions Core Tools v4.0.5095+ (en cas d’exécution locale)
• azure-functions-durable v1.2.4+

Activer le modèle de programmation v2

Le paramètre d’application suivant est requis pour exécuter le modèle de programmation v2 :

• Nom : AzureWebJobsFeatureFlags
• Valeur : EnableWorkerIndexing

Si vous exécutez localement en utilisant Azure Functions Core Tools, ajoutez ce paramètre à votre fichier local.settings.json. Si vous exécutez dans Azure, effectuez les étapes suivantes en utilisant un outil approprié :

az functionapp config appsettings set --name <FUNCTION_APP_NAME> --resource-group <RESOURCE_GROUP_NAME> --settings AzureWebJobsFeatureFlags=EnableWorkerIndexing

Update-AzFunctionAppSetting -Name <FUNCTION_APP_NAME> -ResourceGroupName <RESOURCE_GROUP_NAME> -AppSetting @{"AzureWebJobsFeatureFlags" = "EnableWorkerIndexing"}

Pour créer une application Durable Functions de base en utilisant ces trois types de fonctions, remplacez le contenu de function_app.py par le code Python suivant :

import azure.functions as func
import azure.durable_functions as df

myApp = df.DFApp(http_auth_level=func.AuthLevel.ANONYMOUS)

# An HTTP-triggered function with a Durable Functions client binding
@myApp.route(route="orchestrators/{functionName}")
@myApp.durable_client_input(client_name="client")
async def http_start(req: func.HttpRequest, client):
    function_name = req.route_params.get('functionName')
    instance_id = await client.start_new(function_name)
    response = client.create_check_status_response(req, instance_id)
    return response

# Orchestrator
@myApp.orchestration_trigger(context_name="context")
def hello_orchestrator(context):
    result1 = yield context.call_activity("hello", "Seattle")
    result2 = yield context.call_activity("hello", "Tokyo")
    result3 = yield context.call_activity("hello", "London")

    return [result1, result2, result3]

# Activity
@myApp.activity_trigger(input_name="city")
def hello(city: str):
    return f"Hello {city}"

Consultez le tableau suivant pour obtenir une explication de chaque fonction et de son objectif dans l’exemple :

1. Pour tester votre fonction, définissez un point d’arrêt dans le code de la fonction d’activité Hello (dans Hello/__init__.py). Sélectionnez F5 ou Déboguer : Démarrer le débogage dans la palette de commandes pour démarrer le projet d’application de fonction. La sortie de Core Tools s’affiche dans le panneau Terminal.

   Remarque

   Pour plus d’informations sur le débogage, consultez Diagnostics Durable Functions.

1. Pour tester votre fonction, définissez un point d’arrêt dans le hello code de la fonction d’activité. Sélectionnez F5 ou Déboguer : Démarrer le débogage dans la palette de commandes pour démarrer le projet d’application de fonction. La sortie de Core Tools s’affiche dans le panneau Terminal.

   Remarque

   Pour plus d’informations sur le débogage, consultez Diagnostics Durable Functions.

5. Utilisez votre navigateur ou un outil de test HTTP pour envoyer une requête HTTP POST au point de terminaison d’URL.

   Remplacez le dernier segment par le nom de la fonction d’orchestrateur (HelloOrchestrator). L’URL doit ressembler à http://localhost:7071/api/orchestrators/HelloOrchestrator.

   La réponse est le résultat initial de la fonction HTTP. Elle vous permet de savoir que l’orchestration durable a démarré correctement. Elle n’affiche pas encore le résultat final de l’orchestration. La réponse contient plusieurs URL utiles. Pour le moment, interrogez l’état de l’orchestration.

6. Copiez la valeur de l’URL pour statusQueryGetUri, collez-la dans la barre d’adresse de votre navigateur, puis exécutez la requête. Vous pouvez également continuer à utiliser votre outil de test HTTP pour émettre la requête GET.

   La requête interroge l’instance d’orchestration pour obtenir l’état. Vous devez voir que l’instance s’est terminée, et qu’elle inclut les sorties ou les résultats de la fonction durable. Elle se présente de façon similaire à cet exemple :

   {
       "name": "HelloOrchestrator",
       "instanceId": "9a528a9e926f4b46b7d3deaa134b7e8a",
       "runtimeStatus": "Completed",
       "input": null,
       "customStatus": null,
       "output": [
           "Hello Tokyo!",
           "Hello Seattle!",
           "Hello London!"
       ],
       "createdTime": "2020-03-18T21:54:49Z",
       "lastUpdatedTime": "2020-03-18T21:54:54Z"
   }
   

5. Utilisez votre navigateur ou un outil de test HTTP pour envoyer une requête HTTP POST au point de terminaison d’URL.

   Remplacez le dernier segment par le nom de la fonction d’orchestrateur (HelloOrchestrator). L’URL doit ressembler à http://localhost:7071/api/orchestrators/HelloOrchestrator.

   La réponse est le résultat initial de la fonction HTTP. Elle vous permet de savoir que l’orchestration durable a démarré correctement. Elle n’affiche pas encore le résultat final de l’orchestration. La réponse contient plusieurs URL utiles. Pour le moment, interrogez l’état de l’orchestration.

6. Copiez la valeur de l’URL pour statusQueryGetUri, collez-la dans la barre d’adresse de votre navigateur, puis exécutez la requête. Vous pouvez également continuer à utiliser votre outil de test HTTP pour émettre la requête GET.

   La requête interroge l’instance d’orchestration pour obtenir l’état. Vous devez voir que l’instance s’est terminée, et qu’elle inclut les sorties ou les résultats de la fonction durable. Elle se présente de façon similaire à cet exemple :

   {
       "name": "hello_orchestrator",
       "instanceId": "9a528a9e926f4b46b7d3deaa134b7e8a",
       "runtimeStatus": "Completed",
       "input": null,
       "customStatus": null,
       "output": [
           "Hello Tokyo!",
           "Hello Seattle!",
           "Hello London!"
       ],
       "createdTime": "2020-03-18T21:54:49Z",
       "lastUpdatedTime": "2020-03-18T21:54:54Z"
   }
   

1. Copiez l’URL du déclencheur HTTP à partir du panneau de sortie. L’URL qui appelle la fonction déclenchée par HTTP doit avoir le format suivant :

   https://<functionappname>.azurewebsites.net/api/orchestrators/HelloOrchestrator

1. Copiez l’URL du déclencheur HTTP à partir du panneau de sortie. L’URL qui appelle la fonction déclenchée par HTTP doit avoir le format suivant :

   https://<functionappname>.azurewebsites.net/api/orchestrators/hello_orchestrator