Sdílet prostřednictvím

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

  • Článek

Tento článek obsahuje referenční dokumentaci ke službě Azure Functions Core Tools, která umožňuje 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 používané k 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 V2 pro V1 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 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: net9.0 (Preview), (výchozí) net6.0net8.0 a 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 s VYUŽITÍM 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 je také nutné zvolit jazyk.

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

Možnost Popis
--authlevel Umožňuje nastavit ú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 (Verze 2.x a novější verze.) Vygeneruje stejné šablony skriptu C# (.csx) používané ve verzi 1.x a na portálu.
--language, -l Programovací jazyk šablon, například C#, F# nebo JavaScript. Tato možnost je vyžadována ve verzi 1.x. Ve verzi 2.x a novějších verzích tuto možnost nepoužíváte, protože jazyk je definován modulem runtime pracovního procesu.
--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 run

Pouze verze 1.x.

Umožňuje vyvolat funkci přímo, která se podobá spuštění funkce pomocí karty Test na webu Azure Portal. Tato akce je podporována pouze ve verzi 1.x. V případě novějších verzí použijte func start a volejte koncový bod funkce přímo.

func run

Akce 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 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.

Nastavení se stáhnou do souboru local.settings.json projektu. Hodnoty na obrazovce jsou maskované pro zabezpečení. Nastavení v souboru local.settings.json 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>

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 2 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. V plánu Consumption zatím nejsou podporované aplikace pro Linux. 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
--access-token Umožňuje použít konkrétní přístupový token při provádění ověřených azure akcí.
--access-token-stdin Načte konkrétní přístupový token 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.
--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.
--management-url Nastaví adresu URL správy pro váš cloud. Tuto možnost použijte při spuštění v suverénním cloudu.
--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.
--slot Volitelný název konkrétního slotu, do kterého se má publikovat.
--subscription Nastaví výchozí předplatné, které se má použít.

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
--access-token Umožňuje použít konkrétní přístupový token při provádění ověřených azure akcí.
--access-token-stdin Načte konkrétní přístupový token 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.
--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ě se jedná o stejnou oblast jako prostředky prostředí a účtu úložiště.
--management-url Nastaví adresu URL správy pro váš cloud. Tuto možnost použijte při spuštění v suverénním cloudu.
--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 nasdílí do registru nastaveného v --registrysouboru . 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.
--subscription Nastaví výchozí předplatné, které se má použít.
--worker-runtime Nastaví jazyk modulu runtime aplikace funkcí. Tento parametr se používá pouze s --image-name a --image-buildv opačném případě je jazyk určen během místního sestavení. Podporované hodnoty jsou: dotnet, , nodedotnetIsolated, 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 soubory skriptů, které používají func azurecontainerapps deploy , a neukládejte je do žádné 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ů, které se mají vrátit.
--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 poskytnout jednu nebo více soch oddělených prostorem.
--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ě completd, terminated, canceleda failed. Můžete poskytnout jednu nebo více soch oddělených prostorem. 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 ručně nainstalovat rozšíření pomocí nástrojů Core Tools, musíte mít nainstalovanou sadu .NET 6.0 SDK .

  • Pokud je to možné, měli byste místo toho použít 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í v sadě k dispozici.
    • V sadě potřebujete získat přístup k vlastnímu rozšíření, které není 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í přidaná 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 je v souboru host.json definována sada rozšíření, není provedena žá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 Values v 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 Values v 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 nastavení aplikace funkcí použijte objekt (v1) místo objektu Secret (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

Hodnoty připojovacího ConnectionStrings řetězce v kolekci se také dešifrují. V local.settings.json IsEncrypted je také nastavena hodnota 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

Hodnoty připojovacího ConnectionStrings řetězce v kolekci jsou také šifrované. V local.settings.json IsEncrypted je také nastaven na true, který určuje, že místní modul runtime dešifruje nastavení před jejich 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í. Pomocí této --showValue možnosti můžete zobrazit 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.