Sdílet prostřednictvím

Referenční informace ke službě Azure Functions Core Tools

Tento článek obsahuje referenční dokumentaci k nástrojům Azure Functions Core Tools. Pomocí tohoto místního modulu runtime a nástrojů příkazového řádku můžete vyvíjet, spravovat a nasazovat projekty Azure Functions z místního počítače. Další informace o používání nástrojů Core Tools najdete v tématu Práce s nástroji Azure Functions Core Tools.

Příkazy Core Tools jsou uspořádány do následujících kontextů, z nichž každá poskytuje jedinečnou sadu akcí.

Kontext příkazu Popis
func Příkazy pro vytváření a spouštění funkcí na místním počítači
func azure Příkazy pro práci s prostředky Azure, včetně publikování
func azurecontainerapps Nasaďte kontejnerizovanou aplikaci funkcí do Azure Container Apps.
func durable Příkazy pro práci s Durable Functions
func extensions Příkazy pro instalaci a správu rozšíření
func kubernetes Příkazy pro práci s Kubernetes a Azure Functions
func settings Příkazy pro správu nastavení prostředí pro místního hostitele Functions
func templates Příkazy pro výpis dostupných šablon funkcí

Před použitím příkazů v tomto článku je nutné nainstalovat nástroje Core Tools.

func init

Vytvoří nový projekt Functions v určitém jazyce.

func init <PROJECT_FOLDER>

Po zadání <PROJECT_FOLDER>se projekt vytvoří v nové složce s tímto názvem. V opačném případě se použije aktuální složka.

func init podporuje následující možnosti, které nepodporují verzi 1.x, pokud není uvedeno jinak:

Možnost Popis
--csx Vytvoří funkce .NET jako skript jazyka C#, což je chování verze 1.x. Platné pouze s --worker-runtime dotnet.
--docker Vytvoří soubor Dockerfile pro kontejner pomocí základní image, která je založena na zvoleném --worker-runtimesouboru . Tuto možnost použijte, když plánujete nasadit kontejnerizovanou aplikaci funkcí.
--docker-only Přidá do existujícího projektu soubor Dockerfile. Pokud není zadaný nebo nastavený v local.settings.json, zobrazí se výzva k zadání modulu worker-runtime. Tuto možnost použijte, když plánujete nasadit kontejnerizovanou aplikaci funkcí a projekt již existuje.
--force Inicializace projektu i v případě, že jsou v projektu existující soubory. Toto nastavení přepíše existující soubory se stejným názvem. Jiné soubory ve složce projektu nejsou ovlivněné.
--language Inicializuje projekt specifický pro jazyk. Aktuálně se podporuje, když --worker-runtime je nastavená hodnota node. Možnosti jsou typescript a javascript. Můžete také použít --worker-runtime javascript nebo --worker-runtime typescript.
--managed-dependencies Nainstaluje spravované závislosti. V současné době tuto funkci podporuje pouze pracovní modul runtime PowerShellu.
--model Nastaví požadovaný programovací model pro cílový jazyk, pokud je k dispozici více než jeden model. Podporované možnosti jsou a V1 pro V2 Python a V3 pro V4 Node.js. Další informace najdete v příručce pro vývojáře v Pythonu a v průvodci pro vývojáře Node.js.
--source-control Určuje, jestli se vytvoří úložiště Git. Ve výchozím nastavení se úložiště nevytvořilo. Když truese vytvoří úložiště.
--worker-runtime Nastaví modul runtime jazyka pro projekt. Podporované hodnoty jsou: csharp, dotnet, dotnet-isolated, , javascript,node (výchozí hodnoty JavaScript), powershell, pythona typescript. Pro Javu použijte Maven. Pokud chcete vygenerovat projekt nezávislý na jazyce pouze se soubory projektu, použijte custom. Pokud není nastavené, zobrazí se výzva k výběru modulu runtime během inicializace.
--target-framework Nastaví cílovou architekturu pro projekt aplikace funkcí. Platné pouze s --worker-runtime dotnet-isolated. Podporované hodnoty jsou: net10.0 (Preview), net9.0, net8.0 (výchozí) net6.0a net48 (.NET Framework 4.8).

Poznámka:

Když použijete některou --docker z --docker-only možností, nástroje Core Tools automaticky vytvoří soubor Dockerfile pro funkce jazyka C#, JavaScript, Python a PowerShell. Pro funkce v Javě musíte soubor Dockerfile vytvořit ručně. Další informace najdete v tématu Vytváření kontejnerizovaných aplikací funkcí.

