Löpande distribution för Azure Functions

Azure Functions gör det möjligt att kontinuerligt distribuera ändringar från ett versionshanteringsarkiv till en funktionsapp. I detta arbetsflöde triggar en koduppdatering byggande, paketering och distribution från ditt projekt till Azure. De stödda distributionsleverantörerna och lanseringsstrategierna beror på värdplanen.

Webbhotellspaket	Rekommenderad CI/CD-leverantör	Utplacering och utsläppsvägledning
Flex Consumption	GitHub Actions eller Azure-pipelines	Använder paketdistribution. Utplaceringsplatser stöds inte. Använd CI/CD-releasekontroller och överväg rullande uppdateringar för driftsättningar utan driftstopp.
Elastisk premie, dedikerad och konsumtion	GitHub Actions eller Azure-pipelines	Använder ZIP-distribution. Om appen har stöd för det distribuerar du till en mellanlagringsplats, verifierar uppdateringen och växlar sedan platsen till produktion.
Azure Container-applikationer	Arbetsflöde för containerbyggande och distribution	Driftsätter en containeravbildning. Mer information finns i Översikt över Azure Functions i Azure Container Apps.

Välj din hostingplan högst upp i denna artikel för att se riktlinjerna för kontinuerlig distribution som gäller för din funktionsapp.

För värdplaner som har stöd för distributionsplatser konfigurerar du kontinuerlig distribution för en mellanlagringsplats i stället för produktionsplatsen. Verifiera uppdateringarna i mellanlagringsmiljön och växla sedan mellanlagringsplatsen till produktion. Om du ansluter direkt till en produktionsslot, se till att endast kod av produktionskvalitet når integreringsgrenen.

För Flex Consumption, konfigurera GitHub Actions eller Azure-pipelines. Eftersom Flex Consumption inte stödjer distributionsplatser, behåll din distributionshistorik i versionshanteringen och ditt CI/CD-system så att du kan återhämta dig från en dålig distribution.

För Functions på Azure Container Apps, bygg och distribuera en containerimage. Utplaceringsplatser är inte tillgängliga. Använd versioner och överväg en blågrön distributionsstrategi för släpp utan driftstopp.

Stegen för Deployment Center i den här artikeln gäller funktionsappar som stöder integrering med App Service-källkodshantering. På Consumption-planen stöds denna integration endast på Windows. Du kan också konfigurera versionshanteringsintegration genom att använda Azure CLI.

Azure Functions stöder dessa källor för kontinuerlig distribution till din app:

Azure-lagringsplatseritorier

Behåll projektkoden i Azure-lagringsplatser, en av tjänsterna i Azure DevOps. Stöder både Versionskontroll för Git och Team Foundation. Används med Azure-pipelines-byggprovidern. Mer information finns i Vad är Azure-lagringsplatser?

GitHub

Behåll din projektkod i GitHub. Stöds av alla byggleverantörer. Mer information finns i GitHub-dokument.

Bitbucket

Behåll projektkoden i Bitbucket. Kräver App Service build-tjänsten.

Lokal Git

Underhåll din projektkod i en dedikerad Git-server som är hostad i samma App Service-plan som din funktionsapp. Detta alternativ kräver App Service build service. Mer information finns i Lokal Git-distribution till Azure App Service.

Du kan också koppla din funktionsapp till ett externt Git-repository, men detta alternativ kräver manuell synkronisering. Mer information om distributionsalternativ finns i Distributionstekniker i Azure Functions.

Anteckning

Alternativ för kontinuerlig distribution som beskrivs i den här artikeln är specifika för distributioner med endast kod. För Azure Functions i Azure Container Apps, se Översikt över Azure Functions i Azure Container Apps. För en anpassad container som hostas av Azure Functions i en Premium- eller Dedikerad plan, se avsnittet Aktivera kontinuerlig distribution av containrar till Azure i Work with containers and Azure Functions.

Flex Consumption stödjer kontinuerlig distribution från Azure-lagringsplatser genom att använda Azure-pipelines och från GitHub genom att använda GitHub Actions. App Service versionshanteringsintegration, inklusive Bitbucket- och Local Git-distributioner, stöds inte.

