Utvecklarguide för Azure Functions

I Azure Functions delar vissa funktioner några grundläggande tekniska begrepp och komponenter, oavsett vilket språk eller bindning du använder. Innan du börjar lära dig information som är specifik för ett visst språk eller en viss bindning måste du läsa igenom den här översikten som gäller för alla.

Den här artikeln förutsätter att du redan har läst Azure Functions översikt.

Funktionskod

En funktion är det primära konceptet i Azure Functions. En funktion innehåller två viktiga delar – din kod, som kan skrivas på flera olika språk och en del config, filen function.json. För kompilerade språk genereras den här konfigurationsfilen automatiskt från anteckningar i koden. För skriptspråk måste du ange konfigurationsfilen själv.

Filen function.json definierar funktionens utlösare, bindningar och andra konfigurationsinställningar. Varje funktion har endast en utlösare. Körningen använder den här konfigurationsfilen för att fastställa de händelser som ska övervakas och hur data ska överföras till och returnera data från en funktionskörning. Följande är ett exempel på en function.json-fil.

{
    "disabled":false,
    "bindings":[
        // ... bindings here
        {
            "type": "bindingType",
            "direction": "in",
            "name": "myParamName",
            // ... more depending on binding
        }
    ]
}

Mer information finns i Azure Functions utlösare och bindningar.

Egenskapen bindings är den plats där du konfigurerar både utlösare och bindningar. Varje bindning delar några vanliga inställningar och vissa inställningar som är specifika för en viss typ av bindning. Varje bindning kräver följande inställningar:

Funktionsapp

En funktionsapp tillhandahåller en körningskontext i Azure där dina funktioner körs. Därför är det distributions- och hanteringsenheten för dina funktioner. En funktionsapp består av en eller flera enskilda funktioner som hanteras, distribueras och skalas tillsammans. Alla funktioner i en funktionsapp delar samma prisplan, distributionsmetod och körningsversion. Tänk på en funktionsapp som ett sätt att organisera och gemensamt hantera dina funktioner. Mer information finns i Hantera en funktionsapp.

Mappstrukturen

Koden för alla funktioner i en specifik funktionsapp finns i en rotprojektmapp som innehåller en värdkonfigurationsfil. Filen host.jsinnehåller körningsspecifika konfigurationer och finns i funktionsappens rotmapp. En bin-mapp innehåller paket och andra biblioteksfiler som funktionsappen kräver. Specifika mappstrukturer som krävs av funktionsappen beror på språk:

• C#-kompilerad (.csproj)
• C#-skript (.csx)
• F#-skript
• Java
• JavaScript
• Python

I version 2.x och senare av Functions-körningen måste alla funktioner i funktionsappen dela samma språkstack.

Ovanstående är standardmappstrukturen (och rekommenderas) för en funktionsapp. Om du vill ändra filplatsen för en funktions kod ändrar du avsnittet scriptFile i filen function.json. Vi rekommenderar också att du använder paketdistribution för att distribuera ditt projekt till funktionsappen i Azure. Du kan också använda befintliga verktyg som kontinuerlig integrering och distribution och Azure DevOps.

Använda lokala verktyg och publicering

Funktionsappar kan redigeras och publiceras med en mängd olika verktyg, inklusive Visual Studio, Visual Studio Code, IntelliJ, Eclipse och Azure Functions Core Tools. Mer information finns i Koda och testa Azure Functions lokalt.

Redigera funktioner i Azure Portal

Med Funktionsredigeraren som är inbyggd i Azure Portal kan du uppdatera din kod och din function.json-fil direkt infogade. Detta rekommenderas endast för små ändringar eller konceptbevis – bästa praxis är att använda ett lokalt utvecklingsverktyg som VS Code.

Parallell körning

När flera utlösande händelser inträffar snabbare än en enkeltrådig funktionskörning kan bearbeta dem, kan körningen anropa funktionen flera gånger parallellt. Om en funktionsapp använder värdplanen Förbrukningkan funktionsappen skalas ut automatiskt. Varje instans av funktionsappen, oavsett om appen körs på förbrukningsvärdplanen eller en vanlig App Service-värdplan,kan bearbeta samtidiga funktionsanrop parallellt med hjälp av flera trådar. Det maximala antalet samtidiga funktionsanrop i varje funktionsappinstans varierar beroende på vilken typ av utlösare som används samt de resurser som används av andra funktioner i funktionsappen.

