Partager via

Packs d’extensions Azure Functions

Cet article explique comment les bundles d’extensions permettent à votre code de fonction d’utiliser tous les déclencheurs et liaisons pris en charge par Azure Functions. Vous découvrez également les différents niveaux de support et stratégies pour vos applications lors de l’utilisation de bundles d’extensions.

Cet article s’applique uniquement aux développeurs Azure Functions utilisant des langages non-.NET. Pour savoir comment ajouter des extensions de liaison directement à vos applications de fonction C#, consultez Inscrire des extensions de liaison Azure Functions.

Aperçu

Les bundles d’extensions ajoutent un ensemble prédéfini d’extensions de liaison compatibles à votre application de fonction. Les offres groupées d’extensions sont associées à une version. Chaque version contient un ensemble spécifique d’extensions de liaison qui sont vérifiées pour fonctionner ensemble. Sélectionnez une version groupée basée sur les versions des extensions dont vous avez besoin dans votre application.

Lorsque vous créez un projet Azure Functions à partir d’un modèle non-.NET, les bundles d’extensions sont déjà activés dans le fichier host.json de l’application.

Définir une référence de pack d'extensions

Vous définissez une référence d’ensemble d’extensions dans le fichier projet host.json en ajoutant une extensionBundle section, comme dans cet exemple :

{
    "version": "2.0",
    "extensionBundle": {
        "id": "Microsoft.Azure.Functions.ExtensionBundle",
        "version": "[4.0.0, 5.0.0)"
    }
}

Les propriétés suivantes sont disponibles dans extensionBundle :

Propriété Descriptif
id Espace de noms pour les offres groupées d’extension Microsoft Azure Functions.
version Plage de versions de l’offre groupée à installer. Le runtime Functions récupère toujours la version autorisée maximale définie par la plage ou l’intervalle de version. Par exemple, une plage de valeurs version spécifiée sous la forme [4.0.0, 5.0.0) autorise toutes les versions de bundle commençant à la version 4.0.0 et s’arrêtant à la version 5.0.0 (non incluse). Pour plus d’informations, consultez la notation d’intervalle de spécification de plages de versions.

Offres groupées d’extensions prises en charge

Ce tableau répertorie toutes les Microsoft.Azure.Functions.ExtensionBundle versions de bundle et l’état de prise en charge actuel.

Version de l’offre groupée Version dans host.json État du support Date de fin de prise en charge
4.x [4.0.0, 5.0.0) Actif Pas encore déterminé
3.x [3.3.0, 4.0.0) Déconseillé 05/30/2026
2.x [2.*, 3.0.0) Déconseillé 05/30/2026
1.x [1.*, 2.0.0) Déconseillé 05/30/2026

Les ensembles d’extensions par défaut sont définis à l’aide de plages de versions. Sélectionnez la version du bundle pour afficher le fichier de définitionextensions.json utilisé pour générer la version actuelle du bundle d’extension principale.

Pour plus d’informations, consultez la stratégie de support.

Considérations relatives aux bundles d’extensions

Gardez ces considérations à l’esprit lors de l’utilisation des offres groupées d’extensions :

  • Si possible, vous devez définir une version valeur de plage dans host.json de cette table, par [4.0.0, 5.0.0)exemple, au lieu de définir une plage personnalisée.
  • Utilisez la dernière plage de versions pour obtenir des performances optimales d’application et accéder aux dernières fonctionnalités.
  • Dans le cas peu probable où vous ne pouvez pas utiliser un bundle d’extensions, vous devez installer explicitement des extensions.

Offres groupées d’extensions en préversion

Les versions préliminaires d’extensions de liaison spécifiques sont mises à jour dans un ensemble d’extensions en préversion. L'offre groupée d'extensions en préversion (Microsoft.Azure.Functions.ExtensionBundle.Preview) vous permet de profiter des extensions en préversion et de découvrir de nouveaux comportements dans les extensions existantes, avant qu'elles ne soient annoncées en disponibilité générale.