För Functions på Azure Container Apps, underhåll din källkod i ditt föredragna repository och använd ett CI/CD-arbetsflöde för att bygga och pusha en containerimage. Uppdatera sedan din funktionsapp för att använda den nya bilden. För mer information, se Distribution och installation för Functions på Azure Container Apps.

Krav

Distributionsenheten för funktioner i Azure är funktionsappen. För att kontinuerlig distribution ska lyckas måste katalogstrukturen i projektet vara kompatibel med den grundläggande mappstrukturen som Azure Functions förväntar sig. När du skapar ditt kodprojekt med Azure Functions Core Tools, Visual Studio Code eller Visual Studio, skapar Azure Functions-mallarna kodprojekt med rätt katalogstruktur. Du distribuerar alla funktioner i en funktionsapp samtidigt och i samma paket.

Efter att du aktiverat kontinuerlig distribution konfigureras åtkomsten till funktionskoden i Azure-portalen som skrivskyddad eftersom sanningskällan finns någon annanstans.

Anteckning

Distributionscentret stöder inte aktivering av kontinuerlig distribution för en funktionsapp med begränsningar för inkommande nätverk. Konfigurera istället byggleverantörens arbetsflöde direkt i GitHub eller Azure-pipelines. Runnern eller agenten måste kunna nå appens distributionsendpoint under de konfigurerade åtkomstbegränsningarna. När slutpunkten är privat behöver runnern eller agenten också privat DNS-lösning. För Azure-pipelines, använd en självhostad agent på ett anslutet nätverk eller en hanterad DevOps-agentpool med nätverk. För GitHub Actions, använd en självhostad runner på ett anslutet nätverk eller en GitHub-hostad runner med Azure privat nätverk.

När din funktionsapp har inkommande nätverksbegränsningar måste arbetsflödeslöparen eller agenten kunna nå appens distributionspunkt under de konfigurerade åtkomstbegränsningarna. När slutpunkten är privat behöver runnern eller agenten också privat DNS-lösning. För Azure-pipelines, använd en självhostad agent på ett anslutet nätverk eller en hanterad DevOps-agentpool med nätverk. För GitHub Actions, använd en självhostad runner på ett anslutet nätverk eller en GitHub-hostad runner med Azure privat nätverk.

Ditt CI/CD-arbetsflöde måste bygga en giltig Azure Functions-containerimage, skicka bilden till ett register som din containerapp kan komma åt, och uppdatera funktionsappen för att skapa en version från den bilden. För mer information, se Skapa en funktionsapp i Azure Container Apps.

Välj en byggprovider

Att skapa kodprojektet är en del av distributionsprocessen. Den specifika byggprocessen beror på din specifika språkstack, operativsystem och värdplan. Du kan bygga lokalt eller på distans, beroende på din hosting. Mer information finns i Fjärrbygge.

Viktigt!

För ökad säkerhet, använd en byggleverantör som stödjer hanterade identiteter, såsom Azure-pipelines och GitHub Actions. App Service-byggtjänsten kräver att du aktiverar grundläggande autentisering och använder textbaserade inloggningsuppgifter.

Azure Functions har stöd för följande byggleverantörer:

Azure-pipelines

Azure-pipelines är en av tjänsterna i Azure DevOps och standardleverantör för Azure-lagringsplatser-projekt. Du kan också använda Azure-pipelines för att skapa projekt från GitHub. I Azure-pipelines finns det en AzureFunctionApp uppgift som är särskilt utformad för att distribuera till Azure Functions. Den här uppgiften ger dig kontroll över hur projektet skapas, paketeras och distribueras. Azure-pipelines stöder hanterade identiteter.

GitHub Actions

Standardversionsprovidern för GitHub-projekt är GitHub Actions. Det ger dig kontroll över hur projektet skapas, paketeras och distribueras. Den här providern stöder hanterade identiteter.

App Service-byggtjänst

