Gestire l'app per le funzioni

In Funzioni di Azure un'app per le funzioni fornisce il contesto di esecuzione per le singole funzioni. I comportamenti dell'app per le funzioni si applicano a tutte le funzioni ospitate da un'app per le funzioni specifica. Tutte le funzioni in un'app per le funzioni devono condividere lo stesso linguaggio.

Le singole funzioni in un'app per le funzioni vengono distribuite insieme e vengono ridimensionate insieme. Tutte le funzioni nella stessa app per le funzioni condividono risorse, per istanza, mentre l'app per le funzioni viene ridimensionata.

Le stringhe di connessione, le variabili di ambiente e altre impostazioni dell'applicazione vengono definite separatamente per ogni app per le funzioni. Tutti i dati che devono essere condivisi tra le app per le funzioni devono essere archiviati esternamente in un archivio persistente.

Inizia nel portale di Azure

Nota

A causa delle limitazioni alla modifica del codice della funzione nel portale di Azure, è consigliabile sviluppare le funzioni in locale e pubblicare il progetto di codice in un'app per le funzioni in Azure. Per altre informazioni, vedere Limitazioni per lo sviluppo nel portale di Azure

Per visualizzare le impostazioni dell'app nell'app per le funzioni, seguire questa procedura:

1. Accedere al portale di Azure con l'account di Azure. Cercare l'app per le funzioni e selezionarla.

2. Nel riquadro sinistro dell'app per le funzioni, espandere Impostazioni, selezionare Variabili di ambiente e successivamente selezionare la scheda Impostazioni app.

   

Lavorare con le impostazioni dell'applicazione

Oltre alle impostazioni dell'app predefinite usate da Funzioni di Azure, è possibile creare un numero qualsiasi di impostazioni dell'app, come richiesto dal codice della funzione. Per maggiori informazioni, vedere Informazioni di riferimento sulle impostazioni dell'app per Funzioni di Azure.

Queste impostazioni vengono archiviate crittografate. Per maggiori informazioni, vedere Sicurezza delle impostazioni delle app.

È possibile gestire le impostazioni dell'app dal portale di Azure, usando l'interfaccia della riga di comando di Azure e Azure PowerShell. È anche possibile gestire le impostazioni delle app da Visual Studio Code e da Visual Studio.

Azure portal

Per visualizzare le impostazioni dell'app, andare su Informazioni di base sul portale di Azure.

La scheda Impostazioni app mantiene le impostazioni usate dall'app per le funzioni:

1. Per visualizzare i valori delle impostazioni dell'app, selezionare Mostra valori.

2. Per aggiungere un'impostazione, selezionare + Aggiungi e immettere il Nome e il Valore della nuova coppia chiave-valore.

   

Interfaccia della riga di comando di Azure

Il az functionapp config appsettings list comando restituisce le impostazioni dell'applicazione esistenti, ad esempio:

az functionapp config appsettings list --name <FUNCTION_APP_NAME> \
--resource-group <RESOURCE_GROUP_NAME>

Il az functionapp config appsettings set comando aggiunge o aggiorna un'impostazione dell'applicazione. Nell'esempio seguente, viene creata un'impostazione con una chiave denominata CUSTOM_FUNCTION_APP_SETTING e un valore di 12345:

az functionapp config appsettings set --name <FUNCTION_APP_NAME> \
--resource-group <RESOURCE_GROUP_NAME> \
--settings CUSTOM_FUNCTION_APP_SETTING=12345

Azure PowerShell

Il Get-AzFunctionAppSetting cmdlet restituisce le impostazioni dell'applicazione esistenti, ad esempio:

Get-AzFunctionAppSetting -Name <FUNCTION_APP_NAME> -ResourceGroupName <RESOURCE_GROUP_NAME>

Il Update-AzFunctionAppSetting comando aggiunge o aggiorna un'impostazione dell'applicazione. Nell'esempio seguente, viene creata un'impostazione con una chiave denominata CUSTOM_FUNCTION_APP_SETTING e un valore di 12345:

Update-AzFunctionAppSetting -Name <FUNCTION_APP_NAME> -ResourceGroupName <RESOURCE_GROUP_NAME> -AppSetting @{"CUSTOM_FUNCTION_APP_SETTING" = "12345"}

Usare le impostazioni dell'applicazione

