Megjegyzés
Az oldalhoz való hozzáféréshez engedély szükséges. Megpróbálhat bejelentkezni vagy módosítani a címtárat.
Az oldalhoz való hozzáféréshez engedély szükséges. Megpróbálhatja módosítani a címtárat.
A Azure Functions parancssori felület a helyi fejlesztési futtatókörnyezet következő főverziója (v5), és Azure Functions eszközkészlete. A func.exe ezen verziója számítási feladatalapú architektúrával rendelkezik, így csak azt töltheti le, amire szüksége van ahhoz a veremhez, amelyen fejleszt.
Important
Az Azure Functions CLI (v5) jelenleg előnézetben van. Ez az előzetes verzió még nem támogatja a Java-t és a PowerShell-t. Ha jelenleg nem támogatott nyelvekkel dolgozhatsz, használd továbbra is a Azure Functions Core Tools v4-t.
A func.exe két változata létezik helyi Azure Functions fejlesztéshez:
| v4 | v5 | |
|---|---|---|
| API név | Azure Functions Core Tools | Azure Functions CLI |
| Támogatotti szint | Általános rendelkezésre állás (GA) | Preview |
| Telepítési lábnyom | Teljes bináris, amely tartalmazza az összes parancsot és képességet minden anyanyelvhez. | Kis alap telepítés, plusz nyelvenként szükséges feladatok és egyéb funkciók, amelyeket szükség szerint hozzáadsz. A gazda saját számítási feladatként érkezik, így a CLI újbóli letöltése nélkül megkapja a gazda legújabb verzióját. |
| Használja, amikor... | Minden fejlesztési munkafolyamathoz teljes körű ga-támogatásra van szüksége. | Egyszerű, számítási feladatalapú élményt szeretne az új funkciókkal, például gyorsútmutató-sablonokkal és profilokkal, amelyek szinkronban tartják a helyi környezetet a Azure üzemeltetési terv konfigurációjával. |
A parancsreferenciát lásd a Azure Functions parancssori referenciájában.
A példák jelenleg nem érhetők el a nyelvi környezet támogatásának hiánya miatt.
A Azure Functions parancssori felület telepítése
Az Azure Functions CLI egy kis méretű alaptelepítéssel érhető el, amelyhez azokhoz a technológiai veremekhez adhat hozzá számítási feladatcsomagokat, amelyekben fejleszt. Microsoft Windows, macOS és Linux rendszerhez teszi közzé a telepítőcsomagokat. A telepítés után a(z) func bináris elérhető a(z) PATH útvonalon.
Note
Bár a Azure Functions parancssori felület előzetes verzióban érhető el, telepítse a legújabb előzetes verziójú buildet a Azure Functions Core Tools kiadási oldaláról. A végleges telepítési útmutatót az általános rendelkezésre állási kiadással tesszük közzé.
Ellenőrizze a telepítést:
func --version
Az alap CLI telepítése után telepítse a stackjéhez tartozó workloadokat. A leggyorsabb módszer a(z) func setup, amely egy lépésben telepíti a hostot, a nyelvi feldolgozót, a bővítménycsomagokat (ha szükséges), a stackhez tartozó workloadot és a sablonokhoz tartozó workloadot.
Például:
func setup --features dotnet
func setup --features node
func setup --features python
func setup --features go
A számítási feladatokat egyenként is telepítheti a használatával func workload install. Akárhogy is, amikor először futtatja a(z) func init, func new vagy func run parancsot a szükséges munkaterhelések telepítése nélkül, a CLI felkéri ezek telepítésére.
Workloads
A Azure Functions parancssori felület egy munkacsomag-modellt használ. Az alap func telepítés kis méretű és nyelvfüggetlen. Igény szerint telepítheti a munkaterheléseket, hogy hozzáférjen a veremspecifikus eszközökhöz, a Functions futtatókörnyezetéhez, a nyelvi feldolgozókhoz, a bővítménycsomagokhoz és a sablonokhoz.
A számítási feladatok a következő kategóriákba sorolhatók:
-
Host: A Azure Functions gazdafuttatás, amelyet
func runhasznál. - Bundles: Előre összeállított bővítménycsomagok, hogy az eseményindítók és kötések külön beállítás nélkül működjenek (nem .NET-alapú vermekhez szükséges).
-
Stack: Nyelvspecifikus projekteszközök (például
python,node,dotnet). -
Munkafolyamat: Az a nyelvi munkafolyamat, amelyet a gazdagép futásidőben használ (például
python-worker,node-worker). -
Sablonok: A
func newáltal megjelenített függvénysablonok (példáulpython-templates,node-templates).
Az elérhető számítási feladatok teljes listáját és leírását a CLI-referencia elérhető számítási feladatai között találja.
Első használati élmény
A parancssori felület első futtatásakor func initfunc newfunc runellenőrzi, hogy a forgatókönyvhöz szükséges számítási feladatok telepítve vannak-e. Ha nem, a parancssori felület kéri, hogy telepítse őket. Az üzenet elfogadása telepíti a javasolt készletet a kiválasztott veremhez. Elutasíthatja a felszólítást, és manuálisan telepítheti a munkaterheléseket a(z) func workload install használatával, vagy futtathatja a(z) func setup elemet a szabványos készlet nem interaktív telepítéséhez.
Munkaterhelés frissítései
Futtassa rendszeresen a(z) func workload search parancsot az újonnan elérhető munkaterhelések kereséséhez. Továbbra is használja a Core Tools (v4) eszközt nem támogatott stackek esetén, vagy ha a Core Tools bizonyos GA-funkcióira van szüksége.
Helyi projekt létrehozása
Új Functions-projekt létrehozásához használja a func init parancsot.
func init MyProjFolder --stack dotnet
func init MyProjFolder --stack node --language javascript
func init MyProjFolder --stack node --language typescript
func init MyProjFolder --stack python
func init MyProjFolder --stack go
A --stack beállítás megadja, hogy melyik nyelvi veremet kell használni. Az adott veremhez telepített munkaterhelés biztosítja a vázat.
Függvény létrehozása
Ha sablonból szeretne függvényt hozzáadni, használja a func new parancsot.
func new --template "HTTP trigger" --name MyHttpTrigger
Függvények lokális lefuttatása
A Functions-gazdagép elindításához és a projekt futtatásához használja a következőt func run:
func run
func start visszafelé kompatibilis aliasként van megőrzve. A gazda automatikusan kezeli az Azurite-ot (helyi tárolóemulátort), kivéve, ha megadja a(z) --no-azurite paramétert.
Projektváz létrehozása gyorsindítási sablonokból
A teljes mintaalkalmazások (HTTP API-k, üzenetsor-feldolgozók, Durable Functions-orchesztrációk) tallózásához és generálásához használja a func quickstart:
func quickstart --stack dotnet --resource http
func quickstart --stack node --resource http
func quickstart --stack python --resource http
func quickstart --stack go --resource http
Terhelések kezelése
Számítási feladatok telepítésére, frissítésére és eltávolítására használható func workload . Az alparancsok és lehetőségek teljes listáját a parancssori felület hivatkozásában találja func workload .
Profiles
A profilok a hosztra, a bővítménycsomagokra és a feldolgozókra vonatkozó verziókorlátozásokat rögzítik. Alkalmazzon egy profilt futásidőben a(z) func run --profile <name> használatával. Az alparancsok és lehetőségek teljes listáját a parancssori felület hivatkozásában találja func profile .