Löpande distribution för Azure Functions

Med Azure Functions kan du kontinuerligt distribuera ändringarna som gjorts i en källkontrolllagringsplats till en ansluten funktionsapp. Den här källkontrollintegreringen möjliggör ett arbetsflöde där en koduppdatering utlöser bygge, paketering och distribution från projektet till Azure.

Du bör alltid konfigurera kontinuerlig distribution för en mellanlagringsplats och inte för produktionsplatsen. När du använder produktionsplatsen skickas koduppdateringar direkt till produktion utan att verifieras i Azure. Aktivera i stället kontinuerlig distribution till ett mellanlagringsfack, verifiera uppdateringar i mellanlagringsplatsen och när allt har körts korrekt kan du växla mellanlagringsfackets kod till produktion. Om du ansluter till en produktionsplats kontrollerar du att endast kod av produktionskvalitet gör den till den integrerade kodgrenen.

Steg i den här artikeln visar hur du konfigurerar kontinuerliga koddistributioner till din funktionsapp i Azure med hjälp av Distributionscenter i Azure-portalen. Du kan också konfigurera kontinuerlig integrering med hjälp av Azure CLI. De här stegen kan vara inriktade på antingen en mellanlagring eller en produktionsplats.

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

Azure-lagringsplatser

Behåll projektkoden i Azure Repos, 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.

GitHub är den enda kontinuerliga distributionskällan som stöds för appar som körs på Linux i en förbrukningsplan, som innehåller serverlösa Python-appar.

Bitbucket

Behåll projektkoden i Bitbucket. Kräver App Service-byggprovidern.

Lokal Git

Behåll projektkoden på en dedikerad Git-server som finns i samma App Service-plan med din funktionsapp. Kräver App Service-byggprovidern. Mer information finns i Lokal Git-distribution till Azure App Service.

Du kan också ansluta din funktionsapp till en extern Git-lagringsplats, men detta kräver en manuell synkronisering. Mer information om distributionsalternativ finns i Distributionstekniker i Azure Functions.

Kommentar

Alternativ för kontinuerlig distribution som beskrivs i den här artikeln är specifika för distributioner med endast kod. Information om distribution av containerbaserade funktionsappar finns i Aktivera kontinuerlig distribution av containrar till Azure.

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 hjälp av Azure Functions Core Tools, Visual Studio Code eller Visual Studio används Azure Functions-mallarna för att skapa kodprojekt med rätt katalogstruktur. Alla funktioner i en funktionsapp distribueras samtidigt och i samma paket.

När du har aktiverat kontinuerlig distribution konfigureras åtkomsten till funktionskoden i Azure-portalen som skrivskyddad eftersom sanningskällan är känd för att finnas någon annanstans.

Kommentar

Distributionscentret stöder inte aktivering av kontinuerlig distribution för en funktionsapp med begränsningar för inkommande nätverk. Du måste i stället konfigurera arbetsflödet för byggprovidern direkt i GitHub eller Azure Pipelines. Dessa arbetsflöden kräver också att du använder en virtuell dator i samma virtuella nätverk som funktionsappen som antingen en lokalt installerad agent (Pipelines) eller en lokalt installerad löpare (GitHub).)

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. Byggen kan göras lokalt eller via fjärranslutning, igen beroende på din specifika värd. Mer information finns i Fjärrbygge.

Viktigt!

För ökad säkerhet bör du överväga att använda en byggprovider som stöder hanterade identiteter, inklusive Azure Pipelines och Gitub Actions. App Service-tjänsten (Kudu) kräver att du aktiverar grundläggande autentisering och arbetar med textbaserade autentiseringsuppgifter.

Functions har stöd för dessa byggleverantörer:

Azure Pipelines

Azure Pipelines är en av tjänsterna i Azure DevOps och standardleverantör för Azure Repos-projekt. Du kan också använda Pipelines för att skapa projekt från GitHub. I 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. Stöder hanterade identiteter.

GitHub Actions

GitHub Actions är standardversionsprovidern för GitHub-projekt. GitHub Actions ger dig kontroll över hur projektet skapas, paketeras och distribueras. Stöder hanterade identiteter.

App Service-tjänst (Kudu)

App Service-plattformen har en intern distributionstjänst (Project Kudu) som stöd för lokal Git-distribution, vissa containerdistributioner och andra distributionskällor som inte stöds av vare sig Pipelines eller GitHub Actions. Fjärrversioner, paketering och andra underhållsaktiviteter utförs i en underdomän scm.azurewebsites.net som är dedikerad till din app, till exempel https://myfunctionapp.scm.azurewebsites.net. Den här byggtjänsten kan bara användas när platsen scm kan nås av distributionen. Många publiceringsverktyg kräver grundläggande autentisering för att ansluta till scm slutpunkten, vilket innebär att du inte kan använda hanterade identiteter.

Den här byggprovidern används när du distribuerar ditt kodprojekt med hjälp av Visual Studio, Visual Studio Code eller Azure Functions Core Tools. Om du inte redan har distribuerat kod till funktionsappen scm med hjälp av något av dessa verktyg kan du behöva aktivera grundläggande autentisering för att distributioner ska kunna använda webbplatsen.

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.

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-lagringsplatser

