Az Azure Functions Core Tools referenciája

Ez a cikk az 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. A Core Tools használatáról további információt az Azure Functions Core Tools használata című témakörben talál.

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	Függvények helyi számítógépen való létrehozásához és futtatásához használt parancsok.
func azure	Az Azure-erőforrások használatának parancsai, beleértve a közzétételt is.
func azurecontainerapps	Tárolóalapú függvényalkalmazás üzembe helyezése az Azure Container Appsben.
func durable	A Durable Functions használatának parancsai.
func extensions	Parancsok bővítmények telepítéséhez és kezeléséhez.
func kubernetes	Parancsok a Kubernetes és az Azure Functions kezeléséhez.
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 felsorolására szolgáló parancsok.

A cikkben szereplő parancsok használata előtt telepítenie kell 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.

func init A következő beállításokat támogatja, amelyek nem támogatják az 1.x verziót, hacsak másként nem jelezzük:

Lehetőség	Leírás
--csx	A .NET-függvényeket C# szkriptként hozza létre, amely az 1.x-es verzió viselkedése. Csak a --worker-runtime dotnet.
--docker	Létrehoz egy Dockerfile-t egy tárolóhoz egy, a kiválasztott --worker-runtimerendszerképen alapuló alaprendszerkép használatával. 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. Ha nincs megadva vagy beállítva a local.settings.json, a feldolgozó-futtatókörnyezetet kéri. 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	Nyelvspecifikus projekt inicializálása. Jelenleg támogatott, ha --worker-runtime be van állítva.node A beállítások és javascripta typescript . Használhatja vagy --worker-runtime typescripthasználhatja is--worker-runtime javascript.
--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	Beállítja a kívánt programozási modellt egy célnyelvhez, ha több modell is elérhető. A támogatott lehetőségek a V1 V2 Python V3 V4 és a Node.js. További információkért tekintse meg a Python fejlesztői útmutatót és a Node.js fejlesztői útmutatót.
--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,node javascript, (JavaScript), pythonpowershellés typescript. Java esetén használja a Mavent. 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: net9.0 (előzetes verzió), net8.0 (alapértelmezett) net6.0és net48 (.NET-keretrendszer 4.8).

Feljegyzés

Ha bármelyiket --docker vagy --docker-only beállítást 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.

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 művelet a következő lehetőségeket támogatja:

Lehetőség	Leírás
--platform	A függvényalkalmazás üzemeltetési platformja. Támogatott beállítások: kubernetes.
--name	Függvényalkalmazás neve az Azure-ban.

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 --template beállítás nélkül futfunc new, 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 művelet a következő lehetőségeket támogatja:

Lehetőség	Leírás
--authlevel	Lehetővé teszi a HTTP-eseményindító engedélyezési szintjének beállításá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.
--language, -l	A sablon programozási nyelve, például C#, F# vagy JavaScript. Ez a beállítás az 1.x verzióban szükséges. A 2.x és újabb verziókban nem 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 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 az Azure Portal Teszt lapján. 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 művelet a következő lehetőségeket 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.

Ha például HTTP-aktivált függvényt szeretne meghívni, és átadni a tartalomtörzset, futtassa a következő 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.

v2.x+

func start

func start 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élyezze a kereszt-eredetű hitelesített kéréseket a cookie-k és a hitelesítési fejléc használatával.
--dotnet-isolated-debug	Ha be van trueállítva, szünetelteti a .NET-feldolgozói folyamatot, amíg a hibakereső a hibakeresés alatt álló .NET izolált projektből csatlakozik.
--enable-json-output	Lehetőség szerint JSON-ként bocsát ki konzolnaplókat.
--enableAuth	Teljes hitelesítési kezelési folyamat engedélyezése engedélyezési követelményekkel.
--functions	A betöltendő függvények szóközzel elválasztott listája.
--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 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	A figyelendő helyi port. Alapértelmezett érték: 7071.
--timeout	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.

A projekt futásával ellenőrizheti az egyes függvényvégpontokat.

v1.x

func host start

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