func logs

Získá protokoly pro funkce spuštěné v clusteru Kubernetes.

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

Akce func logs podporuje následující možnosti:

Možnost Popis
--platform Hostování platformy pro aplikaci funkcí Podporované možnosti: kubernetes.
--name Název aplikace funkcí v Azure

Další informace najdete v tématu Azure Functions v Kubernetes se službou KEDA.

func new

Vytvoří novou funkci v aktuálním projektu na základě šablony.

func new

Když spustíte func new bez --template možnosti, zobrazí se výzva k výběru šablony. Ve verzi 1.x musíte použít --language možnost nastavit jazyk.

Akce func new podporuje následující možnosti:

Možnost Popis
--authlevel Nastavte úroveň autorizace pro trigger HTTP. Podporované hodnoty jsou: function, anonymous, admin. Autorizace se nevynucuje při místním spuštění. Další informace najdete v tématu Úroveň autorizace.
--csx Vygeneruje stejné šablony skriptu C# (.csx) používané verzí 1.x a v editoru portálu.
--language, -l Reguired pouze ve verzi 1.x. Ve všech ostatních verzích je jazyk definován hodnotou předanou --worker-runtimefunc init.
--name, -n Název funkce.
--template, -t func templates list Pomocí příkazu zobrazíte úplný seznam dostupných šablon pro každý podporovaný jazyk.

Další informace najdete v tématu Vytvoření funkce.

func pack

Vytvoří balíček pro nasazení, který obsahuje kód projektu ve spuštěném stavu. Tuto metodu použijte, když potřebujete ručně vytvořit balíček pro nasazení aplikace na místním počítači mimo func azure functionapp publish příkaz. Ve výchozím nastavení projekt sestaví v func pack případě potřeby.

func pack

Spusťte func pack v adresáři, který obsahuje váš host.json soubor projektu, což je kořenový adresář vaší aplikace. Vygenerovaný výstupní soubor (.zip) má stejný název jako složka, kterou vytváříte. Pokud už soubor .zip s tímto názvem existuje, nejprve se odstraní a nahradí aktualizovanou verzí.

Ve výchozím nastavení sestaví a zabalí projekt Functions v adresáři, func pack ve kterém běží. Spuštěním balíčku jiného adresáře můžete func pack nastavit cestu ke kořenovému adresáři projektu za příkazem, například func pack ./myprojectroot. Pokud adresář, na kterém func pack běží, neobsahuje host.json soubor, vrátí se chyba.

Ve výchozím nastavení func pack sestaví všechny projekty a nainstaluje závislosti pro všechny jazyky. K úpravě --no-build tohoto chování použijte možnosti a --skip-install možnosti.

Důležité

Balíčky aplikací Pythonu vytvořené na počítači s Windows často mají problémy s nasazením a spouštěním v Linuxu ve službě Azure Functions. Zvažte použití --no-build se vzdáleným sestavením nebo --build-native-deps při spuštění func pack aplikace v Pythonu ve Windows.

Akce func pack podporuje tyto možnosti:

Možnost Popis
--output Nastaví cestu k umístění, ve kterém se vytvoří soubor balíčku .zip nasazení.
--no-build Projekt není před balením sestaven. Pro aplikace jazyka C# používejte pouze v případě, že jste už vygenerovali binární soubory. U Node.js aplikací se obě npm install aplikace npm run build přeskočí. Tuto možnost můžete použít při vyžádání vzdáleného sestavení v obsahu balíčku.
--skip-install Při balení Node.jsaplikace funkcí se přeskočí npm install . Tuto možnost použijte, pokud se chcete vyhnout přepsání vlastních modulů npm.
--build-native-deps Závislosti Pythonu se instalují místně pomocí image, která odpovídá prostředí používanému v Azure, což vyžaduje nástroje Dockeru. Pokud je tato možnost povolená, nástroje Core Tools spustí kontejner Dockeru, sestaví aplikaci uvnitř daného kontejneru a vytvoří soubor .zip se všemi obnovenými závislostmi..python_packages Tuto možnost použijte při spouštění ve Windows jako způsob, jak se vyhnout potenciálním problémům s knihovnou při nasazení do Linuxu v Azure.

func run

Pouze verze 1.x.

