Scrivere codici per Funzioni di Azure e testarle in locale

  • Articolo

Benché sia possibile sviluppare e testare Funzioni di Azure nel portale di Azure, molti sviluppatori preferiscono un'esperienza di sviluppo locale. Quando si usano Funzioni, usando l'editor di codice preferito e gli strumenti di sviluppo per creare e testare le funzioni nel computer locale diventa più semplice. Le funzioni locali possono connettersi ai servizi di Azure attivi ed è possibile eseguirne il debug nel computer locale usando il runtime completo di Funzioni di Azure.

Questo articolo fornisce collegamenti a specifici ambienti di sviluppo per il linguaggio preferito. Fornisce anche alcune indicazioni condivise per lo sviluppo locale, ad esempio l'uso del file local.settings.json.

Ambienti di sviluppo locale

Il modo in cui si sviluppano funzioni nel computer locale dipende dalle preferenze di linguaggio e strumenti. Gli ambienti nella tabella seguente supportano lo sviluppo locale:

Ambiente Linguaggi Descrizione
Visual Studio Code C# (in-process)
C# (processo di lavoro isolato)
JavaScript
PowerShell
Python		 L'estensione di Funzioni di Azure per Visual Studio Code aggiunge il supporto di Funzioni di Azure a Visual Studio Code. Richiede gli strumenti di base. Supporta lo sviluppo in Linux, macOS e Windows, quando si usa la versione 2.x degli strumenti di base. Per altre informazioni, vedere Creare la prima funzione con Visual Studio Code.
Prompt dei comandi o terminal C# (in-process)
C# (processo di lavoro isolato)
JavaScript
PowerShell
Python		 Funzioni di Azure Core Tools offre il runtime di base e i modelli per la creazione di funzioni, che consentono lo sviluppo locale. La versione 2.x supporta lo sviluppo in Linux, macOS e Windows. Tutti gli ambienti si basano su Strumenti di base per il runtime Funzioni di Azure locale.
Visual Studio C# (in-process)
C# (processo di lavoro isolato)		 Gli strumenti di Funzioni di Azure sono inclusi nel carico di lavoro di sviluppo di Azure di Visual Studio, a partire da Visual Studio 2019. Consente di compilare le funzioni in una libreria di classi e di pubblicare il file con estensione dll in Azure. Include gli strumenti di base per il test locale. Per altre informazioni, vedere Sviluppare Funzioni di Azure con Visual Studio.
Maven (varie) Java Maven archetype supporta Gli strumenti di base consentono lo sviluppo di funzioni Java. La versione 2.x supporta lo sviluppo in Linux, macOS e Windows. Per altre informazioni, vedere Creare la prima funzione con Java e Maven. Supporta anche lo sviluppo usando Eclipse e IntelliJ IDEA.

Nota

Non combinare lo sviluppo locale con lo sviluppo del portale nella stessa app per le funzioni. Quando si creano e pubblicano funzioni da un progetto locale, non sarà possibile gestire o modificare il codice del progetto nel portale.

Ognuno di questi ambienti di sviluppo locale consente di creare progetti di app per le funzioni e usare modelli di funzione predefiniti per creare nuove funzioni. Ognuno di essi usa gli strumenti di base per consentire di testare ed eseguire il debug delle funzioni con il runtime reale di Funzioni di Azure nel proprio computer esattamente come qualsiasi altra app. È anche possibile pubblicare il progetto dell'app per le funzioni da uno di questi ambienti ad Azure.

File di impostazioni locali

Il file local.settings.json archivia le impostazioni e le impostazioni dell'app usate dagli strumenti di sviluppo locali. Le impostazioni nel file local.settings.json vengono usate solo quando si esegue il progetto in locale. Quando si pubblica il progetto in Azure, assicurarsi di aggiungere anche le impostazioni necessarie alle impostazioni dell'app per l'app.

Importante

Poiché local.settings.json può contenere segreti, ad esempio stringhe di connessione, non è mai necessario archiviarlo in un repository remoto. Gli strumenti che supportano Funzioni forniscono modi per sincronizzare le impostazioni nel file local.settings.json con le impostazioni dell'app nell'app per le funzioni a cui viene distribuito il progetto.

La struttura del file di impostazioni locali è la seguente:

{
  "IsEncrypted": false,
  "Values": {
    "FUNCTIONS_WORKER_RUNTIME": "<language worker>",
    "AzureWebJobsStorage": "<connection-string>",
    "MyBindingConnection": "<binding-connection-string>",
    "AzureWebJobs.HttpExample.Disabled": "true"
  },
  "Host": {
    "LocalHttpPort": 7071,
    "CORS": "*",
    "CORSCredentials": false
  },
  "ConnectionStrings": {
    "SQLConnectionString": "<sqlclient-connection-string>"
  }
}

Queste impostazioni sono supportate quando si eseguono progetti in locale:

Impostazione Descrizione
IsEncrypted Quando questa impostazione è impostata su true, tutti i valori vengono crittografati con una chiave del computer locale. Usato con i comandi func settings. Il valore predefinito è false. Potrebbe essere necessario crittografare il file local.settings.json nel computer locale quando contiene segreti, ad esempio le stringhe di connessione al servizio. L'host decrittografa automaticamente le impostazioni durante l'esecuzione. Usare il comando func settings decrypt prima di provare a leggere le impostazioni crittografate in locale.
Values Raccolta di impostazioni dell'applicazione usate quando un progetto è in esecuzione in locale. Queste coppie chiave-valore (stringa-stringa) corrispondono alle impostazioni dell'applicazione nell'app per le funzioni in Azure, ad esempio AzureWebJobsStorage. Molti trigger e associazioni includono una proprietà che fa riferimento a un'impostazione di app per la stringa di connessione, ad esempio Connection per il trigger di archiviazione BLOB. Per queste proprietà è necessaria un'impostazione dell'applicazione definita nella matrice Values. Vedere la tabella successiva per un elenco di impostazioni usate di frequente.
I valori devono essere stringhe e non oggetti o matrici JSON. I nomi di impostazione non possono includere una sottolineatura doppia () e non devono includere due punti (__:). I caratteri di sottolineatura doppia sono riservati dal runtime e i due punti sono riservati per supportare l'inserimento delle dipendenze.
Host Le impostazioni in questa sezione consentono di personalizzare il processo host di Funzioni durante l'esecuzione dei progetti in locale. Queste impostazioni sono distinte da quelle del file host.json, che vengono applicate anche quando si eseguono progetti in Azure.
LocalHttpPort Consente di impostare la porta predefinita usata durante l'esecuzione nell'host locale di Funzioni, ovvero func host start e func run. L'opzione --port della riga di comando ha la precedenza su questa impostazione. Ad esempio, quando viene eseguito nell'IDE di Visual Studio, è possibile modificare il numero di porta passando alla finestra "Proprietà progetto -> Debug" e specificando in modo esplicito il numero di porta in un host start --port <your-port-number> comando che può essere fornito nel campo "Argomenti applicazione".
CORS Definisce le origini consentite per la condivisione di risorse tra le origini (CORS). Le origini sono elencate in un elenco delimitato dalla virgola senza spazi. Il valore jolly (*) è supportato, che consente richieste da qualsiasi origine.
CORSCredentials Quando è impostata su true, consente le richieste withCredentials.
ConnectionStrings Raccolta. Non usare questa raccolta per le stringhe di connessione usate per le associazioni di funzione. Questa raccolta viene usata solo dai framework che in genere ottengono le stringhe di connessione dalla sezione ConnectionStrings di un file di configurazione, ad esempio Entity Framework. Le stringhe di connessione in questo oggetto vengono aggiunte all'ambiente con il tipo di provider di System.Data.SqlClient. Gli elementi in questa raccolta non vengono pubblicati in Azure con altre impostazioni di app. È necessario aggiungere questi valori in modo esplicito alla raccolta Connection strings delle impostazioni dell'app per le funzioni. Se si crea una connessione SqlConnection nel codice di funzione, è consigliabile archiviare il valore della stringa di connessione insieme alle altre connessioni in Impostazione applicazione nel portale.

Le impostazioni dell'applicazione seguenti possono essere incluse nella matrice Values durante l'esecuzione in locale:

Impostazione Valori Descrizione
AzureWebJobsStorage Stringa di connessione dell'account di archiviazione oppure
UseDevelopmentStorage=true		 Contiene la stringa di connessione per un account di archiviazione di Azure. Obbligatoria quando si usano trigger diversi da HTTP. Vedere le informazioni di riferimento per AzureWebJobsStorage.
Quando si dispone dell'emulatore Azurite installato in locale e si imposta AzureWebJobsStorage su UseDevelopmentStorage=true, Core Tools usa l'emulatore. Per altre informazioni, vedere Emulatore di archiviazione locale.
AzureWebJobs.<FUNCTION_NAME>.Disabled true|false Per disabilitare una funzione durante l'esecuzione in locale, aggiungere "AzureWebJobs.<FUNCTION_NAME>.Disabled": "true" alla raccolta, dove <FUNCTION_NAME> è il nome della funzione. Per altre informazioni, vedere Come disabilitare le funzioni in Funzioni di Azure.
FUNCTIONS_WORKER_RUNTIME dotnet
dotnet-isolated
node
java
powershell
python		 Indica il linguaggio di destinazione del runtime di Funzioni. Obbligatoria per la versione 2.x e successive del runtime di Funzioni. Questa impostazione viene generata per il progetto da Core Tools. Vedere le informazioni di riferimento per FUNCTIONS_WORKER_RUNTIME.
FUNCTIONS_WORKER_RUNTIME_VERSION ~7 Indica di usare PowerShell 7 durante l'esecuzione in locale. Se non è impostata, viene usato PowerShell Core 6. Questa impostazione viene usata solo durante l'esecuzione in locale. La versione di runtime di PowerShell è determinata dall'impostazione di configurazione del powerShellVersion sito, quando viene eseguita in Azure, che può essere impostata nel portale.

Sincronizzare le impostazioni

Quando si sviluppano le funzioni in locale, tutte le impostazioni locali richieste dall'app devono essere presenti anche nelle impostazioni dell'app per le funzioni a cui viene distribuito il codice. Potrebbe anche essere necessario scaricare le impostazioni correnti dall'app per le funzioni al progetto locale. Anche se è possibile configurare manualmente le impostazioni dell'app nella portale di Azure, gli strumenti seguenti consentono anche di sincronizzare le impostazioni dell'app con le impostazioni locali nel progetto:

Trigger e associazioni

Quando si sviluppano le funzioni in locale, è necessario prendere in considerazione i comportamenti di trigger e binding. Il modo più semplice per testare le associazioni durante lo sviluppo locale consiste nell'usare le stringhe di connessione destinate ai servizi di Azure in tempo reale. È possibile eseguire la destinazione dei servizi live aggiungendo le impostazioni appropriate della Values stringa di connessione nella matrice nel file local.settings.json. Quando si esegue questa operazione, le esecuzioni locali durante il test influiscono su dati del servizio live. A causa di questo, prendere in considerazione la configurazione di servizi separati da usare durante lo sviluppo e il test e quindi passare a servizi diversi durante la produzione. È anche possibile usare un emulatore di archiviazione locale.

Emulatore di archiviazione locale

Durante lo sviluppo locale, è possibile usare l'emulatore locale di Azurite durante il test delle funzioni con associazioni di archiviazione di Azure (archiviazione code, archiviazione BLOB e archiviazione tabelle), senza dover connettersi ai servizi di archiviazione remota. Azurite si integra con Visual Studio Code e Visual Studio ed è anche possibile eseguirlo dal prompt dei comandi usando npm. Per altre informazioni, vedere Usare l'emulatore Azurite per lo sviluppo locale di Archiviazione di Azure.

L'impostazione Values seguente nella raccolta del file local.settings.json indica all'host Funzioni locali di usare Azurite per la connessione predefinita AzureWebJobsStorage :

"AzureWebJobsStorage": "UseDevelopmentStorage=true"

Con questa impostazione, qualsiasi trigger o associazione di Archiviazione di Azure che usa AzureWebJobsStorage come connessione si connette a Azurite durante l'esecuzione in locale. Durante l'esecuzione locale, è necessario installare e eseguire Azurite. L'emulatore è utile durante lo sviluppo, ma è consigliabile eseguire test con una connessione di archiviazione effettiva prima della distribuzione. Quando si pubblica il progetto, non pubblicare questa impostazione. È invece necessario usare una stringa di connessione di Archiviazione di Azure nelle stesse impostazioni nell'app per le funzioni in Azure.

Passaggi successivi