Creare una funzione attivata dall'archiviazione code di Azure
Informazioni su come creare una funzione attivata nel momento in cui vengono inviati messaggi a una coda di archiviazione di Azure.
Nota
La modifica nel portale è supportata solo per le funzioni JavaScript, PowerShell e Script C#. La modifica nel portale di Python è supportata solo quando è in esecuzione nel piano a consumo. Quando possibile, è consigliabile sviluppare le funzioni in locale.
Per altre informazioni sulle limitazioni relative alla modifica del codice della funzione nella portale di Azure, vedere Limitazioni di sviluppo nella portale di Azure.
Prerequisiti
- Una sottoscrizione di Azure. Se non se ne dispone, creare un account gratuito prima di iniziare.
Creare un'app per le funzioni di Azure
Nel menu del portale di Azure o dalla pagina Home selezionare Crea una risorsa.
Nella pagina Nuovo, selezionare Calcolo>App per le funzioni.
Nella pagina Informazioni di base usare le impostazioni dell'app per le funzioni specificate nella tabella seguente:
Impostazione Valore suggerito Descrizione Abbonamento Sottoscrizione in uso Sottoscrizione in cui si crea la nuova app per le funzioni. Gruppo di risorse myResourceGroup Nome del nuovo gruppo di risorse in cui si crea l'app per le funzioni. È consigliabile creare un nuovo gruppo di risorse perché esistono limitazioni note durante la creazione di nuove app per le funzioni in un gruppo di risorse esistente. Nome dell'app per le funzioni Nome globalmente univoco Nome che identifica la nuova app per le funzioni. I caratteri validi sono a-z(senza distinzione tra maiuscole e minuscole),0-9e-.Distribuire codice o immagine del contenitore? Codice Opzione per pubblicare file di codice o un contenitore Docker. Stack di runtime Lingua preferita Scegliere un runtime che supporti il linguaggio di programmazione della funzione preferito. La modifica nel portale è disponibile solo per script JavaScript, PowerShell, Python, TypeScript e C#. La libreria di classi C# e le funzioni Java devono essere sviluppate localmente. Versione Numero versione Scegliere la versione del runtime installato. Area Area preferita Selezionare un'area vicina o vicina ad altri servizi a cui le funzioni possono accedere. Sistema operativo Windows Un sistema operativo è preselezionato in base alla selezione dello stack di runtime, ma è possibile modificare l'impostazione, se necessario. La modifica all'interno del portale è supportata solo in Windows. La pubblicazione dei contenitori è supportata solo in Linux. Opzioni e piani di hosting Consumo (serverless) Piano di hosting che definisce come vengono allocate le risorse all'app per le funzioni. Nel piano Consumo predefinito le risorse vengono aggiunte dinamicamente in base alle esigenze delle funzioni. In questo hosting serverless si paga solo per il periodo in cui le funzioni sono in esecuzione. Il piano Premium offre anche il ridimensionamento dinamico. In caso di esecuzione in un piano di servizio app, è necessario gestire il ridimensionamento dell'app per le funzioni. Accettare le opzioni predefinite per la creazione di un nuovo account di archiviazione nella scheda Archiviazione e una nuova istanza di Application Insight nella scheda Monitoraggio. È anche possibile scegliere di usare un account di archiviazione esistente o un'istanza di Application Insights.
Selezionare Rivedi e crea per esaminare la configurazione dell'app scelta e quindi selezionare Crea per effettuare il provisioning e distribuire l'app per le funzioni.
Selezionare l'icona Notifiche nell'angolo superiore destro del portale e attendere che venga visualizzato il messaggio La distribuzione è riuscita.
Selezionare Vai alla risorsa per visualizzare la nuova app per le funzioni. È anche possibile selezionare Aggiungi al dashboard. In questo modo è più facile tornare in questa risorsa di app per le funzioni dal dashboard.
Si creerà ora una funzione nella nuova app per le funzioni.
Creare una funzione attivata da una coda
Nell'app per le funzioni selezionare Panoramica e quindi + Crea in Funzioni.
In Selezionare un modello scorrere verso il basso e scegliere il modello di trigger Archiviazione coda di Azure.
In Dettagli modello configurare il nuovo trigger con le impostazioni specificate in questa tabella e quindi selezionare Crea:
Impostazione Valore suggerito Description Nome Univoco nell'app per le funzioni Nome della funzione attivata dalla coda. Nome coda myqueue-items Nome della coda a cui connettersi nell'account di archiviazione. Connessione dell'account di archiviazione AzureWebJobsStorage È possibile usare la connessione dell'account di archiviazione già usata dall'app per le funzioni oppure crearne una nuova. Azure crea la funzione attivata Archiviazione coda in base ai valori forniti
Connettersi quindi all'account di archiviazione di Azure e creare la coda di archiviazione myqueue-items.
Creare la coda
Nella pagina Panoramica della funzione selezionare il gruppo di risorse.
Cercare e selezionare l'account di archiviazione del gruppo di risorse.
Scegliere Code e quindi + Coda.
Nel campo Nome digitare
myqueue-itemse quindi selezionare Crea.
È possibile ora testare la funzione aggiungendo un messaggio alla coda.
Testare la funzione
Tornare al portale di Azure, selezionare la funzione, espandere i log nella parte inferiore della pagina e assicurarsi che lo streaming dei log non sia stato interrotto.
In una finestra separata del browser passare al gruppo di risorse nel portale di Azure e selezionare l'account di archiviazione.
Selezionare Code e quindi il contenitore myqueue-items.
Selezionare Aggiungi messaggio e digitare "Hello World!" nel testo del messaggio. Seleziona OK.
Attendere alcuni secondi, tornare ai log di funzione e verificare che il nuovo messaggio sia stato letto dalla coda.
Tornare alla coda di archiviazione, selezionare Aggiorna e verificare che il messaggio sia stato elaborato e non sia più in coda.
Pulire le risorse
Altre guide di avvio rapido di questa raccolta si basano sulla presente guida di avvio rapido. Se si prevede di usare guide introduttive, esercitazioni o con uno dei servizi creati in questa guida introduttiva, non pulire le risorse.
Il termine risorse in Azure si riferisce ad app per le funzioni, funzioni, account di archiviazione e così via. Le risorse sono raggruppate in gruppi di risorse, ed è possibile eliminare tutti gli elementi in un gruppo eliminando il gruppo.
Sono state create risorse per completare queste guide introduttive. È possibile che vengano fatturate queste risorse, a seconda dello stato dell'account e dei prezzi del servizio. Se le risorse non sono più necessarie, ecco come eliminarle:
Nel portale di Azure passare alla pagina Gruppo di risorse.
Per accedere a tale pagina dalla pagina dell'app per le funzioni, selezionare la scheda Panoramica e quindi selezionare il collegamento in Gruppo di risorse.
Per accedere a tale pagina dal dashboard, selezionare Gruppi di risorse e quindi selezionare il gruppo di risorse usato per questo articolo.
Nella pagina Gruppo di risorse esaminare l'elenco delle risorse incluse e verificare che siano quelle da eliminare.
Selezionare Elimina gruppo di risorse e seguire le istruzioni.
L'eliminazione potrebbe richiedere alcuni minuti. Al termine, viene visualizzata una notifica per pochi secondi. È anche possibile selezionare l'icona a forma di campana nella parte superiore della pagina per visualizzare la notifica.
Passaggi successivi
È stata creata una funzione che viene eseguita nel momento in cui un messaggio viene aggiunto a una coda di archiviazione. Per altre informazioni sui trigger dell'archiviazione code, vedere Associazioni della coda dell'archiviazione di Funzioni di Azure.
Dopo avere creato la prima funzione, è possibile aggiungere un'associazione di output alla funzione che esegue il writeback del messaggio in un'altra coda.