Tento příkaz použijte k přímému vyvolání funkce. Tento příkaz funguje jako spuštění funkce pomocí karty Test na webu Azure Portal. Tento příkaz funguje jenom ve verzi 1.x. V případě novějších verzí použijte func start a volejte koncový bod funkce přímo.

func run

Příkaz func run podporuje následující možnosti:

Možnost Popis
--content Vložený obsah předaný funkci.
--debug Před spuštěním funkce připojte ladicí program k hostitelskému procesu.
--file Název souboru, který se má použít jako obsah.
--no-interactive Nezobrazuje výzvu k zadání vstupu, což je užitečné pro scénáře automatizace.
--timeout Doba čekání (v sekundách) až do doby, než bude místní hostitel functions připravený.

Pokud chcete například volat funkci aktivovanou protokolem HTTP a předat text obsahu, spusťte následující příkaz:

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

func start

Spustí místního hostitele modulu runtime a načte projekt funkce v aktuální složce.

Konkrétní příkaz závisí na verzi modulu runtime.

func start

func start podporuje následující možnosti:

Možnost Popis
--cert Cesta k souboru .pfx, který obsahuje privátní klíč. Podporováno pouze s --useHttps.
--cors Čárkami oddělený seznam původů CORS bez mezer.
--cors-credentials Povolte požadavky ověřené mezi zdroji pomocí souborů cookie a hlavičky Ověřování.
--dotnet-isolated-debug Pokud je nastavená hodnota true, pozastaví pracovní proces .NET, dokud není ladicí program připojen z izolovaného projektu .NET, který je laděný.
--enable-json-output Pokud je to možné, vygeneruje protokoly konzoly jako JSON.
--enableAuth Povolte úplný kanál pro zpracování ověřování s požadavky na autorizaci.
--functions Seznam funkcí oddělených mezerami, které se mají načíst.
--language-worker Argumenty pro konfiguraci pracovního procesu jazyka Ladění pro pracovní proces jazyka můžete povolit například zadáním portu ladění a dalších požadovaných argumentů.
--no-build Než spustíte, nevystavujte aktuální projekt. Pouze pro projekty tříd .NET. Výchozí hodnota je false.
--password Heslo nebo soubor, který obsahuje heslo pro soubor .pfx. Používá se pouze s --cert.
--port Místní port, na který se má naslouchat. Výchozí hodnota: 7071.
--timeout Časový limit pro spuštění hostitele služby Functions v sekundách Výchozí hodnota: 20 sekund.
--useHttps Svázání s https://localhost:{port} výjimkou http://localhost:{port}. Ve výchozím nastavení tato možnost vytvoří v počítači důvěryhodný certifikát.

Se spuštěným projektem můžete ověřit jednotlivé koncové body funkcí.

func azure functionapp globální možnosti

Všechny func azure functionapp příkazy podporují tyto možnosti:

Možnost Popis
--slot Pokud je nakonfigurovaný, zaměřte se na konkrétní pojmenovaný slot nasazení.
--access-token Zadejte přístupový token kromě výchozího tokenu, který se použije k provádění ověřených akcí v Azure.
--access-token-stdin Čtení konkrétního přístupového tokenu ze standardního vstupu Tuto možnost použijte při čtení tokenu přímo z předchozího příkazu, například az account get-access-token.
--management-url Nastavte adresu URL pro správu cloudu Azure, která má výchozí hodnotu https://management.azure.com. Tuto možnost použijte, když vaše aplikace funkcí běží v suverénním cloudu.
--subscription Nastavte výchozí předplatné Azure.

func azure functionapp fetch-app-settings

Získá nastavení z konkrétní aplikace funkcí.

func azure functionapp fetch-app-settings <APP_NAME>

Další informace najdete v tématu Stažení nastavení aplikace.

Příkaz stáhne nastavení do local.settings.json souboru projektu. Příkaz maskuje hodnoty na obrazovce pro zabezpečení. Nastavení v local.settings.json souboru můžete chránit povolením místního šifrování.

func azure functionapp list-functions

Vrátí seznam funkcí v zadané aplikaci funkcí.

func azure functionapp list-functions <APP_NAME>
Možnost Popis
--show-keys Vrácené adresy URL koncového bodu funkce zahrnují hodnoty přístupových klíčů na úrovni funkce.

func azure functionapp logstream

Připojí místní příkazový řádek k protokolům streamování aplikace funkcí v Azure.

func azure functionapp logstream <APP_NAME>

