Eseguire funzioni da un file pacchetto in Azure

Articolo
07/02/2024

In Azure, è possibile eseguire le funzioni direttamente da un file di pacchetto di distribuzione nell'app per le funzioni. L'altra opzione consiste nel distribuire i file nella directory c:\home\site\wwwroot (Windows) o /home/site/wwwroot (Linux) dell'app per le funzioni.

Questo articolo descrive i vantaggi dell'esecuzione delle funzioni da un pacchetto. Viene inoltre illustrato come abilitare questa funzionalità nell'app per le funzioni.

Vantaggi dell'esecuzione da un file di pacchetto

Esistono diversi vantaggi nell'esecuzione da un file di pacchetto:

Riduce il rischio di problemi di blocco di copia dei file.
Possono essere distribuiti in un'app di produzione (con il riavvio).
È possibile sapere con sicurezza quali file sono in esecuzione nell'app.
Migliora le prestazioni delle distribuzioni Azure Resource Manager.
Si possono ridurre i tempi di avvio a freddo, in particolare per le funzioni di JavaScript con grandi alberi del pacchetto npm.

Per altre informazioni, vedere questo annuncio.

Abilitare le funzioni perché possano essere eseguite da un pacchetto

Per abilitare l'esecuzione dell'app per le funzioni da un pacchetto, aggiungere un'impostazione WEBSITE_RUN_FROM_PACKAGE alle impostazioni dell'app per le funzioni. L'impostazione WEBSITE_RUN_FROM_PACKAGE deve avere almeno uno dei valori seguenti:

Valore	Descrizione
`1`	Essa indica che l'app per le funzioni viene eseguita da un file di pacchetto locale distribuito nella cartella `c:\home\data\SitePackages` (Windows) o `/home/data/SitePackages` (Linux) dell'app per le funzioni.
`<URL>`	Imposta un URL che rappresenta il percorso remoto del file pacchetto specifico da eseguire. Obbligatorio per app per le funzioni in esecuzione in Linux in un piano a consumo.

La tabella seguente indica le opzioni consigliate WEBSITE_RUN_FROM_PACKAGE per la distribuzione in un sistema operativo e in un piano di hosting specifici:

Piano di hosting	Windows	Linux
Consumo	`1` è altamente consigliato.	È supportato solo `<URL>`.
Premium	È consigliato`1` .	È consigliato`1` .
Dedicato	È consigliato`1` .	È consigliato`1` .

Considerazioni generali

Il file del pacchetto deve essere di formato .zip. I formati tar e gzip non sono attualmente supportati.
La distribuzione zip è consigliabile.
Quando si distribuisce l'app per le funzioni in Windows, è necessario impostare WEBSITE_RUN_FROM_PACKAGE su 1 e pubblicare con distribuzione zip.
Quando si esegue da un pacchetto, la cartella wwwroot diventa di sola lettura e viene visualizzato un errore durante la scrittura di file in questa directory. Anche i file sono di sola lettura nel portale di Azure.
La dimensione massima per un file del pacchetto di distribuzione è attualmente di 1 GB.
Non è possibile usare la cache locale durante l'esecuzione da un pacchetto di distribuzione.
Se il progetto necessita di usare la compilazione remota, non usare l'impostazione dell'app WEBSITE_RUN_FROM_PACKAGE. Aggiungere invece l'impostazione dell'app SCM_DO_BUILD_DURING_DEPLOYMENT=true di personalizzazione della distribuzione. Per Linux, aggiungere anche l'impostazione ENABLE_ORYX_BUILD=true. Per altre informazioni, vedere Compilazione remota.

Nota

WEBSITE_RUN_FROM_PACKAGE non funziona con MSDeploy, come descritto qui. Si riceverà un errore durante la distribuzione, ad esempio ARM-MSDeploy Deploy Failed. Modificare /MSDeploy a /ZipDeploy e questo errore sarà risolto.

Aggiungere l'impostazione WEBSITE_RUN_FROM_PACKAGE

