Guida per sviluppatori di Funzioni di Azure

In Funzioni di Azure tutte le funzioni condividono alcuni concetti e componenti tecnici di base, indipendentemente dal linguaggio o dall'ambiente di sviluppo preferito. Questo articolo è specifico della lingua. Scegliere la lingua preferita nella parte superiore dell'articolo.

Questo articolo presuppone che tu abbia già letto la panoramica di Funzioni di Azure.

Progetto di codice

Al centro di Funzioni di Azure è un progetto di codice specifico del linguaggio che implementa una o più unità di esecuzione del codice denominate functions. Le funzioni sono semplicemente metodi eseguiti nel cloud Azure in base agli eventi, in risposta alle richieste HTTP o in base a una pianificazione. Si pensi al progetto di codice Funzioni di Azure come un meccanismo per organizzare, distribuire e gestire collettivamente le singole funzioni nel progetto quando vengono eseguite in Azure. Per altre informazioni, vedere Organizzare le funzioni.

Tutte le funzioni devono avere un trigger, che definisce l'avvio della funzione e può fornirle input. Le funzioni possono facoltativamente definire associazioni di input e output. Queste associazioni semplificano le connessioni ad altri servizi senza dover usare SDK client. Per altre informazioni, vedere Funzioni di Azure trigger e concetti relativi alle associazioni.

Funzioni di Azure fornisce un set di modelli di funzione e progetto specifici del linguaggio che semplificano la creazione di nuovi progetti di codice e l'aggiunta di funzioni al progetto. È possibile usare uno degli strumenti che supportano Funzioni di Azure sviluppo per generare nuove app e funzioni usando questi modelli.

Strumenti di sviluppo

I seguenti strumenti offrono un'esperienza locale e integrata di sviluppo e pubblicazione per Funzioni di Azure nel linguaggio che preferisci:

• Visual Studio Code

• Funzioni di Azure Core Tools (prompt dei comandi)

Questi strumenti si integrano con Funzioni di Azure Core Tools in modo da poter eseguire ed eseguire il debug nel computer locale usando il runtime di Funzioni. Per altre informazioni, vedere Code e testare Funzioni di Azure in locale.

Distribuzione

Quando si pubblica il progetto di codice in Azure, si distribuisce essenzialmente il progetto in una risorsa dell'app per le funzioni esistente. Un'app per le funzioni fornisce un contesto di esecuzione in Azure in cui vengono eseguite le funzioni. Di conseguenza, è l'unità di distribuzione e gestione per le funzioni. Dal punto di vista della risorsa Azure, un'app per le funzioni equivale a una risorsa del sito (Microsoft.Web/sites) in Servizio app di Azure, equivalente a un'app Web.

Un'app di funzioni è composta da una o più funzioni individuali che gestisci, distribuisci e scali insieme. Tutte le funzioni in un'app per le funzioni condividono lo stesso piano tariffario, lo stesso metodo di distribuzione e la stessa versione di runtime. Per altre informazioni, vedere Come gestire un'app per le funzioni.

Quando l'app di funzioni e qualsiasi altra risorsa necessaria non esistono già in Azure, devi creare queste risorse prima di poter distribuire i file del progetto. È possibile creare queste risorse in uno dei modi seguenti:

• Uso di Visual Studio Code

• A livello di codice usando interfaccia della riga di comando di Azure, Azure PowerShell, ARM templates o Bicep file

• Nel portale Azure

Oltre alla pubblicazione basata su strumenti, Funzioni supporta altre tecnologie per la distribuzione del codice sorgente in un'app per le funzioni esistente. Per altre informazioni, vedere Deployment technologies in Funzioni di Azure.

Connettersi ai servizi

Un requisito principale di qualsiasi servizio di calcolo basato sul cloud consiste nel leggere i dati e scrivere dati in altri servizi cloud. Funzioni offre un ampio set di associazioni che semplifica la connessione ai servizi senza dover usare SDK client.