Výchozí časový limit připojení je dva hodiny. Časový limit můžete změnit přidáním nastavení aplikace s názvem SCM_LOGSTREAM_TIMEOUT s hodnotou časového limitu v sekundách. Tato funkce zatím není podporovaná pro Linux v plánu Flex Consumption nebo Consumption . U těchto aplikací použijte --browser možnost zobrazit protokoly na portálu.

Akce deploy podporuje následující možnosti:

Možnost Popis
--browser Otevřete Aplikace Azure lication Insights Live Stream pro aplikaci funkcí ve výchozím prohlížeči.

Další informace najdete v tématu Povolení protokolů spouštění streamování ve službě Azure Functions.

func azure functionapp publish

Nasadí projekt Functions do existujícího prostředku aplikace funkcí v Azure.

func azure functionapp publish <APP_NAME>

Další informace naleznete v tématu Nasazení souborů projektu.

Na základě verze platí následující možnosti publikování:

Možnost Popis
--additional-packages Seznam balíčků, které se mají nainstalovat při sestavování nativních závislostí Například: python3-dev libevent-dev.
--build, -b Provede akci sestavení při nasazování do aplikace funkcí Pro Linux. Přijímá: remote a local.
--build-native-deps Přeskočí generování .wheels složky při publikování aplikací funkcí Pythonu.
--csx Publikujte projekt skriptu jazyka C# (.csx).
--dotnet-cli-params Při publikování zkompilovaných funkcí jazyka C# (.csproj) volá dotnet build --output bin/publishzákladní nástroje . Všechny parametry předané do tohoto příkazu se připojí k příkazovému řádku.
--force V určitých scénářích ignorujte předběžné publikování ověření.
--list-ignored-files Zobrazí seznam souborů, které se při publikování ignorují, což je založeno na .funcignore souboru.
--list-included-files Zobrazí seznam publikovaných souborů, které jsou založené na .funcignore souboru.
--no-build Projekt není sestaven během publikování. V případě Pythonu pip install se neprovádí.
--nozip Vypne výchozí Run-From-Package režim.
--overwrite-settings -y Potlačit výzvu k přepsání nastavení aplikace při --publish-local-settings -i použití.
--publish-local-settings -i Publikujte nastavení v local.settings.json do Azure a zobrazí se výzva k přepsání, pokud nastavení již existuje. Pokud používáte emulátor místního úložiště, nejprve změňte nastavení aplikace na skutečné připojení k úložišti.
--publish-settings-only, -o Publikujte pouze nastavení a přeskočte obsah. Výchozí hodnota je výzva.

func azure storage fetch-connection-string

Získá připojovací řetězec pro zadaný účet Azure Storage.

func azure storage fetch-connection-string <STORAGE_ACCOUNT_NAME>

Další informace najdete v tématu Stažení připojovací řetězec úložiště.

func azurecontainerapps deploy

Nasadí kontejnerizovanou aplikaci funkcí do prostředí Azure Container Apps. Účet úložiště používaný aplikací funkcí i prostředí už musí existovat. Další informace najdete v tématu Azure Container Apps hostování služby 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>

Platí následující možnosti nasazení:

Možnost Popis
--environment Název existujícího prostředí Container Apps.
--image-build Při nastavení truepřeskočí místní sestavení Dockeru.
--image-name Název image existujícího kontejneru v registru kontejneru. Název image obsahuje název značky.
--location Oblast pro nasazení V ideálním případě je tato oblast stejná jako prostředky prostředí a účtu úložiště.
--name Název použitý pro nasazení aplikace funkcí v prostředí Container Apps. Stejný název se používá také při správě aplikace funkcí na portálu. Název by měl být v prostředí jedinečný.
--registry Při nastavení se spustí sestavení Dockeru a image se odešle do registru nastaveného v --registry. Nemůžete použít --registry s --image-name. Pro Docker Hub použijte --registry-usernametaké .
--registry-password Heslo nebo token použitý k načtení image z privátního registru.
--registry-username Uživatelské jméno použité k načtení image z privátního registru.
--resource-group Skupina prostředků, ve které chcete vytvořit prostředky související s funkcemi.
--storage-account Připojovací řetězec pro účet úložiště, který bude aplikace funkcí používat.
--worker-runtime Nastaví jazyk modulu runtime aplikace funkcí. Tento parametr se používá pouze s parametrem --image-name a --image-build. V opačném případě se jazyk určí během místního sestavení. Podporované hodnoty jsou: dotnet, , dotnetIsolatednode, python, powershella custom (pro obslužné rutiny zákazníka).

