Inscrire des extensions de liaison Azure FunctionsRegister Azure Functions binding extensions

Dans Azure Functions version 2.x, des liaisons sont disponibles sous forme de packages distincts du runtime de fonctions.In Azure Functions version 2.x, bindings are available as separate packages from the functions runtime. Alors que les fonctions .NET accèdent aux liaisons via des packages NuGet, les offres groupées d’extension permettent à d’autres fonctions d’accéder à toutes les liaisons via un paramètre de configuration.While .NET functions access bindings through NuGet packages, extension bundles allow other functions access to all bindings through a configuration setting.

Prenez en compte les éléments suivants liés aux extensions de liaison :Consider the following items related to binding extensions:

Le tableau suivant indique quand et comment vous inscrivez des liaisons.The following table indicates when and how you register bindings.

Environnement de développementDevelopment environment InscriptionRegistration
dans Functions 1.xin Functions 1.x
InscriptionRegistration
dans Functions 2.xin Functions 2.x
Portail AzureAzure portal AutomatiqueAutomatic AutomatiqueAutomatic
Langages non .NET ou développement Azure Core Tools localNon-.NET languages or local Azure Core Tools development AutomatiqueAutomatic Utiliser Azure Functions Core Tools et des offres groupées d’extensionUse Azure Functions Core Tools and extension bundles
Bibliothèque de classes C# avec Visual StudioC# class library using Visual Studio Utiliser les outils NuGetUse NuGet tools Utiliser les outils NuGetUse NuGet tools
Bibliothèque de classes C# avec Visual Studio CodeC# class library using Visual Studio Code N/AN/A Utiliser CLI .NET CoreUse .NET Core CLI

Offres groupées d’extension pour développement localExtension bundles for local development

Les offres groupées d’extensions constituent une technologie de déploiement qui vous permet d’ajouter un jeu d’extensions de liaison Functions compatible avec votre application de fonction.Extension bundles is a deployment technology that lets you add a compatible set of Functions binding extensions to your function app. Un ensemble prédéfini d’extensions est ajouté lorsque vous générez votre application.A predefined set of extensions are added when you build your app. Les packages d’extension définis dans une offre groupée sont compatibles entre eux, vous permettant ainsi d’éviter les conflits entre les packages.Extension packages defined in a bundle are compatible with each other, which helps you avoid conflicts between packages. Vous activez les offres groupées d’extensions dans le fichier host.json de l’application.You enable extension bundles in the app's host.json file.

Vous pouvez utiliser des offres groupées d’extensions avec la version 2.x et les versions ultérieures du runtime Functions.You can use extension bundles with version 2.x and later versions of the Functions runtime. Lors d’un développement local, vérifiez que vous utilisez la dernière version d’Azure Functions Core Tools.When developing locally, make sure you are using the latest version of Azure Functions Core Tools.

Utilisez des offres groupées d’extensions pour le développement local à l’aide d’Azure Functions Core Tools ou de Visual Studio Code, ou lorsque vous créez à distance.Use extension bundles for local development using Azure Functions Core Tools, Visual Studio Code, and when you build remotely.

Si vous n’utilisez pas d’offres groupées d’extension, vous devez installer le Kit de développement logiciel (SDK) .NET Core 2.x sur votre ordinateur local avant d’installer des extensions de liaison.If you don't use extension bundles, you must install the .NET Core 2.x SDK on your local computer before you install any binding extensions. Les offres groupées d’extensions suppriment cette exigence pour le développement local.Extension bundles removes this requirement for local development.

Pour utiliser des offres groupées d’extension, mettez à jour le fichier host.json pour inclure l’entrée suivante pour extensionBundle :To use extension bundles, update the host.json file to include the following entry for extensionBundle:

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

Les propriétés suivantes sont disponibles dans extensionBundle :The following properties are available in extensionBundle:

PropriétéProperty DescriptionDescription
idid Espace de noms pour les offres groupées d’extension Microsoft Azure Functions.The namespace for Microsoft Azure Functions extension bundles.
versionversion Version de l’offre groupée à installer.The version of the bundle to install. Le runtime Functions récupère toujours la version autorisée maximale définie par la plage ou l’intervalle de version.The Functions runtime always picks the maximum permissible version defined by the version range or interval. La valeur de version ci-dessus autorise toutes les versions d’offre groupée jusqu’à 1.0.0 mais sans inclure la version 2.0.0.The version value above allows all bundle versions from 1.0.0 up to but not including 2.0.0. Pour plus d’informations, consultez la notation d’intervalle de spécification de plages de versions.For more information, see the interval notation for specifying version ranges.

