Doorlopende implementatie voor Azure Functions

Met Azure Functions kunt u continu de wijzigingen in een opslagplaats voor broncodebeheer implementeren in een verbonden functie-app. Deze integratie van broncodebeheer maakt een werkstroom mogelijk waarin een code-update build, verpakking en implementatie activeert van uw project naar Azure.

U moet altijd continue implementatie configureren voor een staging-site en niet voor de productiesite. Wanneer u de productiesite gebruikt, worden code-updates rechtstreeks naar productie gepusht zonder te worden geverifieerd in Azure. Schakel in plaats daarvan continue implementatie in naar een staging-site, controleer updates in de staging-site en nadat alles correct wordt uitgevoerd, kunt u de staging-sitecode in productie wisselen. Als u verbinding maakt met een productiesite, moet u ervoor zorgen dat alleen code van productiekwaliteit deze in de geïntegreerde codevertakking maakt.

Stappen in dit artikel laten zien hoe u continue code-implementaties configureert voor uw functie-app in Azure met behulp van het Implementatiecentrum in Azure Portal. U kunt ook continue integratie configureren met behulp van de Azure CLI. Deze stappen kunnen zich richten op een fasering of een productiesite.

Functions ondersteunt deze bronnen voor continue implementatie in uw app:

Azure-opslagplaatsen

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. Zie Wat is Azure-opslagplaatsen voor meer informatie ?

GitHub

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

GitHub is de enige bron voor continue implementatie die wordt ondersteund voor apps die worden uitgevoerd op Linux in een verbruiksabonnement, waaronder serverloze Python-apps.

Bitbucket

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

Lokale Git

Onderhoud uw projectcode in een toegewezen Git-server die wordt gehost in hetzelfde App Service-plan met uw functie-app. Vereist de App Service-buildprovider. Zie Lokale Git-implementatie voor Azure-app Service voor meer informatie.

U kunt uw functie-app ook verbinden met een externe Git-opslagplaats, maar hiervoor is handmatige synchronisatie vereist. 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. Zie Continue implementatie van containers van containers naar Azure inschakelen voor implementaties van functie-apps in containers.

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 u uw codeproject maakt met behulp van Azure Functions Core Tools, Visual Studio Code of Visual Studio, worden de Azure Functions-sjablonen gebruikt om codeprojecten te maken met de juiste mapstructuur. Alle functies in een functie-app worden tegelijkertijd en in hetzelfde pakket geïmplementeerd.

Nadat u continue implementatie hebt ingeschakeld, wordt de toegang tot functiecode in Azure Portal geconfigureerd als alleen-lezen omdat de bron van waarheid ergens anders staat.

Notitie

Het Implementatiecentrum biedt geen ondersteuning voor het inschakelen van continue implementatie voor een functie-app met binnenkomende netwerkbeperkingen. U moet in plaats daarvan de werkstroom van de buildprovider rechtstreeks configureren in GitHub of Azure Pipelines. Voor deze werkstromen moet u ook een virtuele machine in hetzelfde virtuele netwerk gebruiken als de functie-app als een zelf-hostende agent (pijplijnen) of een zelf-hostende runner (GitHub).

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. Builds kunnen lokaal of extern worden uitgevoerd, afhankelijk van uw specifieke hosting. Zie Remote build voor meer informatie.

Belangrijk

Voor betere beveiliging kunt u overwegen een buildprovider te gebruiken die beheerde identiteiten ondersteunt, waaronder Azure Pipelines en Gitub Actions. Voor de App Service-service (Kudu) moet u basisverificatie inschakelen en werken met referenties op basis van tekst.

Functions ondersteunt deze buildproviders:

Azure Pipelines

Azure Pipelines is een van de services in Azure DevOps en de standaardbuildprovider voor Azure-opslagplaatsprojecten. U kunt pijplijnen ook gebruiken om projecten te bouwen vanuit GitHub. In Pijplijnen 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. Ondersteunt beheerde identiteiten.

GitHub Actions