Důležité

Důležité tajné kódy jsou připojovací řetězec úložiště a další přihlašovací údaje služby. Nezapomeňte bezpečně ukládat všechny soubory skriptů, které používají func azurecontainerapps deploy , a neukládají je do veřejně přístupné správy zdrojového kódu.

func deploy

Příkaz func deploy je zastaralý. Místo toho použijte func kubernetes deploy.

func durable delete-task-hub

Odstraní všechny artefakty úložiště v centru úloh Durable Functions.

func durable delete-task-hub

Akce delete-task-hub podporuje následující možnosti:

Možnost Popis
--connection-string-setting Volitelný název nastavení obsahujícího připojovací řetězec úložiště, které se má použít.
--task-hub-name Volitelný název Centra úloh Durable, které se má použít.

Další informace najdete v dokumentaci k Durable Functions.

func durable get-history

Vrátí historii zadané instance orchestrace.

func durable get-history --id <INSTANCE_ID>

Akce get-history podporuje následující možnosti:

Možnost Popis
--id Určuje ID instance orchestrace (povinné).
--connection-string-setting Volitelný název nastavení obsahujícího připojovací řetězec úložiště, které se má použít.
--task-hub-name Volitelný název Centra úloh Durable, které se má použít.

Další informace najdete v dokumentaci k Durable Functions.

func durable get-instances

Vrátí stav všech instancí orchestrace. Podporuje stránkování pomocí parametru top .

func durable get-instances

Akce get-instances podporuje následující možnosti:

Možnost Popis
--continuation-token Volitelný token, který označuje konkrétní stránku nebo oddíl požadavků k vrácení.
--connection-string-setting Volitelný název nastavení aplikace, které obsahuje připojovací řetězec úložiště, které se má použít.
--created-after Volitelně můžete získat instance vytvořené po tomto datu a čase (UTC). Všechny hodnoty datetime ve formátu ISO 8601 jsou přijímány.
--created-before Volitelně můžete získat instance vytvořené před konkrétním datem a časem (UTC). Všechny hodnoty datetime ve formátu ISO 8601 jsou přijímány.
--runtime-status Volitelně můžete získat instance, jejichž stav odpovídá určitému stavu, včetně running, completeda failed. Můžete zadat jeden nebo více stavů oddělených mezerami.
--top Volitelně můžete omezit počet záznamů vrácených v daném požadavku.
--task-hub-name Volitelný název centra úloh Durable Functions, které chcete použít.

Další informace najdete v dokumentaci k Durable Functions.

func durable get-runtime-status

Vrátí stav zadané instance orchestrace.

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

Akce get-runtime-status podporuje následující možnosti:

Možnost Popis
--connection-string-setting Volitelný název nastavení obsahujícího připojovací řetězec úložiště, které se má použít.
--id Určuje ID instance orchestrace (povinné).
--show-input Při nastavení obsahuje odpověď vstup funkce.
--show-output Při nastavení obsahuje odpověď historii spuštění.
--task-hub-name Volitelný název centra úloh Durable Functions, které chcete použít.

Další informace najdete v dokumentaci k Durable Functions.

func durable purge-history

Vyprázdnění stavu instance orchestrace, historie a úložiště objektů blob pro orchestrace starší než zadaná prahová hodnota.

func durable purge-history

Akce purge-history podporuje následující možnosti:

Možnost Popis
--connection-string-setting Volitelný název nastavení obsahujícího připojovací řetězec úložiště, které se má použít.
--created-after Volitelně můžete odstranit historii instancí vytvořených po tomto datu a čase (UTC). Všechny hodnoty data a času ve formátu ISO 8601 jsou přijímány.
--created-before Volitelně můžete odstranit historii instancí vytvořených před tímto datem a časem (UTC). Všechny hodnoty data a času ve formátu ISO 8601 jsou přijímány.
--runtime-status Volitelně můžete odstranit historii instancí, jejichž stav odpovídá určitému stavu, včetně completed, terminated, canceleda failed. Můžete zadat jeden nebo více stavů oddělených mezerami. Pokud nezahrnete --runtime-status, historie instancí se odstraní bez ohledu na stav.
--task-hub-name Volitelný název centra úloh Durable Functions, které chcete použít.

Další informace najdete v dokumentaci k Durable Functions.

