Megosztás a következőn keresztül:

Azure Functions kötésbővítmények regisztrálása

  • Cikk

Az Azure Functions 2.x-es verziójától kezdve a függvények futtatókörnyezete alapértelmezés szerint csak HTTP- és időzítő-eseményindítókat tartalmaz. Más triggerek és kötések külön csomagként érhetők el.

A .NET-osztálytár-függvényalkalmazások a projektben NuGet-csomagokként telepített kötéseket használnak. A bővítménykötegek lehetővé teszik, hogy non-.NET függvényalkalmazások ugyanazokat a kötéseket használják anélkül, hogy a .NET-infrastruktúrával kellene foglalkozniuk.

Az alábbi táblázat azt jelzi, hogy mikor és hogyan regisztrál kötéseket.

Fejlesztői környezet Nyilvántartás
a Functions 1.x-ben		 Nyilvántartás
a Functions 2.x vagy újabb verzióiban
Azure Portal Automatikus Automatikus*
Non-.NET nyelvek Automatikus Bővítménykötegek használata (ajánlott) vagy kifejezetten bővítmények telepítése
C#-osztálykódtár a Visual Studióval NuGet-eszközök használata NuGet-eszközök használata
C# osztálykódtár a Visual Studio Code használatával n/a A .NET Core parancssori felületének használata
A C#Dev Kit használata

* A Portál bővítménycsomagokat használ, beleértve a C# szkriptet is.

Bővítménykötegek

Alapértelmezés szerint a bővítménykötegek kötési támogatást nyújtanak az alábbi nyelveken található függvényekhez:

  • Java
  • JavaScript
  • PowerShell
  • Python
  • C#-szkript
  • Egyéb (egyéni kezelők)

Ritkán, amikor a bővítménycsomagok nem használhatók, explicit módon telepíthet kötésbővítményeket a függvényalkalmazás-projekttel. A bővítménykötegek a Functions-futtatókörnyezet 2.x és újabb verziójában támogatottak.

A bővítménykötegekkel előre definiált kompatibilis kötésbővítményeket adhat hozzá a függvényalkalmazáshoz. A bővítménycsomagok verziószámozottak. Minden verzió tartalmaz egy bizonyos kötésbővítményeket, amelyek igazoltan működnek együtt. Válasszon ki egy csomagverziót az alkalmazásban szükséges bővítmények alapján.

Amikor non-.NET Functions-projektet hoz létre az eszközkészletből vagy a portálon, a bővítménycsomagok már engedélyezve vannak az alkalmazás host.json fájljában.

A bővítményköteg-hivatkozást egy host.json szakasza extensionBundle határozza meg az alábbiak szerint:

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

Az extensionBundle alábbi tulajdonságai érhetők el:

Tulajdonság Leírás
id A Microsoft Azure Functions bővítménycsomagjainak névtere.
version A telepíteni kívánt csomag verziótartománya. A Functions futtatókörnyezete mindig a verziótartomány által meghatározott legmagasabb verziószámot választja ki. Egy értéktartomány [4.0.0, 5.0.0) például lehetővé teszi az version összes csomagverziót a 4.0.0-tól az 5.0.0-ig, de az 5.0.0-s verziót nem. További információért lásd az intervallumok verziótartományok megadásakor történő megjelölésével foglalkozó részt.

Az alábbi táblázat az alapértelmezett Microsoft.Azure.Functions.ExtensionBundle-csomagok jelenleg elérhető verziótartományait és az általuk tartalmazott bővítményekre mutató hivatkozásokat sorolja fel.

Csomag verziója Verzió a host.json Kizárt kiterjesztések
1.x [1.*, 2.0.0) Lásd a csomag létrehozásához használt extensions.json .
2.x [2.*, 3.0.0) Lásd a csomag létrehozásához használt extensions.json .
3.x [3.3.0, 4.0.0) Lásd a csomag létrehozásához használt extensions.json .
4.x [4.0.0, 5.0.0) Lásd a csomag létrehozásához használt extensions.json .

Feljegyzés

Annak ellenére, hogy host.json támogatja az versionegyéni tartományokat, a táblázatból származó verziótartomány-értéket kell használnia, például [4.0.0, 5.0.0). Az egyes kiadások bővítménycsomagjainak és bővítményverzióinak teljes listáját a bővítménykötegek kiadási oldalán találja.

Bővítmények explicit telepítése

A lefordított C#-osztálytár-projektekhez (folyamatban lévő és elkülönített feldolgozói folyamathoz) a szokásos módon kell telepítenie a NuGet-csomagokat a szükséges bővítményekhez. Ilyen például a Visual Studio Code fejlesztői útmutatója vagy a Visual Studio fejlesztői útmutatója. Tekintse meg a bővítménykötegek kiadási oldalát az ellenőrzött kompatibilis bővítményverziók kombinációinak áttekintéséhez.

Ha non-.NET nyelveket és C# szkriptet használ, ha nem tud bővítménycsomagokat használni, manuálisan kell telepítenie a szükséges kötésbővítményeket a helyi projektben. A legegyszerűbb módszer az Azure Functions Core Tools használata. További információ: func extensions install.

A csak portálos fejlesztéshez manuálisan kell létrehoznia egy extensions.csproj fájlt a függvényalkalmazás gyökerében. További információ: Bővítmények manuális telepítése.

Következő lépések

Azure-függvény eseményindítója és kötési példája