Utvecklarguide för Azure Functions

I Azure Functions delar alla funktioner några viktiga tekniska begrepp och komponenter, oavsett vilket språk eller din utvecklingsmiljö du föredrar. Den här artikeln är språkspecifik. Välj önskat språk överst i artikeln.

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

Kodprojekt

Kärnan i Azure Functions är ett språkspecifikt kodprojekt som implementerar en eller flera kodkörningsenheter som kallas funktioner. Funktioner är helt enkelt metoder som körs i Azure-molnet baserat på händelser, som svar på HTTP-begäranden eller enligt ett schema. Tänk på ditt Azure Functions-kodprojekt som en mekanism för att organisera, distribuera och gemensamt hantera dina enskilda funktioner i projektet när de körs i Azure. Mer information finns i Ordna dina funktioner.

Alla funktioner måste ha en utlösare som definierar hur funktionen startar och kan ge indata till funktionen. Dina funktioner kan också definiera indata- och utdatabindningar. Dessa bindningar förenklar anslutningar till andra tjänster utan att du behöver arbeta med klient-SDK:er. Mer information finns i Utlösare och bindningar i Azure Functions.

Azure Functions tillhandahåller en uppsättning språkspecifika projekt- och funktionsmallar som gör det enkelt att skapa nya kodprojekt och lägga till funktioner i projektet. Du kan använda något av de verktyg som stöder Azure Functions-utveckling för att generera nya appar och funktioner med hjälp av dessa mallar.

Utvecklingsverktyg

Följande verktyg ger en integrerad utvecklings- och publiceringsupplevelse för Azure Functions på önskat språk:

• Visual Studio Code

• Azure Functions Core Tools (kommandotolk)

De här verktygen integreras med Azure Functions Core Tools så att du kan köra och felsöka på din lokala dator med hjälp av Functions-körningen. Mer information finns i Koda och testa Azure Functions lokalt.

Distribution

När du publicerar kodprojektet i Azure distribuerar du i princip projektet till en befintlig funktionsappresurs. 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. Ur ett Azure-resursperspektiv motsvarar en funktionsapp en webbplatsresurs (Microsoft.Web/sites) i Azure App Service, vilket motsvarar en webbapp.

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. Mer information finns i Hantera en funktionsapp.

När funktionsappen och andra nödvändiga resurser inte redan finns i Azure måste du först skapa dessa resurser innan du kan distribuera dina projektfiler. Du kan skapa dessa resurser på något av följande sätt:

• Använda Visual Studio Code

• Programmatiskt med hjälp av Azure CLI, Azure PowerShell, ARM-mallar eller Bicep-mallar

• I Azure Portal

Förutom verktygsbaserad publicering har Functions stöd för andra tekniker för att distribuera källkod till en befintlig funktionsapp. Mer information finns i Distributionstekniker i Azure Functions.

Ansluta till tjänster

Ett stort krav för alla molnbaserade beräkningstjänster är att läsa data från och skriva data till andra molntjänster. Functions tillhandahåller en omfattande uppsättning bindningar som gör det enklare för dig att ansluta till tjänster utan att behöva arbeta med klient-SDK:er.

Oavsett om du använder bindningstilläggen som tillhandahålls av Functions eller om du arbetar direkt med klient-SDK:er lagrar du anslutningsdata på ett säkert sätt och inkluderar dem inte i koden. Mer information finns i Anslut ions.

Bindningar

Functions tillhandahåller bindningar för många Azure-tjänster och några tjänster från tredje part som implementeras som tillägg. Mer information finns i den fullständiga listan över bindningar som stöds.

Bindningstillägg kan stödja både indata och utdata, och många utlösare fungerar också som indatabindningar. Med bindningar kan du konfigurera anslutningen till tjänster så att Functions-värden kan hantera dataåtkomsten åt dig. Mer information finns i Utlösare och bindningar i Azure Functions.

Om du har problem med fel som kommer från bindningar kan du läsa dokumentationen om Azure Functions-bindningsfelkoder .

Klient-SDK: er

Även om Functions tillhandahåller bindningar för att förenkla dataåtkomsten i funktionskoden kan du fortfarande använda en klient-SDK i projektet för att få direkt åtkomst till en viss tjänst, om du vill. Du kan behöva använda klient-SDK:er direkt om dina funktioner kräver en funktion i den underliggande SDK som inte stöds av bindningstillägget.

När du använder klient-SDK:er bör du använda samma process för att lagra och komma åt anslutningssträng som används av bindningstillägg.

Kontakter

Som bästa säkerhet kan Azure Functions dra nytta av funktionerna för programinställningar i Azure App Service för att hjälpa dig att lagra strängar, nycklar och andra token som krävs för att ansluta till andra tjänster på ett säkrare sätt. Programinställningarna i Azure lagras krypterade och kan nås vid körning av din app som miljövariabelpar namevalue . För utlösare och bindningar som kräver en anslutningsegenskap anger du namnet på programinställningen i stället för den faktiska anslutningssträng. Du kan inte konfigurera en bindning direkt med en anslutningssträng eller nyckel.

