Creare e gestire app per le funzioni nel piano A consumo Flex

1. Se non è già stato fatto, accedere ad Azure:

   az login
   

   Il comando az login consente di accedere all'account Azure.

2. Usare il comando az functionapp list-flexconsumption-locations per esaminare l'elenco delle aree che attualmente supportano A consumo Flex.

   az functionapp list-flexconsumption-locations --output table
   

3. Creare un gruppo di risorse in una delle aree attualmente supportate:

   az group create --name <RESOURCE_GROUP> --location <REGION>
   

   Nel comando precedente sostituire <RESOURCE_GROUP> con un valore univoco nella sottoscrizione e <REGION> con una delle aree attualmente supportate. Il comando az group create crea un gruppo di risorse.

4. Creare un account di archiviazione per utilizzo generico nel gruppo di risorse e nell'area:

   az storage account create --name <STORAGE_NAME> --location <REGION> --resource-group <RESOURCE_GROUP> --sku Standard_LRS --allow-blob-public-access false
   

   Nell'esempio precedente sostituire <STORAGE_NAME> con un nome appropriato e univoco in Archiviazione di Azure. I nomi devono contenere da tre a 24 caratteri costituiti esclusivamente da numeri e lettere in minuscolo. Standard_LRS specifica un account per utilizzo generico, che è supportato da Funzioni. Il comando az storage account create crea l'account di archiviazione.

   Importante

   L'account di archiviazione viene usato per archiviare dati importanti dell'app, a volte incluso il codice dell'applicazione stesso. È consigliabile limitare l'accesso da altre app e utenti all'account di archiviazione.

5. Creare l'app per le funzioni in Azure:

   az functionapp create --resource-group <RESOURCE_GROUP> --name <APP_NAME> --storage-account <STORAGE_NAME> --flexconsumption-location <REGION> --runtime dotnet-isolated --runtime-version 8.0 
   

   Le app C# in esecuzione in-process non sono attualmente supportate durante l'esecuzione in un piano A consumo Flex.

   az functionapp create --resource-group <RESOURCE_GROUP> --name <APP_NAME> --storage-account <STORAGE_NAME> --flexconsumption-location <REGION> --runtime java --runtime-version 17 
   

   Per le app Java, è attualmente supportato anche Java 11.

   az functionapp create --resource-group <RESOURCE_GROUP> --name <APP_NAME> --storage-account <STORAGE_NAME> --flexconsumption-location <REGION> --runtime node --runtime-version 20 
   

   az functionapp create --resource-group <RESOURCE_GROUP> --name <APP_NAME> --storage-account <STORAGE_NAME> --flexconsumption-location <REGION> --runtime python --runtime-version 3.11 
   

   Per le app Python, è attualmente supportato anche Python 3.10.

   az functionapp create --resource-group <RESOURCE_GROUP> --name <APP_NAME> --storage-account <STORAGE_NAME> --flexconsumption-location <REGION> --runtime powershell --runtime-version 7.4 
   

   In questo esempio sostituire sia <RESOURCE_GROUP> che <STORAGE_NAME> con il gruppo di risorse e con il nome dell'account usato rispettivamente nel passaggio precedente. Sostituire anche <APP_NAME> con un nome univoco globale appropriato. <APP_NAME> è anche il dominio DNS (Domain Name Server) predefinito per l'app per le funzioni. Il comando az functionapp create crea l'app per le funzioni in Azure.

   Questo comando crea un'app per le funzioni in esecuzione nel piano A consumo Flex. La versione specifica del runtime del linguaggio usata è quella attualmente supportata nell'anteprima.

   Poiché l'app è stata creata senza specificare istanze sempre pronte, l'app comporta solo costi durante l'esecuzione attiva delle funzioni. Il comando crea anche un'istanza di Azure Application Insights associata nello stesso gruppo di risorse, con cui è possibile monitorare l'app per le funzioni e visualizzare i log. Per altre informazioni, vedere Monitorare Funzioni di Azure.

1. Nel portale di Azure dal menu o dalla pagina home selezionare Crea una risorsa.

2. Selezionare Attività iniziali e quindi Crea in App per le funzioni.

3. In Selezionare un'opzione di hosting, scegliere A consumo Flex>Seleziona.

