Az Azure Functions Core Tools referenciája

  • Cikk

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:

Beállítás 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 fájlban, 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 V1V2 Pythonhoz és V3V4 a Node.js-hez tartoznak. 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,nodejavascript, (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: net6.0 (alapértelmezett), net7.0és net8.0net48 (.NET-keretrendszer 4.8).

Megjegyzés:

Ha bármelyiket --docker vagy --dockerfile 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-naplók

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:

Beállítás 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:

Beállítás 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ót a HTTP-kötésről szóló cikkben talál.
--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:

Beállítás 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.

func start

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

Beállítás 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.

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.

Gépház a rendszer letölti a projekt local.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édheti.

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

Csatlakozás a helyi parancssort a függvényalkalmazás naplóinak streameléséhez 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:

Beállítás Leírás
--browser Nyissa meg Azure-alkalmazás Elemzések élő 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:

Beállítás 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. For example: 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 a local.settings.json webhelyen 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.

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 üzembe helyezése

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:

Beállítás 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 üzembe helyezése

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:

Beállítás 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:

Beállítás 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:

Beállítás 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:

Beállítás 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:

Beállítás 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:

Beállítás 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 visszatekerés

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:

Beállítás 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:

Beállítás 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:

Beállítás 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-bővítmények telepítése

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:

Beállítás 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 egy 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-bővítmények szinkronizálása

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:

Beállítás 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 a host.json fájlban bővítménycsomag van definiálva.

func kubernetes üzembe helyezése

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:

Beállítás 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, hogy a Values local.settings.json fájlban lévő objektum alapján hoz létre beállításokat.
--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 függvényelérési kulcsok tárolására használható Kubernetes Titkos kulcsok gyűjtemény 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 függvény hozzáférési kulcsait .
--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, hogy a Values local.settings.json fájlban lévő objektum alapján hoz létre beállításokat.
--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 telepítése

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:

Beállítás 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:

Beállítás 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:

Beállítás 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

Visszafejti a korábban titkosított értékeket a Values gyűjteményben a local.settings.json fájlban.

func settings decrypt

Csatlakozás gyűjteménybeli sztringértékek ConnectionStrings is visszafejthetők. A local.settings.json IsEncrypted fájlban a beállítás értéke falseis. A helyi beállítások titkosítása a local.settings.json webhelyről származó értékes információk kiszivárgásának kockázatának csökkentése érdekében. Az Azure-ban az alkalmazásbeállítások mindig titkosítva vannak tárolva.

func-beállítások törlése

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:

Beállítás 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-beállítások titkosítása

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

func settings encrypt

Csatlakozás gyűjteményben lévő sztringértékek ConnectionStrings is titkosítva vannak. A local.settings.json fájlban is be van állítva truea beállítás, amely 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ása a local.settings.json webhelyről származó értékes információk kiszivárgásának kockázatának csökkentése érdekében. Az Azure-ban az alkalmazásbeállítások mindig titkosítva vannak tárolva.

func-beállítások listája

Megjeleníti a gyűjtemény beállításainak listáját a Valueslocal.settings.json fájlban.

func settings list

Csatlakozás gyűjteményből származó ConnectionStrings sztringek 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:

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

func-sablonok listája

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

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

Beállítás 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.