Che tu usi le estensioni di binding fornite da Functions o che tu lavori direttamente con gli SDK client, memorizzi in modo sicuro i dati di connessione e non li includi nel tuo codice.

Memoria host predefinita

Funzioni di Azure richiede un account di Archiviazione di Azure quando si crea un'istanza dell'applicazione di funzioni. Questo account di archiviazione predefinito è utilizzato internamente dall'host Functions e da alcune estensioni di binding.

Per imparare come definire in modo sicuro le connessioni all'account di archiviazione predefinito, vedi Definire connessioni.

Collegamenti

Funzioni fornisce associazioni per molti servizi di Azure e alcuni servizi di terze parti, implementati come estensioni. Per altre informazioni, vedere l'elenco completo delle associazioni supportate.

Le estensioni di associazione possono supportare sia input che output e molti trigger fungono anche da associazioni di input. Le associazioni consentono di configurare la connessione ai servizi in modo che l'host di Funzioni possa gestire automaticamente l'accesso ai dati. Per altre informazioni, vedere Funzioni di Azure trigger e concetti relativi alle associazioni.

Se si verificano problemi con gli errori provenienti dalle associazioni, vedere la documentazione Funzioni di Azure Codici di errore di binding. Per imparare come definire in modo sicuro le connessioni nei bindings verso servizi remoti, vedi Definire connessioni.

Proprietà comuni per le connessioni basate su identità

Le connessioni basate su identità per Funzioni di Azure utilizzano identità gestite per l'autenticazione. L'identità assegnata dal sistema viene usata di default, ma puoi specificare un'identità assegnata dall'utente con le credential proprietà e.clientId Per dettagli completi sulla configurazione delle connessioni basate sull'identità, incluse le impostazioni richieste dell'app e i permessi RBAC, vedi Definisci connessioni di identità gestite.

Sviluppo locale con connessioni basate su identità

Quando si avvia localmente, le connessioni basate sull'identità usano la tua identità di sviluppatore (come il login interfaccia della riga di comando di Azure) invece di un'identità gestita. Non è necessario impostare le credential proprietà o clientId durante lo sviluppo locale. Per altre informazioni, vedere Sviluppo locale con connessioni basate su identità.

Client SDK

Sebbene Functions offra binding per semplificare l'accesso ai dati nel tuo codice funzione, puoi anche utilizzare un client SDK nel tuo progetto per accedere direttamente a un determinato servizio. Potresti dover usare direttamente gli SDK client se le tue funzioni richiedono una funzionalità dell'SDK sottostante non supportata dall'estensione di binding. Il tuo codice delle funzioni non può accedere ai client sottostanti usati dalle estensioni di binding. Devi creare e gestire in modo indipendente qualsiasi istanze client che tu abbia bisogno di utilizzare nelle tue funzioni.

Considera questi aspetti quando crei e usi gli SDK client nel tuo codice di funzione:

• Usa lo stesso processo per memorizzare e accedere alle stringhe di connessione che usano le estensioni di binding. Per saperne di più, vedi Definisci le connessioni.

• Quando ospiti la tua app in un piano Consumo, c'è un limite al numero totale di connessioni in uscita su tutte le istanze. Questo limite significa che devi fare attenzione a evitare l'esaurimento delle porte. Per saperne di più, consulta Gestire le connessioni client SDK.

Segnalazione di problemi

Repository open source

Il codice di Funzioni di Azure è open source. Puoi trovare componenti chiave in questi repository GitHub:

• Funzioni di Azure

• Host di Funzioni di Azure

• Funzioni di Azure portal

• modelli Funzioni di Azure

• Azure WebJobs SDK

• Estensioni azure WebJobs SDK

Articoli correlati

Per altre informazioni, vedere le seguenti risorse:

• scenari Funzioni di Azure
• Gestire le connessioni in Funzioni di Azure
• Code e testare Funzioni di Azure in locale
• procedure Best per Funzioni di Azure