I valori delle impostazioni dell'app di funzione possono anche essere letti nel codice come variabili di ambiente. Per maggiori informazioni, vedere la sezione Variabili di ambiente in questi articoli di riferimento specifici della lingua:

• C# precompilato
• Script C# (file con estensione csx)
• Java
• JavaScript
• PowerShell
• Python

Quando si sviluppa un'app per le funzioni in locale, è necessario mantenere copie locali di questi valori nel file di progetto local.settings.json. Per maggiori informazioni, vedere File di impostazioni locali.

Impostazioni di distribuzione FTPS

Funzioni di Azure supporta la distribuzione del codice del progetto nell'app per le funzioni tramite FTPS. Questo metodo di distribuzione richiede la sincronizzazione dei trigger, pertanto non è consigliabile. Per trasferire in modo sicuro i file di progetto, usare sempre FTPS e non FTP.

Per ottenere le credenziali necessarie per la distribuzione FTPS, usare uno dei metodi seguenti:

Azure portal

È possibile ottenere le credenziali di pubblicazione FTPS nel portale di Azure scaricando il profilo di pubblicazione per l'app per le funzioni.

Importante

Il profilo di pubblicazione contiene credenziali di sicurezza importanti. Proteggere sempre il file scaricato nel computer locale.

Per scaricare il profilo di pubblicazione dell'app per le funzioni:

1. Nel portale di Azureindividuare la pagina per l'app per le funzioni, espandere Impostazioni>Configurazione nella colonna sinistra.

2. Nella pagina Configurazione, selezionare la scheda Impostazioni generali e assicurarsi che le Credenziali di pubblicazione dell'autenticazione di base di SCM siano impostate su On. Quando questa impostazione è Disattivata, non è possibile usare i profili di pubblicazione, quindi selezionare On e Salva.

3. Tornare alla pagina Panoramica dell'app per le funzioni e quindi selezionare Ottieni profilo di pubblicazione.

   

4. Salvare e copiare il contenuto del file.

3. Nel file, individuare l'elemento publishProfile con l'attributo publishMethod="FTP". In questo elemento, gli attributi publishUrl, userName e userPWD contengono l'URL di destinazione e le credenziali per la pubblicazione FTPS.

Interfaccia della riga di comando di Azure

Eseguire questo comando dell'interfaccia della riga di comando di Azure che restituisce le credenziali FTPS dal profilo di pubblicazione.

az functionapp deployment list-publishing-profiles --name <APP_NAME> --resource-group <GROUP_NAME> --query "[?publishMethod=='FTP'].{URL:publishUrl, username:userName, password:userPWD}" -o table

In questo esempio, sostituire <APP_NAME> con il nome dell'app per le funzioni e <GROUP_NAME> con il gruppo di risorse. Le colonne URL, username e password restituite contengono l'URL di destinazione e le credenziali per la pubblicazione FTPS.

Azure PowerShell

Eseguire questo comando di Azure PowerShell che restituisce le credenziali FTPS dal profilo di pubblicazione.

$profile = [xml](Get-AzWebAppPublishingProfile -ResourceGroupName "<GROUP_NAME>" -Name "<APP_NAME>" -Format "Ftp") 
$profile.publishData.publishProfile | Where-Object -Property publishMethod -eq Ftp | Select-Object -Property @{Name="URL"; Expression = {$_.publishUrl}}, 
@{Name="username"; Expression = {$_.userName}}, @{Name="password"; Expression = {$_.userPWD}} | Format-Table

In questo esempio, sostituire <APP_NAME> con il nome dell'app per le funzioni e <GROUP_NAME> con il gruppo di risorse. Le colonne URL, username e password restituite contengono l'URL di destinazione e le credenziali per la pubblicazione FTPS.

Tipo di piano di hosting

Quando si crea un'app per le funzioni, si crea anche un piano di hosting in cui viene eseguita l'app. Un piano può avere una o più app per le funzioni. Le funzionalità, il ridimensionamento e i prezzi delle funzioni dipendono dal tipo di piano. Per altre informazioni, vedere Opzioni di hosting di Funzioni di Azure.

È possibile determinare il tipo di piano usato dall'app per le funzioni dal portale di Azure, oppure usando l'interfaccia della riga di comando di Azure o le API di Azure PowerShell.