func durable raise-event

Vyvolá událost na zadanou instanci orchestrace.

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

Akce raise-event podporuje následující možnosti:

Možnost Popis
--connection-string-setting Volitelný název nastavení obsahujícího připojovací řetězec úložiště, které se má použít.
--event-data Data, která se mají předat události, buď vložené, nebo ze souboru JSON (povinné). U souborů předpona cesty k souboru pomocí ampersandu (@), například @path/to/file.json.
--event-name Název události, která se má vyvolat (povinné).
--id Určuje ID instance orchestrace (povinné).
--task-hub-name Volitelný název centra úloh Durable Functions, které chcete použít.

Další informace najdete v dokumentaci k Durable Functions.

func durable rewind

Převinutí zadané instance orchestrace zpět.

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

Akce rewind podporuje následující možnosti:

Možnost Popis
--connection-string-setting Volitelný název nastavení obsahujícího připojovací řetězec úložiště, které se má použít.
--id Určuje ID instance orchestrace (povinné).
--reason Důvod pro převinutí orchestrace (povinné)
--task-hub-name Volitelný název centra úloh Durable Functions, které chcete použít.

Další informace najdete v dokumentaci k Durable Functions.

func durable start-new

Spustí novou instanci zadané funkce orchestrátoru.

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

Akce start-new podporuje následující možnosti:

Možnost Popis
--connection-string-setting Volitelný název nastavení obsahujícího připojovací řetězec úložiště, které se má použít.
--function-name Název funkce orchestrátoru, která se má spustit (povinné).
--id Určuje ID instance orchestrace (povinné).
--input Vstup do funkce orchestrátoru, buď vložený, nebo ze souboru JSON (povinné). U souborů předpona cesty k souboru pomocí ampersandu (@), například @path/to/file.json.
--task-hub-name Volitelný název centra úloh Durable Functions, které chcete použít.

Další informace najdete v dokumentaci k Durable Functions.

func durable terminate

Zastaví zadanou instanci orchestrace.

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

Akce terminate podporuje následující možnosti:

Možnost Popis
--connection-string-setting Volitelný název nastavení obsahujícího připojovací řetězec úložiště, které se má použít.
--id Určuje ID instance orchestrace (povinné).
--reason Důvod zastavení orchestrace (povinné).
--task-hub-name Volitelný název centra úloh Durable Functions, které chcete použít.

Další informace najdete v dokumentaci k Durable Functions.

func extensions install

Ručně nainstaluje rozšíření Functions do projektu non-.NET nebo do projektu skriptu jazyka C#.

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

Akce install podporuje následující možnosti:

Možnost Popis
--configPath Cesta k adresáři obsahujícího soubor extensions.csproj.
--csx Podporuje skriptování projektů jazyka C# (.csx).
--force Aktualizujte verze existujících rozšíření.
--output Výstupní cesta pro rozšíření
--package Identifikátor konkrétního balíčku rozšíření. Pokud není zadáno, nainstalují se všechna odkazovaná rozšíření, stejně jako v func extensions syncpřípadě .
--source Zdroj informačního kanálu NuGet, pokud nepoužíváte NuGet.org.
--version Verze balíčku rozšíření

Následující příklad nainstaluje v místním projektu verzi 5.0.1 rozšíření Event Hubs:

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

Při použití func extensions installplatí následující aspekty:

  • Pro zkompilované projekty C# (proces v procesu i izolovaný pracovní proces) místo toho použijte standardní metody instalace balíčku NuGet, například dotnet add package.

  • Pokud chcete rozšíření nainstalovat ručně pomocí nástrojů Core Tools, musíte mít nainstalovanou sadu .NET SDK .

  • Pokud je to možné, použijte sady rozšíření. Tady je několik důvodů, proč možná budete muset nainstalovat rozšíření ručně:

    • Potřebujete získat přístup ke konkrétní verzi rozšíření, která není dostupná v sadě.
    • Potřebujete získat přístup k vlastnímu rozšíření, které není v sadě k dispozici.
    • Potřebujete získat přístup ke konkrétní kombinaci rozšíření, která nejsou k dispozici v jedné sadě.

  • Než budete moct ručně nainstalovat rozšíření, musíte nejprve odebrat extensionBundle objekt ze souboru host.json, který sadu definuje. Není provedena žádná akce, pokud je sada rozšíření již nastavena v souboru host.json.

  • Při první instalaci rozšíření se do kořenového adresáře projektu aplikace přidá soubor projektu .NET s názvem extensions.csproj. Tento soubor definuje sadu balíčků NuGet vyžadovaných vašimi funkcemi. I když můžete pracovat s odkazy na balíčky NuGet v tomto souboru, nástroje Core Tools umožňují instalovat rozšíření, aniž byste museli ručně upravovat tento soubor projektu C#.

