Registrera Azure Functions bindnings tillägg

Från och med Azure Functions version 2. x inkluderar Functions-körningen bara HTTP och timer-utlösare som standard. Andra utlösare och bindningar är tillgängliga som separata paket.

Program i .NET-klass biblioteks funktioner använder bindningar som är installerade i projektet som NuGet-paket. Med tilläggs paket kan non-.NET Functions-appar använda samma bindningar utan att behöva hantera .NET-infrastrukturen.

I följande tabell visas när och hur du registrerar bindningar.

Utvecklingsmiljö Registrering
i funktioner 1. x
Registrering
i functions 3. x/2. x
Azure Portal Automatiskt Autokorrigering*
Non-.NET-språk Automatiskt Använd tilläggs paket (rekommenderas) eller installera tillägg uttryckligen
C#-klass bibliotek med Visual Studio Använda NuGet-verktyg Använda NuGet-verktyg
C#-klass bibliotek med Visual Studio Code Ej tillämpligt Använd .NET Core CLI

* Portalen använder tilläggs paket.

Åtkomst tillägg på non-.NET språk

För Java-, Java Script-, PowerShell-, python-och anpassad hanterarmappning-funktioner rekommenderar vi att du använder tilläggs paket för att få åtkomst till bindningar. I de fall där tilläggs paket inte kan användas kan du uttryckligen installera bindnings tillägg.

Paket för tillägg

Paket för tillägg är ett sätt att lägga till en kompatibel uppsättning bindnings tillägg i din Function-app. Du aktiverar tilläggs paket i appens host.js fil.

Du kan använda tilläggs paket med version 2. x och senare versioner av Functions-körningen.

Tilläggs paketen har versions hantering. Varje version innehåller en bestämd uppsättning bindnings tillägg som verifieras för att fungera tillsammans. Välj en paket version baserat på de tillägg som du behöver i din app.

Lägg till ett tilläggs paket i din Function-app genom att lägga till extensionBundle avsnittet i host.jspå. I många fall kommer Visual Studio Code och Azure Functions Core Tools automatiskt att lägga till den åt dig.

{
    "version": "2.0",
    "extensionBundle": {
        "id": "Microsoft.Azure.Functions.ExtensionBundle",
        "version": "[1.*, 2.0.0)"
    }
}

Följande egenskaper är tillgängliga i extensionBundle :

Egenskap Beskrivning
id Namn området för Microsoft Azure Functions-paket för tillägg.
version Den version av paketet som ska installeras. Functions-körningen plockar alltid den högsta tillåtna versionen som definieras av versions intervallet eller intervallet. Version svärdet ovan tillåter alla paket versioner från 1.0.0 upp till men inte inklusive 2.0.0. Mer information finns i intervall notation för att ange versions intervall.

I följande tabell visas tillgängliga versioner av standard versionen av Microsoft. Azure. functions. ExtensionBundle och länkar till de tillägg som de innehåller.

Paket version Version i host.jspå Inkluderade tillägg
1.x [1.*, 2.0.0) Se extensions.js som används för att generera paketet
2x [2.*, 3.0.0) Se extensions.js som används för att generera paketet

Anteckning

Även om du kan ange ett anpassat versions intervall i host.jspå rekommenderar vi att du använder ett versions värde från den här tabellen.

Installera tillägg uttryckligen

Om du inte kan använda paket för tillägg kan du använda Azure Functions Core Tools lokalt för att installera de speciella tilläggs paket som krävs för ditt projekt.

Viktigt

Du kan inte uttryckligen installera tillägg i en Function-app som använder tilläggs paket. Ta bort extensionBundle avsnittet i host.jspå innan du installerar tillägg explicit.

Följande objekt beskriver några orsaker till att du kan behöva installera tillägg manuellt:

  • Du måste ha åtkomst till en speciell version av ett tillägg som inte är tillgängligt i ett paket.
  • Du måste ha åtkomst till ett anpassat tillägg som inte är tillgängligt i ett paket.
  • Du måste ha åtkomst till en viss kombination av tillägg som inte är tillgängliga i ett enda paket.

