Doorlopende implementatie voor Azure Functions

U kunt Azure Functions gebruiken om uw code continu te implementeren met behulp van broncodebeheerintegratie. Integratie van broncodebeheer maakt een werkstroom mogelijk waarin een code-update build, verpakking en implementatie activeert van uw project naar Azure.

Continue implementatie is een goede optie voor projecten waarbij u meerdere en frequente bijdragen integreert. Wanneer u continue implementatie gebruikt, onderhoudt u één bron van waarheid voor uw code, zodat teams eenvoudig kunnen samenwerken.

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.

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 Build-provider 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

Voor een geslaagde continue implementatie moet uw mapstructuur compatibel zijn met de basismapstructuur die Azure Functions verwacht.

De code voor alle functies in een specifieke functie-app bevindt zich in een hoofdprojectmap die een hostconfiguratiebestand bevat. Het bestand host.json bevat runtimespecifieke configuraties en bevindt zich in de hoofdmap van de functie-app. Een bin-map bevat pakketten en andere bibliotheekbestanden die de functie-app nodig heeft. Specifieke mapstructuren die voor de functie-app zijn vereist, zijn afhankelijk van de taal:

• C#
• Java
• JavaScript
• TypeScript
• Powershell
• Python

Alle functies in de functie-app moeten dezelfde taalstack delen.

Providers bouwen

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.

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.

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.

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. Voor veel publicatiehulpprogramma's is basisverificatie vereist om verbinding te maken met het scm eindpunt. Zie Basisverificatie inschakelen voor implementaties voor meer informatie.

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 niet hebt geïmplementeerd met behulp van een van deze hulpprogramma's, moet u mogelijk basisverificatie inschakelen op het SCM-eindpunt.

Welke van deze buildproviders u kunt gebruiken, is afhankelijk van de specifieke bron van de code-implementatie.

Implementatiecentrum

Azure Portal biedt een implementatiecentrum voor uw functie-apps, waardoor het eenvoudiger is om continue implementatie te configureren. De manier waarop u continue implementatie configureert, is afhankelijk van het specifieke 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.

Overwegingen

Houd rekening met deze overwegingen bij het plannen van een strategie voor continue implementatie:

• GitHub is de enige bron die momenteel ondersteuning biedt voor continue implementatie voor Linux-apps die worden uitgevoerd in een verbruiksabonnement. Dit is een populaire hostingoptie voor Python-apps.

• De implementatie-eenheid voor functies in Azure is de functie-app. 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 waarheidergens anders staat.

• 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.

• 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).

Continue implementatie 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

Standaard 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 configuratie-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