Azure Functions Core Tools-referencia

Ez a cikk a Azure Functions Core Tools referenciadokumentációját tartalmazza, amely lehetővé teszi Azure Functions projektek fejlesztését, kezelését és üzembe helyezését a helyi számítógépről. 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.

func init

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

func init [<PROJECT_FOLDER>]

Amikor megadja a projektet <PROJECT_FOLDER>, a rendszer egy új mappában hozza létre ezt a nevet. Ellenkező esetben a rendszer az aktuális mappát használja.

A func init parancs támogatja ezeket a beállításokat, amelyek az 1.x verzióban nem támogatottak, kivéve, ha másként van feltüntetve:

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 C#-szkriptként hozza létre .NET függvényeket, amely az 1.x-es verzió viselkedése. Csak a --worker-runtime dotnet.
--docker Létrehoz egy Dockerfile-t egy tárolóhoz egy alaprendszerkép használatával a kiválasztott --worker-runtimerendszerkép alapján. 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 Inicializálja a projektet akkor is, ha már vannak 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.

A beállítás használatakor --configuration-profile a rendszer előre definiált projektkonfigurációkat és beállításokat hoz 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 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 new

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

func new

Ha a func new beállítás nélkül fut--template, a rendszer kérni fogja, hogy válasszon egy sablont. Az 1.x verzióban a nyelvet is ki kell választania.

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

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 (2.x és újabb verziók.) Ugyanazt a C#-szkriptet (.csx) hozza létre, amelyet az 1.x verzióban és a portálon használ.
--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ó.
--language, -l A sablon programozási nyelve, például C# vagy JavaScript. Ez a beállítás az 1.x verzióban szükséges. A 2.x és újabb verziókban ne használja ezt a beállítást, mert a nyelvet a feldolgozó futtatókörnyezete határozza meg.
--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 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.

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.
--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 1.x-es verzió.

Lehetővé teszi egy függvény közvetlen meghívását, amely hasonló egy függvény futtatásához a Test lapon a Azure portálon. Ez a művelet csak az 1.x verzióban támogatott. Későbbi verziók esetén használja func start és hívja meg közvetlenül a függvényvégpontot.

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 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 beállítások a projekt local.settings.json fájljába tölthető le. A képernyőn megjelenő értékek maszkoltak a biztonság érdekében. A helyi titkosítás engedélyezésével megvédheti a local.settings.json fájl beállításait.

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 Application 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 connection string.

func azure storage fetch-connection-string <STORAGE_ACCOUNT_NAME>

További információ: letöltési connection string.

func azurecontainerapps deploy

Tárolóalapú függvényalkalmazás üzembe helyezése Azure Container Apps környezetben. A függvényalkalmazás és a környezet által használt tárfióknak 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 connection string.
--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 következőt 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 connection string.
--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 connection string.
--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 paraméterrel való lapozást 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 connection string 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 connection string 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 connection string 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 connection string 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 connection string 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 connection string 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 connection string 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 a függvényalkalmazáshoz hozzáadott összes 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 extensions.csproj fájlt tartalmazó könyvtár elérési útja.
--csx Támogatja a C#-szkriptelési (.csx) projekteket.
--output, -o A bővítmények kimeneti elérési útja.

Egy hiányzó extensions.csproj fájl újragenerálása. Nem hajt végre műveletet, ha egy bővítménycsomag van definiálva a host.json fájlban.

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 --dockerfile 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 connection string értékeit is visszafejti. A local.settings.json IsEncrypted is be van állítva false. A helyi beállítások titkosításával csökkentheti a local.settings.json származó értékes információk kiszivárgásának kockázatát. 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 gyűjtemény kapcsolati sztringértékei ConnectionStrings is titkosítva vannak. A local.settings.json is be van állítvaIsEncrypted, ami azt határozza meg, true hogy a helyi futtatókörnyezet visszafejtse a beállításokat a használat előtt. A helyi beállítások titkosításával csökkentheti a local.settings.json származó értékes információk kiszivárgásának kockázatát. 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 az értékek maszkolással vannak elfedve a biztonság érdekében. 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

Ezek a lehetőségek a legtöbb Core Tools-parancshoz elérhetők:

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é. Az összes parancs nem támogatja.
--offline Offline módban fut, külső hálózati hívások nélkül. Támogatja a func start, func inités func new. A környezeti változóval FUNCTIONS_CORE_TOOLS_OFFLINE is beállítható.
--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. Hasznos, ha integrált fejlesztési környezetből (IDE) indítja el a Core Toolst.
  • Last updated on