App Service-plattformen tillhandahåller en inbyggd bygg- och distributionstjänst. Denna tjänst stödjer lokal Git-distribution, vissa containerdistributioner och andra distributionskällor som Azure-pipelines och GitHub Actions inte stödjer. Distributionsplatsen som är dedikerad till din app hanterar fjärrbygganden, paketering och andra underhållsuppgifter. Distributionsändpunkten använder deldomänen scm , som i https://myfunctionapp.scm.azurewebsites.net. Du kan använda denna byggtjänst endast när din distribution kan komma åt distributionsendpointen. Även om du kan använda identiteter för att ansluta till distributionsendpointen, kräver många publiceringsverktyg grundläggande autentisering istället.

På Consumption-planen stöder App Service-byggtjänsten endast Windows.

Denna byggtjänst används när du distribuerar ditt kodprojekt med Visual Studio, Visual Studio Code eller Azure Functions Core Tools. Om du inte redan har använt något av dessa verktyg för att distribuera kod till din funktionsapp, kan du behöva aktivera grundläggande autentisering för distributioner för att använda distributionsslutpunkten.

Tänk på dessa leverantörers styrkor och begränsningar när du aktiverar källkontrollintegrering. Du kan behöva ändra källtypen för lagringsplatsen för att dra nytta av en viss provider.

Använd Azure-pipelines eller GitHub Actions för att bygga och distribuera ditt projekt. Dessa leverantörer stödjer Microsoft Entra-identiteter och använder Flex Consumption-paketets distributionsprocess.

• För Azure-lagringsplatser, använd Azure-pipelines.
• För GitHub, använd GitHub Actions.

App Service-byggtjänsten gäller inte för Flex Consumption.

Använd en containerbyggarleverantör som kan bygga din Azure Functions-image, skicka den till ett container-register och uppdatera din Function-app för att skapa en revision från den nya imagen. För ett end-to-end GitHub Actions-arbetsflöde, se Deploy to Azure Container Apps with GitHub Actions.

Konfigurera kontinuerlig distribution

Azure-portalen tillhandahåller ett distributionscenter för dina funktionsappar, vilket gör det enklare att konfigurera kontinuerlig distribution. Det specifika sättet du konfigurerar kontinuerlig distribution på beror både på vilken typ av lagringsplats för källkontroll som koden finns i och vilken byggprovider du väljer.

I Azure-portalen bläddrar du till funktionsappsidan och väljer Distributionscenter under Distribution i den vänstra rutan.

Välj den källlagringsplatstyp där projektkoden underhålls från något av följande alternativ som stöds:

Azure-lagringsplatseritorier

Definiera distributioner från Azure-lagringsplatser som använder Azure-pipelines i Azure DevOps-portalen. Definiera inte dessa distributioner från din funktionsapp. För en steg-för-steg-guide till att skapa en Azure-pipelines-baserad distribution från Azure-lagringsplatser, se Continuous delivery with Azure-pipelines.

GitHub

Definiera distributioner från GitHub som använder Azure-pipelines i Azure DevOps-portalen. Definiera inte dessa distributioner från din funktionsapp. För en steg-för-steg-guide för att skapa en Azure-pipelines-baserad distribution från GitHub, se Continuous delivery with Azure-pipelines.

Bitbucket

Du kan inte distribuera från Bitbucket genom att använda Azure-pipelines. Välj istället App Service build-tjänsten.

Lokal Git

Du kan inte distribuera från Local Git genom att använda Azure-pipelines. Välj istället App Service build-tjänsten.

Azure-lagringsplatseritorier

Du kan inte distribuera från Azure-lagringsplatser genom att använda GitHub Actions. Välj en annan byggprovider.

GitHub

Så här lägger du till ett GitHub Actions-arbetsflöde i en befintlig funktionsapp:

1. Gå till din funktionsapp i Azure-portalen och välj Deployment>Deployment Center.

2. Välj Kontinuerlig Distribution (CI/CD). För Källa väljer du GitHub. Om du inte ser standardmeddelandet Bygger med GitHub Actions, välj Change provider, välj GitHub Actions och välj OK.

3. Om du inte redan har auktoriserat GitHub-åtkomst, välj Auktorisera. Ange dina GitHub-autentiseringsuppgifter och välj Logga in. Om du vill auktorisera ett annat GitHub-konto väljer du Ändra konto och loggar in med ett annat konto.

4. Välj din GitHub-organisation, lagringsplats och gren. För att distribuera med GitHub Actions måste du ha skrivbehörighet till detta arkiv.

