Distribuera till Azure Functions med Azure Developer CLI

Azure Developer CLI (azd) stöder kod- och containerdistributioner till Azure Functions. Använd den dedikerade function värden i azure.yaml för båda lägena:

  • Koddistribution paketerar din inbyggda funktionskod som ett zip-arkiv och laddar upp den till funktionsappen.
  • Containerdistribution skapar eller hämtar en containeravbildning, publicerar den till Azure Container Registry (ACR) vid behov och uppdaterar funktionsappen för att köra avbildningen.

Azure Functions och Azure App Service använder båda Microsoft.Web/sites resursprovider, och deras containerdistributionsflöden har vissa interna mekanismer gemensamt. De finns dock inte på samma azd värd. Functions använder host: function, har funktionsspecifik paketering och fjärrbyggsbeteende och använder inte arbetsflödet för App Service-distributionsfack.

Välj ett distributionssätt

azd väljer distributionsläge i tjänstkonfigurationen:

Configuration Distributionsläge
En källa project med en icke-Docker language som stöds och ingen docker.path Driftsättning av kod
language: docker Containerdriftsättning
Ett docker.path värde med ett källspråk Containerdriftsättning
En fördefinierad image Containerdriftsättning

Den provisionerade funktionsappen måste använda samma läge som tjänstkonfigurationen. Om funktionsappen är konfigurerad för containrar men azure.yaml väljer koddistribution, eller tvärtom, stoppar azd deploy innan uppladdning och rapporterar avvikelsen.

Distribuera kod för funktioner

Konfigurera en kodbaserad funktionstjänst med ett källprojekt, språk som stöds och host: function:

services:
  api:
    project: ./src/api
    language: ts
    host: function

Vid azd deploy bygger azd projektet, tillämpar .funcignore undantag, skapar ett zip-arkiv och laddar upp paketet via Azure Functions-distributions-API:et.

Din Bicep eller Terraform måste etablera en kodbaserad funktionsapp och tagga den med azd-service-name inställt på tjänstnamnet, såvida du inte identifierar resursen med hjälp av resourceName i azure.yaml. Konfigurera värdplanen, körningsmiljö, lagring, identiteter, nätverk och programinställningar via infrastruktur som kod.

Konfigurera fjärrbyggen för kodutrullningar

Den översta tjänstegenskapen remoteBuild gäller endast för kodbaserade Function Apps i Flex Consumption-planen. Den styr om Azure Functions använder Oryx för att skapa det uppladdade paketet:

services:
  api:
    project: ./src/api
    language: python
    host: function
    remoteBuild: true

När du utelämnar remoteBuild i Flex Consumption väljer azd ett standardvärde baserat på språket och paketinnehållet:

Language Standardbeteende
JavaScript eller TypeScript Använder fjärrbygge när .funcignore exkluderar node_modules, eller när det inte finns någon .funcignore fil. I annat fall används det lokalt byggda paketet.
Python Använder fjärrkompilering.
Go Bygger lokalt. Go Function Apps stöder inte fjärrbygge.
Andra språk som stöds Använder det lokalt byggda paketet.

För JavaScript och TypeScript måste ett explicit konfigurerat remoteBuild värde överensstämma med .funcignore när den filen finns. Ange remoteBuild: true när .funcignore exkluderar node_modules. Ange remoteBuild: false när .funcignore innehåller node_modules i paketet.

Ange inte egenskapen på den översta nivån remoteBuild för icke-Flex-planer. Om du vill aktivera ett Oryx-bygge på en annan plan som stöds konfigurerar du ENABLE_ORYX_BUILD=true och SCM_DO_BUILD_DURING_DEPLOYMENT=true som funktionsappinställningar i infrastrukturen.

Distribuera en containerbaserad funktion

För ett källprojekt med en Dockerfile anger du language: dockereller behåller källspråket och anger docker.path.

I följande exempel används ett TypeScript-projekt med en Dockerfile:

services:
  api:
    project: ./src/api
    language: ts
    host: function
    docker:
      path: ./Dockerfile

Du kan också distribuera en förbyggd avbild utan ett lokalt projekt:

services:
  api:
    host: function
    image: myregistry.azurecr.io/functions/api:1.0

För en förbyggd avbild, utelämna language eller ställ in den på docker. Kombinera image inte med project.

