Doorlopende implementatie voor Azure Functions

Azure Functions stelt je in staat om continu wijzigingen uit te rollen vanuit een source control-repository naar een functie-app. In deze workflow triggert een code-update het bouwen, verpakken en uitrollen van je project naar Azure. De ondersteunde implementatieproviders en releasestrategieën zijn afhankelijk van het hostingplan.

Hostingabonnement	Aanbevolen CI/CD-aanbieder	Inzet- en vrijgaverichtlijnen
Flex Consumption	GitHub Actions of Azure-pipelines	Gebruikt pakketimplementatie. Implementatieslots worden niet ondersteund. Gebruik CI/CD release controls en overweeg rolling updates voor zero-downtime deployments.
Elastic Premium, Dedicated en Verbruik	GitHub Actions of Azure-pipelines	Gebruikt ZIP-deployment. Wanneer je app dit ondersteunt, implementeer dan naar een faseringsslot, controleer de update en wissel het slot vervolgens naar productie.
Azure Container Apps - een dienst van Microsoft waarmee je containers kunt uitvoeren en beheren in de cloud.	Workflow voor containerbouw en -uitrol	Implementeert een containerimage. Zie het overzicht van Azure Functions in Azure Container Apps voor meer informatie.

Selecteer je hostingplan bovenaan dit artikel om de richtlijnen voor continue implementatie te bekijken die van toepassing zijn op jouw functieapp.

Voor hostingplannen die deployment slots ondersteunen, configureer continuous deployment voor een stagingslot in plaats van de production slot. Controleer updates in de stagingomgeving en wissel vervolgens het staging-slot naar productie. Als je direct aansluit op een productieslot, zorg er dan voor dat alleen code van productiekwaliteit de geïntegreerde tak bereikt.

Voor Flex Consumption configureer je GitHub Actions of Azure-pipelines. Omdat Flex Consumption geen deployment slots ondersteunt, bewaar je deploymentgeschiedenis in source control en je CI/CD-systeem zodat je kunt herstellen van een slechte deployment.

Voor Functions in Azure Container Apps bouwt en implementeert u een container-installatiekopie. Er zijn geen uitzendplaatsen beschikbaar. Gebruik revisies en overweeg een blauw-groene implementatiestrategie voor releases zonder downtime.

De stappen in het Deployment Center in dit artikel zijn van toepassing op functie-apps die integratie van App Service source control ondersteunen. Op het Consumption-plan wordt deze integratie alleen ondersteund op Windows. Je kunt ook source control-integratie configureren door gebruik te maken van Azure CLI.

Azure Functions ondersteunt deze bronnen voor continue implementatie in uw app:

Azure-opslagplaatsenitories

Onderhoud uw projectcode in Azure-opslagplaatsen, een van de services in Azure DevOps. Ondersteunt zowel Git als Team Foundation Version Control. Wordt gebruikt met de buildprovider van Azure-pipelines. Voor meer informatie, zie Wat is Azure-opslagplaatsen?

GitHub

Onderhoud uw projectcode in GitHub. Ondersteund door alle buildproviders. Zie GitHub-documenten voor meer informatie.

Bitbucket

Onderhoud uw projectcode in Bitbucket. Vereist de App Service-buildservice.

Lokale Git

Onderhoud je projectcode in een speciale Git-server die wordt gehost in hetzelfde App Service-plan als je functie-app. Deze optie vereist de App Service build service. Zie Lokale Git-implementatie voor Azure-app Service voor meer informatie.

Je kunt je functie-app ook verbinden met een externe Git-repository, maar deze optie vereist handmatige synchronisatie. Zie Implementatietechnologieën in Azure Functions voor meer informatie over implementatieopties.

Notitie

Opties voor continue implementatie die in dit artikel worden behandeld, zijn specifiek voor implementaties met alleen code. Voor Azure Functions on Azure Container Apps, zie Azure Functions on Azure Container Apps overview. Voor een aangepaste container die door Azure Functions wordt gehost in een Premium- of Dedicated plan, zie de sectie Continue implementatie van containers naar Azure inschakelen in Work with containers and Azure Functions.

Flex Consumption ondersteunt continue implementatie vanuit Azure-opslagplaatsen via Azure-pipelines en vanuit GitHub via GitHub Actions. App Service source control-integratie, inclusief Bitbucket- en Local Git-implementaties, wordt niet ondersteund.

