Scrivere codici per Funzioni di Azure e testarle in localeCode and test Azure Functions locally

Sebbene il portale di Azure offra un set di strumenti completo per lo sviluppo e il test delle funzioni di Azure, molti sviluppatori preferiscono un'esperienza di sviluppo locale.While the Azure portal provides a full set of tools for developing and testing Azure Functions, many developers prefer a local development experience. Funzioni di Azure semplifica l'uso dell'editor di codice e degli strumenti di sviluppo locale preferiti per sviluppare e testare le funzioni nel computer locale.Azure Functions makes it easy to use your favorite code editor and local development tools to develop and test your functions on your local computer. Le funzioni possono attivare gli eventi in Azure ed è possibile eseguire il debug delle funzioni JavaScript e C# nel computer locale.Your functions can trigger on events in Azure, and you can debug your C# and JavaScript functions on your local computer.

Se si sviluppatori di Visual Studio C#, Funzioni di Azure si integra anche con Visual Studio 2017.If you are a Visual Studio C# developer, Azure Functions also integrates with Visual Studio 2017.

Importante

Non combinare lo sviluppo locale con lo sviluppo del portale nella stessa app per le funzioni.Do not mix local development with portal development in the same function app. Quando si creano e si pubblicano le funzioni da un progetto locale, non tentare di gestire o modificare il codice di progetto nel portale.When you create and publish functions from a local project, you should not try to maintain or modify project code in the portal.

Installare gli strumenti di base per Funzioni di AzureInstall the Azure Functions Core Tools

Strumenti di base di Funzioni di Azure è una versione locale del runtime di Funzioni di Azure che è possibile eseguire nel computer di sviluppo locale.Azure Functions Core Tools is a local version of the Azure Functions runtime that you can run on your local development computer. Non è un emulatore o simulatore.It's not an emulator or simulator. Si tratta dello stesso runtime presente in Funzioni di Azure.It's the same runtime that powers Functions in Azure. Sono disponibili due versioni degli strumenti di base di Funzioni di Azure:There are two versions of Azure Functions Core Tools:

  • Versione 1.x: supporta la versione 1.x del runtime.Version 1.x: supports version 1.x of the runtime. Questa versione è supportata solo nei computer Windows e viene installata da un pacchetto npm.This version is only supported on Windows computers and is installed from an npm package.
  • Versione 2.x: supporta la versione 2.x del runtime.Version 2.x: supports version 2.x of the runtime. Questa versione supporta Windows, macOS e Linux.This version supports Windows, macOS, and Linux. Usa gestori di pacchetti specifici della piattaforma o npm per l'installazione.Uses platform-specific package managers or npm for installation.

Versione 1.xVersion 1.x

La versione originale degli strumenti usa il runtime 1.x di Funzioni.The original version of the tools uses the Functions 1.x runtime. Questa versione usa .NET Framework (4.7.1) ed è supportata solo nei computer Windows.This version uses the .NET Framework (4.7.1) and is only supported on Windows computers. Prima di installare la versione 1.x degli strumenti, è necessario installare NodeJS che include npm.Before you install the version 1.x tools, you must install NodeJS, which includes npm.

Usare il comando seguente per installare gli strumenti in versione 1.x:Use the following command to install the version 1.x tools:

npm install -g azure-functions-core-tools

Versione 2.xVersion 2.x

Nota

Il runtime 2.0 di Funzioni di Azure è disponibile in anteprima e attualmente non tutte le funzionalità di Funzioni di Azure sono supportate.Azure Functions runtime 2.0 is in preview, and currently not all features of Azure Functions are supported. Per altre informazioni, vedere Panoramica delle versioni del runtime per Funzioni di Azure.For more information, see Azure Functions versions

La versione 2.x degli strumenti usa il runtime di Funzioni di Azure 2.x basata su .NET Core.Version 2.x of the tools uses the Azure Functions runtime 2.x that is built on .NET Core. Questa versione è supportata su tutte le piattaforme supportate da .NET Core 2.x, incluse Windows, macOS e Linux.This version is supported on all platforms .NET Core 2.x supports, including Windows, macOS, and Linux.

WindowsWindows