Les versions d’offre groupées sont incrémentées à mesure que les packages contenus dans l’offre groupée changent.Bundle versions increment as packages in the bundle change. Des changements de version majeure se produisent lorsque les packages de l’offre groupée passent à la version majeure supérieure.Major version changes occur when packages in the bundle increment by a major version. Les changements de version majeure dans l’offre groupée coïncident généralement avec ceux du runtime Functions.Major version changes in the bundle usually coincide with a change in the major version of the Functions runtime.

L’ensemble actuel d’extensions installées par l’offre groupée par défaut est énuméré dans ce fichier extensions.json.The current set of extensions installed by the default bundle is enumerated in this extensions.json file.

Bibliothèque de classes C# avec Visual StudioC# class library with Visual Studio

Dans Visual Studio, vous pouvez installer des packages à partir de la console du Gestionnaire de package avec la commande Install-Package, comme indiqué dans l’exemple suivant :In Visual Studio, you can install packages from the Package Manager Console using the Install-Package command, as shown in the following example:

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

Le nom du package utilisé pour une liaison donnée est fourni dans l’article de référence pour cette liaison.The name of the package used for a given binding is provided in the reference article for that binding. Pour obtenir un exemple, consultez la section Packages de l’article Informations de référence sur les liaisons Service Bus.For an example, see the Packages section of the Service Bus binding reference article.

Remplacez <TARGET_VERSION> dans l’exemple par une version spécifique du package, comme 3.0.0-beta5.Replace <TARGET_VERSION> in the example with a specific version of the package, such as 3.0.0-beta5. Les versions valides sont répertoriées sur les pages de chaque package sur NuGet.org. Les versions majeures qui correspondent aux runtime Functions 1.x ou 2.x sont spécifiées dans l’article de référence pour la liaison.Valid versions are listed on the individual package pages at NuGet.org. The major versions that correspond to Functions runtime 1.x or 2.x are specified in the reference article for the binding.

Si vous utilisez Install-Package pour faire référence à une liaison, vous n’avez pas besoin d’utiliser des offres groupées d’extensions.If you use Install-Package to reference a binding, you don't need to use extension bundles. Cette approche est spécifique aux bibliothèques de classes générées dans Visual Studio.This approach is specific for class libraries built in Visual Studio.

Bibliothèque de classes C# avec Visual Studio CodeC# class library with Visual Studio Code

Notes

Nous vous recommandons d’utiliser des offres groupées d’extension pour que Functions installe automatiquement un ensemble de packages d’extension de liaison compatible.We recommend using extension bundles to have Functions automatically install a compatible set of binding extension packages.

Dans Visual Studio Code, installez des packages pour un projet de bibliothèque de classes C# à partir de l’invite de commandes avec la commande dotnet add package dans CLI .NET Core.In Visual Studio Code, install packages for a C# class library project from the command prompt using the dotnet add package command in the .NET Core CLI. L’exemple suivant montre comment ajouter une liaison :The following example demonstrates how you add a binding:

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

CLI .NET Core peut être utilisé seulement pour le développement Azure Functions 2.x.The .NET Core CLI can only be used for Azure Functions 2.x development.

Remplacez <BINDING_TYPE_NAME> par le nom du package qui contient la liaison dont vous avez besoin.Replace <BINDING_TYPE_NAME> with the name of the package that contains the binding you need. Vous trouverez l’article de référence de la liaison souhaitée dans la liste des liaisons prises en charge.You can find the desired binding reference article in the list of supported bindings.

Remplacez <TARGET_VERSION> dans l’exemple par une version spécifique du package, comme 3.0.0-beta5.Replace <TARGET_VERSION> in the example with a specific version of the package, such as 3.0.0-beta5. Les versions valides sont répertoriées sur les pages de chaque package sur NuGet.org. Les versions majeures qui correspondent aux runtime Functions 1.x ou 2.x sont spécifiées dans l’article de référence pour la liaison.Valid versions are listed on the individual package pages at NuGet.org. The major versions that correspond to Functions runtime 1.x or 2.x are specified in the reference article for the binding.

Étapes suivantesNext steps