Lehetőség	Leírás
--cors	A CORS-források vesszővel tagolt listája szóközök nélkül.
--port	A figyelendő helyi port. Alapértelmezett érték: 7071.
--pause-on-error	A folyamatból való kilépés előtt szüneteljen további bemenetekért. Csak akkor használható, ha a Core Toolst integrált fejlesztési környezetből (IDE) indítja el.
--script-root	A futtatandó vagy üzembe helyezendő függvényalkalmazás gyökeréhez vezető elérési út megadására szolgál. Ez olyan lefordított projektekhez használható, amelyek projektfájlokat hoznak létre egy almappában. C#-osztálykódtár-projekt létrehozásakor például a host.json, a local.settings.json és a function.json fájlok egy olyan elérési úttal rendelkező gyökérmappában jönnek létre, mint a MyProject/bin/Debug/netstandard2.0. Ebben az esetben állítsa be az előtagot --script-root MyProject/bin/Debug/netstandard2.0. Ez a függvényalkalmazás gyökere az Azure-ban való futtatáskor.
--timeout	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.

Az 1.x verzióban a func run parancs segítségével futtathat egy adott függvényt, és tesztadatokat továbbíthat neki.

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 rendszer letölti a beállításokat a projekt local.settings.json fájljába. 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áját adja vissza.

func azure functionapp list-functions <APP_NAME>

func azure functionapp logstream

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

func azure functionapp logstream <APP_NAME>

A kapcsolat alapértelmezett időtúllépése 2 óra. Az időtúllépést egy SCM_LOGSTREAM_TIMEOUT nevű alkalmazásbeállítás hozzáadásával módosíthatja, amelynek időtúllépési értéke másodpercben van megadva. A Használat csomag linuxos alkalmazásai még nem támogatottak. Ezekben az alkalmazásokban a naplókat a --browser portálon tekintheti meg.

A deploy művelet a következő lehetőségeket 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ó: Streamelési végrehajtási naplók engedélyezése az Azure Functionsben.

func azure functionapp publish

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

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:

v2.x+

Lehetőség	Leírás
--access-token	Lehetővé teszi egy adott hozzáférési jogkivonat használatát hitelesített azure műveletek végrehajtásakor.
--access-token-stdin	Beolvas egy adott hozzáférési jogkivonatot egy szabványos bemenetből. Ezt akkor használja, ha a jogkivonatot közvetlenül egy korábbi parancsból, például az account get-access-tokena .
--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 Linux-függvényalkalmazásban való üzembe helyezéskor. Elfogadja: remote és local.
--build-native-deps	Kihagyja a mappa létrehozásának kihagyását a .wheels 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 dotnet build --output bin/publishazokat. Az ehhez átadott paraméterek hozzá lesznek fűzve a parancssorhoz.
--force	Bizonyos esetekben figyelmen kívül hagyhatja az előzetes közzétételi ellenőrzést.
--list-ignored-files	Megjeleníti a közzététel során figyelmen kívül hagyott fájlok listáját, amely a .funcignore fájlon alapul.
--list-included-files	Megjeleníti a közzétett fájlok listáját, amely a .funcignore fájlon alapul.
--management-url	Beállítja a felhő felügyeleti URL-címét. Használja ezt szuverén felhőben való futtatáskor.
--no-build	A projekt nem a közzététel során készült. Python pip install esetén a művelet nem történik meg.
--nozip	Kikapcsolja az alapértelmezett Run-From-Package módot.
--overwrite-settings -y	Az alkalmazásbeállítások felülírására vonatkozó kérés mellőzése használat esetén --publish-local-settings -i .
--publish-local-settings -i	Tegye közzé a beállításokat local.settings.json az Azure-ban, é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 közzétételi beállításokat, és hagyja ki a tartalmat. Az alapértelmezett érték a parancssor.
--slot	Nem kötelező annak a pontnak a neve, amelyhez közzé szeretné tenni.
--subscription	Beállítja az alapértelmezett előfizetést.

v1.x

Lehetőség	Leírás
--overwrite-settings -y	Az alkalmazásbeállítások felülírására vonatkozó kérés mellőzése használat esetén --publish-local-settings -i .
--publish-local-settings -i	Tegye közzé a beállításokat local.settings.json az Azure-ban, és kéri, hogy írja felül, ha a beállítás már létezik. Ha a Microsoft Azure Storage Emulatort használja, először módosítsa az alkalmazásbeállítást egy tényleges tárolási kapcsolatra.

