Distribuzione continua per Funzioni di Azure

Funzioni di Azure consente di distribuire continuamente le modifiche apportate in un repository di controllo del codice sorgente a un'app per le funzioni connessa. Questa integrazione del controllo del codice sorgente consente un flusso di lavoro in cui un aggiornamento del codice attiva la compilazione, la creazione di pacchetti e la distribuzione dal progetto ad Azure.

È consigliabile configurare sempre la distribuzione continua per uno slot di staging e non per lo slot di produzione. Quando si usa lo slot di produzione, gli aggiornamenti del codice vengono inseriti direttamente nell'ambiente di produzione senza essere verificati in Azure. Abilitare invece la distribuzione continua in uno slot di staging, verificare gli aggiornamenti nello slot di staging e dopo che tutto viene eseguito correttamente, è possibile scambiare il codice dello slot di staging nell'ambiente di produzione. Se ci si connette a uno slot di produzione, assicurarsi che solo il codice di qualità di produzione lo renda nel ramo di codice integrato.

I passaggi descritti in questo articolo illustrano come configurare distribuzioni di codice continuo per l'app per le funzioni in Azure usando il Centro distribuzione nel portale di Azure. È anche possibile configurare l'integrazione continua usando l'interfaccia della riga di comando di Azure. Questi passaggi possono essere destinati a uno slot di staging o di produzione.

Funzioni supporta queste origini per la distribuzione continua nell'app:

Azure Repos

Gestire il codice del progetto in Azure Repos, uno dei servizi in Azure DevOps. Supporta sia Git che controllo della versione di Team Foundation. Usato con il provider di compilazione di Azure Pipelines. Per altre informazioni, vedere Che cos'è Azure Repos?

GitHub

Gestire il codice del progetto in GitHub. Supportato da tutti i provider di compilazione. Per altre informazioni, vedere la documentazione di GitHub.

GitHub è l'unica origine di distribuzione continua supportata per le app in esecuzione in Linux in un piano a consumo, che include app Python serverless.

Bitbucket

Gestire il codice del progetto in Bitbucket. Richiede il provider di compilazione servizio app.

GIT locale

Gestire il codice del progetto in un server Git dedicato ospitato nello stesso piano di servizio app con l'app per le funzioni. Richiede il provider di compilazione servizio app. Per altre informazioni, vedere Distribuzione Git locale nel servizio app Azure.

È anche possibile connettere l'app per le funzioni a un repository Git esterno, ma richiede una sincronizzazione manuale. Per altre informazioni sulle opzioni di distribuzione, vedere Tecnologie di distribuzione in Funzioni di Azure.

Nota

Le opzioni di distribuzione continua descritte in questo articolo sono specifiche per le distribuzioni di solo codice. Per le distribuzioni di app per le funzioni in contenitori, vedere Abilitare la distribuzione continua di contenitori in Azure.

Requisiti

L'unità di distribuzione per le funzioni in Azure è l'app per le funzioni. Affinché la distribuzione continua abbia esito positivo, la struttura di directory del progetto deve essere compatibile con la struttura di cartelle di base prevista Funzioni di Azure. Quando si crea il progetto di codice usando Funzioni di Azure Core Tools, Visual Studio Code o Visual Studio, i modelli di Funzioni di Azure vengono usati per creare progetti di codice con la struttura di directory corretta. Tutte le funzioni in un'app per le funzioni vengono distribuite contemporaneamente e nello stesso pacchetto.

Dopo aver abilitato la distribuzione continua, l'accesso al codice della funzione nel portale di Azure è configurato come di sola lettura perché l'origine della verità è nota per risiedere altrove.

Nota

Il Centro distribuzione non supporta l'abilitazione della distribuzione continua per un'app per le funzioni con restrizioni di rete in ingresso. È invece necessario configurare il flusso di lavoro del provider di compilazione direttamente in GitHub o Azure Pipelines. Questi flussi di lavoro richiedono anche di usare una macchina virtuale nella stessa rete virtuale dell'app per le funzioni come agente self-hosted (Pipelines) o uno strumento di esecuzione self-hosted (GitHub).