Versionshantering för Functions-körning

Du kan konfigurera versionen av Functions-körningen med hjälp av FUNCTIONS_EXTENSION_VERSION appinställningen. Värdet "~3" anger till exempel att funktionsappen kommer att använda 3.x som huvudversion. Funktionsappar uppgraderas till varje ny delversion när de släpps. Mer information, inklusive hur du visar den exakta versionen av funktionsappen, finns i How to target Azure Functions runtime versions.

Centrallager

Koden för Azure Functions är öppen källkod och lagras GitHub lagringsplatsen:

• Azure Functions
• Azure Functions värd
• Azure Functions portal
• Azure Functions mallar
• Azure WebJobs SDK
• Azure WebJobs SDK-tillägg

Bindningar

Här är en tabell med alla bindningar som stöds.

Den här tabellen visar de bindningar som stöds i de större versionerna av Azure Functions runtime:

¹ Från och med version 2.x-körningen måste alla bindningar utom HTTP och Timer registreras. Se Registrera bindningstillägg.

² Utlösare stöds inte i förbrukningsplanen. Kräver körningsdrivna utlösare.

³ Stöds endast i Kubernetes, IoT Edge och andra lägen med egen värd.

Har du problem med fel som kommer från bindningarna? Läs dokumentationen Azure Functions om bindningsfelkoder.

Anslutningar

Funktionsprojektet refererar till anslutningsinformation efter namn från dess konfigurationsprovider. Anslutningsinformationen godkänns inte direkt, vilket gör att de kan ändras mellan miljöer. En utlösardefinition kan till exempel innehålla en connection -egenskap. Detta kan referera till en anslutningssträng, men du kan inte ange anslutningssträngen direkt i en function.json . I stället skulle du ange connection namnet på en miljövariabel som innehåller anslutningssträngen.

Standardkonfigurationsprovidern använder miljövariabler. Dessa kan anges av Program Inställningar när de körs i Azure Functions-tjänsten eller från den lokala inställningsfilen när du utvecklar lokalt.

Anslutningsvärden

När anslutningsnamnet matchas till ett enda exakt värde identifierar körningen värdet som en anslutningssträng , som vanligtvis innehåller en hemlighet. Information om en anslutningssträng definieras av den tjänst som du vill ansluta till.

Ett anslutningsnamn kan dock även referera till en samling med flera konfigurationsobjekt, vilket är användbart för att konfigurera identitetsbaserade anslutningar. Miljövariabler kan behandlas som en samling med hjälp av ett delat prefix som slutar med dubbla understreck __ . Du kan sedan referera till gruppen genom att ange anslutningsnamnet till det här prefixet.

Egenskapen för en connection Azure Blob-utlösardefinition kan till exempel vara "Storage1". Så länge det inte finns något enskilt strängvärde som konfigurerats av en miljövariabel med namnet "Storage1" kan en miljövariabel med namnet användas för att informera egenskapen Storage1__blobServiceUri blobServiceUri för anslutningen. Anslutningsegenskaperna är olika för varje tjänst. Läs dokumentationen för komponenten som använder anslutningen.

Konfigurera en identitetsbaserad anslutning

Vissa anslutningar i Azure Functions konfigureras för att använda en identitet i stället för en hemlighet. Stödet beror på tillägget med hjälp av anslutningen. I vissa fall kan en anslutningssträng fortfarande krävas i Functions, även om tjänsten som du ansluter till stöder identitetsbaserade anslutningar. En självstudiekurs om hur du konfigurerar funktionsappar med hanterade identiteter finns i självstudien Skapa en funktionsapp med identitetsbaserade anslutningar.

Identitetsbaserade anslutningar stöds av följande komponenter:

När identitetsbaserade anslutningar Azure Functions i tjänsten använder de en hanterad identitet. Den system tilldelade identiteten används som standard, även om en användar tilldelad identitet kan anges med credential egenskaperna clientID och . När den körs i andra kontexter, till exempel lokal utveckling, används din utvecklaridentitet i stället, även om detta kan anpassas. Se Lokal utveckling med identitetsbaserade anslutningar.

Bevilja behörighet till identiteten

Den identitet som används måste ha behörighet att utföra de avsedda åtgärderna. Du måste tilldela en roll i Azure RBACmed hjälp av inbyggda eller anpassade roller som ger dessa behörigheter.