Voor Functions op Azure Container Apps onderhoud je je bron in je voorkeursrepository en gebruik een CI/CD-workflow om een containerimage te bouwen en pushen. Werk daarna je functie-app bij om de nieuwe image te gebruiken. Raadpleeg Implementatie en configuratie voor Functions op Azure Container Apps voor meer informatie.

Vereisten

De implementatie-eenheid voor functies in Azure is de functie-app. Voor een geslaagde continue implementatie moet de mapstructuur van uw project compatibel zijn met de basismapstructuur die Door Azure Functions wordt verwacht. Wanneer je je codeproject aanmaakt met Azure Functions Core Tools, Visual Studio Code of Visual Studio, maken de Azure Functions-sjablonen codeprojecten met de juiste mapstructuur. Je deployt alle functies tegelijk en in hetzelfde pakket in een functie-app.

Nadat je continue implementatie hebt ingeschakeld, wordt de toegang tot functiecode in het Azure-portaal geconfigureerd als alleen-lezen omdat de bron van waarheid elders ligt.

Notitie

Het Implementatiecentrum biedt geen ondersteuning voor het inschakelen van continue implementatie voor een functie-app met binnenkomende netwerkbeperkingen. Configureer in plaats daarvan de workflow van de build provider direct in GitHub of Azure-pipelines. De runner of agent moet het deployment-eindpunt van de app kunnen bereiken onder de geconfigureerde toegangsbeperkingen. Wanneer het eindpunt privé is, heeft de runner of agent ook een privé-DNS-resolutie nodig. Voor Azure-pipelines gebruik je een zelf-gehoste agent op een verbonden netwerk of een beheerde DevOps-agentpool met netwerk. Voor GitHub Actions gebruik je een zelf-gehoste runner op een verbonden netwerk of een GitHub-gehoste runner met Azure privénetwerk.

Wanneer je functie-app inkomende netwerkbeperkingen heeft, moet de workflow runner of agent het deploy-endpoint van de app kunnen bereiken onder de geconfigureerde toegangsbeperkingen. Wanneer het eindpunt privé is, heeft de runner of agent ook een privé-DNS-resolutie nodig. Voor Azure-pipelines gebruik je een zelf-gehoste agent op een verbonden netwerk of een beheerde DevOps-agentpool met netwerk. Voor GitHub Actions gebruik je een zelf-gehoste runner op een verbonden netwerk of een GitHub-gehoste runner met Azure privénetwerk.

Je CI/CD-workflow moet een geldig Azure Functions containerimage bouwen, de image naar een register pushen waar je container-app toegang toe heeft, en de functie-app updaten om een revisie van die image te maken. Voor meer informatie, zie Create a function app on Azure Container Apps.

Een buildprovider selecteren

Het bouwen van uw codeproject maakt deel uit van het implementatieproces. Het specifieke buildproces is afhankelijk van uw specifieke taalstack, besturingssysteem en hostingabonnement. Je kunt lokaal of op afstand bouwen, afhankelijk van je hosting. Zie Remote build voor meer informatie.

Belangrijk

Voor verhoogde beveiliging gebruik je een buildprovider die beheerde identiteiten ondersteunt, zoals Azure-pipelines en GitHub Actions. De App Service build-service vereist dat je basisauthenticatie inschakelt en tekstgebaseerde inloggegevens gebruikt.

Azure Functions ondersteunt deze buildproviders:

Azure-pijplijnen

Azure-pipelines is een van de services in Azure DevOps en de standaardbuildprovider voor Azure-opslagplaatsprojecten. U kunt ook Azure-pipelines gebruiken om projecten te bouwen vanuit GitHub. In Azure-pipelines is er een AzureFunctionApp taak die speciaal is ontworpen voor implementatie in Azure Functions. Deze taak biedt u controle over hoe het project wordt gebouwd, verpakt en geïmplementeerd. Azure-pipelines ondersteunt beheerde identiteiten.

GitHub Actions

De standaard buildprovider voor GitHub-projecten is GitHub Actions. Het biedt u controle over hoe het project wordt gebouwd, verpakt en geïmplementeerd. Deze provider ondersteunt beheerde identiteiten.

App Service-buildservice