GitHub Actions is de standaard buildprovider voor GitHub-projecten. GitHub Actions biedt u controle over hoe het project wordt gebouwd, verpakt en geïmplementeerd. Ondersteunt beheerde identiteiten.

App Service-service (Kudu)

Het App Service-platform onderhoudt een systeemeigen implementatieservice (Project Kudu) ter ondersteuning van lokale Git-implementatie, sommige containerimplementaties en andere implementatiebronnen die niet worden ondersteund door Pijplijnen of GitHub Actions. Externe builds, pakketten en andere onderhoudstaken worden uitgevoerd in een subdomein van scm.azurewebsites.net toegewezen aan uw app, zoals https://myfunctionapp.scm.azurewebsites.net. Deze buildservice kan alleen worden gebruikt wanneer de scm site toegankelijk is voor uw implementatie. Hoewel u identiteiten kunt gebruiken om verbinding te maken met het scm eindpunt, vereisen veel publicatiehulpprogramma's in plaats daarvan basisverificatie om verbinding te maken met het scm eindpunt.

Deze buildprovider wordt gebruikt wanneer u uw codeproject implementeert met behulp van Visual Studio, Visual Studio Code of Azure Functions Core Tools. Als u nog geen code hebt geïmplementeerd in uw functie-app met behulp van een van deze hulpprogramma's, moet u mogelijk basisverificatie inschakelen voor implementaties om de scm site te kunnen gebruiken.

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.

Continue implementatie inschakelen

Azure Portal biedt een implementatiecentrum voor uw functie-apps, waardoor het eenvoudiger is om continue implementatie te configureren. 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-opslagplaatsen

Implementaties van Azure-opslagplaatsen die gebruikmaken van Azure Pipelines worden gedefinieerd in de Azure DevOps-portal en niet vanuit uw functie-app. Zie Continue levering met Azure Pipelines voor een stapsgewijze handleiding voor het maken van een implementatie op basis van pijplijnen vanuit Azure-opslagplaatsen.

GitHub

Implementaties van GitHub die gebruikmaken van Azure Pipelines, worden gedefinieerd in de Azure DevOps-portal en niet vanuit uw functie-app. Zie Continue levering met Azure Pipelines voor een stapsgewijze handleiding voor het maken van een implementatie op basis van pijplijnen vanuit GitHub.

Bitbucket

U kunt niet implementeren vanuit Bitbucket met behulp van Azure Pipelines. Kies in plaats daarvan de App Service-buildprovider.

Lokale Git

U kunt niet implementeren vanuit lokale git met behulp van Azure Pipelines. Kies in plaats daarvan de App Service-buildprovider.

Azure-opslagplaatsen

U kunt niet implementeren vanuit Azure-opslagplaatsen met behulp van GitHub Actions. Kies een andere buildprovider.

GitHub

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

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

2. Selecteer GitHub als bron. Als u het standaardbericht Building met GitHub Actions niet ziet, selecteert u Change provider choose GitHub Actions en selecteert u OK.

3. Als u nog geen geautoriseerde GitHub-toegang hebt, 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 uw GitHub-organisatie, -opslagplaats en -vertakking. Als u wilt implementeren met GitHub Actions, moet u schrijftoegang hebben tot deze opslagplaats.

5. Kies in verificatie-instellingen of GitHub Actions moeten worden geverifieerd met een door de gebruiker toegewezen identiteit of met behulp van basisverificatiereferenties . Voor basisverificatie worden de huidige referenties gebruikt.

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

7. Selecteer Opslaan om het werkstroombestand toe te voegen aan uw opslagplaats.

Zie Continue levering met behulp van GitHub Actions voor meer informatie over Implementaties van GitHub Action, waaronder andere manieren om het configuratiebestand voor werkstromen te genereren.

Bitbucket

U kunt niet implementeren vanuit Bitbucket met behulp van GitHub Actions. Kies in plaats daarvan de App Service-buildprovider.

Lokale Git

U kunt niet implementeren vanuit lokale Git met behulp van GitHub Actions. Kies in plaats daarvan de App Service-buildprovider.