I passaggi seguenti usano npm per installare gli strumenti di base in Windows.The following steps use npm to install Core Tools on Windows. È anche possibile usare Chocolatey.You can also use Chocolatey. Per altre informazioni, vedere il file leggimi degli strumenti di base.For more information, see the Core Tools readme.

  1. Installare .NET Core 2.0 per Windows.Install .NET Core 2.0 for Windows.

  2. Installare Node.js, che include npm.Install Node.js, which includes npm. Per la versione 2.x degli strumenti, sono supportate solo le versioni Node.js 8.5 e successive.For version 2.x of the tools, only Node.js 8.5 and later versions are supported.

  3. Installare il pacchetto degli strumenti di base:Install the Core Tools package:

    npm install -g azure-functions-core-tools@core
    

MacOS con HomebrewMacOS with Homebrew

I passaggi seguenti usano Homebrew per installare gli strumenti di base su macOS.The following steps use Homebrew to install the Core Tools on macOS.

  1. Installare .NET Core 2.0 per macOS.Install .NET Core 2.0 for macOS.

  2. Installare Homebrew, se non è già installato.Install Homebrew, if it's not already installed.

  3. Installare il pacchetto degli strumenti di base:Install the Core Tools package:

    brew tap azure/functions
    brew install azure-functions-core-tools 
    

Linux (Ubuntu/Debian) con APTLinux (Ubuntu/Debian) with APT

La procedura seguente usa APT per installare gli strumenti di base nella distribuzione Ubuntu/Debian Linux.The following steps use APT to install Core Tools on your Ubuntu/Debian Linux distribution. Per altre distribuzioni Linux, vedere il file leggimi degli strumenti di base.For other Linux distributions, see the Core Tools readme.

  1. Installare .NET Core 2.0 per LinuxInstall .NET Core 2.0 for Linux.

  2. Registrare il codice Product Key di Microsoft come attendibile:Register the Microsoft product key as trusted:

    curl https://packages.microsoft.com/keys/microsoft.asc | gpg --dearmor > microsoft.gpg
    sudo mv microsoft.gpg /etc/apt/trusted.gpg.d/microsoft.gpg
    
  3. Verificare che il server Ubuntu esegua uno delle versioni appropriate nella tabella seguente.Verify your Ubuntu server is running one of the appropriate versions from the table below. Per aggiungere l'origine apt, eseguire:To add the apt source, run:

    sudo sh -c 'echo "deb [arch=amd64] https://packages.microsoft.com/repos/microsoft-ubuntu-$(lsb_release -cs)-prod $(lsb_release -cs) main" > /etc/apt/sources.list.d/dotnetdev.list'
    sudo apt-get update
    
    Distribuzione LinuxLinux distribution VersionVersion
    Ubuntu 17.10Ubuntu 17.10 artful
    Ubuntu 17.04Ubuntu 17.04 zesty
    Ubuntu 16.04/Linux Mint 18Ubuntu 16.04/Linux Mint 18 xenial
  4. Installare il pacchetto degli strumenti di base:Install the Core Tools package:

    sudo apt-get install azure-functions-core-tools
    

Eseguire Strumenti di base di Funzioni di AzureRun Azure Functions Core Tools

Strumenti di base di Funzioni di Azure aggiunge gli alias di comando seguenti:Azure Functions Core Tools adds the following command aliases:

  • funcfunc
  • azfunazfun
  • azurefunctionsazurefunctions

Uno di questi alias può essere utilizzato dove func è visualizzato negli esempi.Any of these aliases can be used where func is shown in the examples.

func init MyFunctionProj

Creare un progetto Funzioni localeCreate a local Functions project

Quando è eseguito in locale, un progetto Funzioni è una directory che presenta i file host.json e local.settings.json.When running locally, a Functions project is a directory that has the files host.json and local.settings.json. Questa directory è l'equivalente di un'app per le funzioni in Azure.This directory is the equivalent of a function app in Azure. Per altre informazioni sulla struttura delle cartelle di Funzioni di Azure, vedere la Guida per sviluppatori di Funzioni di Azure.To learn more about the Azure Functions folder structure, see the Azure Functions developers guide.

Nella finestra del terminale o da un prompt dei comandi, eseguire il comando seguente per creare il progetto e l’archivio Git locale:In the terminal window or from a command prompt, run the following command to create the project and local Git repository:

func init MyFunctionProj

L'output ha un aspetto simile all'esempio seguente:The output looks like the following example:

Writing .gitignore
Writing host.json
Writing local.settings.json
Created launch.json
Initialized empty Git repository in D:/Code/Playground/MyFunctionProj/.git/

Per creare il progetto senza un archivio Git locale, utilizzare l’opzione --no-source-control [-n].To create the project without a local Git repository, use the --no-source-control [-n] option.

Registrare le estensioniRegister extensions

Nella versione 2.x del runtime di Funzioni di Azure è necessario registrare in modo esplicito le estensioni delle associazioni(tipi di associazioni) usate nell'app per le funzioni.In version 2.x of the Azure Functions runtime, you have to explicitly register the binding extensions (binding types) that you use in your function app.

Quando si sviluppano funzioni in locale, è possibile installare le estensioni necessarie tramite Strumenti di base di Funzioni di Azure dal terminale o da un prompt dei comandi.When you develop functions locally, you can install the extensions you need by using the Azure Functions Core Tools from the Terminal or from a command prompt.

Dopo avere aggiornato il file function.json per includere tutte le associazioni necessarie per la funzione, eseguire il comando func extensions install nella cartella del progetto.After you have updated your function.json file to include all the bindings that your function needs, run the func extensions install command in the project folder. Il comando legge il file function.json per scoprire quali pacchetti sono necessari e li installa.The command reads the function.json file to see which packages you need and then installs them.

Se si vuole installare una versione specifica di un pacchetto o si vogliono installare i pacchetti prima di modificare il file function.json, usare il comando func extensions install con il nome del pacchetto, come illustrato nell'esempio seguente:If you want to install a particular version of a package or you want to install packages before editing the function.json file, use the func extensions install command with the name of the package, as shown in the following example:

func extensions install --package Microsoft.Azure.WebJobs.ServiceBus --version <target_version>

Sostituire <target_version> con una specifica versione del pacchetto, come 3.0.0-beta5.Replace <target_version> with a specific version of the package, such as 3.0.0-beta5. Le versioni valide sono elencate nelle pagine dei singoli pacchetti in NuGet.org.Valid versions are listed on the individual package pages at NuGet.org.

Per altre informazioni, vedere Concetti relativi a trigger e associazioni in Funzioni di Azure.For more information, see Azure Functions triggers and bindings concepts.

File di impostazioni localiLocal settings file

Il file local.settings.json archivia le impostazioni di app, le stringhe di connessione e le impostazioni per Strumenti di base di Funzioni di Azure.The file local.settings.json stores app settings, connection strings, and settings for Azure Functions Core Tools. Presenta la struttura seguente:It has the following structure:

{
  "IsEncrypted": false,   
  "Values": {
    "AzureWebJobsStorage": "<connection-string>", 
    "AzureWebJobsDashboard": "<connection-string>",
    "MyBindingConnection": "<binding-connection-string>"
  },
  "Host": {
    "LocalHttpPort": 7071, 
    "CORS": "*" 
  },
  "ConnectionStrings": {
    "SQLConnectionString": "Value"
  }
}
ImpostazioneSetting DESCRIZIONEDescription
IsEncryptedIsEncrypted Se impostato su true, tutti i valori sono crittografati tramite una chiave del computer locale.When set to true, all values are encrypted using a local machine key. Usato con i comandi func settings.Used with func settings commands. Il valore predefinito è false.Default value is false.
ValoriValues Raccolta di impostazioni dell'applicazione e stringhe di connessioni usate durante l'esecuzione in locale.Collection of application settings and connection strings used when running locally. Questi corrispondono alle impostazioni delle app nell'app in Azure, funzione, ad esempio AzureWebJobsStorage e AzureWebJobsDashboard.These correspond to app settings in your function app in Azure, such as AzureWebJobsStorage and AzureWebJobsDashboard. Molti trigger e associazioni includono una proprietà che fa riferimento a un'impostazione della stringa di connessione, ad esempio Connection per Trigger di archiviazione del BLOB.Many triggers and bindings have a property that refers to a connection string app setting, such as Connection for the Blob storage trigger. Per tali proprietà, è necessaria un'impostazione dell'applicazione definita nella matrice Values.For such properties, you need an application setting defined in the Values array.
AzureWebJobsStorage è un'impostazione di app obbligatoria per i trigger diversi da HTTP.AzureWebJobsStorage is a required app setting for triggers other than HTTP. Quando si dispone dell'emulatore di archiviazione di Azure installato localmente, è possibile impostare AzureWebJobsStorage su UseDevelopmentStorage=true e gli strumenti di base usano l'emulatore.When you have the Azure storage emulator installed locally, you can set AzureWebJobsStorage to UseDevelopmentStorage=true and Core Tools uses the emulator. Ciò è utile durante lo sviluppo, ma è consigliabile testare con una connessione di archiviazione reale prima della distribuzione.This is useful during development, but you should test with an actual storage connection before deployment.
HostHost Le impostazioni in questa sezione consentono di personalizzare il processo host di Funzioni durante l'esecuzione in locale.Settings in this section customize the Functions host process when running locally.
LocalHttpPortLocalHttpPort Consente di impostare la porta predefinita usata durante l'esecuzione nell'host locale di Funzioni, ovvero func host start e func run.Sets the default port used when running the local Functions host (func host start and func run). L'opzione --port della riga di comando ha la precedenza su questo valore.The --port command-line option takes precedence over this value.
CORSCORS Definisce le origini consentite per la condivisione di risorse tra le origini (CORS).Defines the origins allowed for cross-origin resource sharing (CORS). Le origini sono elencate in un elenco delimitato dalla virgola senza spazi.Origins are supplied as a comma-separated list with no spaces. È supportato il valore del carattere jolly (*) che consente le richieste di qualsiasi origine.The wildcard value (*) is supported, which allows requests from any origin.
ConnectionStringsConnectionStrings Non usare questa raccolta per le stringhe di connessione usate per l'associazione di funzione.Do not use this collection for the connection strings used by your function bindings. Questa raccolta viene usata solo dai Framework che devono ottenere le stringhe di connessione dalla sezione ConnectionStrings ad una configurazione del file, ad esempio Entity Framework.This collection is only used by frameworks that must get connection strings from the ConnectionStrings section of a configuration file, such as Entity Framework. Le stringhe di connessione in questo oggetto vengono aggiunte all'ambiente con il tipo di provider di System.Data.SqlClient.Connection strings in this object are added to the environment with the provider type of System.Data.SqlClient. Gli elementi in questa raccolta non vengono pubblicati in Azure con altre impostazioni di app.Items in this collection are not published to Azure with other app settings. È necessario aggiungere in modo esplicito questi valori per la sezione Stringhe di connessione delle Impostazioni dell'applicazione per l'app di funzione.You must explicitly add these values to the Connection strings section of the Application settings for your function app.

I valori delle impostazioni dell'app di funzione possono anche essere letti nel codice come variabili di ambiente.The function app settings values can also be read in your code as environment variables. Per altre informazioni, vedere la sezione Variabili di ambiente negli argomenti di riferimento specifici del linguaggio seguenti:For more information, see the Environment variables section of these language-specific reference topics:

Le impostazioni nel file local.settings.json vengono usate solo per gli strumenti delle funzioni durante l'esecuzione in locale.Settings in the local.settings.json file are only used by Functions tools when running locally. Per impostazione predefinita, queste impostazioni non vengono migrate automaticamente quando il progetto viene pubblicato in Azure.By default, these settings are not migrated automatically when the project is published to Azure. Utilizzare lo switch --publish-local-settings durante la pubblicazione per assicurarsi che queste impostazioni vengano aggiunte all'app della funzione in Azure.Use the --publish-local-settings switch when you publish to make sure these settings are added to the function app in Azure. I valori in ConnectionStrings non vengono mai pubblicati.Values in ConnectionStrings are never published.

Quando non è impostata alcuna stringa di connessione di archiviazione valida per AzureWebJobsStorage e non viene usato l'emulatore, viene visualizzato il messaggio di errore seguente:When no valid storage connection string is set for AzureWebJobsStorage and the emulator isn't being used, the following error message is shown:

Valore mancante per AzureWebJobsStorage in local.settings.json.Missing value for AzureWebJobsStorage in local.settings.json. È necessario per tutti i trigger diversi da HTTP.This is required for all triggers other than HTTP. È possibile eseguire "func azure functionapp fetch-app-settings " o specificare una stringa di connessione in local.settings.json.You can run 'func azure functionapp fetch-app-settings ' or specify a connection string in local.settings.json.