Het App Service-platform biedt een ingebouwde service voor compilatie en implementatie. Deze service ondersteunt lokale Git-implementatie, sommige container-implementaties en andere deploymentbronnen die Azure-pipelines en GitHub Actions niet ondersteunen. De deployment site die aan uw app is toegewijd, verzorgt externe bouwactiviteiten, verpakkingen en andere onderhoudstaken. Het deployment-eindpunt gebruikt het scm subdomein, zoals in https://myfunctionapp.scm.azurewebsites.net. Je kunt deze buildservice alleen gebruiken als je implementatie toegang heeft tot het implementatie-eindpunt. Hoewel je identiteiten kunt gebruiken om verbinding te maken met het deployment-endpoint, vereisen veel publicatietools basisauthenticatie.

Op het Consumption-plan ondersteunt de App Service build-service alleen Windows.

Deze buildservice wordt gebruikt wanneer je je codeproject uitrolt met Visual Studio, Visual Studio Code of Azure Functions Core Tools. Als je nog geen van deze tools hebt gebruikt om code naar je functie-app te deployen, moet je misschien basisauthenticatie inschakelen zodat de deployment endpoint kan worden gebruikt.

Houd rekening met de sterke punten en beperkingen van deze providers wanneer u integratie van broncodebeheer inschakelt. Mogelijk moet u het brontype van de opslagplaats wijzigen om te profiteren van een specifieke provider.

Gebruik Azure-pipelines of GitHub Actions om je project te bouwen en uit te rollen. Deze providers ondersteunen Microsoft Entra-identiteiten en gebruiken het implementatieproces van het Flex Consumption-pakket.

• Voor Azure-opslagplaatsen, gebruik Azure-pipelines.
• Voor GitHub, gebruik GitHub Actions.

De App Service build-service is niet van toepassing op Flex Consumption.

Gebruik een container build-provider die je Azure Functions-image kan bouwen, push het naar een containerregister en update je Function-app om een revisie te maken vanuit de nieuwe image. Voor een end-to-end GitHub Actions-workflow, zie Deploy to Azure Container Apps with GitHub Actions.

Continue implementatie inschakelen

Het Azure-portaal biedt een Deployment Center voor je functie-apps, wat het configureren van continue implementatie eenvoudiger maakt. De specifieke manier waarop u continue implementatie configureert, is afhankelijk van het type opslagplaats voor broncodebeheer waarin uw code zich bevindt en de buildprovider die u kiest.

Blader in Azure Portal naar de pagina van uw functie-app en selecteer Implementatiecentrum onder Implementatie in het linkerdeelvenster.

Selecteer het type bronopslagplaats waarin uw projectcode wordt onderhouden op basis van een van de volgende ondersteunde opties:

Azure-opslagplaatsenitories

Definieer deployments uit Azure-opslagplaatsen die Azure-pipelines gebruiken in het Azure DevOps-portaal. Definieer deze implementaties niet vanuit je functie-app. Voor een stapsgewijze gids voor het creëren van een op Azure-pipelines gebaseerde deployment vanuit Azure-opslagplaatsen, zie Continuous delivery with Azure-pipelines.

GitHub

Definieer deployments van GitHub die Azure-pipelines gebruiken in het Azure DevOps-portaal. Definieer deze implementaties niet vanuit je functie-app. Voor een stapsgewijze gids voor het creëren van een Azure-pipelines-gebaseerde implementatie vanuit GitHub, zie Continuous delivery with Azure-pipelines.

Bitbucket

Je kunt niet vanuit Bitbucket deployen met Azure-pipelines. Kies in plaats daarvan de App Service build service.

Lokale Git

Je kunt niet deployen vanuit Local Git met Azure-pipelines. Kies in plaats daarvan de App Service build service.

Azure-opslagplaatsenitories

Je kunt niet deployen vanuit Azure-opslagplaatsen via GitHub Actions. Kies een andere buildprovider.

GitHub

Een GitHub Actions-werkstroom toevoegen aan een bestaande functie-app:

1. Ga naar je functie-app in het Azure-portaal en selecteer Deployment>Deployment Center.

2. Selecteer Continue Uitrol (CI/CD). Voor Bron, selecteer GitHub. Als je het standaardbericht Building with GitHub Actions niet ziet, selecteer dan Change provider, kies GitHub Actions en selecteer OK.

3. Als je nog geen toegang tot GitHub hebt goedgekeurd, kies dan Autoriseren. Geef uw GitHub-referenties op en selecteer Aanmelden. Als u een ander GitHub-account wilt autoriseren, selecteert u Account wijzigen en meldt u zich aan met een ander account.

4. Selecteer je GitHub organisatie, repository en branch. Om te deployen met GitHub Actions, moet je schrijftoegang hebben tot deze repository.