5. För alternativet Arbetsflöde, välj Lägg till ett arbetsflöde. Detta alternativ skapar en ny arbetsflödesfil i /.github/workflows/. För att använda ett befintligt arbetsflöde, välj Använd tillgängligt arbetsflöde och välj din arbetsflödesfil.

6. I autentiseringsinställningarna, välj Användartilldelad identitet för att använda OpenID Connect (OIDC), vilket rekommenderas eftersom det inte kräver att du lagrar hemligheter i GitHub. Välj din prenumeration och det (nya) föreslagna identitetsnamnet. En ny användartilldelad hanterad identitet skapas och ges tillgång till rollen som webbplatsbidragsgivare . Om du använder en befintlig identitet måste du först ge den tillgång till rollen som webbplatsbidragsgivare .

   Viktigt!

   När du väljer Grundläggande autentisering lagras din publiceringsprofil, som innehåller delade hemligheter, i GitHub Secrets. Du måste också aktivera SCM-grundläggande autentisering, vilket gör din app mindre säker.

7. Välj Förhandsgranskningsfil för att se arbetsflödesfilen som läggs till i GitHub-lagringsplatsen i .github/workflows/.

8. Välj Spara för att lägga till arbetsflödesfilen på lagringsplatsen. Välj fliken Loggar för att se status för nuvarande och tidigare distributioner.

För att lära dig mer om GitHub Actions-distributioner, inklusive andra sätt att generera arbetsflödeskonfigurationsfilen, se Continuous Delivery by using GitHub Actions.

Bitbucket

Du kan inte distribuera från Bitbucket genom att använda GitHub Actions. Välj istället App Service build-tjänsten.

Lokal Git

Du kan inte distribuera från Local Git genom att använda GitHub Actions. Välj istället App Service build-tjänsten.

Azure-lagringsplatseritorier

1. Gå till funktionsappen i Azure-portalen och välj Distributionscenter.

2. För Källa, välj Azure-lagringsplatser. Om App Service build service provider inte är standard väljer du Ändra provider, väljer App Service build service och sedan OK.

3. Välj värden för Organisation, Projekt, Lagringsplats och Gren. Endast organisationer som tillhör ditt Azure-konto visas.

4. Välj Spara för att skapa webhooken i ditt arkiv.

GitHub

1. Gå till funktionsappen i Azure-portalen och välj Distributionscenter.

2. För Källa väljer du GitHub. Om App Service build service provider inte är standard väljer du Ändra provider, väljer App Service build service och sedan OK.

3. Om din GitHub-åtkomst inte redan är auktoriserad väljer du Auktorisera. Ange dina GitHub-autentiseringsuppgifter och välj Logga in. Om du behöver auktorisera ett annat GitHub-konto väljer du Ändra konto och loggar in med ett annat konto.

4. Välj värden för Organisation, Lagringsplats och Gren. Värdena baseras på kodens plats.

5. Granska all information och välj Spara. Tjänsten placerar en webhook i ditt valda arkiv.

När du skickar en ny commit till den valda branchen hämtar tjänsten din kod, bygger din applikation och distribuerar den till din funktionsapp.

Bitbucket

1. Gå till funktionsappen i Azure-portalen och välj Distributionscenter.

2. För Källa väljer du Bitbucket.

3. Om du inte redan har auktoriserat åtkomst till Bitbucket, välj Auktorisera och sedan Bevilja åtkomst. Ange dina autentiseringsuppgifter för Bitbucket om du vill och välj Logga in. Om du behöver auktorisera ett annat Bitbucket-konto väljer du Ändra konto och loggar in med ett annat konto.

4. Välj värden för Organisation, Lagringsplats och Gren. Värdena baseras på kodens plats.

5. Granska all information och välj Spara. Tjänsten placerar en webhook i ditt valda arkiv.

När du skickar en ny commit till den valda branchen hämtar tjänsten din kod, bygger din applikation och distribuerar den till din funktionsapp.

Lokal Git

1. Gå till funktionsappen i Azure-portalen och välj Distributionscenter.

2. För Källa väljer du Lokal Git och sedan Spara.