Under en containerdriftsättning: azd

  1. Skapar imagen lokalt eller via fjärranslutning eller identifierar den konfigurerade förbyggda imagen.
  2. Publicerar avbilden till den ACR-instans som konfigurerats för projektet när publicering krävs.
  3. Uppdaterar funktionsappens linuxFxVersion till DOCKER|<image>.
  4. Distribueras till huvudwebbplatsen för funktionsappen.

Egenskapen för tjänsten på högsta nivån remoteBuild gäller inte för containrar. Om du vill skapa en containeravbildning med ACR Tasks använder du docker.remoteBuild:

services:
  api:
    project: ./src/api
    language: docker
    host: function
    docker:
      path: ./Dockerfile
      remoteBuild: true

Skapa en containerfärdig Function App

azd deploy uppdaterar avbildningsreferensen men konverterar inte en kodbaserad funktionsapp till en containerbaserad funktionsapp. Infrastrukturen måste etablera en kompatibel webbplats innan driftsättning.

Krav Details
Linux Function App Etablera en Linux-funktionsapp på en Azure Functions Premium- eller Dedikerad (App Service)-plan. Flex Consumption stöder inte anpassade containrar. Det här host: function arbetsflödet riktar sig till Microsoft.Web/sites, inte Azure Functions som finns på Azure Container Apps.
Konfiguration av containerwebbplats Ange webbplatstyp så att den innehåller functionapp, linuxoch container. Initiera linuxFxVersion med värdet DOCKER\|<image>. En platshållarbild räcker eftersom azd deploy ersätter den.
Container-registertjänst För källversioner etablerar du en ACR-instans och exponerar dess inloggningsserver via infrastrukturutdata för AZURE_CONTAINER_REGISTRY_ENDPOINT, eller konfigurerar docker.registry för tjänsten. Ett fullständigt kvalificerat färdigbyggt image kan användas direkt utan en separat publiceringstjänst.
Registeråtkomst Ge den identitet som publicerar avbilden behörighet att pusha till målregistret när publicering krävs. Konfigurera Function App separat för att hämta den distribuerade containeravbildningen. För privata ACR-avbilder beviljar du funktionsappens hanterade identitet pull-åtkomst och konfigurerar webbplatsen så att den använder autentiseringsuppgifter för hanterad identitet. För ett annat privat registry konfigurerar du lämpliga pull-autentiseringsuppgifter i infrastrukturen.
Funktionsinställningar Konfigurera nödvändiga inställningar som FUNCTIONS_EXTENSION_VERSION, FUNCTIONS_WORKER_RUNTIMEoch AzureWebJobsStorage via Bicep eller Terraform.
Resursupptäckning Använd en azd-service-name tagg vars värde matchar tjänstnamnet i azure.yamleller ange resourceName explicit.

Inställningar på tjänstnivå env stöds inte för function värdenheten. Definiera inställningarna för funktionsappen i infrastrukturen i stället.

Förstå distributionsplatser

azd driftsätter alltid en function tjänst på huvudwebbplatsen för funktionsappen. Den identifierar inte, frågar inte efter eller distribuerar inte till Function App-platser. Inställningar för App Service-kortplatser, till exempel AZD_DEPLOY_{SERVICE}_SLOT_NAME, påverkar inte distributionen av funktionsappen.

Om du behöver en slot-baserad releaseprocess för Functions hanterar du sloten och distributionen utanför det inbyggda host: function arbetsflödet.

Jämför Azure Functions- och App Service-värdar

Functions och App Service delar Microsoft.Web/sites resurstypen, men välj den värd som matchar arbetsbelastningen:

Behavior function värd appservice värd
Arbetsbörda Händelsedriven Azure Functions Webbappar och API:er
Driftsättning av kod Använder zipdistributionsflödet för Azure Functions Använder App Service-distributionsflödet
Containerdriftsättning Uppdaterar funktionsappavbildningen efter validering av att webbplatsen är containerbaserad Uppdaterar webbappsavbildningen efter validering av att webbplatsen är containerklar
Fjärrbyggning av kod Stöder servicenivåalternativet remoteBuild för Function Apps med Flex Consumption Använder inte alternativet Functions remoteBuild
Implementeringsplatser Distribueras alltid till huvudwebbplatsen Stöder arbetsflödet för azd App Service-distributionsplatser
Servicenivå env Stöds inte; använd funktionsappinställningar i infrastrukturen Konfigurera appinställningar i infrastrukturen