func extensions sync

Nainstaluje všechna rozšíření, která přidáte do aplikace funkcí.

Akce sync podporuje následující možnosti:

Možnost Popis
--configPath Cesta k adresáři obsahujícího soubor extensions.csproj.
--csx Podporuje skriptování projektů jazyka C# (.csx).
--output Výstupní cesta pro rozšíření

Znovu vygeneruje chybějící soubor extensions.csproj. Pokud v souboru host.json definujete sadu rozšíření, neproběhne žádná akce.

func kubernetes deploy

Nasadí projekt Functions jako vlastní kontejner Dockeru do clusteru Kubernetes.

func kubernetes deploy

Tento příkaz sestaví projekt jako vlastní kontejner a publikuje ho do clusteru Kubernetes. Vlastní kontejnery musí mít soubor Dockerfile. Pokud chcete vytvořit aplikaci se souborem Dockerfile, použijte tuto --dockerfile možnost s příkazem func init .

K dispozici jsou následující možnosti nasazení Kubernetes:

Možnost Popis
--dry-run Volitelně můžete zobrazit šablonu nasazení bez spuštění.
--config-map-name Volitelný název existující mapy konfigurace s nastavením aplikace funkcí, která se má použít v nasazení. Vyžaduje --use-config-map. Výchozím chováním je vytvoření nastavení na základě objektu Valuesv souboru local.settings.json.
--cooldown-period Období studeného snížení kapacity (v sekundách) po všech aktivačních událostech už není aktivní, než se nasazení škáluje zpět na nulu, přičemž výchozí hodnota je 300 s.
--ignore-errors Pokračuje v nasazení poté, co prostředek vrátí chybu. Výchozí chování je zastavit chybu.
--image-name Název image, která se má použít pro nasazení podu a ze které se mají číst funkce.
--keda-version Nastaví verzi KEDA, která se má nainstalovat. Platné možnosti jsou: v1 a v2 (výchozí).
--keys-secret-name Název kolekce tajných kódů Kubernetes, který se má použít k ukládání přístupových klíčů.
--max-replicas Nastaví maximální počet replik, pro který se horizontální automatické škálování podů (HPA) škáluje.
--min-replicas Nastaví minimální počet replik, pod kterým se HPA nebude škálovat.
--mount-funckeys-as-containervolume Připojí přístupové klíče jako svazek kontejneru.
--name Název použitý pro nasazení a další artefakty v Kubernetes.
--namespace Nastaví obor názvů Kubernetes, do kterého se má nasadit, což je výchozí obor názvů.
--no-docker Funkce se čtou z aktuálního adresáře místo z obrázku. Vyžaduje připojení systému souborů image.
--registry Při nastavení se spustí sestavení Dockeru a image se nasdílí do registru tohoto názvu. Nemůžete použít --registry s --image-name. Pro Docker použijte své uživatelské jméno.
--polling-interval Interval dotazování (v sekundách) pro kontrolu triggerů mimo PROTOKOL HTTP s výchozím nastavením 30s.
--pull-secret Tajný klíč používaný pro přístup k přihlašovacím údajům privátního registru.
--secret-name Název existující kolekce tajných kódů Kubernetes, která obsahuje nastavení aplikace funkcí pro použití v nasazení. Výchozím chováním je vytvoření nastavení na základě objektu Valuesv souboru local.settings.json.
--show-service-fqdn Zobrazí adresy URL triggerů HTTP s plně kvalifikovaným názvem domény Kubernetes místo výchozího chování při použití IP adresy.
--service-type Nastaví typ služby Kubernetes Service. Podporované hodnoty jsou: ClusterIP, NodePorta LoadBalancer (výchozí).
--use-config-map ConfigMap Ke konfiguraci Secret aplikace funkcí použijte objekt (v1) místo objektu (v1). Název mapy je nastaven pomocí --config-map-name.

Nástroje Core Tools používají místní rozhraní příkazového řádku Dockeru k sestavení a publikování image. Ujistěte se, že je váš Docker už nainstalovaný místně. Spuštěním docker login příkazu se připojte ke svému účtu.