Selezionare un provider di compilazione

La compilazione del progetto di codice fa parte del processo di distribuzione. Il processo di compilazione specifico dipende dallo stack di linguaggio, dal sistema operativo e dal piano di hosting specifico. Le compilazioni possono essere eseguite in locale o in remoto, a seconda dell'hosting specifico. Per ulteriori informazioni, vedere Compilazione remota.

Importante

Per una maggiore sicurezza, è consigliabile usare un provider di compilazione che supporta le identità gestite, tra cui Azure Pipelines e Gitub Actions. Il servizio servizio app (Kudu) richiede l'abilitazione dell'authenication di base e l'uso delle credenziali basate su testo.

Funzioni supporta questi provider di compilazione:

Azure Pipelines

Azure Pipelines è uno dei servizi in Azure DevOps e il provider di compilazione predefinito per i progetti Azure Repos. È anche possibile usare Pipeline per compilare progetti da GitHub. In Pipeline è disponibile un'attività AzureFunctionApp progettata in modo specifico per la distribuzione in Funzioni di Azure. Questa attività consente di controllare la modalità di compilazione, creazione di pacchetti e distribuzione del progetto. Supporta le identità gestite.

GitHub Actions

GitHub Actions è il provider di compilazione predefinito per i progetti GitHub. GitHub Actions offre il controllo sulla modalità di compilazione, creazione di pacchetti e distribuzione del progetto. Supporta le identità gestite.

servizio servizio app (Kudu)

La piattaforma servizio app gestisce un servizio di distribuzione nativo (Project Kudu) per supportare la distribuzione Git locale, alcune distribuzioni di contenitori e altre origini di distribuzione non supportate da Pipeline o GitHub Actions. Le compilazioni remote, la creazione di pacchetti e altre attività di manutenzione vengono eseguite in un sottodominio dedicato scm.azurewebsites.net all'app, ad esempio https://myfunctionapp.scm.azurewebsites.net. Questo servizio di compilazione può essere usato solo quando è possibile accedere al scm sito tramite la distribuzione. Sebbene sia possibile usare le identità per connettersi all'endpoint scm , molti strumenti di pubblicazione richiedono invece l'autenticazione di base per connettersi all'endpoint scm .

Questo provider di compilazione viene usato quando si distribuisce il progetto di codice usando Visual Studio, Visual Studio Code o Funzioni di Azure Core Tools. Se il codice non è già stato distribuito nell'app per le funzioni usando uno di questi strumenti, potrebbe essere necessario abilitare l'autenticazione di base per le distribuzioni per l'uso del scm sito.

Tenere presenti i punti di forza e le limitazioni di questi provider quando si abilita l'integrazione del controllo del codice sorgente. Potrebbe essere necessario modificare il tipo di origine del repository per sfruttare i vantaggi di un provider specifico.

Configurare la distribuzione continua

Il portale di Azure fornisce un Centro distribuzione per le app per le funzioni, che semplifica la configurazione della distribuzione continua. Il modo specifico in cui si configura la distribuzione continua dipende sia dal tipo di repository di controllo del codice sorgente in cui risiede il codice che dal provider di compilazione scelto .

Nella portale di Azure passare alla pagina dell'app per le funzioni e selezionare Centro distribuzione in Distribuzione nel riquadro sinistro.

Selezionare il tipo di repository di origine in cui viene mantenuto il codice del progetto da una di queste opzioni supportate:

Azure Repos

Le distribuzioni da Azure Repos che usano Azure Pipelines vengono definite nel portale di Azure DevOps e non dall'app per le funzioni. Per una guida dettagliata alla creazione di una distribuzione basata su pipeline da Azure Repos, vedere Recapito continuo con Azure Pipelines.

GitHub