Överväg till exempel en utlösardefinition som har en connection egenskap. I stället för anslutningssträng anger connection du namnet på en miljövariabel som innehåller anslutningssträng. Med hjälp av den här strategin för åtkomst till hemligheter blir både dina appar säkrare och gör det enklare för dig att ändra anslutningar mellan miljöer. För ännu mer säkerhet kan du använda identitetsbaserade anslutningar.

Standardkonfigurationsprovidern använder miljövariabler. Dessa variabler definieras i programinställningar när de körs i Azure och i filen för lokala inställningar när du utvecklar lokalt.

Anslut ionsvärden

När anslutningsnamnet matchas till ett enda exakt värde identifierar körningen värdet som en anslutningssträng, vilket vanligtvis innehåller en hemlighet. Informationen om en anslutningssträng beror på vilken tjänst du ansluter till.

Ett anslutningsnamn kan dock också referera till en samling med flera konfigurationsobjekt, som är användbara 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 __. Gruppen kan sedan refereras genom att ange anslutningsnamnet till det här prefixet.

Egenskapen för en Azure Blob-utlösardefinition kan till exempel connection vara Storage1. Så länge det inte finns något enda strängvärde som konfigurerats av en miljövariabel med namnet Storage1kan en miljövariabel med namnet Storage1__blobServiceUri användas för att informera blobServiceUri anslutningens egenskap. Anslutningsegenskaperna skiljer sig åt för varje tjänst. Se dokumentationen för komponenten som använder anslutningen.

Konfigurera en identitetsbaserad anslutning

Vissa anslutningar i Azure Functions kan konfigureras för att använda en identitet i stället för en hemlighet. Supporten 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 dina funktionsappar med hanterade identiteter finns i självstudien skapa en funktionsapp med identitetsbaserade anslutningar.

Följande komponenter stöder identitetsbaserade anslutningar:

När identitetsbaserade anslutningar finns i Azure Functions-tjänsten använder de en hanterad identitet. Den systemtilldelade identiteten används som standard, även om en användartilldelad identitet kan anges med credential egenskaperna och clientID . Observera att det inte går att konfigurera en användartilldelad identitet med ett resurs-ID. När den körs i andra sammanhang, till exempel lokal utveckling, används utvecklaridentiteten i stället, även om den 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. För de flesta Azure-tjänster innebär det att du måste tilldela en roll i Azure RBAC med hjälp av antingen inbyggda eller anpassade roller som ger dessa behörigheter.

Välj någon av de här flikarna 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 <CONNECTION_NAME_PREFIX> är värdet för din connection egenskap i utlösar- eller bindningsdefinitionen:

Andra alternativ kan stödjas för en viss anslutningstyp. Se dokumentationen för komponenten som upprättar anslutningen.

Lokal utveckling med identitetsbaserade anslutningar

När du kör funktionsprojektet lokalt instruerar konfigurationen ovan körningen att 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.

Din identitet kanske redan har vissa rolltilldelningar mot Azure-resurser som används för utveckling, men dessa roller kanske inte ger nödvändig 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 tilldelat dem 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 ett Microsoft Entra-tjänsthuvudnamn. 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 extra 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>"
  }
}

Anslut som värd för lagring med en identitet

Azure Functions-värden använder lagringsanslutningen som angetts för AzureWebJobsStorage att aktivera kärnbeteenden, till exempel samordning av singleton-körning av timerutlösare och standardlagring av appnycklar. Den här anslutningen kan också konfigureras för att använda en identitet.

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

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

Om du konfigurerar AzureWebJobsStorage med ett lagringskonto som använder standard-DNS-suffixet och tjänstnamnet för globala Azure kan du i https://<accountName>.[blob|queue|file|table].core.windows.net stället ange AzureWebJobsStorage__accountName namnet på ditt lagringskonto efter formatet. Slutpunkterna för varje lagringstjänst härleds för det här kontot. Detta fungerar inte när lagringskontot finns i ett nationellt 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 Lagringsblobdataägare täcker 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. Flera tillägg använder den här anslutningen som standardplats för blobar, köer och tabeller, och dessa användningsområden kan lägga till krav som anges i tabellen nedan. Du kan behöva ytterligare behörigheter om du använder "AzureWebJobsStorage" för andra ändamål.

Rapporteringsproblem

Lagringsplatser med öppen källkod

Koden för Azure Functions är öppen källkod och du hittar viktiga komponenter i dessa GitHub-lagringsplatser:

• Azure Functions

• Azure Functions-värd

• Azure Functions-portalen

• Azure Functions-mallar

• Azure WebJobs SDK

• Azure WebJobs SDK-tillägg

Nästa steg

Mer information finns i följande resurser:

• Azure Functions-scenarier
• Koda och testa Azure Functions lokalt
• Metodtips för Azure Functions