Azure Functions local runtime and tools reference

Ez a cikk referenciadokumentációt nyújt a helyi futásidőhöz és az Azure Functions-t támogató eszközökhöz. Használd ezeket az eszközöket Azure Functions projektek fejlesztésére, kezelésére és futtatására a helyi számítógépedről. A bináris név func (vagy func.exe Windows-n).

A CLI két változata érhető el. Használd a verzióválasztót, hogy melyik verziót nézd meg.

Fontos

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 gazdahajók saját számítási feladatként szolgálnak, így a parancssori felület ismételt letöltése nélkül megkapja a legújabb gazdaverziót.
Használja a következőt: 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.

További információ a Core Tools használatáról: Munka Azure Functions Core Tools.

Az Alapvető eszközök parancsok a következő környezetekbe vannak rendezve, amelyek mindegyike egyedi műveletkészletet biztosít.

Parancskörnyezet Leírás
func Parancsok függvények létrehozásához és futtatásához a helyi számítógépen.
func azure Parancsok Azure erőforrásokkal való munkához, beleértve a közzétételt is.
func azurecontainerapps Parancsok tárolóalapú függvényalkalmazás üzembe helyezéséhez a Azure Container Apps.
func bundles Bővítménykötegek kezelésére szolgáló parancsok.
func durable Parancsok a Durable Functions használatához.
func extensions Bővítmények telepítéséhez és kezeléséhez szükséges parancsok.
func kubernetes Parancsok a Kubernetes és a Azure Functions használatához.
func settings Parancsok a helyi Functions-gazdagép környezeti beállításainak kezeléséhez.
func templates Az elérhető függvénysablonok listázására használható parancsok.

A cikkben szereplő parancsok használata előtt telepítse a Core Tools eszközt.

Fontos

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.

Ha többet szeretnél megtudni a CLI használatáról, beleértve a telepítést és a munkaterhelést, lásd a Develop Azure Functions helyi fejlesztését a Azure Functions CLI segítségével.

A következő beépített parancsok az alap CLI telepítéssel rendelkeznek:

Command Leírás
func init Inicializálj egy új Azure Functions projektet.
func new Hozz létre egy új függvényt egy sablonból.
func run Indítsd el az Azure Functions host runtime-ját helyileg. func start visszafelé kompatibilis álnév.
func quickstart Böngészd és építs fel teljes funkciós alkalmazásokat a gyorsindító sablon katalógusból.
func profile Inspect and manage Azure Functions CLI profiles.
func setup Prepare local Azure Functions CLI dependencies (host runtime, language workers, extension bundles).
func workload Kezeld a telepített CLI munkaterheléseket.

A munkaterhelések további felső szintű parancsokat is hozzáadhatnak. Ezek a parancsok csak akkor jelennek meg, ha telepítetted a hozzá kapcsolódó munkaterhelést.

func init

Létrehoz egy új Functions-projektet egy adott nyelven.

func init [<PROJECT_FOLDER>]

Amikor beadod <PROJECT_FOLDER>, a parancs létrehozza a projektet egy új mappában ezzel a névvel. Egyébként a jelenlegi mappát használja.

A func init parancs ezeket az opciókat támogatja, amelyek a verziótól függnek:

Lehetőség Leírás
--bundles-channel, -c Bővítményköteg kiadási csatornája. A támogatott értékek a következők: GA (alapértelmezett), Previewés Experimental. Csak nem .NET projektekre alkalmazható.
--configuration-profile Inicializál egy projektet gazdagépkonfigurációs profillal. A --configuration-profile beállítás jelenleg előzetes verzióban érhető el. További információ: Konfigurációs profilok.
--csx Létrehozza .NET funkciókat C# script formátumban. Csak a --worker-runtime dotnet.
--docker Dockerfájlt hoz létre egy konténerhez egy alapkép felhasználásával, amely a kiválasztott --worker-runtime. Ezt a lehetőséget akkor használja, ha tárolóalapú függvényalkalmazást szeretne üzembe helyezni.
--docker-only Hozzáad egy Dockerfile-t egy meglévő projekthez. Kéri a feldolgozó-futtatókörnyezet megadását, ha nincs megadva vagy be van állítva local.settings.json. Ezt a lehetőséget akkor használja, ha tárolóalapú függvényalkalmazás üzembe helyezését tervezi, és a projekt már létezik.
--force Akkor is inicializálja a projektet, ha vannak meglévő fájlok a projektben. Ez a beállítás felülírja az azonos nevű meglévő fájlokat. A projektmappában lévő többi fájlra nincs hatással.
--language, -l Nyelvspecifikus projekt inicializálása. Jelenleg támogatott, ha --worker-runtime be van állítva.node A beállítások és typescripta javascript . Használhatja vagy --worker-runtime javascripthasználhatja is--worker-runtime typescript.
--managed-dependencies Felügyelt függőségeket telepít. Jelenleg csak a PowerShell-feldolgozó futtatókörnyezete támogatja ezt a funkciót.
--model, -m Beállítja a programozási modellt egy célnyelvhez, ha több modell is elérhető. A támogatott lehetőségek a Python V1 és V2, V3 és V4 Node.js. További információ: Python fejlesztői útmutató és a Node.js fejlesztői útmutató.
--no-bundle Ne konfigurálja a bővítménycsomagot ahost.json. Csak nem .NET projektekre alkalmazható.
--no-docs Kihagyja az "Első lépések" dokumentációs fájlok létrehozásának kihagyását. Python projektekre alkalmazható.
--skip-npm-install Hagyja ki a futást npm install a projekt létrehozása után. Node.js projektekre alkalmazható.
--source-control Meghatározza, hogy létrejön-e Git-adattár. Alapértelmezés szerint a rendszer nem hoz létre adattárat. Amikor truelétrejön egy adattár.
--worker-runtime Beállítja a projekt nyelvi futtatókörnyezetét. A támogatott értékek a következők: csharp, dotnet, dotnet-isolated, javascriptnode, (JavaScript), powershellpythonés typescript. A Java használja a Maven. Ha csak a projektfájlokat tartalmazó nyelvi-agnosztikus projektet szeretne létrehozni, használja customa következőt: . Ha nincs beállítva, a rendszer kérni fogja, hogy válassza ki a futtatókörnyezetet az inicializálás során.
--target-framework Beállítja a függvényalkalmazás-projekt cél keretrendszerét. Csak a --worker-runtime dotnet-isolated. A támogatott értékek a következők: net10.0 (előzetes verzió), net9.0, net8.0 (alapértelmezett), net6.0 és net48 (.NET Framework 4.8).

Feljegyzés

Ha a --docker vagy a --docker-only lehetőséget használja, a Core Tools automatikusan létrehozza a Dockerfile-t a C#, a JavaScript, a Python és a PowerShell függvényekhez. Java függvényekhez manuálisan kell létrehoznia a Dockerfile-t. További információ: Tárolóalapú függvényalkalmazások létrehozása.

Konfigurációs profilok

Fontos

A konfigurációs profilok támogatása jelenleg előzetes verzióban érhető el.

Amikor ezt --configuration-profile az opciót használod, előre meghatározott projektkonfigurációkat és beállításokat hozsz létre. Konfigurációs profil megadásakor előfordulhat, hogy az inicializálás kihagyja az összes többi inicializálási lépést.

Profilérték Leírás Konkrét műveletek
mcp-custom-handler Létrehoz egy projektet, amely egyéni kezelőkkel üzemeltet egy MCP-kiszolgálót (Model Context Protocol), amelyhez az AI-ügynökök és más MCP-ügyfelek csatlakozhatnak. • Konfigurálja a "configurationProfile": "mcp-custom-handler"host.json fájl elemét az egyéni kezelő beállításaival.
• Alocal.settings.jsonértékre MCP_EXTENSION_ENABLEDtrue.		 
func init [<PATH>] [options]

Amikor beadod <PATH>, a projekt abban a mappában jön létre. Ellenkező esetben a rendszer az aktuális mappát használja.

A func init parancs ezeket a beépített opciókat támogatja:

Lehetőség Leírás
--stack, -s A projekthez használt stack (például python, node, dotnet, ). go Fuss func workload list meg, hogy lássd a telepített munkaterhelések által hozzáadott stackeket.
--name, -n Az function app projekt neve.
--language, -l A programozási nyelv (például C#, F#, JavaScript, TypeScript, Python). Akkor használják, ha egy stack több nyelvet támogat. A támogatott értékeket telepített stack munkaterhelésekből számítják ki.
--force Újraindítás akkor is, ha a célmappa nem üres. A mappát (kivéve .git) kiüríti a vázlat előtt.

A munkaterhelések további opciókat adnak hozzá, amelyek a munkaterhelés neve alatt csoportosítva vannak .func init --help Lásd: a terhelés-specifikus opciók a stackenként.

Ha semmilyen munkaterhelés nem biztosítja a kért stacket, a Komentoköznapi kinyomtatás egy tippet nyomtat, amely a nemnulla kijárati kódot mutatja a func workload install Kikötőhöz, és kilép.

Munkaterhelés-specifikus lehetőségek

A init parancs kibővül, ha telepítesz egy vagy több ilyen munkaterhelést:

Lehetőség Leírás
--target-framework, -tfm A célpont .NET keretrendszer a projekthez (például net10.0). Alapértelmezett: net10.0.

A .NET inicializátor nem ír bővítménycsomag blokkot, így a --no-bundles és --bundles-channel nem alkalmazhatók.

Ha több telepített munkaterhelés ugyanazt az opciót adja hozzá, az opció egyszer jelenik meg .func init --help

Megosztott opciók

Jelenleg a közös opciók a --no-bundles és --bundles-channel. Az alapértelmezett kiterjesztési csomagazonosító, amelyhez írszhost.json a kiválasztott csatornától függ:

Csatorna Csomagazonosító
GA (alapértelmezett) Microsoft.Azure.Functions.ExtensionBundle
Preview Microsoft.Azure.Functions.ExtensionBundle.Preview
Experimental Microsoft.Azure.Functions.ExtensionBundle.Experimental

Az alapértelmezett verziótartomány .[4.*, 5.0.0)

func new

Új függvényt hoz létre az aktuális projektben sablon alapján.

func new

A func new parancs ezeket az opciókat támogatja, amelyek a verziótól függnek:

Lehetőség Leírás
--authlevel, -a Beállítja a HTTP-eseményindító engedélyezési szintjét. A támogatott értékek a következők: function, anonymous, admin. A helyi futtatáskor az engedélyezés nem lesz kényszerítve. További információ: Engedélyezési szint.
--csx Ugyanazokat a C# szkript (.csx) sablonokat generálja, mint az 1. verzióban és a portálban.
--file, -f Az új függvény célfájlja. A Python v2-projekteknél adja meg azt a fájlt, amelybe hozzá szeretné adni a függvényt (alapértelmezés szerint function_app.py). A Node.js v4-projektek esetében a kimeneti fájl nevét adja meg a src/functions mappában. Lefordított .NET projektekre nem alkalmazható.
--name, -n A függvény neve.
--template, -t func templates list A parancs használatával megtekintheti az egyes támogatott nyelvekhez elérhető sablonok teljes listáját.

További információ: Függvény létrehozása.

func new [<PATH>] [options]

Fontos

func new jelenleg egy előzetes stur. Kinyomtat egy munkaterhelés-telepítési tippet, majd nem nulla kijárati kóddal lép ki, amíg egy sablon munkaterhelés be nem épül és be nem kötik. A sablonspecifikus opciók dinamikusan hidratálódnak sablon metaadatból, így egy új sablonopció hozzáadásához nem kell CLI kiadás.

A func new parancs ezeket a beépített opciókat támogatja:

Lehetőség Leírás
--name, -n A függvény neve.
--template, -t A függvénysablon neve. A rendelkezésre álló sablonok a projekt stackjéhez telepített <stack>-templates munkaterhelésből származnak.
--force Meglévő fájlok felülírása.

További opciókat dinamikusan ad hozzá a kiválasztott sablon. Fuss func new --template <name> --help meg, hogy megnézd egy adott sablon opcióit.

Ha nincs betelepítve sablon munkaterhelés a jelenlegi projekthez, a CLI egy tippet nyomtat, ami a func workload installrá mutat.

func logs

Lekéri a Kubernetes-fürtön futó függvények naplóit.

func logs --platform kubernetes --name <APP_NAME>

A func logs parancs a következő beállításokat támogatja:

Lehetőség Leírás
--platform A függvényalkalmazás üzemeltetési platformja. Érvényes beállítások: kubernetes.
--name Függvényalkalmazás neve a Azure.

További információ: Azure Functions a Kubernetesen a KEDA-val.

func pack

Létrehoz egy üzembehelyezési csomagot, amely futtatható állapotban tartalmazza a projektkódot. Ezt a módszert akkor használja, ha manuálisan kell létrehoznia egy központi telepítési csomagot az alkalmazáshoz a helyi számítógépen, a func azure functionapp publish parancson kívül. Alapértelmezés szerint func pack szükség esetén létrehozza a projektet.

Go funkciós alkalmazásoknál a func pack egy Linux x64 telepítési csomagot épít, amit a Azure CLI az functionapp deployment source config-zip parancs segítségével telepíthetsz.

func pack [<FOLDER_PATH>]

Alapértelmezés szerint func pack az aktuális könyvtárat csomagolja, és a kimeneti .zip fájl neve megegyezik a projekt gyökérmappájának nevével. Futtassa func pack a host.json projektfájlt tartalmazó könyvtárban. Ha egy másik könyvtárban kell futtatnia func pack , állítsa be <FOLDER_PATH> a projektgyökér elérési útját, például func pack ./myprojectroot. Ha az adott .zip fájl már létezik, először törlődik, majd egy frissített verzióra cseréli.

A func pack parancs a következő beállításokat támogatja:

Lehetőség Leírás
--output, -o Beállítja annak a helynek az elérési útját, ahol az üzembe helyezési .zip csomagfájl létrejön.
--no-build Project nem csomagolás előtt készült. C#-alkalmazások esetén csak akkor használja, ha már létrehozta a bináris fájlokat. Node.js alkalmazások esetében mindkettőt npm installnpm run build kihagyja. Go alkalmazásokhoz csak akkor használd, ha a bin/app már tartalmaz Linux x64 binárist.
--skip-install Kihagyja a futtatásokat npm install Node.js-alapú függvényalkalmazások csomagolásakor. Az egyéni npm-modulok felülírásának elkerülésére szolgál.
--build-native-deps Helyileg telepíti Python függőségeket egy olyan rendszerkép használatával, amely megfelel a Azure használt környezetnek. Ha engedélyezve van, a Core Tools elindít egy Docker-tárolót, létrehozza az alkalmazást a tárolóban .python_packages, és létrehoz egy .zip fájlt, amelyben az összes függőség visszaállítva van. Ezzel a beállítással Windows futtatva elkerülheti a lehetséges kódtárproblémákat, amikor linuxos környezetben helyezi üzembe Azure.

func run (csak v1-ben)

Feljegyzés

Ez a parancs csak a Core Tools 1-es verziójára vonatkozik, és elavult. A 4. verzióhoz közvetlenül használd func start és hívd meg a funkció végpontját.

Közvetlenül hív egy függvényt, hasonlóan ahhoz, amikor a Azure portál Test fülén futtatnánk egy függvényt.

func run

A func run parancs a következő beállításokat támogatja:

Lehetőség Leírás
--content A függvénynek átadott beágyazott tartalom.
--debug A függvény futtatása előtt csatoljon egy hibakeresőt a gazdafolyamathoz.
--file A tartalomként használandó fájlnév.
--no-interactive Nem kér bemenetet, ami automatizálási forgatókönyvekhez hasznos.
--timeout Várakozási idő (másodpercben), amíg a helyi Functions-gazdagép készen áll.

Egy HTTP által aktivált függvény meghívásához és a tartalomtörzs átadásához futtassa például ezt a parancsot:

func run MyHttpTrigger --content '{\"name\": \"Azure\"}'

func start

Elindítja a helyi futtatókörnyezet gazdagépét, és betölti a függvényprojektet az aktuális mappába.

Az adott parancs a futtatókörnyezet verziójától függ.

func start

A func start parancs a következő beállításokat támogatja:

Lehetőség Leírás
--cert A titkos kulcsot tartalmazó .pfx-fájl elérési útja. Csak a --useHttps.
--cors A CORS-források vesszővel tagolt listája szóközök nélkül.
--cors-credentials Engedélyezi a cookie-kat és a hitelesítési fejlécet használó, több forrásból származó hitelesített kéréseket.
--dotnet-isolated-debug Ha true értékre van állítva, szünetelteti a .NET feldolgozói folyamatot, amíg egy hibakeresőt nem csatol a hibakeresés alatt álló .NET izolált projekthez.
--enable-json-output Lehetőség szerint JSON-ként bocsát ki konzolnaplókat.
--enableAuth Engedélyezi a teljes hitelesítési kezelési folyamatot engedélyezési követelményekkel.
--functions A betöltendő függvények szóközzel elválasztott listája.
--json-output-file Ha meg van adva, a kimenet --enable-json-outputírásához használt fájl elérési útja.
--language-worker A nyelvi feldolgozó konfigurálásához használható argumentumok. Engedélyezheti például a hibakeresést a nyelvi feldolgozó számára a hibakeresési port és egyéb szükséges argumentumok megadásával.
--no-build A futtatás előtt ne hozza létre az aktuális projektet. Csak .NET osztályprojektekhez. Az alapértelmezett érték false.
--password A jelszó vagy egy .pfx fájl jelszavát tartalmazó fájl. Csak a --cert.
--port, -p A figyelendő helyi port. Alapértelmezett érték: 7071.
--runtime Beállítja, hogy a gazdagép melyik verzióját indítsa el. Az engedélyezett értékek a következők: inproc6, inproc8és default (amely a folyamaton kívüli gazdagépet futtatja).
--timeout, -t A Functions-gazdagép kezdési időkorlátja másodpercben. Alapértelmezett: 20 másodperc.
--useHttps Kötés ahelyett, https://localhost:{port} hogy a .http://localhost:{port} Ez a beállítás alapértelmezés szerint létrehoz egy megbízható tanúsítványt a számítógépen.
--user-log-level A felhasználói naplók minimális naplószintjének beállítása. Az érvényes értékek a következők: Trace, Debug, Information, Warning, Error, Criticalés None. Ez a beállítás nincs hatással a rendszernaplókra. Az elkülönített projektek .NET a Program.cs minimális szintjét is beállíthatja a beállítás érvénybe lépéséhez a builder.Logging.SetMinimumLevel(LogLevel.Debug) használatával.

Ha a projekt fut, ellenőrizze az egyes függvényvégpontokat.

func run

Indítja el a Functions host futásidőt, és betölti a projektet a jelenlegi mappába.

func run [<PATH>] [options]

func start visszafelé kompatibilis álnévként marad fenn, és ugyanazokat az érveket, valamint opciókat fogadja el.

A func run parancs a következő beállításokat támogatja:

Lehetőség Leírás
--port, -p A figyelendő helyi port. Alapértelmezett: 7071.
--cors A CORS-források vesszővel tagolt listája szóközök nélkül.
--cors-credentials Engedélyezzük a kereszteredetű hitelesítési kéréseket, amelyek sütiket és a Authentication fejlécet használnak.
--functions A betöltendő függvények szóközzel elválasztott listája.
--no-build Ne építsd fel a projektet a futás előtt.
--enable-auth Engedélyezze a teljes hitelesítés-kezelő folyamatot, beleértve az engedélyezési követelményeket is.
--host-version, -v A host runtime verzió, amit használni kell (például 4.1049.0).
--profile Az Azure Functions profil alkalmazásához a host, worker és bundle verziók megoldása során. Lásd a(z) func profile.
--offline Csak helyben telepített munkaterheléseket használjunk, és hagyd ki a hálózati telepítéseket.
--output Kimeneti mód: compact (interaktív TUI), plain (CI / nem TTY), vagy json (NDJSON programozott fogyasztók és AI ügynökök számára). Alapértelmezés az automatikus azonosítás a terminál alapján.
--no-tui Alias a következőhöz --output=plain: . Letiltja az interaktív TUI-t.
--log-file Tükrözze az összes host eseményt a megadott naplófájlba.
--no-azurite A kezelt Azurit letiltása. A hoszter nem indul be a helyi emulátor tesztelése vagy indítása.

Amikor a projekt fut, közvetlenül hívd a függvényvégpontokat a viselkedés ellenőrzésére.

Kezelt Azurit

Ha a projekted helyi tárolót használ (például AzureWebJobsStorage=UseDevelopmentStorage=true), func run automatikusan ellenőrzi az Azurite emulátort, és elindítja egyet, ha nem talál ilyet. Az emulátor leáll, amikor func run kilép. Passzolj --no-azurite , hogy kilépj és kezeld az Azurite-ot magad.

Kimeneti módok

func run automatikusan kiválaszt egy kimeneti módot a terminál alapján:

Állapot Üzemmód
Interaktív terminál (TTY) compact
Nem interaktív stdout, átirányított kimenet vagy CI környezeti változóhalmaz plain
Explicit --output=json json

A Sorrendi Rendszer soha nem választja jsonautomatikusan . Ha compact kérik, de stdout nem TTY, akkor a CLI visszautal és plain egy soros értesítést ír az stderr-re. A json mód új vonal-delimitált JSON-t (NDJSON) bocsát ki, egy objektumot soronként, egy schema_version .1

func quickstart

Böngész és scaffolds teljes funkciós alkalmazásokat az Azure Functions gyorsindítási sablon katalógusából. A gyorsindítási sablonok teljes mintaalkalmazások, mint például HTTP API, sorban triggerelt munkatárs vagy Durable Functions orkráráció. A stack munkaterhelések hozzájárulnak a nyelvspecifikus feloldókhoz. A katalógus parancshívás idején kerül elő.

func quickstart [<PATH>] [options]

Amikor beadod <PATH>, a projekt abban a mappában jön létre. Ellenkező esetben a rendszer az aktuális mappát használja.

A func quickstart parancs a következő beállításokat támogatja:

Lehetőség Leírás
--stack, -s A használt halom, például python, node, vagy dotnet.
--language, -l A programozási nyelv. A támogatott értékek telepített gyorsindító szolgáltatóktól származnak.
--template, -t Sablonazonosító a katalógusból, például http-trigger-python-azd. Minden interaktív promptot kihagy.
--resource, -r Szűrő trigger vagy kötési erőforrás szerint, például , , , , , httptimerblobeventhub, vagy .servicebuscosmossqlmcpdurable
--iac Szűrj infrastruktúra-kódként típus szerint, például bicep, terraform, vagy none.
--search Kis- és nagybetűs alstringszűrő, amelyet sablonnevekre és leírásokra alkalmaznak.
--fetch Katalógus bevonási stratégia: auto (alapértelmezett), git, vagy http. auto átvizsgálja a git HTTP-t, és visszatér a HTTP-hez.
--force Állvány akkor is, ha a célmappa nem üres. A mappát (kivéve .git) kiüríti a vázlat előtt.

Alparancsok:

Subcommand Leírás
func quickstart list Listázd fel a rendelkezésre álló sablonokat a katalógusban.
func quickstart info Mutasd meg a részleteket egy adott sablonról.

func quickstart list

Elérhető sablonok a katalógusból, opcionálisan szűrve.

func quickstart list [options]
Lehetőség Leírás
--stack, -s A használt halom, például python, node, vagy dotnet.
--language, -l A programozási nyelv. A támogatott értékek telepített gyorsindító szolgáltatóktól származnak.
--resource, -r Szűrő trigger vagy binding resource szerint.
--iac Szűrj infrastruktúra-kódként típus szerint.
--search Kisbetű-érzékeny alstring egyezik az azonosítókkal, sablonnevekkel, erőforrás típussal, az infrastruktúra kód típusával és leírásokkal.
--json Géppel olvasható JSON kibocsátás táblázat helyett.

func quickstart info

Részletes információkat jelenít meg egy adott sablonról.

func quickstart info <ID> [options]

<ID> a katalógusból származó sablonazonosító. Használd func quickstart list az elérhető azonosítók felfedezésére.

Lehetőség Leírás
--json Gépen olvasható JSON kibocsátás a formázott kimenet helyett.

func profile

Vizsgálja és kezeli az Azure Functions CLI profilokat. A profilok verziókorlátokat kódolnak, mint például a host verziótartomány, a bővítménycsomag verziótartomány és a munkatárs verziótartományok. Más profilokból is meghatározzák az öröklést is. A profilforrások közé tartoznak a project-local (.func/profiles/), user-global (~/.azure-functions/profiles/), valamint beépített profilok. Használd a func run --profile <name> választógombot, hogy melyik profil korlátai érvényesek a host indításakor.

func profile <subcommand>

Alparancsok:

Subcommand Leírás
func profile list Listázd fel a projekt-, felhasználói és beépített forrásokból elérhető profilokat.
func profile show Részleteket mutasson a profilhoz.
func profile set Állítsd be a projekt alapértelmezett profilját.

func profile list

Felsorolja a projekt, felhasználó és beépített forrásokból elérhető profilokat. Megjelenít egy táblát a névről, forrásból, hadószerverről, bővítménycsomagról és státuszról.

func profile list [<PATH>] [options]
Lehetőség Leírás
--source Vesszővel elválasztott források listája, amely tartalmazza: project, user, built-in. Minden forrásra alapértelmezett.
--json Géppel olvasható JSON kibocsátás táblázat helyett.

func profile show

Egyetlen profil részleteit mutatja, akár feloldott (öröklött értékekkel), akár nyers (a definifikáció leírása szerint, öröklés bővítés nélkül).

func profile show <NAME> [<PATH>] [options]
Lehetőség Leírás
--raw Mutassa meg a nyers profildefiníciót öröklött értékek nélkül.

func profile set

A Functions projekt alapértelmezett profilját úgy állítja be, hogy a profilnevet a projekt beírja .func/config.json. Ha a profil még nincs a projekt profillistáján, add hozzá.

func profile set <NAME> [<PATH>]

func setup

Előkészíti a helyi gépet Azure Functions projektek futtatására. Telepíti vagy ellenőrzi a host runtime-t, a nyelvi munkálókat, a bővítménycsomagokat és a megadott stackek sablonjait. Támogatja profilalapú verziókorlátokat, előzetes kiválasztást, nem interaktív CI módot és csak ellenőrzési módot.

func setup [<PATH>] [options]

--features Kiválasztja, mit telepít vagy ellenőriz. A funkciók és a munkaterhelések, amelyeket mindegyik megold, a következők:

Funkció Telepített munkaterhelések
node host, bundles, node, node-workernode-templates
python host, bundles, python, python-workerpython-templates
go host, bundles, gogo-worker
dotnet \, \, \
runtime host, bundles
host host csak

--features ismételhető, és vesszővel elválasztott értékeket fogad el, így egyetlen hívásban kombinálhatod a jellemzőket (például func setup --features node,python). dotnet-isolatedelismerik álnévként .dotnet

Lehetőség Leírás
--features Alkatrészek, amiket telepíteni vagy ellenőrizni. Ismételhető vagy vesszővel elválasztva. Lásd a fenti táblázatot az egyes funkciók által telepített munkaterhelésekért.
--profile Azure Functions profil verziókorlátokhoz használatra. Ismételhető. Összeolvadva .--profiles
--profiles Verzseléssel elválasztott Azure Functions profillista verziókorlátokhoz való használatra.
--install-policy Telepítési szabályzat: latest-compatible (alapértelmezett) vagy if-needed.
--source NuGet csomagforrás, amit a munkaterhelés felbontásához és telepítéséhez használhatunk.
--prerelease Engedélyezze a kiadó munkaterhelés verziókat, amikor a katalógusból oldódik meg. Alapértelmezett: engedélyezve, amíg a munkaterhelések előnézetben vannak.
--non-interactive Ne kérj hozzászólást.
--yes, -y Válasz igennel a beállítási promptokra.
--check Ellenőrizd, hogy a kiválasztott függőségek telepítettek-e anélkül, hogy változtatnánk.
--output Kimeneti mód: plain (alapértelmezett) vagy json (NDJSON).

func workload

Kezeli az Azure Functions CLI-hez telepített munkaterheléseket.

func workload <subcommand>

Alparancsok:

Subcommand Leírás
func workload list Listázd fel a telepített munkaterheléseket.
func workload search Keresd meg a munkaterhelés katalógusát.
func workload install Telepíts egy munkaterhelést.
func workload update Frissítsd a telepített munkaterhelést.
func workload uninstall Törölj egy munkaterhelést.
func workload prune Távolítsd el az inaktív egymás melletti munkaterhelés telepítéseket.

func workload list

A telepített számítási feladatok listája. Alapértelmezés szerint a parancs csak a betöltött verziót (legmagasabb telepítésű semver) mutatja minden munkaterhelésnek. Használd --all-versions minden egymás melletti telepítést látni.

func workload list [options]
Lehetőség Leírás
--all-versions, -a Sorold fel minden telepített verziót minden munkaterheléshez. Alapértelmezett: csak betöltött verzió.
--json Géppel olvasható JSON kibocsátás táblázat helyett.

A konfigurált munkaterhelés katalógusában keresi a rendelkezésre álló munkaterhelés csomagokat.

func workload search [<QUERY>] [options]

Ha kihagyod <QUERY>, a parancs felsorolja az összes munkaterhelést a katalógusban.

Lehetőség Leírás
--source Katalógus forrás URL-je a kereséshez. Alapértelmezett a konfigurált katalógus.
--prerelease Mellékeld az előzetes kiadású verziókat az eredményekbe. Alapértelmezett: engedélyezve, amíg a munkaterhelések előnézetben vannak.
--json Géppel olvasható JSON kibocsátás táblázat helyett.

func workload install

Megoldja a munkaterhelés csomagazonosítóját (vagy aliast) a konfigurált katalóguson keresztül, és telepíti.

func workload install <ID> [options]

<ID> lehet munkaterhelés csomagazonosító, alias (például python), vagy egy helyi munkaterhelés csomagfájlhoz vezető út.

Lehetőség Leírás
--version, -v Konkrét verzió telepítésére. Alapértelmezett: a katalógus legfrissebb stabil változata.
--source Katalógus forrás URL vagy helyi könyvtár megoldása érdekében. Alapértelmezett: a konfigurált katalógus.
--prerelease Engedélyezd az előzetes kiadású verziókat, amikor a katalógusból oldod meg. Alapértelmezett: engedélyezve, amíg a munkaterhelések előnézetben vannak.
--force, -f Írj felül egy meglévő telepítést ugyanazzal az ID-vel és verzióval. Emellett kihagyja a "használd frissítést helyette" promptot is.
--exact, -e Kapcsold ki az alias párosítást. <ID> biztosan a csomagazonosító a szó szerint.

Ha a munkaterhelés egy verziója már telepítve van, a CLI arra kér, hogy használd func workload update helyette. A nem interaktív kontextusokban a promptot visszaesésként kezelik.

func workload update

Telepített munkaterhelés esetén helyben atomi verzió cserét hajt végre. A frissítések nem egymás mellett zajlanak; Egymás melletti telepítésekhez használj func workload install --force.

func workload update [<ID>] [options]

Pass an <ID> egyetlen munkaterhelés frissítéséhez, vagy --all minden telepített munkaterhelés frissítéséhez. Pontosan az egyik opciót jelöld meg.

Lehetőség Leírás
--version, -v Telepített verzió cserére. Alapértelmezett: a legmagasabban telepített verzió.
--all Frissítsd az összes telepített munkaterhelést. Kölcsönösen kizárja egymást a <ID>-vel.
--major Engedélyezzük a nagy verziójú határ átlépését. Alapértelmezett: csak ugyanaz a szak.
--source Katalógus forrás URL vagy helyi könyvtár megoldása érdekében. Alapértelmezett: a konfigurált katalógus.
--prerelease Engedélyezd az előzetes kiadású verziókat, amikor a katalógusból oldod meg. Alapértelmezett: engedélyezve, amíg a munkaterhelések előnézetben vannak.
--exact, -e Kapcsold ki az alias párosítást. <ID> biztosan a csomagazonosító a szó szerint.

func workload uninstall

Eltávolítja egy vagy az összes telepített verziót egy munkaterhelésből.

func workload uninstall <ID> [options]
Lehetőség Leírás
--version, -v Konkrét verzió az eltávolításra. Alapértelmezett: az egyetlen telepített verzió.
--all-versions, -a Távolítsd el az összes telepített munkaterhelés verziót. Kölcsönösen kizárja egymást a --version-vel.
--exact, -e Kapcsold ki az alias párosítást. <ID> biztosan a csomagazonosító a szó szerint.

func workload prune

Eltávolítja az inaktív, egymás melletti munkaterheléses telepítéseket. Minden belső csomagazonosító esetén a parancs megtartja a legmagasabb telepített verziót, és eltávolítja a régebbi verziókat. Ez a parancs csak helyi rendszerű, és soha nem érinti a katalógust.

func workload prune [<ID>] [options]

Ha kihagyod <ID>, a parancs minden telepített terhelést levág.

Lehetőség Leírás
--exact, -e Kapcsold ki az alias párosítást. <ID> biztosan a csomagazonosító a szó szerint.

func azure functionapp

A func azure functionapp környezet a következő parancsokat tartalmazza:

Az összes func azure functionapp parancs támogatja ezeket a beállításokat:

Lehetőség Leírás
--slot Ha konfigurálva van, egy adott elnevezett üzembehelyezési pontot céloz meg.
--access-token Az alapértelmezett jogkivonattól eltérő hozzáférési jogkivonatot biztosít a hitelesített műveletek végrehajtásához Azure.
--access-token-stdin Beolvas egy adott hozzáférési jogkivonatot a standard bemenetből. Ezt a lehetőséget akkor használja, ha a jogkivonatot közvetlenül egy előző parancsból olvassa, például az account get-access-token.
--management-url Beállítja a Azure felhő felügyeleti URL-címét, amely alapértelmezés szerint https://management.azure.com. Ezt a lehetőséget akkor használhatja, ha a függvényalkalmazás szuverén felhőben fut.
--subscription Beállítja az alapértelmezett Azure-előfizetést.

func azure functionapp fetch-app-settings

Lekéri a beállításokat egy adott függvényalkalmazásból.

func azure functionapp fetch-app-settings <APP_NAME>

További információ: Alkalmazásbeállítások letöltése.

A parancs letölti a beállításokat a projektlocal.settings.json fájljába. A képernyőn megjelenő értékek maszkoltak a biztonság érdekében. A local.settings.json fájl beállításait a helyi titkosítás engedélyezésével védheted.

func azure functionapp list-functions

A megadott függvényalkalmazás függvényeinek listája.

func azure functionapp list-functions <APP_NAME>

A func azure functionapp list-functions parancs ezt a beállítást támogatja:

Lehetőség Leírás
--show-keys Adja meg a függvényszintű hozzáférési kulcs értékeit a visszaadott függvényvégpont URL-címeiben.

func azure functionapp logstream

Csatlakoztatja a helyi parancssort a függvényalkalmazás streamelési naplóihoz a Azure.

func azure functionapp logstream <APP_NAME>

A kapcsolat alapértelmezett időtúllépése 2 óra. Az időtúllépés módosításához adjon hozzá egy SCM_LOGSTREAM_TIMEOUT nevű alkalmazásbeállítást másodpercben megadott időtúllépési értékkel. Linux esetén még nem támogatott Flex Consumption vagy Consumption csomagban. Ezekben az alkalmazásokban a naplókat a --browser portálon tekintheti meg.

A func azure functionapp logstream parancs ezt a beállítást támogatja:

Lehetőség Leírás
--browser Nyissa meg a Azure-alkalmazás Insights Live Streamet a függvényalkalmazáshoz az alapértelmezett böngészőben.

További információ: A streamelési végrehajtási naplók Azure Functions.

func azure functionapp publish

Functions-projektet helyez üzembe egy meglévő függvényalkalmazás-erőforráson a Azure.

func azure functionapp publish <APP_NAME>

További információ: Projektfájlok üzembe helyezése.

A következő közzétételi lehetőségek érvényesek a verzió alapján:

Lehetőség Leírás
--additional-packages A natív függőségek létrehozásakor telepíteni kívánt csomagok listája. Például: python3-dev libevent-dev.
--build, -b Buildelési műveletet hajt végre linuxos függvényalkalmazásban való üzembe helyezéskor. Elfogadja: remote és local.
--build-native-deps Kihagyja a .wheels mappa létrehozásának kihagyását Python függvényalkalmazások közzétételekor.
--csx C#-szkript (.csx) projekt közzététele.
--dotnet-cli-params A lefordított C# (.csproj) függvények közzétételekor az alapvető eszközök meghívják a függvényt dotnet build --output bin/publish. Az ehhez a beállításhoz átadott paraméterek hozzá vannak fűzve a parancssorhoz.
--dotnet-version A dotnet-isolated alkalmazások esetében a cél .NET verziót adja meg (például 8.0).
--force Bizonyos esetekben figyelmen kívül hagyja az előzetes közzététel ellenőrzését.
--list-ignored-files Megjeleníti a közzététel során figyelmen kívül hagyott fájlok listáját a .funcignore fájl alapján.
--list-included-files Megjeleníti a közzétett fájlok listáját, amely a .funcignore fájlon alapul.
--no-build Project nem a közzététel során készült. A Python pip install nem fut.
--nozip Kikapcsolja az alapértelmezett Run-From-Package módot. A fájlok kinyerése a wwwroot kiszolgáló mappájába ahelyett, hogy közvetlenül az üzembe helyezési csomagból futtatja őket.
--overwrite-settings, -y Letiltja az alkalmazásbeállítások felülírására vonatkozó kérést a használat --publish-local-settings -isorán.
--publish-local-settings, -i Közzéteszi a beállításokat a local.settings.json Azure, és kéri, hogy írja felül, ha a beállítás már létezik. Ha helyi tárolóemulátort használ, először módosítsa az alkalmazásbeállítást egy tényleges tárolási kapcsolatra.
--publish-settings-only, -o Csak a beállításokat teszi közzé, és kihagyja a tartalmat. Az alapértelmezett érték a parancssor.
--show-keys Függvénykulcsokat ad hozzá a naplókban megjelenített URL-címekhez.

func azure storage fetch-connection-string

Lekéri a megadott Azure Storage fiók kapcsolati karakterlánc.

func azure storage fetch-connection-string <STORAGE_ACCOUNT_NAME>

További információ: letöltési kapcsolati karakterlánc.

func azurecontainerapps deploy

Tárolóalapú függvényalkalmazás üzembe helyezése Azure Container Apps környezetben. Az alapértelmezett host tárolófióknak, a funkcióalkalmazásnak és a környezetnek már léteznie kell. További információ: Azure Container Apps üzemeltetése Azure Functions.

func azurecontainerapps deploy --name <APP_NAME> --environment <ENVIRONMENT_NAME> --storage-account <STORAGE_CONNECTION> --resource-group <RESOURCE_GROUP> --image-name <IMAGE_NAME> --registry-server <REGISTRY_SERVER> --registry-username <USERNAME> --registry-password <PASSWORD>

A következő üzembehelyezési beállítások érvényesek:

Lehetőség Leírás
--environment Egy meglévő Container Apps-környezet neve.
--image-build Állítsa be a true helyi Docker-build kihagyására.
--image-name A tárolóregisztrációs adatbázisban lévő meglévő tárolórendszerkép neve, beleértve a címke nevét is.
--location Az üzembe helyezés régiója. Ideális esetben ez a régió megegyezik a környezet és a tárfiók erőforrásaival.
--name A függvényalkalmazás Container Apps-környezetben való üzembe helyezéséhez használt név. Ez a név a függvényalkalmazás portálon történő kezelésekor is megjelenik. A névnek egyedinek kell lennie a környezetben.
--registry Ha be van állítva, egy Docker-build fut, és a rendszer leküldi a rendszerképet a beállításjegyzékbe.--registry Nem használható --registry a következővel --image-name: . A Docker Hub --registry-username is használható.
--registry-password A rendszerkép magánregisztrációs adatbázisból való lekéréséhez használt jelszó vagy jogkivonat.
--registry-username A rendszerkép magánregisztrációs adatbázisból való lekéréséhez használt felhasználónév.
--resource-group Az az erőforráscsoport, amelyben a függvényekkel kapcsolatos erőforrásokat létre szeretné hozni.
--storage-account A függvényalkalmazás által használni kívánt tárfiók kapcsolati karakterlánc.
--worker-runtime Beállítja a függvényalkalmazás futtatókörnyezeti nyelvét. Ezt a paramétert csak a --image-name rendszer használja, ellenkező --image-buildesetben a nyelv meghatározása a helyi build során történik. A támogatott értékek a következők: dotnet, dotnetIsolated, node, python, powershellés custom (egyéni kezelők esetén).

Fontos

A tárolási kapcsolati sztring és más szolgáltatás hitelesítő adatai fontos titkos kulcsok. Biztonságosan tárolhatja azokat a szkriptfájlokat, amelyek nyilvánosan hozzáférhető forrásvezérlőkben használják func azurecontainerapps deploy és nem tárolják őket.

func deploy

A func deploy parancs elavult. Ehelyett használja a func kubernetes deploy.

func bundles add

Bővítményköteg-konfigurációt ad hozzá a host.json fájlhoz.

func bundles add

A func bundles add parancs a következő beállításokat támogatja:

Lehetőség Leírás
--force, -f Felülírja a meglévő bővítményköteg konfigurációját, ha van ilyen.
--channel, -c Bővítményköteg kiadási csatornája. A támogatott értékek a következők: GA (alapértelmezett), Previewés Experimental.

func bundles download

Letölti a host.jsonkonfigurált bővítménycsomagot.

func bundles download

A func bundles download parancs a következő beállításokat támogatja:

Lehetőség Leírás
--force, -f A bővítménycsomag újraletöltését kényszeríti még akkor is, ha az már jelen van.

func bundles list

A letöltött bővítménycsomagok listája.

func bundles list

func bundles path

Lekéri a letöltött bővítménycsomag elérési útját.

func bundles path

func durable delete-task-hub

Törli a Durable Functions tevékenységközpontban található összes tárolási összetevőt.

func durable delete-task-hub

A func durable delete-task-hub parancs a következő beállításokat támogatja:

Lehetőség Leírás
--connection-string-setting A használni kívánt tárterületet tartalmazó beállítás neve kapcsolati karakterlánc.
--task-hub-name A használni kívánt Tartós feladatközpont neve.

További információ: Durable Functions dokumentáció.

func durable get-history

Egy adott vezénylési példány előzményeit adja vissza.

func durable get-history --id <INSTANCE_ID>

A func durable get-history parancs a következő beállításokat támogatja:

Lehetőség Leírás
--id Vezénylési példány azonosítója. (Szükséges)
--connection-string-setting Annak a beállításnak a neve, amely rendelkezik a használni kívánt tárolási kapcsolati karakterlánc.
--task-hub-name A használni kívánt Tartós feladatközpont neve.

További információ: Durable Functions dokumentáció.

func durable get-instances

Az összes vezénylési példány állapotát adja vissza. Ez a parancs támogatja a pageringet a paraméter használatával top .

func durable get-instances

A func durable get-instances parancs a következő beállításokat támogatja:

Lehetőség Leírás
--continuation-token A visszaadni kívánt kérések egy adott oldalát vagy szakaszát jelző jogkivonat.
--connection-string-setting A használni kívánt tárolási kapcsolati karakterlánc tartalmazó alkalmazásbeállítás neve.
--created-after A dátum és idő (UTC) után létrehozott példányok lekérése. A rendszer minden ISO 8601 formátumú dátumidőt elfogad.
--created-before Egy adott dátum és időpont (UTC) előtt létrehozott példányok lekérése. A rendszer minden ISO 8601 formátumú dátumidőt elfogad.
--runtime-status Lekérheti azokat a példányokat, amelyek állapota megfelel egy adott állapotnak, beleértve a running, completedés failed. Megadhat egy vagy több szóközzel elválasztott állapotot.
--top Az adott kérelemben visszaadott rekordok számának korlátozása.
--task-hub-name A használni kívánt Durable Functions feladatközpont neve.

További információ: Durable Functions dokumentáció.

func durable get-runtime-status

Egy adott vezénylési példány állapotát adja vissza.

func durable get-runtime-status --id <INSTANCE_ID>

A func durable get-runtime-status parancs a következő beállításokat támogatja:

Lehetőség Leírás
--connection-string-setting A használni kívánt tárolási kapcsolati karakterlánc tartalmazó beállítás neve.
--id Vezénylési példány azonosítója. (Szükséges)
--show-input Ha be van állítva, a válasz tartalmazza a függvény bemenetét.
--show-output Ha be van állítva, a válasz tartalmazza a végrehajtási előzményeket.
--task-hub-name A használni kívánt Durable Functions feladatközpont neve.

További információ: Durable Functions dokumentáció.

func durable purge-history

Törli a vezénylési példány állapotát, előzményeit és blobtárolóit a megadott küszöbértéknél régebbi vezénylésekhez.

func durable purge-history

A func durable purge-history parancs a következő beállításokat támogatja:

Lehetőség Leírás
--connection-string-setting A használni kívánt tárolási kapcsolati karakterlánc tartalmazó beállítás neve.
--created-after Törölje a dátum/idő (UTC) után létrehozott példányok előzményeit. A rendszer minden ISO 8601 formátumú dátum/idő értéket elfogad.
--created-before Törölje a dátum/idő (UTC) előtt létrehozott példányok előzményeit. A rendszer minden ISO 8601 formátumú dátum/idő értéket elfogad.
--runtime-status Törölje azoknak a példányoknak az előzményeit, amelyek állapota egy adott állapotnak felel meg, beleértve a completed, terminated, canceledés failed. Adjon meg egy vagy több szóközzel elválasztott állapotot. Ha nem adja meg --runtime-status, a rendszer állapottól függetlenül törli a példányelőzményeket.
--task-hub-name A használni kívánt Durable Functions feladatközpont neve.

További információ: Durable Functions dokumentáció.

func durable raise-event

Eseményt hoz létre a megadott vezénylési példányra.

func durable raise-event --event-name <EVENT_NAME> --event-data <DATA>

A func durable raise-event parancs a következő beállításokat támogatja:

Lehetőség Leírás
--connection-string-setting A használni kívánt tárolási kapcsolati karakterlánc tartalmazó beállítás neve.
--event-data Az eseménynek továbbítandó adatok beágyazott vagy JSON-fájlból. Fájlok esetén előtagként írja be a fájl elérési útját egy at sign (@), például @path/to/file.json. (Szükséges)
--event-name Az esemény neve. (Szükséges)
--id Vezénylési példány azonosítója. (Szükséges)
--task-hub-name A használni kívánt Durable Functions feladatközpont neve.

További információ: Durable Functions dokumentáció.

func durable rewind

Visszatekeri a megadott vezénylési példányt.

func durable rewind --id <INSTANCE_ID> --reason <REASON>

A func durable rewind parancs a következő beállításokat támogatja:

Lehetőség Leírás
--connection-string-setting A használni kívánt tárolási kapcsolati karakterlánc tartalmazó beállítás neve.
--id Vezénylési példány azonosítója. (Szükséges)
--reason A vezénylés visszatekerésének oka. (Szükséges)
--task-hub-name A használni kívánt Durable Functions feladatközpont neve.

További információ: Durable Functions dokumentáció.

func durable start-new

Elindítja a megadott vezénylőfüggvény új példányát.

func durable start-new --id <INSTANCE_ID> --function-name <FUNCTION_NAME> --input <INPUT>

A func durable start-new parancs a következő beállításokat támogatja:

Lehetőség Leírás
--connection-string-setting A használni kívánt tárolási kapcsolati karakterlánc tartalmazó beállítás neve.
--function-name A elindítandó vezénylő függvény neve. (Szükséges)
--id Egy vezénylési példány azonosítóját adja meg. (Szükséges)
--input Bemenet a vezénylő függvénybe beágyazott vagy JSON-fájlból. Fájlok esetén az előtag a fájl elérési útját egy erősítővel (@), például @path/to/file.json. (Szükséges)
--task-hub-name A használni kívánt Durable Functions feladatközpont neve.

További információ: Durable Functions dokumentáció.

func durable terminate

Véget vet a megadott vezénylési példánynak.

func durable terminate --id <INSTANCE_ID> --reason <REASON>

A func durable terminate parancs a következő beállításokat támogatja:

Lehetőség Leírás
--connection-string-setting A használni kívánt tárolási kapcsolati karakterlánc tartalmazó beállítás neve.
--id Egy vezénylési példány azonosítóját adja meg. (Szükséges)
--reason A vezénylés befejezésének oka. (Szükséges)
--task-hub-name A használni kívánt Durable Functions feladatközpont neve.

További információ: Durable Functions dokumentáció.

func extensions install

Manuálisan telepíti a Functions-bővítményeket egy nem .NET projektbe vagy egy C#-szkriptprojektbe.

func extensions install --package Microsoft.Azure.WebJobs.Extensions.<EXTENSION> --version <VERSION>

A func extensions install parancs a következő beállításokat támogatja:

Lehetőség Leírás
--configPath, -c A extensions.csproj fájlt tartalmazó könyvtár elérési útja.
--csx C#-szkriptelési (.csx) projektek támogatása.
--force, -f Frissítse a meglévő bővítmények verzióit.
--output, -o A bővítmények kimeneti elérési útja.
--package, -p Adott bővítménycsomag azonosítója. Ha nincs megadva, a rendszer az összes hivatkozott bővítményt telepíti, ahogyan a func extensions sync.
--source, -s NuGet-hírcsatornaforrás NuGet.org használata esetén.
--version, -v Bővítménycsomag verziója.

Az alábbi példa az Event Hubs bővítmény 5.0.1-es verzióját telepíti a helyi projektben:

func extensions install --package Microsoft.Azure.WebJobs.Extensions.EventHubs --version 5.0.1

A következő szempontokat kell figyelembe venni a következők használatakor func extensions install:

  • A lefordított C#-projektekhez (mind a folyamatban, mind az izolált feldolgozói folyamathoz) használjon standard NuGet-csomagtelepítési módszereket, például dotnet add package.

  • A bővítmények Core Tools használatával történő manuális telepítéséhez telepítve kell lennie a .NET SDK.

  • Ha lehetséges, inkább bővítménycsomagokat kell használnia. Az alábbiakban néhány okot talál arra, hogy miért kell manuálisan telepítenie a bővítményeket:

    • Hozzá kell férnie egy csomagban nem elérhető bővítmény adott verziójához.
    • Egy csomagban nem elérhető egyéni bővítményt kell elérnie.
    • Egy csomagban nem elérhető bővítmények adott kombinációját kell elérnie.

  • A bővítmények manuális telepítése előtt először el kell távolítania az objektumot a extensionBundle csomagot meghatározó host.json fájlból. Nem történik művelet, ha a bővítménycsomag már be van állítva a host.json fájlban.

  • Amikor először telepít egy bővítményt, a rendszer hozzáad egy .NET extensions.csproj nevű projektfájlt az alkalmazásprojekt gyökeréhez. Ez a fájl határozza meg a függvényekhez szükséges NuGet-csomagok készletét. Bár használhatja a NuGet-csomag hivatkozásait ebben a fájlban, a Core Tools lehetővé teszi a bővítmények telepítését anélkül, hogy manuálisan kellene szerkesztenie ezt a C#-projektfájlt.

func extensions sync

Telepíti az összes funkciós alkalmazáshoz szükséges bővítményt.

A func extensions sync parancs a következő beállításokat támogatja:

Lehetőség Leírás
--configPath, -c A fájlt tartalmazó extensions.csproj könyvtár útja.
--csx Támogatja a C#-szkriptelési (.csx) projekteket.
--output, -o A bővítmények kimeneti elérési útja.

Újragenerál egy hiányzó extensions.csproj fájlt. Nem tesz semmit, ha a fájlban egy bővítménycsomag van meghatározva host.json .

func kubernetes deploy

Egyéni Docker-tárolóként üzembe helyez egy Functions-projektet egy Kubernetes-fürtön.

func kubernetes deploy

Ez a parancs egyéni tárolóként hozza létre a projektet, és közzéteszi egy Kubernetes-fürtben. Az egyéni tárolóknak Dockerfile-fájlokkal kell rendelkezniük. Ha Docker-fájllal szeretne alkalmazást létrehozni, használja a --docker parancsot func init .

A func kubernetes deploy parancs a következő beállításokat támogatja:

Lehetőség Leírás
--dry-run Megjeleníti az üzembehelyezési sablont végrehajtás nélkül.
--config-map-name Egy meglévő konfigurációs térkép neve az üzembe helyezés során használni kívánt függvényalkalmazás-beállításokkal . A szükséges --use-config-map. Az alapértelmezett viselkedés az Values lévő objektum alapján történő beállítások létrehozása.
--cooldown-period Az összes eseményindító utáni lehűlési időszak (másodpercben) már nem aktív, mielőtt az üzembe helyezés nullára skálázódik, alapértelmezett értéke 300 s.
--ignore-errors Folytassa az üzembe helyezést, miután egy erőforrás hibát ad vissza. Az alapértelmezett viselkedés a hiba leállása.
--image-name A pod üzembe helyezéséhez használandó rendszerkép neve, amelyből függvényeket olvashat.
--keda-version Állítsa be a KEDA verzióját a telepítésre. Az érvényes beállítások a következők: v1 és v2 (alapértelmezett).
--keys-secret-name A hozzáférési kulcsok tárolására használható Kubernetes Titkos kulcsok gyűjteményének neve.
--max-replicas Állítsa be a maximális replikaszámot, amelyre a vízszintes pod automatikus skálázása (HPA) skálázható.
--min-replicas Adja meg azt a minimális replikaszámot, amely alatt a HPA nem skálázható.
--mount-funckeys-as-containervolume Csatlakoztassa a hozzáférési kulcsokat tárolókötetként.
--name A Kubernetesben az üzembe helyezéshez és más összetevőkhöz használt név.
--namespace Állítsa be a Kubernetes-névteret üzembe helyezéshez. Alapértelmezés szerint az alapértelmezett névtér.
--no-docker Függvények olvasása az aktuális könyvtárból kép helyett. A rendszerkép fájlrendszerének csatlakoztatása szükséges.
--registry Ha be van állítva, egy Docker-build fut, és a rendszer leküldi a rendszerképet egy ilyen nevű beállításjegyzékbe. Nem használható --registry a következővel --image-name: . Docker esetén használja a felhasználónevét.
--polling-interval A nem HTTP-eseményindítók ellenőrzésének lekérdezési időköze (másodpercben), alapértelmezés szerint 30-zal.
--pull-secret A privát beállításjegyzék hitelesítő adatainak eléréséhez használt titkos kód.
--secret-name Egy meglévő Kubernetes-titkos kódgyűjtemény neve, amely függvényalkalmazás-beállításokkal rendelkezik az üzembe helyezés során. Az alapértelmezett viselkedés az Values lévő objektum alapján történő beállítások létrehozása.
--show-service-fqdn A HTTP-eseményindítók URL-címeinek megjelenítése a Kubernetes teljes tartománynévvel az IP-cím használatának alapértelmezett viselkedése helyett.
--service-type Adja meg a Kubernetes Service típusát. A támogatott értékek a következők: ClusterIP, NodePortés LoadBalancer (alapértelmezett).
--use-config-map Használjon objektumot ConfigMap (v1) objektum Secret helyett (v1) a függvényalkalmazás beállításainak konfigurálásához. A térkép neve a következő használatával --config-map-namevan beállítva: .
--use-git-hash-version Használja a Git kivonatot a tárolólemezkép verziójaként.
--write-configs A Kubernetes-konfigurációkat yaML-fájlokként adja ki üzembe helyezés helyett.
--config-file Kimeneti fájl elérési útja a használat --write-configssorán. Alapértelmezett: functions.yaml.
--hash-files A rendszerkép verziójának meghatározásához kivonatot tartalmazó fájlok.
--image-build Ha be van falseállítva, kihagyja a Docker-buildet.
--key-secret-annotations A titkos kulcsokhoz hozzáadandó széljegyzetek formátuma key1=val1,key2=val2 .

A Core Tools a helyi Docker CLI használatával hozza létre és teszi közzé a lemezképet. Győződjön meg arról, hogy a Docker helyileg telepítve van. Futtassa a docker login parancsot a fiókhoz való csatlakozáshoz.

Azure Functions támogatja a tárolóalapú függvények üzemeltetését Azure Container Apps vagy Azure Functions. Azure Functions hivatalosan nem támogatja a tárolók közvetlen Kubernetes-fürtön vagy Azure Kubernetes Service (AKS) való futtatását. További információ: Linux-tároló támogatása Azure Functions.

func kubernetes delete

Törli a Functions-telepítést egy Kubernetes-fürtből.

func kubernetes delete --name <APP_NAME>

A func kubernetes delete parancs a következő beállításokat támogatja:

Lehetőség Leírás
--name Az üzembe helyezés és a Kubernetes egyéb összetevőinek neve. (Szükséges)
--namespace Állítsa be a Kubernetes-névteret. default A névtér alapértelmezett értéke.
--registry A tárolóregisztrációs adatbázis neve.
--image-name A pod üzembe helyezéséhez használandó rendszerkép.
--keda-version Állítsa be a KEDA verzióját. Az érvényes beállítások a következők v1 : ( v2 alapértelmezett).

func kubernetes install

A KEDA telepítése Kubernetes-fürtön

func kubernetes install

Telepíti a KEDA-t a kubectl konfigurációs fájlban definiált fürtre.

A func kubernetes install parancs a következő beállításokat támogatja:

Lehetőség Leírás
--dry-run Megjeleníti az üzembehelyezési sablont végrehajtás nélkül.
--keda-version Beállítja a KEDA telepítését. Az érvényes beállítások a következők: v1 és v2 (alapértelmezett).
--namespace Egy adott Kubernetes-névtérre települ. Ha nincs beállítva, a rendszer az alapértelmezett névteret használja.

További információ: KEDA és függvények kezelése a Kubernetesben.

func kubernetes remove

Eltávolítja a KEDA-t a konfigurációs fájlban kubectl definiált Kubernetes-fürtből.

func kubernetes remove

Eltávolítja a KEDA-t a konfigurációs fájlban kubectl definiált fürtből.

A func kubernetes remove parancs ezt a beállítást támogatja:

Lehetőség Leírás
--namespace Eltávolítás egy adott Kubernetes-névtérből. Ha nincs beállítva, a rendszer az alapértelmezett névteret használja.

További információ: A KEDA eltávolítása a Kubernetesből.

func settings add

Új beállítást ad hozzá a Values gyűjteményhez a local.settings.json fájlban.

func settings add <SETTING_NAME> <VALUE>

Cserélje le <SETTING_NAME> az alkalmazásbeállítás nevére.

A func settings add parancs ezt a beállítást támogatja:

Lehetőség Leírás
--connectionString A név-érték pár hozzáadása a ConnectionStrings gyűjteményhez a Values gyűjtemény helyett. A gyűjteményt ConnectionStrings csak akkor használja, ha bizonyos keretrendszerek megkövetelik. További információ: local.settings.json fájl.

func settings decrypt

A Values lévő gyűjtemény titkosított értékeinek visszafejtése.

func settings decrypt

Ez a parancs a ConnectionStrings gyűjtemény kapcsolati karakterlánc értékeit is visszafejti. local.settings.jsonesetén a parancs beállítja IsEncrypted .false Titkosítsuk a helyi beállításokat, hogy csökkentsd az érzékeny információk feltárásának kockázatátlocal.settings.json. A Azure az alkalmazásbeállításokat mindig titkosítva tárolja a rendszer.

func settings delete

Eltávolít egy meglévő beállítást a Values gyűjteményből a local.settings.json fájlban.

func settings delete <SETTING_NAME>

Cserélje le <SETTING_NAME> az alkalmazásbeállítás nevére és <VALUE> a beállítás értékére.

A func settings delete parancs ezt a beállítást támogatja:

Lehetőség Leírás
--connectionString A gyűjtemény helyett a név-érték pár eltávolítása a ConnectionStrings gyűjteménybőlValues.

func settings encrypt

Titkosítja a gyűjtemény egyes elemeinek értékeit a Valueslocal.settings.json fájlban.

func settings encrypt

A parancs a gyűjtemény kapcsolati sztringértékeit is titkosítja ConnectionStrings . local.settings.json-ben a parancs , beállítja IsEncryptedtrue, ami azt jelzi, hogy a helyi futás kódolja a beállításokat a használatuk előtt. Titkosítsuk a helyi beállításokat, hogy csökkentsd az érzékeny információk feltárásának kockázatátlocal.settings.json. A Azure az alkalmazásbeállítások mindig titkosítottként vannak tárolva.

func settings list

A local.settings.json fájlban lévő Values gyűjtemény beállításainak listáját adja ki.

func settings list

A kimenet a gyűjteményből származó kapcsolati sztringeket ConnectionStrings is tartalmazza. Alapértelmezés szerint a parancs biztonság szempontjából rejti az értékeket. A beállítással --showValue megjelenítheti a tényleges értéket.

A func settings list parancs ezt a beállítást támogatja:

Lehetőség Leírás
--showValue, -a A tényleges maszkolt értékek megjelenítése a kimenetben.

func templates list

Az elérhető függvénysablonok (triggerek) listája.

A func templates list parancs ezt a beállítást támogatja:

Lehetőség Leírás
--language, -l A visszaadott sablonok szűrésének nyelve. Alapértelmezés szerint az összes nyelvet visszaadja.

Globális beállítások

A legtöbb Core Tools parancs ezeket az opciókat támogatja:

Lehetőség Leírás
--script-root Beállítja a függvényalkalmazás gyökérkönyvtárát, és módosítja a parancs munkakönyvtárát.
--verbose Részletes naplózást tesz lehetővé. Nem minden parancs támogatja ezt az opciót.
--offline Offline módban fut, külső hálózati hívások nélkül. Az func start, func init, és func new parancsok ezt az opciót támogatják. A környezeti változón keresztül is beállíthatod FUNCTIONS_CORE_TOOLS_OFFLINE .
--version, -v Megjeleníti a Azure Functions Core Tools verzióját.
--help, -h Súgóinformációk megjelenítése.
--pause-on-error A folyamatból való kilépés előtt szünetelteti a további bemeneteket. Ez az opció hasznos, amikor integrált fejlesztői környezetből (IDE) indítod el a Core Tools-t.

A legtöbb parancs ezeket a lehetőségeket támogatja:

Lehetőség Leírás
--help, -h Mutassuk a segítséget a parancshoz.
--version Display the Azure Functions CLI version. Használd --verbose--version együtt részletes építési információkért.
--verbose Részletes kimenet engedélyezése. Minden alparancsra terjed. Ha a gyökéren keresztül továbbítja alparancs nélkül, részletes építési, futásidős, operációs rendszer és architektúra információkat nyomtat.

Elérhető munkaterhelések

Fuss func workload search meg a jelenlegi katalógusért. Jelenleg a következő munkaterhelések elérhetők:

Name Leírás
host A Azure Functions func run által használt host runtime.
bundles Telepíts bővítménycsomagokat, amelyek lehetővé teszik az összes kötési kiterjesztést. Ezt a munkaterhelést használd bármilyen nem-.NET stackhez. A .NET projektek nem használják ezt a terhelést. Ehelyett közvetlenül hivatkoznak a bővítményekre a projektjeikben.
dotnet Azure Functions CLI tooling for .NET (C#, F#) projects. Sablonokat is hozzáad .func quickstart A .NET nem igényel külön munkaterhelést, mert a munka maga a fordított projekt része.
dotnet-templates Function-scaffold sablonok .NET izolált munkás projektekhez.
python Azure Functions CLI tooling for Python projects. Sablonokat is hozzáad .func quickstart
python-worker A Python nyelvi munkatárs, amelyet a Functions hoszt használ.
python-templates Funkció-váz sablonok Python számára (v1 és v2 programozási modellek).
node Azure Functions A CLI eszközök Node.js projektekhez (JavaScript, TypeScript). Sablonokat is hozzáad .func quickstart
node-worker A Node.js nyelvi dolgozó, amelyet a Functions hoszter használ.
node-templates Function-scaffold sablonok Node.js (JavaScript, TypeScript).
go Azure Functions CLI tooling for Go projects. Sablonokat is hozzáad .func quickstart
go-worker A Go nyelvi dolgozó, amelyet a Functions hoszter használ.

Feljegyzés

Nem minden függvénynyelvi stack jelenleg elérhető munkaterhelésként. A Java és PowerShell stackek jelenleg nem támogatottak az Azure Functions CLI-ben.

  • Last updated on