Le distribuzioni da GitHub che usano Azure Pipelines vengono definite nel portale di Azure DevOps e non dall'app per le funzioni. Per una guida dettagliata alla creazione di una distribuzione basata su Pipeline da GitHub, vedere Recapito continuo con Azure Pipelines.

Bitbucket

Non è possibile eseguire la distribuzione da Bitbucket usando Azure Pipelines. Scegliere invece il provider di compilazione servizio app.

GIT locale

Non è possibile eseguire la distribuzione da Git locale usando Azure Pipelines. Scegliere invece il provider di compilazione servizio app.

Azure Repos

Non è possibile eseguire la distribuzione da Azure Repos usando GitHub Actions. Scegliere un provider di compilazione diverso.

GitHub

Per aggiungere un flusso di lavoro di GitHub Actions a un'app per le funzioni esistente:

1. Passare all'app per le funzioni nel portale di Azure e selezionare Centro distribuzione.

2. Per Origine selezionare GitHub. Se non viene visualizzato il messaggio predefinito Compilazione con GitHub Actions, selezionare Cambia provider scegliere GitHub Actions e selezionare OK.

3. Se l'accesso a GitHub non è già stato autorizzato, selezionare Autorizza. Specificare le credenziali di GitHub e selezionare Accedi. Per autorizzare un account GitHub diverso, selezionare Cambia account e accedere con un altro account.

4. Selezionare l'organizzazione, il repository e il ramo di GitHub. Per eseguire la distribuzione con GitHub Actions, è necessario avere accesso in scrittura a questo repository.

5. In Impostazioni di autenticazione scegliere se fare in modo che GitHub Actions esegua l'autenticazione con un'identità assegnata dall'utente o usando le credenziali di autenticazione di base. Per l'autenticazione di base, vengono usate le credenziali correnti.

6. Selezionare Anteprima file per visualizzare il file del flusso di lavoro che viene aggiunto al repository GitHub in github/workflows/.

7. Selezionare Salva per aggiungere il file del flusso di lavoro al repository.

Per altre informazioni sulle distribuzioni di GitHub Action, inclusi altri modi per generare il file di configurazione del flusso di lavoro, vedere Recapito continuo con GitHub Actions.

Bitbucket

Non è possibile eseguire la distribuzione da Bitbucket usando GitHub Actions. Scegliere invece il provider di compilazione servizio app.

GIT locale

Non è possibile eseguire la distribuzione da Git locale usando GitHub Actions. Scegliere invece il provider di compilazione servizio app.

Azure Repos

1. Passare all'app per le funzioni nel portale di Azure e selezionare Centro distribuzione.

2. Per Origine selezionare Azure Repos. Se servizio app provider di servizi di compilazione non è l'impostazione predefinita, selezionare Cambia provider scegliere servizio app servizio di compilazione e selezionare OK.

3. Selezionare i valori per Organizzazione, Progetto, Repository e Ramo. Vengono visualizzate solo le organizzazioni che appartengono all'account Azure.

4. Selezionare Salva per creare il webhook nel repository.

GitHub

1. Passare all'app per le funzioni nel portale di Azure e selezionare Centro distribuzione.

2. Per Origine selezionare GitHub. Se servizio app provider di servizi di compilazione non è l'impostazione predefinita, selezionare Cambia provider scegliere servizio app servizio di compilazione e selezionare OK.

3. Se l'accesso a GitHub non è già stato autorizzato, selezionare Autorizza. Specificare le credenziali di GitHub e selezionare Accedi. Se è necessario autorizzare un account GitHub diverso, selezionare Cambia account e accedere con un altro account.

4. Selezionare i valori per Organizzazione, Repository e Ramo. I valori sono basati sulla posizione del codice.

5. Esaminare tutti i dettagli e selezionare Salva. Un webhook viene inserito nel repository scelto.

Quando viene eseguito il push di un nuovo commit nel ramo selezionato, il servizio esegue il pull del codice, compila l'applicazione e la distribuisce nell'app per le funzioni.