3. Du skapar ett lokalt arkiv i din befintliga App Service-plan, som du får tillgång till från distributionsplatsen. Kopiera Git-klonens URI och använd den för att skapa en klon av den nya lagringsplatsen på den lokala datorn.

När du skickar en ny commit till det lokala Git-lagret, hämtar tjänsten din kod, bygger din applikation och distribuerar den till din funktionsapp.

Efter att distributionen är klar distribuerar tjänsten all kod från den angivna källkoden till din app. Vid den tidpunkten utlöser ändringar i distributionskällan en distribution av dessa ändringar i funktionsappen i Azure.

Konfigurera kontinuerlig distribution i ditt repository genom att använda en av dessa leverantörer:

• Konfigurera kontinuerlig leverans med Azure-pipelines
• Löpande leverans med GitHub Actions

Varje lyckad arbetsflödeskörning distribuerar ett nytt applikationspaket. Integrering av källkontroll i Distributionscenter är inte tillgänglig för Flex Consumption.

Konfigurera ditt CI/CD-arbetsflöde för att bygga och pusha containerimagen, och distribuera sedan bilden till din funktionsapp. Varje bilduppdatering skapar en version av Container Apps. För mer information, se Deploy to Azure Container Apps with GitHub Actions.

Aktivera kontinuerlig distribution när appen skapas

När du skapar en funktionsapp i Azure-portalen kan du konfigurera kontinuerlig distribution från GitHub genom att använda GitHub Actions. Konfigurera GitHub Actions på fliken Deployment på sidan Skapa Funktionsapp.

För att använda en annan distributionskälla eller byggleverantör för kontinuerlig integration, skapa först din funktionsapp. Gå sedan tillbaka till portalen och sätt upp kontinuerlig integration i Deployment Center.

För Azure-pipelines, skapa först din funktionsapp och konfigurera sedan pipelinen i Azure DevOps.

Skapa funktionsappen från en containerimage och konfigurera sedan ditt CI/CD-arbetsflöde för att publicera uppdaterade bilder och skapa revisioner. För mer information, se Skapa en funktionsapp i Azure Container Apps.

Aktivera grundläggande autentisering för distributioner

Detta avsnitt gäller endast för distributionsmetoder som använder App Service-distributionsendpointen.

I vissa fall skapas din funktionsapp med grundläggande autentiseringsåtkomst till distributionsendpointen inaktiverad. Detta villkor blockerar publicering med alla metoder som inte kan använda Microsoft Entra-identiteter för att komma åt distributions-endpointen. Publiceringseffekterna av att inaktivera grundläggande autentisering för distributionsändpunkten beskrivs i Deploy utan grundläggande autentisering.

Viktigt!

När du använder grundläggande autentisering skickas autentiseringsuppgifterna i klartext. För att skydda dessa inloggningsuppgifter måste du endast komma åt distributionsändpunkten via en krypterad anslutning (HTTPS) när du använder grundläggande autentisering. Mer information finns i Säker distribution.

För att aktivera grundläggande autentisering för distributionsändpunkten:

Azure-portalen

1. Gå till funktionsappen i Azure Portal.

2. På appens vänstra meny väljer du Inställningar>Konfiguration>Allmänna inställningar.

3. Ange autentiseringsuppgifter för SCM Basic Auth Publishing till På och välj sedan Spara.

Azure CLI

Använd Azure CLI för att aktivera grundläggande autentisering. Kör kommandot az resource update för att uppdatera resursen som styr distributionsändpunkten.

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

I det här kommandot ersätter du platshållarna med resursgruppens namn och appnamn.

SCM:s grundläggande autentisering gäller inte för Flex Consumption-paketdistributioner. Som standard använder Azure-pipelines en Microsoft Entra-bearertoken från den Azure-tjänstanslutning som krävs; federation av arbetsbelastningsidentiteter rekommenderas. För GitHub Actions, använd den rekommenderade OpenID Connect (OIDC)-autentiseringen. Dessa metoder undviker att SCM-publiceringsuppgifter publiceras och är säkrare än grundläggande autentisering.

Denna grundläggande autentiseringsinställning gäller inte för Functions i Azure Container Apps. Konfigurera autentisering mellan din CI/CD-leverantör, container-register och container-app istället.

Nästa steg

Metodtips för Azure Functions