Esistono diversi modi per aggiungere, aggiornare ed eliminare le impostazioni dell'app per le funzioni:

Le modifiche apportate alle impostazioni dell'app per le funzioni richiedono il riavvio dell'app per le funzioni.

Usare WEBSITE_RUN_FROM_PACKAGE = 1

Questa sezione fornisce informazioni su come eseguire l'app per le funzioni da un file pacchetto in loco.

Considerazioni sulla distribuzione da un pacchetto in loco

L'uso di un pacchetto in loco è l'opzione consigliata per l'esecuzione da pacchetto di distribuzione (ad eccezione di Linux ospitato in un piano a consumo).
La distribuzione zip è il metodo consigliato per caricare un pacchetto di distribuzione sul sito.
Quando non si usa la distribuzione zip, assicurarsi che la cartella c:\home\data\SitePackages (Windows) o /home/data/SitePackages (Linux) contenga un file denominato packagename.txt. Questo file contiene solo il nome, senza spazi vuoti, del file del pacchetto in questa cartella attualmente in esecuzione.

Integrazione con distribuzione di file ZIP

Distribuzione di file ZIP è una funzione del Servizio app di Azure che consente di distribuire il progetto dell'app per le funzioni nella directory wwwroot. Il progetto viene impacchettato come un file di distribuzione di file ZIP. Le stesse API possono essere usate per distribuire il pacchetto nella cartella c:\home\data\SitePackages (Windows) o /home/data/SitePackages (Linux).

Con il valore WEBSITE_RUN_FROM_PACKAGE dell'impostazione dell'app 1, le API di distribuzione di file ZIP copiano il pacchetto nella cartella c:\home\data\SitePackages (Windows) o /home/data/SitePackages (Linux) invece di estrarre i file in c:\home\site\wwwroot (Windows) o /home/site/wwwroot (Linux). Questa operazione crea anche il file packagename.txt. Dopo un riavvio, il pacchetto viene installato in wwwroot come file system di sola lettura. Per altre informazioni sulla distribuzione di file ZIP, vedere Distribuzione di file ZIP nelle Funzioni di Azure.

Nota

Quando si verifica una distribuzione, viene attivato un riavvio dell'app per le funzioni. Le esecuzioni di funzioni attualmente in esecuzione durante la distribuzione vengono terminate. Vedere Migliorare le prestazioni e l'affidabilità di Funzioni di Azure per informazioni su come scrivere funzioni senza stato e difensive.

Usare WEBSITE_RUN_FROM_PACKAGE = URL

Questa sezione fornisce informazioni su come eseguire l'app per le funzioni da un pacchetto distribuito in un endpoint URL. Questa opzione è l'unica supportata per l'esecuzione da un pacchetto in Linux ospitato in un piano a consumo.

Considerazioni sulla distribuzione da un URL

Le app per le funzioni in esecuzione in Windows riscontrano un lieve aumento del tempo di avvio a freddo quando il pacchetto dell'applicazione viene distribuito a un endpoint URL tramite WEBSITE_RUN_FROM_PACKAGE = <URL>.
Quando si specifica un URL, è anche necessario sincronizzare manualmente i trigger dopo la pubblicazione di un pacchetto aggiornato.
Il runtime di Funzioni deve disporre delle autorizzazioni per accedere all'URL del pacchetto.
Non distribuire il pacchetto in Archiviazione BLOB di Azure come BLOB pubblico. Usare invece un contenitore privato con una firma di accesso condiviso o usare un'identità gestita per consentire al runtime di Funzioni di accedere al pacchetto.
È necessario conservare tutti gli URL di firma di accesso condiviso usati per la distribuzione. Quando una firma di accesso condiviso scade, il pacchetto non può più essere distribuito. In questo caso, è necessario generare una nuova firma di accesso condiviso e aggiornare l'impostazione nell'app per le funzioni. È possibile ovviare a quest’onere di gestione usando un'identità gestita.
Quando si è in esecuzione in un piano Premium, assicurarsi di eliminare gli avvii a freddo.
Quando si è in esecuzione in un piano dedicato, assicurarsi di aver abilitato Always On.
È possibile usare Azure Storage Explorer per caricare i file di pacchetto in contenitori BLOB nell'account di archiviazione.

