Kommentar
Åtkomst till den här sidan kräver auktorisering. Du kan prova att logga in eller ändra kataloger.
Åtkomst till den här sidan kräver auktorisering. Du kan prova att ändra kataloger.
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
- Skapar imagen lokalt eller via fjärranslutning eller identifierar den konfigurerade förbyggda imagen.
- Publicerar avbilden till den ACR-instans som konfigurerats för projektet när publicering krävs.
- Uppdaterar funktionsappens
linuxFxVersiontillDOCKER|<image>. - 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 |