4. 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	Il nome del nuovo gruppo di risorse in cui viene creata l'app per le funzioni.
   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-9 e -.
   Area	Area preferita	Selezionare un'area vicina a sé o vicina ad altri servizi a cui le funzioni possono accedere. Le aree non supportate non vengono visualizzate. Per altre informazioni, vedere Visualizzare le aree attualmente supportate.
   Stack di runtime	Lingua preferita	Scegliere uno degli stack di runtime del linguaggio supportati. La modifica nel portale con Visual Studio Code per il Web è attualmente disponibile solo per le app Node.js, PowerShell e Python. La libreria di classi C# e le funzioni Java devono essere sviluppate localmente.
   Versione	Versione del linguaggio	Scegliere una versione supportata dello stack di runtime del linguaggio.
   Dimensioni dell'istanza	Default	Determina la quantità di memoria dell'istanza allocata per ogni istanza dell'app. Per altre informazioni, vedere memoria dell'istanza.

5. Accettare le opzioni predefinite nelle schede rimanenti, incluso il comportamento predefinito della 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.

6. 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.

7. Selezionare l'icona Notifiche nell'angolo superiore destro del portale e attendere che venga visualizzato il messaggio La distribuzione è riuscita.

8. 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.

1. Premere F1 e nel pallet dei comandi immettere Funzioni di Azure: Creare un'app per le funzioni in Azure... (Avanzate).

2. Se non è stato effettuato l'accesso, viene richiesto di accedere ad Azure. È anche possibile creare un account di Azure gratuito. Dopo l'accesso dal browser, tornare a Visual Studio Code.

3. Seguendo le istruzioni, specificare queste informazioni:

   Richiesta	Selezione
   Immettere un nome univoco a livello globale per la nuova app per le funzioni.	Digitare un nome univoco globale che identifichi la nuova app per le funzioni e quindi selezionare INVIO. I caratteri validi per un nome di app per le funzioni sono a-z, 0-9 e -.
   Selezionare un piano di hosting.	Scegliere A consumo Flex (Anteprima).
   Selezionare uno stack di runtime.	Scegliere una delle versioni dello stack di linguaggio supportate.
   Selezionare un gruppo di risorse per le nuove risorse.	Scegliere Crea nuovo gruppo di risorse e digitare un nome del gruppo di risorse, ad esempio myResourceGroup, e quindi selezionare INVIO. È anche possibile selezionare un gruppo di risorse esistente.
   Select a location for new resources.	Selezionare una località in un'area supportata nelle vicinanze o nelle vicinanze di altri servizi a cui accedono le funzioni. Le aree non supportate non vengono visualizzate. Per altre informazioni, vedere Visualizzare le aree attualmente supportate.
   Selezionare un account di archiviazione.	Scegliere Crea nuovo account di archiviazione e al prompt specificare un nome univoco globale per il nuovo account di archiviazione usato dall'app per le funzioni e quindi selezionare Invio. I nomi degli account di archiviazione devono avere una lunghezza compresa tra 3 e 24 caratteri e possono contenere solo numeri e lettere minuscole. È anche possibile selezionare un account esistente.
   Selezionare una risorsa di Application Insights per l'app.	Scegliere Crea nuova risorsa di Application Insights e al prompt specificare il nome dell'istanza usata per archiviare i dati di runtime dalle funzioni.

   Una notifica viene visualizzata dopo la creazione dell'app per le funzioni. Selezionare Visualizza output nelle notifiche per visualizzare i risultati della creazione e della distribuzione, incluse le risorse di Azure create.

1. Nel riquadro comandi immettere quindi selezionare Funzioni di Azure: distribuisci nell'app per le funzioni.

2. Selezionare l'app per le funzioni appena creata. Quando viene richiesto di sovrascrivere le distribuzioni precedenti, selezionare Distribuisci per distribuire il codice della funzione nella nuova risorsa dell'app per le funzioni.

3. Al termine della distribuzione, selezionare Visualizza output per visualizzare i risultati della creazione e della distribuzione, incluse le risorse di Azure create. Se non si riesce a visualizzare la notifica, selezionare l'icona della campana nell'angolo in basso a destra per visualizzarla di nuovo.

   

Nella cartella del progetto radice eseguire questo comando func azure functionapp publish:

func azure functionapp publish <APP_NAME>