func azure storage fetch-connection-string

Lekéri a megadott Azure Storage-fiók kapcsolati sztring.

func azure storage fetch-connection-string <STORAGE_ACCOUNT_NAME>

További információ: Storage-kapcsolati sztring letöltése.

func azurecontainerapps deploy

Tárolóalapú függvényalkalmazás üzembe helyezése Egy 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 Functionst üzemeltető Azure Container Apps.

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
--access-token	Lehetővé teszi egy adott hozzáférési jogkivonat használatát hitelesített azure műveletek végrehajtásakor.
--access-token-stdin	Beolvas egy adott hozzáférési jogkivonatot egy szabványos bemenetből. Ezt akkor használja, ha a jogkivonatot közvetlenül egy korábbi parancsból, például az account get-access-tokena .
--environment	Egy meglévő Container Apps-környezet neve.
--image-build	Ha be van trueállítva, kihagyja a helyi Docker-buildet.
--image-name	A tárolóregisztrációs adatbázisban lévő meglévő tároló képneve. A kép neve tartalmazza a címke nevét.
--location	Az üzembe helyezés régiója. Ideális esetben ez ugyanaz a régió, mint a környezet és a tárfiók erőforrásai.
--management-url	Beállítja a felhő felügyeleti URL-címét. Használja ezt szuverén felhőben való futtatáskor.
--name	A függvényalkalmazás Container Apps-környezetben való üzembe helyezéséhez használt név. Ugyanezt a nevet használja a függvényalkalmazás portálon történő kezelésekor is. A névnek egyedinek kell lennie a környezetben.
--registry	Ha be van állítva, a rendszer futtat egy Docker-buildet, és a rendszerképet a rendszer leküldi a beállításjegyzékbe a következőben --registry: . Nem használható --registry a következővel --image-name: . A Docker Hubhoz használja a következőt --registry-usernameis: .
--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 sztring.
--subscription	Beállítja az alapértelmezett előfizetést.
--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 (az ügyfélkezelők esetében).

Fontos

A tárolási kapcsolati sztring és más szolgáltatás hitelesítő adatai fontos titkos kulcsok. Ügyeljen arra, hogy a parancsfájlokat func azurecontainerapps deploy biztonságosan tárolja, és ne tárolja őket nyilvánosan elérhető forrásvezérlőkben.

func deploy

A func deploy parancs elavult. Ehelyett használja a következőt func kubernetes deploy: .

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 delete-task-hub művelet a következő lehetőségeket támogatja:

Lehetőség	Leírás
--connection-string-setting	A használni kívánt tárolási kapcsolati sztring tartalmazó beállítás nem kötelező neve.
--task-hub-name	A használni kívánt Durable Task Hub nem kötelező neve.

További információkért tekintse meg a Durable Functions dokumentációját.

func durable get-history

A megadott vezénylési példány előzményeit adja vissza.

func durable get-history --id <INSTANCE_ID>

A get-history művelet a következő lehetőségeket támogatja:

Lehetőség	Leírás
--id	Egy vezénylési példány azonosítóját adja meg (kötelező).
--connection-string-setting	A használni kívánt tárolási kapcsolati sztring tartalmazó beállítás nem kötelező neve.
--task-hub-name	A használni kívánt Durable Task Hub nem kötelező neve.

További információkért tekintse meg a Durable Functions dokumentációját.

func durable get-instances

Az összes vezénylési példány állapotát adja vissza. Támogatja a lapozást a top paraméterrel.

func durable get-instances

A get-instances művelet a következő lehetőségeket támogatja:

Lehetőség	Leírás
--continuation-token	Nem kötelező jogkivonat, amely a visszaadni kívánt kérések egy adott oldalát/szakaszát jelzi.
--connection-string-setting	A használni kívánt tárolási kapcsolati sztring tartalmazó alkalmazásbeállítás nem kötelező neve.
--created-after	Ha szeretné, kérje le a példányok létrehozását ezen dátum/idő (UTC) után. A rendszer minden ISO 8601 formátumú dátumidőt elfogad.
--created-before	Ha szeretné, lekérheti a példányokat egy adott dátum/idő (UTC) előtt. A rendszer minden ISO 8601 formátumú dátumidőt elfogad.
--runtime-status	Igény szerint lekérheti azokat a példányokat, amelyek állapota egy adott állapotnak felel meg, beleértve a running, completedés failed. Egy vagy több térelválasztó szobrot is megadhat.
--top	Igény szerint korlátozhatja az adott kérelemben visszaadott rekordok számát.
--task-hub-name	A használni kívánt Durable Functions-feladatközpont nem kötelező neve.

További információkért tekintse meg a Durable Functions dokumentációját.

func durable get-runtime-status

A megadott vezénylési példány állapotát adja vissza.

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

A get-runtime-status művelet a következő lehetőségeket támogatja:

Lehetőség	Leírás
--connection-string-setting	A használni kívánt tárolási kapcsolati sztring tartalmazó beállítás nem kötelező neve.
--id	Egy vezénylési példány azonosítóját adja meg (kötelező).
--show-input	Ha be van állítva, a válasz a függvény bemenetét tartalmazza.
--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 nem kötelező neve.

További információkért tekintse meg a Durable Functions dokumentációját.

func durable purge-history

Törölje 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 purge-history művelet a következő lehetőségeket támogatja:

Lehetőség	Leírás
--connection-string-setting	A használni kívánt tárolási kapcsolati sztring tartalmazó beállítás nem kötelező neve.
--created-after	Ha szeretné, 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	Ha szeretné, 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	Ha szükséges, törölje azoknak a példányoknak az előzményeit, amelyek állapota egy adott állapotnak felel meg, beleértve a completd, terminated, canceledés failed. Egy vagy több térelválasztó szobrot is megadhat. 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 nem kötelező neve.

További információkért tekintse meg a Durable Functions dokumentációját.

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 raise-event művelet a következő lehetőségeket támogatja:

Lehetőség	Leírás
--connection-string-setting	A használni kívánt tárolási kapcsolati sztring tartalmazó beállítás nem kötelező neve.
--event-data	Az eseménynek továbbítandó adatok beágyazott vagy JSON-fájlból (kötelező). 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.
--event-name	Az esemény neve (kötelező).
--id	Egy vezénylési példány azonosítóját adja meg (kötelező).
--task-hub-name	A használni kívánt Durable Functions-feladatközpont nem kötelező neve.

További információkért tekintse meg a Durable Functions dokumentációját.

func durable rewind

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

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

A rewind művelet a következő lehetőségeket támogatja:

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

További információkért tekintse meg a Durable Functions dokumentációját.

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 start-new művelet a következő lehetőségeket támogatja:

Lehetőség	Leírás
--connection-string-setting	A használni kívánt tárolási kapcsolati sztring tartalmazó beállítás nem kötelező neve.
--function-name	A elindítandó vezénylő függvény neve (kötelező).
--id	Egy vezénylési példány azonosítóját adja meg (kötelező).
--input	Bemenet a vezénylő függvénybe beágyazott vagy JSON-fájlból (kötelező). 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.
--task-hub-name	A használni kívánt Durable Functions-feladatközpont nem kötelező neve.

További információkért tekintse meg a Durable Functions dokumentációját.

func durable terminate

Leállítja a megadott vezénylési példányt.

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

A terminate művelet a következő lehetőségeket támogatja:

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

További információkért tekintse meg a Durable Functions dokumentációját.

func extensions install

Manuálisan telepíti a Functions-bővítményeket egy non-.NET projektben vagy egy C#-szkriptprojektben.

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

A install művelet a következő lehetőségeket támogatja:

Lehetőség	Leírás
--configPath	A extensions.csproj fájlt tartalmazó könyvtár elérési útja.
--csx	Támogatja a C#-szkriptelési (.csx) projekteket.
--force	Frissítse a meglévő bővítmények verzióit.
--output	A bővítmények kimeneti elérési útja.
--package	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	NuGet-hírcsatornaforrás NuGet.org használata esetén.
--version	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ő szempontok érvényesek a használat során func extensions install:

• Lefordított C#-projektekhez (mind a folyamatban, mind az elkülönített 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 6.0 SDK-nak .

• Ha lehetséges, inkább bővítménycsomagokat kell használnia. Az alábbiakban néhány oka lehet annak, hogy manuálisan kell 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 extensionBundle objektumot a 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 extensions.csproj nevű .NET-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 sync művelet a következő lehetőségeket támogatja:

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

Egy hiányzó extensions.csproj fájl újragenerálása. Nem történik művelet, 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 .

Az alábbi Kubernetes-telepítési lehetőségek érhetők el:

Lehetőség	Leírás
--dry-run	Az üzembehelyezési sablon igény szerint végrehajtás nélkül is megjeleníthető.
--config-map-name	Nem kötelező megadni egy meglévő konfigurációs térképet, amely függvényalkalmazás-beállításokat használ az üzembe helyezés során. A szükséges --use-config-map. Az alapértelmezett viselkedés az local.settings.json fájlban lévő objektum alapján Values 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	Folytatja 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	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).
--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	Beállítja a maximális replikaszámot, amelyre a vízszintes pod automatikus skálázása (HPA) skálázható.
--min-replicas	Beállítja a minimális replikaszámot, amely alatt a HPA nem méretezhető.
--mount-funckeys-as-containervolume	Tárolókötetként csatlakoztatja a hozzáférési kulcsokat .
--name	A Kubernetesben az üzembe helyezéshez és más összetevőkhöz használt név.
--namespace	Beállítja azt a Kubernetes-névteret, amelyre telepíteni szeretné az üzembe helyezést, amely alapértelmezés szerint az alapértelmezett névtér.
--no-docker	A függvények a rendszerkép helyett az aktuális könyvtárból vannak beolvasva. 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 az üzembe helyezés során használandó függvényalkalmazás-beállításokat tartalmazza. Az alapértelmezett viselkedés az local.settings.json fájlban lévő objektum alapján Values történő beállítások létrehozása.
--show-service-fqdn	Megjeleníti a HTTP-eseményindítók URL-címét a Kubernetes teljes tartománynévvel az IP-cím használatának alapértelmezett viselkedése helyett.
--service-type	Beállítja 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: .

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.

További információ: Függvényalkalmazás üzembe helyezése a Kubernetesben.

func kubernetes install

Telepíti a KEDA-t egy Kubernetes-fürtön.

func kubernetes install 

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

A install művelet a következő lehetőségeket 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	Támogatja a telepítést egy adott Kubernetes-névtérre. 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 kubectl konfigurációs fájlban definiált Kubernetes-fürtből.

func kubernetes remove 

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

A remove művelet a következő lehetőségeket támogatja:

Lehetőség	Leírás
--namespace	Támogatja az eltávolítást 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 és <VALUE> a beállítás értékére.

A add művelet a következő lehetőséget 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. Csak akkor használja a gyűjteményt ConnectionStrings , ha bizonyos keretrendszerek megkövetelik. További információ: local.settings.json fájl.

func settings decrypt

A korábban titkosított értékek visszafejtése a Values gyűjteményben a local.settings.json fájlban.

func settings decrypt

A gyűjtemény kapcsolati sztringértékeinek ConnectionStrings visszafejtése is folyamatban van. 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. Az Azure-ban az alkalmazásbeállítások mindig titkosítva vannak tárolva.

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 delete művelet a következő lehetőséget támogatja:

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

func settings encrypt

Titkosítja a gyűjtemény egyes elemeinek értékeit a Values local.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ítvatrue, ami azt határozza meg, IsEncrypted 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. Az Azure-ban az alkalmazásbeállítások mindig titkosítva 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 gyűjtemény kapcsolati sztringjei ConnectionStrings szintén kimenetek. 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 list művelet a következő lehetőséget támogatja:

Lehetőség	Leírás
--showValue	A tényleges maszkolt értékeket jeleníti meg a kimenetben.

func templates list

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

A list művelet a következő lehetőséget támogatja:

Lehetőség	Leírás
--language	A visszaadott sablonok szűrésének nyelve. Alapértelmezés szerint az összes nyelv visszaadására van lehetőség.