Azure Functions kötésbővítmények regisztrálása
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 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ötegeket a Java, a JavaScript, a PowerShell, a Python, a C# szkript és a Custom Handler függvényalkalmazások használják a kötésbővítmények használatához. Olyan esetekben, 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).
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.
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.