In questo esempio sostituire <APP_NAME> con il nome dell'app. Una distribuzione riuscita mostra risultati simili all'output seguente (troncato per semplicità):

...

Getting site publishing info...
Creating archive for current directory...
Performing remote build for functions project.

...

Deployment successful.
Remote build succeeded!
Syncing triggers...
Functions in msdocs-azurefunctions-qs:
    HttpExample - [httpTrigger]
        Invoke url: https://msdocs-azurefunctions-qs.azurewebsites.net/api/httpexample

È possibile abilitare l'integrazione della rete virtuale eseguendo il comando az functionapp create e includendo i parametri --vnet e --subnet.

1. Creare la rete virtuale e la subnet, se non è già stato fatto.

2. Completare i passaggi da 1 a 4 in Creare un'app A consumo Flex per creare le risorse necessarie per l'app.

3. Eseguire il comando az functionapp create, inclusi i parametri --vnet e --subnet, come nell'esempio seguente:

   az functionapp create --resource-group <RESOURCE_GROUP> --name <APP_NAME> --storage-account <STORAGE_NAME> --flexconsumption-location <REGION> --runtime <RUNTIME_NAME> --runtime-version <RUNTIME_VERSION> --vnet <VNET_RESOURCE_ID> --subnet <SUBNET_NAME>
   

   Il valore <VNET_RESOURCE_ID> è l'ID risorsa per la rete virtuale, che è nel formato: /subscriptions/<SUBSCRIPTION_ID>/resourceGroups/<RESOURCER_GROUP>/providers/Microsoft.Network/virtualNetworks/<VNET_NAME>. È possibile usare questo comando per ottenere un elenco di ID di rete virtuale, filtrati in base a <RESOURCE_GROUP>: az network vnet list --resource-group <RESOURCE_GROUP> --output tsv --query "[]".id.

Usare questi passaggi per creare l'app per le funzioni con l'integrazione della rete virtuale e le risorse di Azure correlate.

1. Nel portale di Azure dal menu o dalla pagina home selezionare Crea una risorsa.

2. Selezionare Attività iniziali e quindi Crea in App per le funzioni.

3. In Selezionare un'opzione di hosting, scegliere A consumo Flex>Seleziona.

4. 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	Il nome del nuovo gruppo di risorse in cui viene creata l'app per le funzioni.
   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-9 e -.
   Area	Area preferita	Selezionare un'area vicina a sé o vicina ad altri servizi a cui le funzioni possono accedere. Le aree non supportate non vengono visualizzate. Per altre informazioni, vedere Visualizzare le aree attualmente supportate.
   Stack di runtime	Lingua preferita	Scegliere uno degli stack di runtime del linguaggio supportati. La modifica nel portale con Visual Studio Code per il Web è attualmente disponibile solo per le app Node.js, PowerShell e Python. La libreria di classi C# e le funzioni Java devono essere sviluppate localmente.
   Versione	Versione del linguaggio	Scegliere una versione supportata dello stack di runtime del linguaggio.
   Dimensioni dell'istanza	Default	Determina la quantità di memoria dell'istanza allocata per ogni istanza dell'app. Per altre informazioni, vedere memoria dell'istanza.

5. Accettare le opzioni predefinite nelle schede rimanenti, incluso il comportamento predefinito della 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.

6. Nella scheda Rete impostare Abilita l'accesso pubblico su Disattivato e Abilita inserimento rete su Sì.

7. Per Rete virtuale selezionare o creare una rete virtuale che si trova nella stessa area dell'app.

8. Impostare Abilita integrazione rete virtuale su Sì e selezionare o creare una subnet.

9. 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 con rete virtuale.

10. Selezionare l'icona Notifiche nell'angolo superiore destro del portale e attendere che venga visualizzato il messaggio La distribuzione è riuscita.

11. 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.

Non è attualmente possibile abilitare la rete virtuale quando si usa Visual Studio Code per creare l'app.

Usare il comando az functionapp vnet-integration add per abilitare l'integrazione della rete virtuale in un'app per le funzioni esistente:

az functionapp vnet-integration add --resource-group <RESOURCE_GROUP> --name <APP_NAME> --vnet <VNET_RESOURCE_ID> --subnet <SUBNET_NAME>