Ottenere le stringhe di connessione di archiviazioneGet your storage connection strings

Anche quando si usa l'emulatore di archiviazione per lo sviluppo, si può desiderare di eseguire il test con una connessione di archiviazione effettiva.Even when using the storage emulator for development, you may want to test with an actual storage connection. Se si dispone che si è già creato un account di archiviazione, è possibile ottenere una stringa di connessione di archiviazione valida in uno dei modi seguenti:Assuming you have already created a storage account, you can get a valid storage connection string in one of the following ways:

  • Nel portale di Azure.From the Azure portal. Passare all'account di archiviazione, selezionare Chiavi di accesso in Impostazioni, quindi copiare uno dei valori della Stringa di connessione.Navigate to your storage account, select Access keys in Settings, then copy one of the Connection string values.

    Copiare la stringa di connessione dal portale di Azure

  • Usare Azure Storage Explorer per collegarsi all'account di Azure.Use Azure Storage Explorer to connect to your Azure account. In Explorer, espandere la propria sottoscrizione, selezionare l'account di archiviazione e copiare la stringa di connessione primaria o secondaria.In the Explorer, expand your subscription, select your storage account, and copy the primary or secondary connection string.

    Copiare la stringa di connessione da Storage Explorer

  • Usare strumenti di base per scaricare la stringa di connessione da Azure con uno dei seguenti comandi:Use Core Tools to download the connection string from Azure with one of the following commands:

    • Scaricare tutte le impostazioni di un'app di funzione esistente:Download all settings from an existing function app:

      func azure functionapp fetch-app-settings <FunctionAppName>
      
    • Ottenere la stringa di connessione per uno specifico account di archiviazione:Get the Connection string for a specific storage account:

      func azure storage fetch-connection-string <StorageAccountName>
      

      Per entrambi i comandi è necessario innanzitutto accedere ad Azure.Both commands require you to first sign in to Azure.

Creare una funzioneCreate a function

Eseguire il comando seguente per creare una funzione:To create a function, run the following command:

func new

func new supporta gli argomenti opzionali seguenti:func new supports the following optional arguments:

ArgomentoArgument DESCRIZIONEDescription
--language -l Il linguaggio di programmazione del modello, come C#, F# o JavaScript.The template programming language, such as C#, F#, or JavaScript.
--template -t Il nome del modello.The template name.
--name -n Il nome della funzione.The function name.

Ad esempio, per creare un trigger HTTP JavaScript, eseguire:For example, to create a JavaScript HTTP trigger, run:

func new --language JavaScript --template "Http Trigger" --name MyHttpTrigger

Per creare una funzione attivata dalla coda, eseguire:To create a queue-triggered function, run:

func new --language JavaScript --template "Queue Trigger" --name QueueTriggerJS
```bash
<a name="start"></a>
## Run functions locally

To run a Functions project, run the Functions host. The host enables triggers for all functions in the project:

```bash
func host start

func host start supporta le opzioni seguenti:func host start supports the following options:

OpzioneOption DESCRIZIONEDescription
--port -p La porta locale su cui ascoltare.The local port to listen on. Valore predefinito: 7071.Default value: 7071.
--debug <type> Le opzioni sono VSCode e VS.The options are VSCode and VS.
--cors Un elenco delimitato dalla virgola di origini CORS, senza spazi.A comma-separated list of CORS origins, with no spaces.
--nodeDebugPort -n La porta per il debugger di nodo da usare.The port for the node debugger to use. Predefinito: un valore di launch.json o 5858.Default: A value from launch.json or 5858.
--debugLevel -d Il livello di traccia della console (off, verbose, info, warning o error).The console trace level (off, verbose, info, warning, or error). Predefinito: Info.Default: Info.
--timeout -t Il timeout per l'host di Funzioni da avviare, in secondi.The timeout for the Functions host to start, in seconds. Impostazione predefinita: 20 secondi.Default: 20 seconds.
--useHttps Eseguire l'associazione a https://localhost:{port} anziché a http://localhost:{port}.Bind to https://localhost:{port} rather than to http://localhost:{port}. Per impostazione predefinita, questa opzione crea un certificato attendibile nel computer in uso.By default, this option creates a trusted certificate on your computer.
--pause-on-error Sospendere per l'input aggiuntivo prima dell'uscita dal processo.Pause for additional input before exiting the process. Utile quando si avvia Strumenti di base di Funzioni di Azure da un ambiente di sviluppo integrato (IDE).Useful when launching Azure Functions Core Tools from an integrated development environment (IDE).