5. Selecteer voor de optie WorkflowEen workflow toevoegen. Deze optie maakt een nieuw workflowbestand aan in /.github/workflows/. Om een bestaande workflow te gebruiken, selecteer je Gebruik beschikbare workflow en kies je je workflowbestand.

6. Kies in de authenticatie-instellingenvoor User-assigned identity om OpenID Connect (OIDC) te gebruiken, wat wordt aanbevolen omdat je geen geheimen in GitHub hoeft op te slaan. Selecteer uw abonnement en de (nieuwe) voorgestelde identiteitsnaam. Er wordt een nieuwe door de gebruiker toegewezen beheerde identiteit aangemaakt en toegang verleend tot de rol Website Contributor. Als je een bestaande identiteit gebruikt, moet je deze eerst toegang geven tot de rol Website-bijdrager .

   Belangrijk

   Wanneer je Basisauthenticatie selecteert, wordt je publicatieprofiel, dat gedeelde geheimen bevat, opgeslagen in GitHub Secrets. Je moet ook SCM-basisauthenticatie inschakelen, wat je app minder veilig maakt.

7. Selecteer Voorbeeldbestand om het werkstroombestand te zien dat wordt toegevoegd aan uw GitHub-opslagplaats in .github/workflows/.

8. Selecteer Opslaan om het werkstroombestand toe te voegen aan uw opslagplaats. Selecteer het tabblad Logs om de status van huidige en eerdere uitrolingen te bekijken.

Voor meer informatie over GitHub Actions-implementaties, inclusief andere manieren om het workflowconfiguratiebestand te genereren, zie Continuous Delivery met behulp van GitHub Actions.

Bitbucket

Je kunt niet vanuit Bitbucket deployen via GitHub Actions. Kies in plaats daarvan de App Service build service.

Lokale Git

Je kunt niet vanuit Local Git deployen met GitHub Actions. Kies in plaats daarvan de App Service build service.

Azure-opslagplaatsenitories

1. Ga naar uw functie-app in Azure Portal en selecteer Deployment Center.

2. Voor Bron selecteert u Azure-opslagplaatsen. Als de buildserviceprovider voor App Service niet de standaardinstelling is, selecteert u Wijzig provider, selecteert u App Service-buildservice en selecteert u OK.

3. Selecteer waarden voor organisatie, project, opslagplaats en vertakking. Alleen organisaties die deel uitmaken van uw Azure-account, worden weergegeven.

4. Selecteer Opslaan om de webhook in uw opslagplaats te maken.

GitHub

1. Ga naar uw functie-app in Azure Portal en selecteer Deployment Center.

2. Voor Bron, selecteer GitHub. Als de buildserviceprovider voor App Service niet de standaardinstelling is, selecteert u Wijzig provider, selecteert u App Service-buildservice en selecteert u OK.

3. Als uw GitHub-toegang nog niet is geautoriseerd, selecteert u Autoriseren. Geef uw GitHub-referenties op en selecteer Aanmelden. Als u een ander GitHub-account wilt autoriseren, selecteert u Account wijzigen en meldt u zich aan met een ander account.

4. Selecteer waarden voor Organisatie, Repository en Branch. De waarden zijn gebaseerd op de locatie van uw code.

5. Bekijk alle details en selecteer Opslaan. De dienst plaatst een webhook in je gekozen repository.

Wanneer je een nieuwe commit naar de geselecteerde branch pusht, haalt de service je code op, bouwt je applicatie en deployt deze naar je functie-app.

Bitbucket

1. Ga naar uw functie-app in Azure Portal en selecteer Deployment Center.

2. Selecteer Bitbucket als bron.

3. Als je nog geen toegang tot Bitbucket hebt goedgekeurd, selecteer dan Autoriseren en vervolgens Toegang verlenen. Geef, indien aangevraagd, uw Bitbucket-referenties op en selecteer Aanmelden. Als u een ander Bitbucket-account moet autoriseren, selecteert u Account wijzigen en meldt u zich aan met een ander account.

4. Selecteer waarden voor Organisatie, Repository en Branch. De waarden zijn gebaseerd op de locatie van uw code.

5. Bekijk alle details en selecteer Opslaan. De dienst plaatst een webhook in je gekozen repository.

Wanneer je een nieuwe commit naar de geselecteerde branch pusht, haalt de service je code op, bouwt je applicatie en deployt deze naar je functie-app.

Lokale Git

1. Ga naar uw functie-app in Azure Portal en selecteer Deployment Center.