Gardez ces considérations à l’esprit lorsque vous choisissez d’utiliser un ensemble d’extensions non ga :

  • Les offres groupées en préversion peuvent inclure des fonctionnalités qui sont toujours en cours de développement et qui ne sont pas encore prêtes à être utilisées en production. Ils sont destinés à l’évaluation et aux tests dans des environnements hors production.
  • Les changements cassants se produisent entre les versions préliminaires sans préavis, ce qui peut inclure des modifications à :
    • Définitions de liaisons et de déclencheurs
    • Extensions incluses dans la préversion
    • Caractéristiques et stabilité des performances
  • Les mises à jour de sécurité peuvent nécessiter la mise à niveau des versions.
  • Vous devez tester complètement les offres groupées en préversion dans des environnements hors production et éviter d’utiliser des offres groupées en préversion en production. Lorsque vous devez utiliser un bundle d’aperçu en production, prenez ces précautions supplémentaires :
    • Épinglez votre bundle à une version spécifique d’un bundle bien testé au lieu d’une plage. L’épinglage empêche la mise à niveau automatique de votre version d’offre groupée avant de pouvoir vérifier la mise à jour dans un environnement hors production.
    • Déplacez votre application vers une version d’offre groupée en disponibilité générale dès que la fonctionnalité devient disponible dans une version complète de l’offre groupée prise en charge.
  • Pour rester informé des mises à jour de bundle, notamment le passage de la préversion à la disponibilité générale, vous devez :
    • Surveillez les versions préliminaires de l’offre groupée sur la page de publication des bundles d’extensions. - Versions · Azure/azure-functions-extension-bundles
    • Superviser la documentation de référence spécifique à l’extension.
    • Passez en revue les versions de package NuGet d’extensions en préversion spécifiques que vous utilisez.
    • Suivez les mises à jour significatives ou les modifications apportées aux journaux des modifications publiées sur NuGet.org pour chaque extension en préversion.

Stratégie de support

Les versions majeures des lots d’extensions peuvent se produire lorsqu’il existe des modifications cassantes ou des mises à jour dans les dépendances des extensions de liaison sous-jacentes. Ces changements majeurs, souvent introduits dans les Kits de développement logiciel (SDK) Azure, nécessitent des mises à jour de l'ensemble pour rester compatibles.

Le cycle de prise en charge d’un ensemble d’extensions GA suit les phases distinctes suivantes :

Étape Descriptif
Actif La version principale la plus récente des offres groupées d’extensions est considérée comme la version active et est recommandée pour vos applications de fonction.
Notification Microsoft fournit un préavis avant de mettre hors service un bundle d’extension ou une version d’extension de liaison. Lorsque vous recevez une telle notification, vous devez commencer à planifier la mise à niveau de vos applications de fonction vers une dernière version prise en charge de l’offre groupée d’extensions. Cette mise à niveau garantit que vos applications continuent d’accéder à de nouvelles fonctionnalités, améliorations des performances et prise en charge.
Dépréciation Lorsqu’une nouvelle version majeure d’ensemble d’extensions devient disponible de manière générale, la version précédente entre dans une phase de dépréciation de 12 mois. Cette période de chevauchement vous donne le temps de planifier, de tester et de mettre à niveau vos applications avant la mise hors service de la version précédente.
Mise hors service Après la mise hors service d’un bundle d’extensions, les applications de fonction qui référencent cette version spécifique ne sont pas éligibles pour les nouvelles fonctionnalités, les correctifs de sécurité et les optimisations des performances. Les applications de fonction qui utilisent des versions supprimées peuvent toujours être créées et déployées et sont autorisées à s’exécuter sur la plateforme. Toutefois, vous devez mettre à niveau votre appli fonctionnelle vers une version de paquet prise en charge avant de pouvoir recevoir l'assistance.

Vous pouvez afficher les versions du bundle d’extensions et leurs extensions incluses dans le dépôt GitHub des offres groupées d’extensions Azure Functions. Les packages .NET individuels sont trouvés sur https://nuget.org.

Pour en savoir plus sur les extensions de liaison, consultez Enregistrer les extensions de liaison des fonctions Azure.