Distributioner från Azure-lagringsplatser som använder Azure Pipelines definieras i Azure DevOps-portalen och inte från din funktionsapp. En stegvis guide för att skapa en Pipelines-baserad distribution från Azure Repos finns i Kontinuerlig leverans med Azure Pipelines.

GitHub

Distributioner från GitHub som använder Azure Pipelines definieras i Azure DevOps-portalen och inte från din funktionsapp. En stegvis guide för att skapa en Pipelines-baserad distribution från GitHub finns i Kontinuerlig leverans med Azure Pipelines.

Bitbucket

Du kan inte distribuera från Bitbucket med Hjälp av Azure Pipelines. Välj i stället App Service-byggprovidern.

Lokal Git

Du kan inte distribuera från lokal git med Hjälp av Azure Pipelines. Välj i stället App Service-byggprovidern.

Azure-lagringsplatser

Du kan inte distribuera från Azure Repos med 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 funktionsappen i Azure-portalen och välj Distributionscenter.

2. För Källa väljer du GitHub. Om du inte ser standardmeddelandet Skapa med GitHub Actions väljer du Ändra provider , väljer GitHub Actions och väljer OK.

3. Om du inte redan har auktoriserad GitHub-åtkomst väljer du 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. Om du vill distribuera med GitHub Actions måste du ha skrivåtkomst till den här lagringsplatsen.

5. I Autentiseringsinställningar väljer du om GitHub Actions ska autentiseras med en användartilldelad identitet eller använda grundläggande autentiseringsuppgifter . För grundläggande autentisering används de aktuella autentiseringsuppgifterna.

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

7. Välj Spara för att lägga till arbetsflödesfilen på lagringsplatsen.

Mer information om GitHub Action-distributioner, inklusive andra sätt att generera arbetsflödeskonfigurationsfilen, finns i Kontinuerlig leverans med hjälp av GitHub Actions.

Bitbucket

Du kan inte distribuera från Bitbucket med GitHub Actions. Välj i stället App Service-byggprovidern.

Lokal Git

Du kan inte distribuera från lokal git med GitHub Actions. Välj i stället App Service-byggprovidern.

Azure-lagringsplatser

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

2. För Källa väljer du Azure-lagringsplatser. Om App Service build service provider inte är standard väljer du Ändra leverantör välj App Service build service och väljer 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 på lagringsplatsen.

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 leverantör välj App Service build service och väljer OK.

3. Om du inte redan har auktoriserad GitHub-åtkomst 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. En webhook placeras på den valda lagringsplatsen.

När en ny incheckning skickas till den valda grenen hämtar tjänsten koden, skapar ditt program och distribuerar den till funktionsappen.

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 auktoriserad Bitbucket-åtkomst väljer du 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. En webhook placeras på den valda lagringsplatsen.

När en ny incheckning skickas till den valda grenen hämtar tjänsten koden, skapar ditt program och distribuerar den till funktionsappen.

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. En lokal lagringsplats skapas i din befintliga App Service-plan, som nås från domänen scm . Kopiera Git-klonens URI och använd den för att skapa en klon av den nya lagringsplatsen på den lokala datorn.

När en ny incheckning skickas till den lokala git-lagringsplatsen hämtar tjänsten din kod, skapar ditt program och distribuerar den till din funktionsapp.

När distributionen är klar distribueras all kod från den angivna källan till din app. Vid den tidpunkten utlöser ändringar i distributionskällan en distribution av dessa ändringar i funktionsappen i Azure.

Aktivera kontinuerlig distribution när appen skapas

För närvarande kan du konfigurera kontinuerlig distribution från GitHub med GitHub Actions när du skapar din funktionsapp i Azure-portalen. Du kan göra detta på fliken Distribution på sidan Skapa funktionsapp .

Om du vill använda en annan distributionskälla eller byggprovider för kontinuerlig integrering skapar du först funktionsappen och återgår sedan till portalen och konfigurerar kontinuerlig integrering i Distributionscenter.

Aktivera grundläggande autentisering för distributioner

Som standard skapas funktionsappen med grundläggande autentiseringsåtkomst till scm slutpunkten inaktiverad. Detta blockerar publicering med alla metoder som inte kan använda hanterade identiteter för att komma åt scm slutpunkten. Publiceringseffekterna av att ha scm slutpunkten inaktiverad beskrivs i Distribution utan grundläggande autentisering.

Viktigt!

När du använder grundläggande autentisering skickas autentiseringsuppgifterna i klartext. För att skydda dessa autentiseringsuppgifter får du bara komma åt scm slutpunkten via en krypterad anslutning (HTTPS) när du använder grundläggande autentisering. Mer information finns i Säker distribution.

Så här aktiverar du grundläggande autentisering till scm slutpunkten:

Azure-portalen

1. Gå till funktionsappen i Azure-portalen.

2. I appens vänstra meny väljer du Konfiguration>Allmänna inställningar.

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

Azure CLI

Du kan använda Azure CLI för att aktivera grundläggande autentisering med hjälp av det här az resource update kommandot för att uppdatera resursen scm som styr slutpunkten.

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.

Nästa steg

Metodtips för Azure Functions