2. Voor Bron selecteert u Lokale Git en selecteert u Opslaan.

3. Je maakt een lokale repository aan in je bestaande App Service-plan, die je vanaf de deploymentsite kunt openen. Kopieer de Git-kloon-URI en gebruik deze om een kloon van deze nieuwe opslagplaats op uw lokale computer te maken.

Wanneer je een nieuwe commit naar de Local Git-repository pusht, haalt de service je code op, bouwt je applicatie en deployt deze naar je functie-app.

Na de deployment deployt de service alle code van de opgegeven bron naar je app. Op dat moment activeren wijzigingen in de implementatiebron een implementatie van deze wijzigingen in uw functie-app in Azure.

Configureer continue deployment in je repository door een van deze providers te gebruiken:

• Continue levering met Azure-pipelines
• Continue levering met GitHub Actions

Elke succesvolle workflowuitvoering deployt een nieuw applicatiepakket. Integratie van versiebeheer in Implementatiecentrum is niet beschikbaar voor Flex Consumption.

Configureer je CI/CD-workflow om de containerimage te bouwen en te pushen, en deploy de image vervolgens naar je functie-app. Elke image-update maakt een Container Apps-revisie. Voor meer informatie, zie Deploy to Azure Container Apps with GitHub Actions.

Continue implementatie inschakelen tijdens het maken van apps

Wanneer je een functie-app maakt in het Azure-portaal, kun je continue uitrol configureren vanaf GitHub met behulp van GitHub Actions. Configureer GitHub Actions op het tabblad Deployment van de pagina Create Function App.

Om een andere deployment source of build provider te gebruiken voor continue integratie, maak eerst je functie-app. Ga daarna terug naar het portaal en stel continue integratie in in het Deployment Center.

Voor Azure-pipelines maak je eerst je functieapp aan en configureer je daarna de pipeline in Azure DevOps.

Maak de functie-app aan vanuit een containerimage en configureer vervolgens je CI/CD-workflow om bijgewerkte images te publiceren en revisies te maken. Voor meer informatie, zie Create a function app on Azure Container Apps.

Basisverificatie inschakelen voor implementaties

Deze sectie geldt alleen voor deployment-methoden die gebruikmaken van het App Service-deployment-endpoint.

In sommige gevallen wordt je functie-app aangemaakt waarbij toegang via basisverificatie tot het deployment-eindpunt is uitgeschakeld. Deze voorwaarde blokkeert publiceren via alle methoden die geen Microsoft Entra-identiteiten kunnen gebruiken om toegang te krijgen tot het implementatie-endpoint. De publicatie-effecten van het uitschakelen van basisauthenticatie voor het deployment-endpoint worden beschreven in Deploy zonder basisauthenticatie.

Belangrijk

Wanneer u basisverificatie gebruikt, worden inloggegevens als platte tekst verzonden. Om deze inloggegevens te beschermen, mag je alleen toegang krijgen tot het deployment-eindpunt via een versleutelde verbinding (HTTPS) wanneer je basisauthenticatie gebruikt. Zie Secure deployment voor meer informatie.

Om basisauthenticatie voor het deployment-endpoint mogelijk te maken:

Azure-portal

1. Ga in Azure Portal naar uw functie-app.

2. Selecteer inhet linkermenu van de app>>algemene instellingen.

3. Stel SCM Basic Auth Publishing Credentials in op Aan en selecteer Opslaan.

Azure-CLI

Gebruik Azure CLI om basisauthenticatie in te schakelen. Voer het az resource update commando uit om de resource die het deployment-eindpunt aanstuurt bij te werken.

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

Vervang in deze opdracht de tijdelijke aanduidingen door de naam van uw resourcegroep en de naam van de app.

SCM basisauthenticatie is niet van toepassing op Flex Consumption-pakketimplementaties. Standaard gebruikt Azure-pipelines een Microsoft Entra-bearertoken via de vereiste Azure-serviceverbinding; federatie van workloadidentiteiten wordt aanbevolen. Voor GitHub Actions gebruik je de aanbevolen OpenID Connect (OIDC) authenticatie. Deze methoden vermijden het publiceren van SCM-credentials en zijn veiliger dan basisauthenticatie.

Deze basisauthenticatie-instelling geldt niet voor Functions in Azure Container Apps. Configureer authenticatie tussen je CI/CD-provider, containerregister en container-app.

Volgende stappen

Aanbevolen procedures voor Azure Functions