Bitbucket

1. Passare all'app per le funzioni nel portale di Azure e selezionare Centro distribuzione.

2. In Origine selezionare Bitbucket.

3. Se l'accesso a Bitbucket non è già stato autorizzato, selezionare Autorizza e quindi Concedi accesso. Se richiesto, specificare le credenziali di Bitbucket e selezionare Accedi. Se è necessario autorizzare un account Bitbucket diverso, selezionare Cambia account e accedere con un altro account.

4. Selezionare i valori per Organizzazione, Repository e Ramo. I valori sono basati sulla posizione del codice.

5. Esaminare tutti i dettagli e selezionare Salva. Un webhook viene inserito nel repository scelto.

Quando viene eseguito il push di un nuovo commit nel ramo selezionato, il servizio esegue il pull del codice, compila l'applicazione e la distribuisce nell'app per le funzioni.

GIT locale

1. Passare all'app per le funzioni nel portale di Azure e selezionare Centro distribuzione.

2. In Origine selezionare Git locale e selezionare Salva.

3. Nel piano di servizio app esistente viene creato un repository locale a cui si accede dal scm dominio. Copiare l'URI clone Git e usarlo per creare un clone di questo nuovo repository nel computer locale.

Quando viene eseguito il push di un nuovo commit nel repository Git locale, il servizio esegue il pull del codice, compila l'applicazione e la distribuisce nell'app per le funzioni.

Al termine della distribuzione, tutto il codice dell'origine specificata viene distribuito nell'app. A questo punto, le modifiche nell'origine di distribuzione attivano una distribuzione di tali modifiche all'app per le funzioni in Azure.

Abilitare la distribuzione continua durante la creazione dell'app

Attualmente, è possibile configurare la distribuzione continua da GitHub usando GitHub Actions quando si crea l'app per le funzioni nel portale di Azure. È possibile eseguire questa operazione nella scheda Distribuzione della pagina Crea app per le funzioni.

Se si vuole usare un'origine di distribuzione o un provider di compilazione diverso per l'integrazione continua, creare prima l'app per le funzioni e quindi tornare al portale e configurare l'integrazione continua nel Centro distribuzione.

Abilitare l'autenticazione di base per le distribuzioni

In alcuni casi, l'app per le funzioni viene creata con l'accesso di base all'autenticazione all'endpoint scm disabilitato. Questo blocca la pubblicazione da parte di tutti i metodi che non possono usare identità gestite per accedere all'endpoint scm . L'impatto della pubblicazione sulla disabilitazione dell'endpoint scm è descritto in Distribuzione senza autenticazione di base.

Importante

Quando si usa l'authenication di base, le credenziali vengono inviate in testo non crittografato. Per proteggere queste credenziali, è necessario accedere all'endpoint scm solo tramite una connessione crittografata (HTTPS) quando si usa l'autenticazione di base. Per altre informazioni, vedere Distribuzione sicura.

Per abilitare l'autenticazione di base per l'endpoint scm :

Azure portal

1. Nel portale di Azure passare all'app per le funzioni.

2. Nel menu a sinistra dell'app selezionare Impostazioni>Configurazione>generale.

3. Impostare SCM Basic Auth Publishing Credentials (Credenziali di pubblicazione autenticazione di base SCM) su Sì e quindi selezionare Salva.

Interfaccia della riga di comando di Azure

È possibile usare l'interfaccia della riga di comando di Azure per attivare l'autenticazione di base usando questo az resource update comando per aggiornare la risorsa che controlla l'endpoint scm .

az resource update --resource-group <RESOURCE_GROUP> --name scm --namespace Microsoft.Web --resource-type basicPublishingCredentialsPolicies --parent sites/<APP_NAME> --set properties.allow=true

In questo comando sostituire i segnaposto con il nome del gruppo di risorse e il nome dell'app.

Passaggi successivi

Procedure consigliate per Funzioni di Azure