Quando viene avviato l'host di Funzioni, restituisce come output l'URL delle funzioni attivate da HTTP:When the Functions host starts, it outputs the URL of HTTP-triggered functions:

Found the following functions:
Host.Functions.MyHttpTrigger

Job host started
Http Function MyHttpTrigger: http://localhost:7071/api/MyHttpTrigger

Eseguire il debug in Visual Studio Code o Visual StudioDebug in VS Code or Visual Studio

Per associare un debugger, passare l'argomento --debug.To attach a debugger, pass the --debug argument. Per eseguire il debug di funzioni JavaScript, usare Visual Studio Code.To debug JavaScript functions, use Visual Studio Code. Per le funzioni C#, usare Visual Studio.For C# functions, use Visual Studio.

Per eseguire il debug di funzioni C#, usare --debug vs.To debug C# functions, use --debug vs. È anche possibile usare Strumenti di Visual Studio 2017 per Funzioni di Azure.You can also use Azure Functions Visual Studio 2017 Tools.

Per avviare l'host e configurare il debug di JavaScript, eseguire:To launch the host and set up JavaScript debugging, run:

func host start --debug vscode

Importante

Per finalità di debug, è supportato solo Node.js 8.x.For debugging, only Node.js 8.x is supported. Node.js 9.x non è supportato.Node.js 9.x is not supported.

Quindi, in Visual Studio Code, nella visualizzazione Debug, selezionare Attach to Azure Functions (Associa a Funzioni di Azure).Then, in Visual Studio Code, in the Debug view, select Attach to Azure Functions. È possibile associare punti di interruzione, controllare variabili ed eseguire il codice passo per passo.You can attach breakpoints, inspect variables, and step through code.

Debug di JavaScript con Visual Studio Code

Passaggio di dati di test a una funzionePassing test data to a function

Per testare le funzioni localmente, avviare l'host di Funzioni e chiamare gli endpoint nel server locale usando richieste HTTP.To test your functions locally, you start the Functions host and call endpoints on the local server using HTTP requests. L'endpoint chiamato dipende dal tipo di funzione.The endpoint you call depends on the type of function.

Nota

Gli esempi in questo argomento usano lo strumento cURL per inviare richieste HTTP dal terminale o da un prompt dei comandi.Examples in this topic use the cURL tool to send HTTP requests from the terminal or a command prompt. È possibile usare lo strumento preferito per inviare richieste HTTP al server locale.You can use a tool of your choice to send HTTP requests to the local server. Lo strumento cURL è disponibile per impostazione predefinita nei sistemi basati su Linux.The cURL tool is available by default on Linux-based systems. In Windows è necessario prima scaricare e installare lo strumento cURL.On Windows, you must first download and install the cURL tool.

Per informazioni più generali sui test delle funzioni, vedere Strategie per il test del codice in Funzioni di Azure.For more general information on testing functions, see Strategies for testing your code in Azure Functions.

Funzioni attivate tramite HTTP e webhookHTTP and webhook triggered functions

È possibile chiamare l'endpoint seguente per eseguire localmente funzioni attivate tramite HTTP e webhook:You call the following endpoint to locally run HTTP and webhook triggered functions:

http://localhost:{port}/api/{function_name}

Assicurarsi di usare lo stesso nome server e la stessa porta su cui è in ascolto l'host di Funzioni.Make sure to use the same server name and port that the Functions host is listening on. Questi valori sono visualizzati nell'output generato all'avvio dell'host di Funzioni.You see this in the output generated when starting the Function host. È possibile chiamare questo URL usando qualsiasi metodo HTTP supportato dal trigger.You can call this URL using any HTTP method supported by the trigger.