I valori seguenti indicano il tipo di piano:

Tipo di piano	Azure portal	Interfaccia della riga di comando di Azure/PowerShell
Consumo	Consumo	Dynamic
Premium	ElasticPremium	ElasticPremium
Dedicato (servizio app)	Varie	Varie

Azure portal

1. Per determinare il tipo di piano usato dall'app per le funzioni, vedere Piano di servizio app nella pagina Panoramica dell'app per le funzioni nel portale di Azure.

   

2. Per visualizzare il piano tariffario, selezionare il nome del Piano di servizio app e quindi selezionare Impostazioni > Proprietà dal riquadro sinistro.

Interfaccia della riga di comando di Azure

Eseguire il comando seguente dell'interfaccia della riga di comando di Azure per ottenere il tipo di piano di hosting:

functionApp=<FUNCTION_APP_NAME>
resourceGroup=FunctionMonitoringExamples
appServicePlanId=$(az functionapp show --name $functionApp --resource-group $resourceGroup --query appServicePlanId --output tsv)
az appservice plan list --query "[?id=='$appServicePlanId'].sku.tier" --output tsv

Nell'esempio precedente, sostituire <RESOURCE_GROUP> e <FUNCTION_APP_NAME> rispettivamente con il gruppo di risorse e i nomi delle app per le funzioni.

Azure PowerShell

Eseguire il comando di Azure PowerShell seguente per ottenere il tipo di piano di hosting:

$FunctionApp = '<FUNCTION_APP_NAME>'
$ResourceGroup = '<RESOURCE_GROUP>'

$PlanID = (Get-AzFunctionApp -ResourceGroupName $ResourceGroup -Name $FunctionApp).AppServicePlan
(Get-AzFunctionAppPlan -Name $PlanID -ResourceGroupName $ResourceGroup).SkuTier

Nell'esempio precedente, sostituire <RESOURCE_GROUP> e <FUNCTION_APP_NAME> rispettivamente con il gruppo di risorse e i nomi delle app per le funzioni.

Migrazione a un altro piano

È possibile migrare un'app per le funzioni tra un piano A consumo e un piano Premium in Windows. Quando si esegue la migrazione tra piani, tenere presenti le considerazioni seguenti:

• La migrazione diretta a un piano dedicato (servizio app) non è supportata.
• Questa migrazione non è supportata in Linux.
• Il piano di origine e il piano di destinazione devono trovarsi nello stesso gruppo di risorse e nella stessa area geografica. Per altre informazioni, vedere Move an app to another App Service plan (Spostare un'app in un altro piano di servizio app).
• I comandi specifici dell’interfaccia della riga di comando dipendono dalla direzione della migrazione.
• Il tempo di inattività nell’esecuzione delle funzioni si verifica quando viene eseguita la migrazione dell'app per le funzioni tra i piani.
• Lo stato e altri contenuti specifici dell'app vengono mantenuti, perché la stessa condivisione di File di Azure viene usata dall'app sia prima che dopo la migrazione.

È possibile eseguire la migrazione del piano usando questi strumenti:

Azure portal

È possibile usare il portale di Azure per passare a un piano diverso.

Interfaccia della riga di comando di Azure

È possibile usare i comandi dell'interfaccia della riga di comando di Azure per creare manualmente un nuovo piano, cambiare l'app per usare il nuovo piano ed eliminare il piano originale.

Azure PowerShell

È possibile usare i comandi di Azure PowerShell per creare manualmente un nuovo piano, cambiare l'app per usare il nuovo piano ed eliminare il piano originale.

Scegliere la direzione della migrazione per l'app in Windows.

Consumption-to-Premium

1. Nel portale di Azure, andare all'app piano A consumo e scegliere Cambia piano di servizio app in Piano di servizio app.

2. Selezionare Premium in Tipo di piano, creare un nuovo piano Premium e selezionare OK.

Per altre informazioni, vedere Move an app to another App Service plan (Spostare un'app in un altro piano di servizio app).

Premium-to-Consumption

1. Nel portale di Azure, andare all'app piano Premium e scegliere Cambia piano di servizio app in Piano di servizio app.

2. In Tipo di piano, selezionare A consumo, creare un nuovo piano A consumo e selezionare OK.

Per altre informazioni, vedere Move an app to another App Service plan (Spostare un'app in un altro piano di servizio app).

Consumption-to-Premium

Usare la procedura seguente per migrare da un piano A consumo a un piano Premium in Windows:

1. Eseguire il comando creare az functionapp come segue per creare un nuovo piano di servizio app (Elastic Premium) nella stessa area e nello stesso gruppo di risorse dell'app per le funzioni esistente:

   az functionapp plan create --name <NEW_PREMIUM_PLAN_NAME> --resource-group <MY_RESOURCE_GROUP> --location <REGION> --sku EP1
   

2. Eseguire il comando aggiornare az functionapp come indicato di seguito per migrare l'app per le funzioni esistente al nuovo piano Premium:

   az functionapp update --name <MY_APP_NAME> --resource-group <MY_RESOURCE_GROUP> --plan <NEW_PREMIUM_PLAN>
   

3. Quando non si necessita più del piano A consumo usato originariamente dall'app, eliminare il piano originale, dopo aver confermato la migrazione a quella nuova. Eseguire il comando lista del piano az functionapp come indicato di seguito, per ottenere un elenco di tutti i piani A consumo nel gruppo di risorse:

   az functionapp plan list --resource-group <MY_RESOURCE_GROUP> --query "[?sku.family=='Y'].{PlanName:name,Sites:numberOfSites}" -o table
   

   È possibile eliminare in modo sicuro il piano con zero siti, ovvero quello da cui è stata eseguita la migrazione.

4. Eseguire il comando eliminare az functionapp plan come indicato di seguito, per eliminare il piano A consumo da cui è stata eseguita la migrazione.

   az functionapp plan delete --name <CONSUMPTION_PLAN_NAME> --resource-group <MY_RESOURCE_GROUP>
   

Premium-to-Consumption

Usare la procedura seguente per migrare da un piano Premium a un piano A consumo in Windows:

1. Eseguire il comando creare az functionapp come segue, per creare una nuova app per le funzioni (A consumo) nella stessa area e nello stesso gruppo di risorse dell'app per le funzioni esistente. Questo comando crea anche un nuovo piano A consumo in cui viene eseguita l'app per le funzioni:

   az functionapp create --resource-group <MY_RESOURCE_GROUP> --name <NEW_CONSUMPTION_APP_NAME> --consumption-plan-location <REGION> --runtime <LANGUAGE_RUNTIME> --functions-version 4 --storage-account <STORAGE_NAME>
   

2. Eseguire il comando mostra az functionapp come indicato di seguito, per ottenere il nome del piano A consumo creato con la nuova app per le funzioni:

   az functionapp show --resource-group <MY_RESOURCE_GROUP> --name <NEW_CONSUMPTION_APP_NAME> --query "{appServicePlanId}" -o tsv
   

   Il nome del piano A consumo è il segmento finale dell'ID della risorsa completo, che viene restituito.

3. Eseguire il comando aggiornare az functionapp come indicato di seguito, per migrare l'app per le funzioni esistente al nuovo piano A consumo:

   az functionapp update --name <MY_APP_NAME> --resource-group <MY_RESOURCE_GROUP> --plan <NEW_CONSUMPTION_PLAN> --force
   

4. Eseguire il comando eliminare az functionapp come indicato di seguito, per eliminare l'app per le funzioni creata nel passaggio 1, poiché si necessita solo del piano creato per eseguire l'app per le funzioni esistente:

   az functionapp delete --name <NEW_CONSUMPTION_APP_NAME> --resource-group <MY_RESOURCE_GROUP>
   

5. Quando non si necessita più del piano Premium usato originariamente dall'app, eliminare il piano originale dopo aver confermato la migrazione a quella nuova. Fino a quando il piano Premium non viene eliminato, l'addebito continua. Eseguire il comando lista del piano az functionapp come indicato di seguito, per ottenere un elenco di tutti i piani Premium nel gruppo risorse:

   az functionapp plan list --resource-group <MY_RESOURCE_GROUP> --query "[?sku.family=='EP'].{PlanName:name,Sites:numberOfSites}" -o table
   

6. Eseguire il comando eliminare il piano az functionapp come indicato di seguito, per eliminare il piano Premium da cui è stata eseguita la migrazione:

   az functionapp plan delete --name <PREMIUM_PLAN> --resource-group <MY_RESOURCE_GROUP>
   

Consumption-to-Premium

Usare la procedura seguente per migrare da un piano A consumo a un piano Premium in Windows:

1. Eseguire il comando New-AzFunctionAppPlan come indicato di seguito, per creare un nuovo piano di servizio app (Elastic Premium) nella stessa area e nello stesso gruppo di risorse dell'app per le funzioni esistente:

   New-AzFunctionAppPlan -Name <NEW_PREMIUM_PLAN_NAME> -ResourceGroupName <MY_RESOURCE_GROUP> -Location <REGION> -Sku EP1 -WorkerType Windows
   

2. Eseguire il comando Update-AzFunctionApp come indicato di seguito, per migrare l'app per le funzioni esistente al nuovo piano Premium:

   Update-AzFunctionApp -Name <MY_APP_NAME> -ResourceGroupName <MY_RESOURCE_GROUP> -PlanName <NEW_PREMIUM_PLAN> -Force
   

3. Quando non si necessita più del piano A consumo usato originariamente dall'app, è possibile eseguire il comando Remove-AzFunctionAppPlan come indicato di seguito, per eliminare il piano A consumo da cui è stata eseguita la migrazione:

   Remove-AzFunctionAppPlan -Name <CONSUMPTION_PLAN_NAME> -ResourceGroupName <MY_RESOURCE_GROUP> -Force
   

Premium-to-Consumption

Usare la procedura seguente per migrare da un piano Premium a un piano A consumo in Windows:

1. Eseguire il comando New-AzFunctionApp come indicato di seguito, per creare una nuova app per le funzioni (A consumo) nella stessa area e nello stesso gruppo di risorse dell'app per le funzioni esistente. Questo comando crea anche un nuovo piano A consumo in cui viene eseguita l'app per le funzioni:

   New-AzFunctionApp -Name <NEW_CONSUMPTION_APP_NAME> -StorageAccountName <STORAGE_NAME> -Location <REGION> -ResourceGroupName <MY_RESOURCE_GROUP> -Runtime <LANGUAGE_RUNTIME> -RuntimeVersion <LANGUAGE_VERSION> -FunctionsVersion 4 -OSType Windows
   

2. Eseguire il comando Get-AzFunctionApp come indicato di seguito, per ottenere il nome del piano A consumo creato con la nuova app per le funzioni:

   Get-AzFunctionApp -ResourceGroupName <MY_RESOURCE_GROUP> -Name <NEW_CONSUMPTION_APP_NAME> | Select-Object -Property AppServicePlan | Format-List
   

3. Eseguire il comando Update-AzFunctionApp come indicato di seguito, per migrare l'app per le funzioni esistente al nuovo piano A consumo:

   Update-AzFunctionApp -Name <MY_APP_NAME> -ResourceGroupName <MY_RESOURCE_GROUP> -PlanName <NEW_CONSUMPTION_PLAN> -Force
   

4. Quando non si necessita più del piano A consumo usato originariamente dall'app, è possibile eseguire il comando Remove-AzFunctionAppPlan come indicato di seguito, per eliminare il piano A consumo da cui è stata eseguita la migrazione:

   Remove-AzFunctionAppPlan -Name <CONSUMPTION_PLAN_NAME> -ResourceGroupName <MY_RESOURCE_GROUP> -Force
   

Limitazioni di sviluppo nel portale di Azure

La tabella seguente illustra i sistemi operativi e le lingue che supportano la modifica nel portale:

Lingua	Consumo Windows	Windows Premium	Windows Dedicato	Consumo Linux	Linux Premium	Linux dedicato
C#
Java
JavaScript (Node.js)	✔	✔	✔		✔	✔
Python				✔	✔	✔
PowerShell	✔	✔	✔
TypeScript (Node.js)

Quando si sviluppano le funzioni nel portale di Azure, tenere presenti queste limitazioni:

• La modifica nel portale è supportata solo per le funzioni create o modificate per l'ultima volta nel portale di Azure.
• La modifica nel portale è supportata solo per le funzioni JavaScript, PowerShell, Python, e C# Script.
• La modifica nel portale non è attualmente supportata dal piano Flex Consumption.
• Quando si implementa il codice in un'app per le funzioni dall'esterno del portale di Azure, non è più possibile modificare alcun codice per tale app per le funzioni nel portale. In questo caso, continuare a usare lo sviluppo locale.
• Per Python, lo sviluppo con moduli personalizzati non è attualmente supportato nel portale. Per aggiungere moduli personalizzati all'app per le funzioni, è necessario sviluppare l'app in locale.
• Per le funzioni C# e Java compilate, è possibile creare l'app per le funzioni e le risorse correlate nel portale. Tuttavia, è necessario creare il progetto di codice delle funzioni in locale e successivamente pubblicarlo in Azure.

Quando possibile, sviluppare le funzioni in locale e pubblicare il progetto di codice in un'app per le funzioni in Azure. Per altre informazioni, vedere Scrivere codice per Funzioni di Azure e testarle in locale.

Installare le estensioni manualmente

Le funzioni della libreria di classi C# possono includere i pacchetti NuGet per le estensioni di associazione direttamente nel progetto di libreria di classi. Per altri linguaggi non-.NET e script C#, è consigliabile usare bundle di estensioni. Se è necessario installare manualmente le estensioni, è possibile farlo usando Azure Functions Core Tools in locale. Se non è possibile usare bundle di estensioni e non è possibile lavorare al di fuori del portale, è necessario usare Strumenti avanzati (Kudu) per creare manualmente il file extensions.csproj direttamente nel sito. Assicurarsi di rimuovere prima l'extensionBundleelemento dal file host.json.

Questo stesso processo funziona per qualsiasi altro file da aggiungere all’app.

Importante

Quando possibile, non modificare i file direttamente nell'app per le funzioni in Azure. È consigliabile scaricare i file dell'app in locale, usando Core Tools per installare estensioni e altri pacchetti, convalidare le modifiche e quindi ripubblicare l'app usando Core Tools o uno degli altri metodi di distribuzione supportati.

L'editor delle Funzioni integrato nel portale di Azure consente di aggiornare il codice della funzione e i file di configurazione direttamente nel portale:

1. Selezionare l'app per le funzioni, quindi in Funzioni selezionare Funzioni.

2. Scegliere la funzione e selezionare Codice + test in Sviluppo.

3. Scegliere il file da modificare e selezionare Salva al termine.

I file nella radice dell'app, come ad esempio function.proj o extensions.csproj, devono essere creati e modificati usando gli Strumenti avanzati (Kudu):

1. Selezionare l'app per le funzioni, espandere Strumenti di sviluppo e quindi selezionare Strumenti avanzati>Vai.

2. Se richiesto, accedere al sito di Gestione controllo del codice sorgente (SCM) con le credenziali di Azure.

3. Dal menù Console di debug, scegliere CMD.

4. Passare a .\site\wwwroot, selezionare il pulsante più (+) nella parte superiore e selezionare Nuovo file.

5. Assegnare un nome al file, ad esempio extensions.csproj, e quindi premere INVIO.

6. Selezionare il pulsante modifica accanto al nuovo file, aggiungere o aggiornare il codice nel file e quindi selezionare Salva.

7. Per un file di progetto come extensions.csproj, eseguire il comando seguente per ricompilare il progetto delle estensioni:

   dotnet build extensions.csproj
   

Funzionalità della piattaforma

Le app per le funzioni vengono eseguite nella piattaforma del servizio app di Azure, che le gestisce. Di conseguenza, le app per le funzioni hanno accesso alla maggior parte delle funzionalità di piattaforma di hosting Web di base di Azure. Quando si usa il portale di Azure, il riquadro sinistro consente di accedere alle numerose funzionalità della piattaforma del servizio app che è possibile usare nelle app per le funzioni.

La matrice seguente indica il supporto delle funzionalità del portale di Azure tramite piano di hosting e sistema operativo:

Funzionalità	Piano a consumo	Piano A consumo Flex	Piano Premium	Piano Dedicato
Strumenti avanzati (Kudu)	Windows: ✔ Linux: X	X	✔	✔
Editor del servizio app	Windows: ✔ Linux: X	X	Windows: ✔ Linux: X	Windows: ✔ Linux: X
Backup	X	X	X	✔
Console	Riga di comando di Windows Linux: X	X	Riga di comando di Windows Linux; SSH	Riga di comando di Windows Linux; SSH

Il resto di questo articolo è incentrato sulle seguenti funzionalità nel portale, utili per le app per le funzioni:

• Editor del servizio app
• Console
• Strumenti avanzati (Kudu)
• Opzioni di distribuzione
• CORS
• Autenticazione

Per altre informazioni su come usare le impostazioni del servizio app, vedere Configurare le impostazioni di del servizio app di Azure.

Editor del servizio app

L'editor del servizio app è un editor avanzato, disponibile nel portale, che si può usare per modificare i file di configurazione JSON e i file del codice nello stesso modo. Quando si sceglie questa opzione, viene aperta una scheda separata del browser con un editor di base. Questo editor consente di realizzare l'integrazione con l'archivio Git, eseguire il codice e il relativo debug e modificare le impostazioni dell'app per le funzioni. Questo editor offre un ambiente di sviluppo migliorato per le funzioni, confrontato con l’editor di funzione predefinito.

Si consiglia di sviluppare le funzioni nel computer locale. Quando si sviluppa in locale e si pubblica in Azure, i file di progetto sono di sola lettura nel portale di Azure. Per altre informazioni, vedere Scrivere codice per Funzioni di Azure e testarle in locale.

Console

La console nel portale è uno strumento ideale per gli sviluppatori quando si desidera interagire con l'app per le funzioni dalla riga di comando. I comandi comuni includono la creazione e lo spostamento di file e directory, nonché l'esecuzione di script e file batch.

Quando si sviluppa in locale, è consigliabile usare Azure Functions Core Tools e l'interfaccia della riga di comando di Azure.

Strumenti avanzati (Kudu)

Gli strumenti avanzati per il servizio app, noto anche come Kudu, consentono l'accesso alle funzionalità amministrative avanzate dell'app per le funzioni. Dalla Kudu è possibile gestire informazioni di sistema, impostazioni dell'app, variabili di ambiente, estensioni del sito, intestazioni HTTP e variabili del server. È anche possibile avviare Kudu dall'endpoint SCM per l'app per le funzioni, ad esempio: https://<myfunctionapp>.scm.azurewebsites.net/.

Centro distribuzione

Quando si usa una soluzione di controllo del codice sorgente per sviluppare e gestire il codice delle funzioni, Il Centro distribuzione consente di compilare e implementare dal controllo del codice sorgente. Il progetto viene compilato e distribuito in Azure quando si apportano aggiornamenti. Per altre informazioni, vedere Tecnologie di distribuzione in Funzioni di Azure.

Condivisione di risorse tra le origini

Per impedire l'esecuzione di codice dannoso nel client, i browser moderni bloccano le richieste da applicazioni Web alle risorse in esecuzione in un dominio separato. La condivisione di risorse di diversa origine (CORS) consente a un'intestazione Access-Control-Allow-Origin di dichiarare quali origini sono autorizzate a chiamare gli endpoint nell'app per le funzioni.

Azure portal

Quando si configura l'elenco delle Origini consentite per l'app per le funzioni, l'intestazione Access-Control-Allow-Origin viene aggiunta automaticamente a tutte le risposte dagli endpoint HTTP nell'app per le funzioni.

Se è presente un'altra voce di dominio, il carattere jolly (*) viene ignorato.

Interfaccia della riga di comando di Azure

Usare il az functionapp cors add comando per aggiungere un dominio all'elenco delle origini consentite. Nell'esempio seguente viene aggiunto il dominio contoso.com:

az functionapp cors add --name <FUNCTION_APP_NAME> \
--resource-group <RESOURCE_GROUP_NAME> \
--allowed-origins https://contoso.com

Usare il az functionapp cors show comando per elencare le attuali origini consentite.

Azure PowerShell

Non è attualmente possibile aggiornare le impostazioni CORS usando Azure PowerShell.

Autenticazione

Quando le funzioni usano un trigger HTTP, è possibile richiedere innanzitutto l'autenticazione delle chiamate. Il servizio app supporta l'autenticazione e l'accesso di Microsoft Entra tramite provider di social networking, ad esempio Facebook, Microsoft e X. Per informazioni sulla configurazione di provider di autenticazione specifici, vedere panoramica dell'autenticazione del servizio app di Azure.

Contenuto correlato

• Configurare un'app del servizio app
• Distribuzione continua per Funzioni di Azure