Caricamento manuale di un pacchetto nell'archivio BLOB

Per distribuire un pacchetto compresso quando l'opzione URL è in uso, è necessario creare un pacchetto di distribuzione compresso .zip e caricarlo nella destinazione. Questo esempio viene distribuito in un contenitore nell'archiviazione BLOB.

Creare un pacchetto .zip per il progetto usando l'utilità preferita.
Nel portale di Azure, cercare il nome dell'account di archiviazione o cercarlo tra gli account di archiviazione.
Nell'account di archiviazione selezionare Contenitori in Archiviazione dati.
Selezionare + Contenitore per creare un nuovo contenitore di archiviazione BLOB nell'account.
Nella pagina Nuovo contenitore, specificare un nome (ad esempio, "distribuzioni"), assicurarsi che il livello di accesso pubblico sia privato e selezionare Crea.
Selezionare il contenitore creato, quindi selezionare Carica, passare al percorso del file .zip creato con il progetto e selezionare Carica.
Al termine del caricamento, scegliere il file BLOB caricato e copiare l'URL. Potrebbe essere necessario generare un URL di firma di accesso condiviso se non si sta usando un'identità
Cercare l'app per le funzioni o cercarla nella pagina App per le funzioni.
Nell'app per le funzioni, selezionare Configurazioni in Impostazioni.
Nella scheda Impostazioni applicazione selezionare + Nuova impostazione applicazione
Immettere il valore WEBSITE_RUN_FROM_PACKAGE come Nome e incollare l'URL del pacchetto in Archiviazione BLOB come Valore.
Seleziona OK. Quindi, selezionare Salva>Continua per salvare l'impostazione e riavviare l'app.

È ora possibile eseguire la funzione in Azure per verificare che la distribuzione abbia avuto esito positivo usando il file pacchetto di distribuzione .zip.

Di seguito viene illustrata un'app per le funzioni configurata per l'esecuzione da un file con estensione zip ospitato in archiviazione BLOB di Azure:

Impostazione dell'app WEBSITE_RUN_FROM_ZIP

Recuperare un pacchetto da Archiviazione BLOB di Azure usando un'identità gestita

Archiviazione BLOB di Azure può essere configurata per autorizzare le richieste con Microsoft Entra ID. Ciò significa che invece di generare una chiave di firma di accesso condiviso con una scadenza, è possibile basarsi sull'identità gestita dell'applicazione. Per impostazione predefinita, verrà usata l'identità assegnata dal sistema dell'app. Se si vuole specificare un'identità assegnata dall'utente, è possibile impostare l'impostazione dell'app WEBSITE_RUN_FROM_PACKAGE_BLOB_MI_RESOURCE_ID sull'ID risorsa di tale identità. L'impostazione può anche accettare "SystemAssigned" come valore, anche se ciò equivale a omettere completamente l'impostazione.

Per abilitare il recupero del pacchetto tramite l'identità:

Assicurarsi che il BLOB sia configurato per l'accesso privato.
Concedere all'identità il ruolo Lettore di dati BLOB di archiviazione con ambito che includa il BLOB del pacchetto. Per informazioni dettagliate sulla creazione dell'assegnazione di ruolo, vedere Assegnare un ruolo di Azure per l'accesso ai dati BLOB.
Impostare l'impostazione dell'applicazione WEBSITE_RUN_FROM_PACKAGE sull'URL BLOB del pacchetto. Probabilmente, esso avrà il formato "https://{storage-account-name}.blob.core.windows.net/{container-name}/{path-to-package}" o simile.

Passaggi successivi

Distribuzione continua per Funzioni di Azure

Condividi tramite