Avvio rapido: Creare un'app TypeScript Durable Functions

• Estensione di Visual Studio Code installata in Funzioni di Azure.

• Estensione di Visual Studio Code versione 1.10.4 o successiva installata in Funzioni di Azure.

• La versione più recente di Azure Functions Core Tools installata.

• Azure Functions Core Tools versione 4.0.5382 o successiva installata.

• Node.js versione 16.x+ installata.

• Node.js versione 18.x+ installata.

3. Quando richiesto, immettere le informazioni seguenti:

   Richiesta	Azione	Descrizione
   Selezionare un linguaggio per il progetto di app per le funzioni	Selezionare TypeScript.	Crea un progetto di Funzioni Node.js locale usando TypeScript.
   Selezionare un modello di programmazione JavaScript	Selezionare Modello V3.	Imposta il modello di programmazione v3.
   Selezionare una versione	Selezionare Funzioni di Azure v4.	Questa opzione è visualizzata solo quando Core Tools non è già installato. In questo caso, Core Tools è installato la prima volta che si esegue l'app.
   Selezionare un modello per la prima funzione del progetto	Selezionare Ignora per adesso.
   Selezionare come si vuole aprire il progetto	Selezionare Apri nella finestra corrente.	Apre Visual Studio Code nella cartella selezionata.

3. Quando richiesto, immettere le informazioni seguenti:

   Richiesta	Azione	Descrizione
   Selezionare un linguaggio per il progetto di app per le funzioni	Selezionare TypeScript.	Crea un progetto di Funzioni Node.js locale usando TypeScript.
   Selezionare un modello di programmazione JavaScript	Selezionare Modello V4.	Imposta il modello di programmazione v4.
   Selezionare una versione	Selezionare Funzioni di Azure v4.	Questa opzione è visualizzata solo quando Core Tools non è già installato. In questo caso, Core Tools è installato la prima volta che si esegue l'app.
   Selezionare un modello per la prima funzione del progetto	Selezionare Ignora per adesso.
   Selezionare come si vuole aprire il progetto	Selezionare Apri nella finestra corrente.	Apre Visual Studio Code nella cartella selezionata.

Per usare il modello di programmazione v4, è necessario installare la versione di anteprima v3.x della libreria durable-functions.

2. Installare il pacchetto npm durable-functions eseguendo npm install durable-functions nella directory radice dell'app per le funzioni.

2. Installare la versione di anteprima del pacchetto npm funzioni-durevoli eseguendo npm install durable-functions@preview nella directory radice dell'app per le funzioni.

Funzione dell'agente di orchestrazione

Per creare il codice Durable Functions nel progetto si usa un modello.

1. Nel riquadro comandi immettere e selezionare Funzioni di Azure: Crea funzione.

2. Quando richiesto, immettere le informazioni seguenti:

   Richiesta	Azione	Descrizione
   Selezionare un modello per la funzione	Selezionare Agente di orchestrazione di Durable Functions.	Crea un'orchestrazione Durable Functions.
   Scegliere un tipo di archiviazione durevole	Selezionare Archiviazione di Azure (impostazione predefinita).	Imposta il back-end di archiviazione da usare per l'app Durable Functions.
   Specificare un nome di funzione	Immettere HelloOrchestrator.	Nome della funzione.

È stato aggiunto un agente di orchestrazione per coordinare le funzioni dell'attività. Aprire HelloOrchestrator/index.ts per visualizzare la funzione dell'agente di orchestrazione. Ogni chiamata a context.df.callActivity richiama una funzione dell'attività denominata Hello.

Si aggiunge ora la funzione dell'attività Hello cui viene fatto riferimento.

Funzione dell'attività

1. Nel riquadro comandi immettere e selezionare Funzioni di Azure: Crea funzione.

2. Quando richiesto, immettere le informazioni seguenti:

   Richiesta	Azione	Descrizione
   Selezionare un modello per la funzione	Selezionare Attività di Durable Functions.	Creare una funzione dell'attività.
   Specificare un nome di funzione	Immettere Hello.	Nome della funzione dell'attività.

È stata aggiunta la funzione dell'attività Hello richiamata dall'agente di orchestrazione. Aprire Hello/index.js per verificare che accetti un nome come input e restituisca un messaggio di saluto. Una funzione di attività è la posizione in cui si esegue "il lavoro reale" nel flusso di lavoro, ad esempio eseguendo una chiamata al database o un calcolo non deterministico.

Si aggiunge infine una funzione attivata tramite HTTP che avvia l'orchestrazione.

Funzione client (Http Starter)

1. Nel riquadro comandi immettere quindi selezionare Azure Functions: Create Function.

2. Quando richiesto, immettere le informazioni seguenti:

   Richiesta	Azione	Descrizione
   Selezionare un modello per la funzione	Selezionare Starter HTTP di Durable Functions.	Creare una funzione Starter HTTP.
   Specificare un nome di funzione	Selezionare DurableFunctionsHttpStart.	Nome della funzione dell'attività.
   Livello di autorizzazione	Selezionare Anonimo.	A scopo dimostrativo, questo valore consente la chiamata della funzione senza autenticazione.

È stata aggiunta una funzione attivata tramite HTTP che avvia un'orchestrazione. Aprire DurableFunctionsHttpStart/index.ts per verificare che usi client.startNew per avviare una nuova orchestrazione. Userà quindi client.createCheckStatusResponse per restituire una risposta HTTP contenente gli URL che possono essere usati per monitorare e gestire la nuova orchestrazione.

È ora disponibile un'app Durable Functions eseguibile in locale e distribuibile in Azure.