Anteckning

Om du vill installera tillägg manuellt med hjälp av kärn verktyg måste du ha installerat .net Core 2. x SDK . .NET Core SDK används av Azure Functions Core Tools för att installera tillägg från NuGet. Du behöver inte känna till .NET för att använda Azure Functions-tillägg.

När du uttryckligen installerar tillägg läggs en .NET-projekt fil med namnet Extensions. CSPROJ till i projektets rot. Den här filen definierar den uppsättning NuGet-paket som krävs av dina funktioner. Även om du kan arbeta med NuGet-paketets referenser i den här filen kan du installera tillägg utan att behöva redigera filen manuellt.

Det finns flera sätt att använda kärn verktyg för att installera de nödvändiga tilläggen i det lokala projektet.

Installera alla tillägg

Använd följande kommando för att automatiskt lägga till alla tilläggs paket som används av bindningarna i det lokala projektet:

func extensions install

Kommandot läser function.jspå fil för att se vilka paket du behöver, installerar dem och återkonstruerar tilläggs projektet (Extensions. CSPROJ). Den lägger till eventuella nya bindningar i den aktuella versionen men uppdaterar inte befintliga bindningar. Använd --force alternativet för att uppdatera befintliga bindningar till den senaste versionen när du installerar nya.

Om din Function-app använder bindningar som grund verktygen inte känner igen måste du installera det angivna tillägget manuellt.

Installera ett angivet tillägg

Använd följande kommando för att installera ett särskilt tilläggs paket i en speciell version, i det här fallet lagrings tillägget:

func extensions install --package Microsoft.Azure.WebJobs.Extensions.Storage --version 4.0.2

Installera tillägg från NuGet på .NET-språk

För ett C#-projekt med klass biblioteks funktioner bör du installera tillägg direkt. Tilläggs paket är särskilt utformade för projekt som inte är C#-klass biblioteks-baserade.

C- # klass bibliotek med Visual Studio

I Visual Studio kan du installera paket från Package Manager-konsolen med kommandot install-Package , som du ser i följande exempel:

Install-Package Microsoft.Azure.WebJobs.Extensions.ServiceBus -Version <TARGET_VERSION>

Namnet på det paket som används för en angiven bindning anges i referens artikeln för den bindningen. Ett exempel finns i avsnittet paket i referens artikeln Service Bus bindning.

Ersätt <TARGET_VERSION> i exemplet med en angiven version av paketet, till exempel 3.0.0-beta5 . Giltiga versioner visas på de enskilda paket sidorna på NuGet.org. De huvud versioner som motsvarar Functions Runtime 1. x eller 2. x anges i referens artikeln för bindningen.

Om du använder Install-Package för att referera till en bindning behöver du inte använda tilläggs paket. Den här metoden är speciell för klass bibliotek som skapats i Visual Studio.

C#-klass bibliotek med Visual Studio Code

I Visual Studio Code installerar du paket för ett C#-klass biblioteks projekt från kommando tolken med kommandot dotNet Lägg till paket i .net Core cli. Följande exempel visar hur du lägger till en bindning:

dotnet add package Microsoft.Azure.WebJobs.Extensions.<BINDING_TYPE_NAME> --version <TARGET_VERSION>

.NET Core CLI kan bara användas för Azure Functions 2. x-utveckling.

Ersätt <BINDING_TYPE_NAME> med namnet på det paket som innehåller den bindning du behöver. Du hittar den önskade bindnings referens artikeln i listan över bindningar som stöds.

Ersätt <TARGET_VERSION> i exemplet med en angiven version av paketet, till exempel 3.0.0-beta5 . Giltiga versioner visas på de enskilda paket sidorna på NuGet.org. De huvud versioner som motsvarar Functions Runtime 1. x eller 2. x anges i referens artikeln för bindningen.

Nästa steg