Il comando cURL seguente attiva la funzione di avvio rapido MyHttpTrigger da una richiesta GET con il parametro name passato nella stringa di query.The following cURL command triggers the MyHttpTrigger quickstart function from a GET request with the name parameter passed in the query string.

curl --get http://localhost:7071/api/MyHttpTrigger?name=Azure%20Rocks

L'esempio seguente è la stessa funzione chiamata da una richiesta POST passando name nel corpo della richiesta:The following example is the same function called from a POST request passing name in the request body:

curl --request POST http://localhost:7071/api/MyHttpTrigger --data '{"name":"Azure Rocks"}'

È possibile effettuare richieste GET da un browser passando dati nella stringa di query.You can make GET requests from a browser passing data in the query string. Per tutti gli altri metodi HTTP è necessario usare cURL, Fiddler, Postman o uno strumento analogo per i test HTTP.For all other HTTP methods, you must use cURL, Fiddler, Postman, or a similar HTTP testing tool.

Funzione attivate non da HTTPNon-HTTP triggered functions

Per tutti i tipi di funzioni diverse dai trigger HTTP e dai webhook, è possibile testare localmente le funzioni chiamando un endpoint di amministrazione.For all kinds of functions other than HTTP triggers and webhooks, you can test your functions locally by calling an administration endpoint. Chiamando questo endpoint con una richiesta HTTP POST sul server locale si attiva la funzione.Calling this endpoint with an HTTP POST request on the local server triggers the function. È facoltativamente possibile passare dati di test all'esecuzione nel corpo del messaggio della richiesta POST.You can optionally pass test data to the execution in the body of the POST request. Questa funzionalità è analoga alla scheda Test del portale di Azure.This functionality is similar to the Test tab in the Azure portal.

Chiamare l'endpoint di amministrazione seguente per attivare funzioni non HTTP:You call the following administrator endpoint to trigger non-HTTP functions:

http://localhost:{port}/admin/functions/{function_name}

Per passare dati di test all'endpoint di amministrazione di una funzione, è necessario fornire i dati nel corpo di un messaggio di richiesta POST.To pass test data to the administrator endpoint of a function, you must supply the data in the body of a POST request message. Il corpo del messaggio deve avere il formato JSON seguente:The message body is required to have the following JSON format:

{
    "input": "<trigger_input>"
}

Il valore <trigger_input> contiene dati nel formato previsto dalla funzione.The <trigger_input> value contains data in a format expected by the function. L'esempio cURL seguente è una richiesta POST per una funzione QueueTriggerJS.The following cURL example is a POST to a QueueTriggerJS function. In questo caso l'input è una stringa che equivale al messaggio previsto nella coda.In this case, the input is a string that is equivalent to the message expected to be found in the queue.

curl --request POST -H "Content-Type:application/json" --data '{"input":"sample queue data"}' http://localhost:7071/admin/functions/QueueTriggerJS

Uso del comando func run nella versione 1.xUsing the func run command in version 1.x

Importante

Il comando func run non è supportato nella versione 2.x degli strumenti.The func run command is not supported in version 2.x of the tools. Per altre informazioni, vedere l'argomento Come specificare le versioni del runtime per Funzioni di Azure.For more information, see the topic How to target Azure Functions runtime versions.

È anche possibile richiamare una funzione direttamente tramite func run <FunctionName> e offrire dati di input per la funzione.You can also invoke a function directly by using func run <FunctionName> and provide input data for the function. Questo comando è simile all'esecuzione di una funzione con la scheda Test nel portale di Azure.This command is similar to running a function using the Test tab in the Azure portal.

func run supporta le opzioni seguenti:func run supports the following options:

OpzioneOption DESCRIZIONEDescription
--content -c Contenuto inline.Inline content.
--debug -d Associare un debugger al processo host prima di eseguire la funzione.Attach a debugger to the host process before running the function.
--timeout -t Tempo di attesa (in secondi) fino a quando l'host locale di Funzioni è pronto.Time to wait (in seconds) until the local Functions host is ready.
--file -f Il nome del file da usare come contenuto.The file name to use as content.
--no-interactive Non richiede input.Does not prompt for input. Utile per scenari di automazione.Useful for automation scenarios.

Ad esempio, per chiamare una funzione attivata da HTTP e passare il corpo del contenuto, eseguire il comando seguente:For example, to call an HTTP-triggered function and pass content body, run the following command:

func run MyHttpTrigger -c '{\"name\": \"Azure\"}'

Visualizzazione dei file di log in localeViewing log files locally

Quando l'host di Funzioni viene eseguito in locale, scrive i log nel percorso seguente:When the Functions host runs locally, it writes logs to the following path:

<DefaultTempDirectory>\LogFiles\Application\Functions

In Windows <DefaultTempDirectory> è il primo valore trovato delle variabili di ambiente TMP, TEMP, USERPROFILE o la directory di Windows.On Windows, <DefaultTempDirectory> is the first found value of the TMP, TEMP, USERPROFILE environment variables, or the Windows directory. In MacOS o Linux <DefaultTempDirectory> è la variabile di ambiente TMPDIR.On MacOS or Linux, <DefaultTempDirectory> is the TMPDIR environment variable.

Nota

Quando l'host di Funzioni viene avviato, sovrascrive la struttura di file esistente nella directory.When the Functions host starts, it overwrites the existing file structure in the directory.

Pubblicazione in AzurePublish to Azure

Per pubblicare un progetto Funzioni in un'app per le funzioni in Azure, usare il comando publish:To publish a Functions project to a function app in Azure, use the publish command:

func azure functionapp publish <FunctionAppName>

È possibile usare le opzioni seguenti:You can use the following options:

OpzioneOption DESCRIZIONEDescription
--publish-local-settings -i Pubblicare le impostazioni di local.settings.json in Azure, suggerendo di sovrascrivere eventuali impostazioni esistenti.Publish settings in local.settings.json to Azure, prompting to overwrite if the setting already exists. Se si usa l'emulatore di archiviazione, si modifica l'impostazione dell'app portandola a connessione di archiviazione effettiva.If you are using the storage emulator, you change the app setting to an actual storage connection.
--overwrite-settings -y Deve essere usato con -i.Must be used with -i. Sovrascrive AppSettings in Azure con il valore locale se diverso.Overwrites AppSettings in Azure with local value if different. Viene suggerito il valore predefinito.Default is prompt.

Questo comando consente di pubblicare un'app per le funzioni esistente in Azure.This command publishes to an existing function app in Azure. Si verifica un errore se <FunctionAppName> non esiste nella propria sottoscrizione.An error occurs when the <FunctionAppName> doesn't exist in your subscription. Per informazioni su come creare un'app per le funzioni dal prompt dei comandi o dalla finestra del terminale usando l'interfaccia della riga di comando di Azure, vedere Creare un'app per le funzioni per l'esecuzione senza server.To learn how to create a function app from the command prompt or terminal window using the Azure CLI, see Create a Function App for serverless execution.

Il comando publish carica il contenuto della directory del progetto Funzioni.The publish command uploads the contents of the Functions project directory. Se si eliminano i file in locale, il comando publish non li elimina da Azure.If you delete files locally, the publish command does not delete them from Azure. È possibile eliminare i file in Azure usando lo strumento Kudu nel portale di Azure.You can delete files in Azure by using the Kudu tool in the Azure portal.

Importante

Quando si crea un'app per le funzioni in Azure, questa utilizza la versione 1.x del runtime di Funzioni per impostazione predefinita.When you create a function app in Azure, it uses version 1.x of the Function runtime by default. Per fare in modo che l’app per le funzioni utilizzi la versione 2.x del runtime, aggiungere l'impostazione dell'applicazione FUNCTIONS_EXTENSION_VERSION=beta.To make the function app use version 2.x of the runtime, add the application setting FUNCTIONS_EXTENSION_VERSION=beta.
Utilizzare il seguente codice dell’interfaccia della riga di comando di Azure per aggiungere questa impostazione all'app per le funzioni:Use the following Azure CLI code to add this setting to your function app:

az functionapp config appsettings set --name <function_app> \
--resource-group myResourceGroup \
--settings FUNCTIONS_EXTENSION_VERSION=beta   

Passaggi successiviNext steps

Strumenti di base di Funzioni di Azure è open source ed è ospitato su GitHub.Azure Functions Core Tools is open source and hosted on GitHub.
Per registrare una richiesta per un bug o una funzionalità aprire un problema di GitHub.To file a bug or feature request, open a GitHub issue.