Azure Functions podporuje hostování kontejnerizovaných funkcí buď v Azure Container Apps, nebo ve službě Azure Functions. Azure Functions oficiálně nepodporuje spouštění kontejnerů přímo v clusteru Kubernetes nebo ve službě Azure Kubernetes Service (AKS). Další informace najdete v tématu Podpora kontejnerů Linuxu ve službě Azure Functions.

func kubernetes install

Nainstaluje KEDA do clusteru Kubernetes.

func kubernetes install

Nainstaluje KEDA do clusteru definovaného v konfiguračním souboru kubectl.

Akce install podporuje následující možnosti:

Možnost Popis
--dry-run Zobrazí šablonu nasazení bez spuštění.
--keda-version Nastaví verzi KEDA, která se má nainstalovat. Platné možnosti jsou: v1 a v2 (výchozí).
--namespace Podporuje instalaci do konkrétního oboru názvů Kubernetes. Pokud není nastavený, použije se výchozí obor názvů.

Další informace najdete v tématu Správa KEDA a funkcí v Kubernetes.

func kubernetes remove

Odebere KEDA z clusteru Kubernetes definovaného v konfiguračním souboru kubectl.

func kubernetes remove

Odebere KEDA z clusteru definovaného v konfiguračním souboru kubectl.

Akce remove podporuje následující možnosti:

Možnost Popis
--namespace Podporuje odinstalaci z konkrétního oboru názvů Kubernetes. Pokud není nastavený, použije se výchozí obor názvů.

Další informace najdete v tématu Odinstalace KEDA z Kubernetes.

func settings add

Přidá nové nastavení do Values kolekce v souboru local.settings.json.

func settings add <SETTING_NAME> <VALUE>

Nahraďte <SETTING_NAME> názvem nastavení aplikace a <VALUE> hodnotou nastavení.

Akce add podporuje následující možnost:

Možnost Popis
--connectionString Přidá dvojici name-value do ConnectionStrings kolekce místo Values kolekce. Kolekci ConnectionStrings používejte pouze v případě, že je to vyžadováno určitými architekturami. Další informace najdete v local.settings.json souboru.

func settings decrypt

Dešifruje dříve zašifrované hodnoty v Values kolekci v souboru local.settings.json.

func settings decrypt

Příkaz také dešifruje hodnoty připojovacího řetězce v kolekci ConnectionStrings . V local.settings.jsonse příkaz nastaví IsEncrypted na false. Zašifrujte místní nastavení, abyste snížili riziko úniku cenných informací z local.settings.json. V Azure jsou nastavení aplikace vždy uložena zašifrovaná.

func settings delete

Odebere existující nastavení z Values kolekce v souboru local.settings.json.

func settings delete <SETTING_NAME>

Nahraďte <SETTING_NAME> názvem nastavení aplikace a <VALUE> hodnotou nastavení.

Akce delete podporuje následující možnost:

Možnost Popis
--connectionString Odebere dvojici name-value z ConnectionStrings kolekce místo z Values kolekce.

func settings encrypt

Zašifruje hodnoty jednotlivých položek v Values kolekci v souboru local.settings.json.

func settings encrypt

Příkaz také šifruje hodnoty připojovacího řetězce v kolekci ConnectionStrings . V local.settings.jsonse příkaz nastaví IsEncrypted na true, který určuje, že místní modul runtime dešifruje nastavení před použitím. Zašifrujte místní nastavení, abyste snížili riziko úniku cenných informací z local.settings.json. V Azure jsou nastavení aplikace vždy uložena zašifrovaná.

func settings list

Vypíše seznam nastavení v Values kolekci v souboru local.settings.json.

func settings list

Připojovací řetězce z ConnectionStrings kolekce jsou také výstupem. Ve výchozím nastavení jsou hodnoty maskovány pro zabezpečení. --showValue Pomocí možnosti zobrazíte skutečnou hodnotu.

Akce list podporuje následující možnost:

Možnost Popis
--showValue Zobrazí skutečné nemaskované hodnoty ve výstupu.

func templates list

Zobrazí seznam dostupných šablon funkce (triggeru).

Akce list podporuje následující možnost:

Možnost Popis
--language Jazyk, pro který se mají filtrovat vrácené šablony. Výchozí hodnota je vrátit všechny jazyky.
  • Last updated on