Uno dei vantaggi del modello di programmazione v4 è la flessibilità della scrittura delle funzioni. Nel modello v4 è possibile usare un singolo modello per creare tutte e tre le funzioni in un unico file del progetto.

1. Nel riquadro comandi immettere e selezionare Funzioni di Azure: Crea funzione.

2. Quando richiesto, immettere le informazioni seguenti:

   Richiesta	Azione	Descrizione
   Selezionare un modello per la funzione	Selezionare Agente di orchestrazione di Durable Functions.	Crea un file con un'orchestrazione dell'app Durable Functions, una funzione di attività e una funzione di avvio client durevole.
   Scegliere un tipo di archiviazione durevole	Selezionare Archiviazione di Azure (impostazione predefinita).	Imposta il back-end di archiviazione da usare per durable function.
   Specificare un nome di funzione	Immettere Hello.	Nome della funzione durevole.

Aprire src/functions/hello.ts per visualizzare le funzioni create.

È stato creato un agente di orchestrazione denominato helloOrchestrator per coordinare le funzioni dell'attività. Ogni chiamata a context.df.callActivity richiama una funzione dell'attività denominata hello.

È stata inoltre aggiunta la funzione dell'attività hello richiamata dall'agente di orchestrazione. Nello stesso file, è possibile vedere che assume un nome come input e restituisce un messaggio di saluto. Una funzione di attività è la posizione in cui si esegue "il lavoro reale" nel flusso di lavoro, ad esempio eseguendo una chiamata al database o un calcolo non deterministico.

Infine, è stata aggiunta una funzione attivata tramite HTTP che avvia un'orchestrazione. Nello stesso file è possibile vedere che usa client.startNew per avviare una nuova orchestrazione. Userà quindi client.createCheckStatusResponse per restituire una risposta HTTP contenente gli URL che possono essere usati per monitorare e gestire la nuova orchestrazione.

È ora disponibile un'app Durable Functions eseguibile in locale e distribuibile in Azure.

1. Per testare la funzione, impostare un punto di interruzione nel codice della funzione dell'attività Hello (Hello/index.ts). Selezionare F5 o Debug: avvia debug nel riquadro comandi per avviare il progetto di app per le funzioni. L'output da Core Tools è visualizzato nel pannello del terminale.

   Nota

   Per altre informazioni sul debug, vedere Diagnostica in Durable Functions.

1. Per testare la funzione, impostare un punto di interruzione nel codice della funzione dell'attività hello (src/functions/hello.ts). Selezionare F5 o Debug: avvia debug nel riquadro comandi per avviare il progetto di app per le funzioni. L'output da Core Tools è visualizzato nel pannello del terminale.

   Nota

   Per altre informazioni sul debug, vedere Diagnostica in Durable Functions.

5. Usare il browser o uno strumento di test HTTP per inviare una richiesta HTTP POST all'endpoint URL.

   Sostituire l'ultimo segmento con il nome della funzione dell'agente di orchestrazione (HelloOrchestrator). L'URL sarà simile a http://localhost:7071/api/orchestrators/HelloOrchestrator.

   La risposta è il risultato iniziale della funzione HTTP. Informa che l'orchestrazione durevole è stata avviata correttamente. Non visualizza ancora il risultato finale dell'orchestrazione. La risposta include alcuni URL utili. Per il momento eseguire una query relativa allo stato dell'orchestrazione.

5. Usare il browser o uno strumento di test HTTP per inviare una richiesta HTTP POST all'endpoint URL.

   Sostituire l'ultimo segmento con il nome della funzione dell'agente di orchestrazione (HelloOrchestrator). L'URL sarà simile a http://localhost:7071/api/orchestrators/HelloOrchestrator.

   La risposta è il risultato iniziale della funzione HTTP. Informa che l'orchestrazione durevole è stata avviata correttamente. Non visualizza ancora il risultato finale dell'orchestrazione. La risposta include alcuni URL utili. Per il momento eseguire una query relativa allo stato dell'orchestrazione.

6. Copiare il valore dell'URL per statusQueryGetUri, incollarlo nella barra degli indirizzi del browser ed eseguire la richiesta. È anche possibile continuare a usare lo strumento di test HTTP per inviare la richiesta GET.

   La richiesta esegue una query per determinare lo stato dell'istanza di orchestrazione. Dovrebbe essere indicato che l'istanza è stata completata e include gli output o i risultati della funzione durevole. È simile all'esempio seguente:

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

6. Copiare il valore dell'URL per statusQueryGetUri, incollarlo nella barra degli indirizzi del browser ed eseguire la richiesta. È anche possibile continuare a usare lo strumento di test HTTP per inviare la richiesta GET.

   La richiesta esegue una query per determinare lo stato dell'istanza di orchestrazione. Si noterà che l'istanza è stata completata e che include gli output o i risultati dell'app Durable Functions. È simile all'esempio seguente:

   {
       "name": "helloOrchestrator",
       "instanceId": "6ba3f77933b1461ea1a3828c013c9d56",
       "runtimeStatus": "Completed",
       "input": "",
       "customStatus": null,
       "output": [
           "Hello, Tokyo",
           "Hello, Seattle",
           "Hello, Cairo"
       ],
       "createdTime": "2023-02-13T23:02:21Z",
       "lastUpdatedTime": "2023-02-13T23:02:25Z"
   }
   

1. Copiare l'URL del trigger HTTP dal pannello Output. L'URL che chiama la funzione attivata tramite HTTP deve essere nel formato seguente:

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

1. Copiare l'URL del trigger HTTP dal pannello Output. L'URL che chiama la funzione attivata tramite HTTP deve essere nel formato seguente:

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