Azure-opslagplaatsen

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

2. Voor Bron selecteert u Azure-opslagplaatsen. Als de Service-serviceprovider voor App Service-build niet de standaardwaarde is, selecteert u De provider wijzigen, kiest u de 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. Navigeer naar uw functie-app in Azure Portal en selecteer Deployment Center.

2. Selecteer GitHub als bron. Als de Service-serviceprovider voor App Service-build niet de standaardwaarde is, selecteert u De provider wijzigen, kiest u de App Service-buildservice en selecteert u OK.

3. Als u nog geen geautoriseerde GitHub-toegang hebt, 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, opslagplaats en vertakking. De waarden zijn gebaseerd op de locatie van uw code.

5. Bekijk alle details en selecteer Opslaan. Er wordt een webhook in uw gekozen opslagplaats geplaatst.

Wanneer een nieuwe doorvoering naar de geselecteerde vertakking wordt gepusht, haalt de service uw code op, bouwt de toepassing en implementeert deze in uw functie-app.

Bitbucket

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

2. Selecteer Bitbucket voor bron.

3. Als u nog geen geautoriseerde Bitbucket-toegang hebt, selecteert u 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, opslagplaats en vertakking. De waarden zijn gebaseerd op de locatie van uw code.

5. Bekijk alle details en selecteer Opslaan. Er wordt een webhook in uw gekozen opslagplaats geplaatst.

Wanneer een nieuwe doorvoering naar de geselecteerde vertakking wordt gepusht, haalt de service uw code op, bouwt de toepassing en implementeert deze in uw functie-app.

Lokale Git

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

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

3. Er wordt een lokale opslagplaats gemaakt in uw bestaande App Service-plan, dat toegankelijk is vanuit het scm domein. Kopieer de Git-kloon-URI en gebruik deze om een kloon van deze nieuwe opslagplaats op uw lokale computer te maken.

Wanneer een nieuwe doorvoering naar de lokale Git-opslagplaats wordt gepusht, haalt de service uw code op, bouwt de toepassing en implementeert deze in uw functie-app.

Nadat de implementatie is voltooid, wordt alle code van de opgegeven bron geïmplementeerd in uw app. Op dat moment activeren wijzigingen in de implementatiebron een implementatie van deze wijzigingen in uw functie-app in Azure.

Continue implementatie inschakelen tijdens het maken van apps

Op dit moment kunt u continue implementatie vanuit GitHub configureren met behulp van GitHub Actions wanneer u uw functie-app maakt in Azure Portal. U kunt dit doen op het tabblad Implementatie op de pagina Functie-app maken.

Als u een andere implementatiebron of buildprovider wilt gebruiken voor continue integratie, maakt u eerst uw functie-app en gaat u terug naar de portal en stelt u continue integratie in het Deployment Center in.

Basisverificatie inschakelen voor implementaties

In sommige gevallen wordt uw functie-app gemaakt met basisverificatietoegang tot het scm eindpunt uitgeschakeld. Hiermee blokkeert u het publiceren op alle methoden die geen beheerde identiteiten kunnen gebruiken voor toegang tot het scm eindpunt. De publicatie-effecten van het uitschakelen van het scm eindpunt worden beschreven in Implementatie zonder basisverificatie.

Belangrijk

Wanneer u basisverificatie gebruikt, worden referenties verzonden in duidelijke tekst. Als u deze referenties wilt beveiligen, moet u alleen toegang krijgen tot het scm eindpunt via een versleutelde verbinding (HTTPS) wanneer u basisverificatie gebruikt. Zie Secure deployment voor meer informatie.

Basisverificatie voor het scm eindpunt inschakelen:

Azure-portal

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

2. Selecteer in het linkermenu van de app Instellingenconfiguratie>>algemene instellingen.

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

Azure-CLI

U kunt de Azure CLI gebruiken om basisverificatie in te schakelen met behulp van deze az resource update opdracht om de resource bij te werken waarmee het scm eindpunt wordt beheerd.

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.

Volgende stappen

Aanbevolen procedures voor Azure Functions