Usare il comando az functionapp vnet-integration remove per disabilitare l'integrazione della rete virtuale nell'app:

az functionapp vnet-integration remove --resource-group <RESOURCE_GROUP> --name <APP_NAME>

Usare il comando az functionapp vnet-integration list per elencare le integrazioni di rete virtuale correnti per l'app:

az functionapp vnet-integration list --resource-group <RESOURCE_GROUP> --name <APP_NAME>

È possibile integrare l'app esistente con una rete virtuale e una subnet esistenti nel portale.

1. Nella pagina dell'app per le funzioni nel portale di Azure, espandere Impostazioni nel menu a sinistra e selezionare Rete.

2. In Configurazione del traffico in uscita, selezionare Non configurato.

3. Nella pagina Integrazione rete virtuale selezionare Aggiungi integrazione rete virtuale.

4. Selezionare una rete virtuale esistente e una subnet e selezionare Connetti.

Non è attualmente possibile configurare la rete virtuale in Visual Studio Code.

Usare il comando az functionapp create e specificare queste opzioni aggiuntive per personalizzare l'archiviazione della distribuzione:

Questo esempio crea un'app per le funzioni nel piano A consumo flessibile con un account di archiviazione di distribuzione separato e l'identità assegnata dall'utente:

az functionapp create --resource-group <RESOURCE_GROUP> --name <APP_NAME> --storage <STORAGE_NAME> --runtime dotnet-isolated --runtime-version 8.0 --flexconsumption-location "<REGION>" --deployment-storage-name <DEPLOYMENT_ACCCOUNT_NAME> --deployment-storage-container-name <DEPLOYMENT_CONTAINER_NAME> --deployment-storage-auth-type UserAssignedIdentity --deployment-storage-auth-value <MI_RESOURCE_ID>

Non è attualmente possibile configurare l'archiviazione di distribuzione durante la creazione dell'app nel portale di Azure. Per configurare l'archiviazione della distribuzione durante la creazione dell'app, usare invece l'interfaccia della riga di comando di Azure per creare l'app.

È possibile usare il portale per modificare le impostazioni di distribuzione di un'app esistente, come descritto nella sezione successiva.

Non è attualmente possibile configurare l'archiviazione di distribuzione durante la creazione dell'app in Azure con Visual Studio Code.

Usare il comando az functionapp deployment config set per modificare la configurazione dell'archiviazione di distribuzione:

az functionapp deployment config set --resource-group <RESOURCE_GROUP> --name <APP_NAME> --deployment-storage-name <DEPLOYMENT_ACCCOUNT_NAME> --deployment-storage-container-name <DEPLOYMENT_CONTAINER_NAME>

1. Nella pagina dell'app per le funzioni nel portale di Azure espandere Impostazioni nel menu a sinistra e selezionare Impostazioni di distribuzione.

2. In Percorso pacchetto applicazione selezionare un account di archiviazione esistente, quindi selezionare un contenitore vuoto esistente nell'account.

3. In Autenticazione archiviazione selezionare il tipo di autenticazione preferito

   • Se si ha selezionato Stringa di connessione, selezionare il nome dell'impostazione dell'app contenente la stringa di connessione per l'account di archiviazione di distribuzione.

   • Se si ha selezionato Identità assegnata dall'utente, selezionare l'identità da usare.

4. Selezionare Salva per aggiornare l'app.

Non è attualmente possibile configurare l'archiviazione di distribuzione per l'app in Azure usando Visual Studio Code.

Specificare il parametro --instance-memory nel comando az functionapp create. Questo esempio crea un'app C# con dimensioni dell'istanza di 4096:

az functionapp create --instance-memory 4096 --resource-group <RESOURCE_GROUP> --name <APP_NAME> --storage-account <STORAGE_NAME> --flexconsumption-location <REGION> --runtime dotnet-isolated --runtime-version 8.0

Quando si crea l'app in un piano A consumo Flex nel portale di Azure, è possibile scegliere le dimensioni della memoria dell'istanza nel campo Dimensioni istanza nella scheda Informazioni di base. Per altre informazioni, vedere Creare un'app A consumo Flex.

Non è attualmente possibile controllare le dimensioni della memoria dell'istanza quando si usa Visual Studio Code per creare l'app. Viene utilizzata la dimensione predefinita.