Välj en flik nedan om du vill veta mer om behörigheter för varje komponent:

Vanliga egenskaper för identitetsbaserade anslutningar

En identitetsbaserad anslutning för en Azure-tjänst accepterar följande vanliga egenskaper, där är värdet för din egenskap i <CONNECTION_NAME_PREFIX> connection utlösar- eller bindningsdefinitionen:

Ytterligare alternativ kan stödjas för en viss anslutningstyp. Läs dokumentationen för komponenten som upprättar anslutningen.

Lokal utveckling med identitetsbaserade anslutningar

När du kör lokalt anger ovanstående konfiguration att körningen ska använda din lokala utvecklaridentitet. Anslutningen försöker hämta en token från följande platser i ordning:

• En lokal cache som delas mellan Microsoft-program
• Den aktuella användarkontexten i Visual Studio
• Den aktuella användarkontexten i Visual Studio Code
• Den aktuella användarkontexten i Azure CLI

Om inget av dessa alternativ lyckas uppstår ett fel.

Eftersom detta använder din utvecklaridentitet kanske du redan har vissa roller mot utvecklingsresurser, men de kanske inte ger dataåtkomst. Hanteringsroller som Ägare räcker inte. Dubbelkolla vilka behörigheter som krävs för anslutningar för varje komponent och se till att du har dem tilldelade till dig själv.

I vissa fall kanske du vill ange användning av en annan identitet. Du kan lägga till konfigurationsegenskaper för anslutningen som pekar på den alternativa identiteten baserat på ett klient-ID och en klienthemlighet för Azure Active Directory tjänstens huvudnamn. Det här konfigurationsalternativet stöds inte när det finns i Azure Functions tjänsten. Om du vill använda ett ID och en hemlighet på den lokala datorn definierar du anslutningen med följande ytterligare egenskaper:

Här är ett exempel på local.settings.json egenskaper som krävs för identitetsbaserad anslutning till Azure Blobs:

{
  "IsEncrypted": false,
  "Values": {
    "<CONNECTION_NAME_PREFIX>__blobServiceUri": "<blobServiceUri>",
    "<CONNECTION_NAME_PREFIX>__queueServiceUri": "<queueServiceUri>",
    "<CONNECTION_NAME_PREFIX>__tenantId": "<tenantId>",
    "<CONNECTION_NAME_PREFIX>__clientId": "<clientId>",
    "<CONNECTION_NAME_PREFIX>__clientSecret": "<clientSecret>"
  }
}

Ansluta till värdlagring med en identitet (förhandsversion)

Azure Functions som standard använder "AzureWebJobsStorage"-anslutningen för kärnbeteenden som att samordna singleton-körning av timerutlösare och standardlagring av appnyckel. Detta kan även konfigureras för att utnyttja en identitet.

Om du vill använda en identitetsbaserad anslutning för "AzureWebJobsStorage" konfigurerar du följande appinställningar:

Vanliga egenskaper för identitetsbaserade anslutningar kan också anges.

Om du använder ett lagringskonto som använder dns-standardsuffixet och tjänstnamnet för globala Azure kan du i stället ange namnet på ditt lagringskonto i https://<accountName>.blob/queue/file/table.core.windows.net AzureWebJobsStorage__accountName följande format. Blob- och köslutpunkterna härförs för det här kontot. Detta fungerar inte om lagringskontot finns i ett suveränt moln eller har en anpassad DNS.

Du måste skapa en rolltilldelning som ger åtkomst till lagringskontot för "AzureWebJobsStorage" vid körning. Hanteringsroller som Ägare räcker inte. Rollen Storage Blob Data-ägare omfattar de grundläggande behoven för Functions-värdlagring – körningen behöver både läs- och skrivåtkomst till blobar och möjligheten att skapa containrar. Det finns vissa situationer, som när du använder blobutlösaren, [där Storage ködatadeltagare] också kan behövas. Du kan behöva ytterligare behörigheter om du använder "AzureWebJobsStorage" för andra ändamål.

Rapportera problem

Nästa steg

Mer information finns i följande resurser:

• Azure Functions utlösare och bindningar
• Koda och testa Azure Functions lokalt
• Metodtips för Azure Functions
• Azure Functions C#-utvecklarreferens
• Azure Functions Node.js för utvecklare