In questo esempio viene usato il comando az functionapp scale config set per modificare l'impostazione delle dimensioni della memoria dell'istanza su 4,096 MB:

az functionapp scale config set --resource-group <resourceGroup> --name <APP_NAME> --instance-memory 4096

1. Nella pagina dell'app per le funzioni nel portale di Azure espandere Impostazioni nel menu a sinistra e selezionare Scalabilità e concorrenza.

2. Selezionare un'opzione Memoria istanza e selezionare Salva per aggiornare l'app.

Non è attualmente possibile modificare l'impostazione delle dimensioni della memoria dell'istanza per l'app usando Visual Studio Code.

Usare il parametro --always-ready-instances con il comando az functionapp create per definire una o più designazioni di istanza sempre pronte. In questo esempio viene impostato il numero di istanze sempre pronte per tutte le funzioni attivate da HTTP su 5:

az functionapp create --resource-group <RESOURCE_GROUP> --name <APP_NAME> --storage <STORAGE_NAME> --runtime <LANGUAGE_RUNTIME> --runtime-version <RUNTIME_VERSION> --flexconsumption-location <REGION> --always-ready-instances http=10

Questo esempio imposta il numero di istanze sempre pronte per tutte le funzioni trigger Durable su 3 e imposta il numero di istanze sempre pronte su 2 per una funzione attivata dal bus di servizio denominata function5:

az functionapp create --resource-group <RESOURCE_GROUP> --name <APP_NAME> --storage <STORAGE_NAME> --runtime <LANGUAGE_RUNTIME> --runtime-version <RUNTIME_VERSION> --flexconsumption-location <REGION> --always-ready-instances durable=3 function:function5=2

Non è attualmente possibile definire istanze sempre pronte durante la creazione dell'app nel portale di Azure. Per definire istanze sempre pronte durante la creazione dell'app, usare invece l'interfaccia della riga di comando di Azure per creare l'app.

È possibile usare il portale per modificare istanze sempre pronte in un'app esistente, come descritto nella sezione successiva.

Non è attualmente possibile definire istanze sempre pronte durante la creazione dell'app in Azure con Visual Studio Code.

In questo esempio viene usato il comando az functionapp scale config always-ready set per modificare il numero di istanze sempre pronte per il gruppo trigger HTTP in 10:

az functionapp scale config always-ready set --resource-group <RESOURCE_GROUP> --name <APP_NAME> --settings http=10

Per rimuovere istanze sempre pronte, usare il comando az functionapp scale config always-ready delete, come in questo esempio che rimuove tutte le istanze sempre pronte dal gruppo trigger HTTP e anche da una funzione denominata hello_world:

az functionapp scale config always-ready delete --resource-group <RESOURCE_GROUP> --name <APP_NAME> --setting-names http function:hello_world

1. Nella pagina dell'app per le funzioni nel portale di Azure espandere Impostazioni nel menu a sinistra e selezionare Scalabilità e concorrenza.

2. In Numero minimo di istanze Always-ready digitare http, blob, durable o un nome di funzione specifico usando il formato function:<FUNCTION_NAME>=n in Trigger e digitare il Numero di istanze Always-ready.

3. Selezionare Salva per aggiornare l'app.

Attualmente non è possibile modificare istanze sempre pronte usando Visual Studio Code.

Usare il comando az functionapp scale config set per impostare limiti di concorrenza HTTP specifici per l'app, indipendentemente dalle dimensioni dell'istanza.

az functionapp scale config set --resource-group <RESOURCE_GROUP> --name <APP_NAME> --trigger-type http --trigger-settings perInstanceConcurrency=10

In questo esempio viene impostato il livello di concorrenza del trigger HTTP su 10. Dopo aver impostato in modo specifico un valore di concorrenza HTTP, tale valore viene mantenuto nonostante le modifiche apportate all'impostazione delle dimensioni dell'istanza dell'app.

1. Nella pagina dell'app per le funzioni nel portale di Azure espandere Impostazioni nel menu a sinistra e selezionare Scalabilità e concorrenza.

2. In Concorrenza per istanza selezionare Assegna manualmente e digitare un limite specifico.

3. Selezionare Salva per aggiornare l'app.

Non è attualmente possibile impostare limiti di concorrenza HTTP usando Visual Studio Code.