Vývoj Azure Functions místně pomocí rozhraní příkazového řádku Azure Functions (Preview)

Azure Functions CLI představuje novou hlavní verzi (v5) místního vývojového runtime a nástrojů pro Azure Functions. Tato verze func.exe obsahuje architekturu založenou na úlohách, takže si stáhnete jenom to, co potřebujete pro sadu, na které vyvíjíte.

Important

Azure Functions CLI (v5) je aktuálně v náhledu. Tato verze Preview zatím nepodporuje Java a PowerShell. Pokud chcete pracovat s aktuálně nepodporovanými jazyky, pokračujte v používání nástrojů Azure Functions Core Tools verze 4.

K dispozici jsou dva nástroje příkazového řádku, které se dodávají jako func.exe pro Azure Functions:

Azure Functions Core Tools Azure Functions CLI
verzefunc.exe v4 v5
Úroveň podpory Všeobecná dostupnost (GA) Náhled
Nároky na instalaci Úplný binární soubor, který obsahuje všechny příkazy a možnosti pro všechny nativní jazyky. Malá základní instalace a úlohy podle jazyka a další funkce, které podle potřeby přidáte. Host je dodáván jako samostatná komponenta, takže získáte nejnovější verzi hosta, aniž byste museli znovu stahovat CLI.
Použijte, když... Potřebujete plnou podporu GA pro všechny vývojové pracovní postupy. Chcete jednoduché prostředí založené na úlohách s novými funkcemi, jako jsou šablony rychlý start a profily, které udržují vaše místní prostředí synchronizované s konfigurací plánu hostování Azure.

Referenční informace k příkazům najdete v tématu Referenční příručka k rozhraní příkazového řádku Azure Functions (CLI).

Příklady jsou momentálně nedostupné kvůli chybějící podpoře jazykového zásobníku.

Instalace rozhraní příkazového řádku Azure Functions

Nástroj příkazového řádku Azure Functions je distribuován jako malá základní instalace doplněná o komponenty, které přidáte pro technologie, ve kterých vyvíjíte. Po instalaci je binární soubor func na vašem PATH.

Note

Metoda instalace se může změnit mezi verzí Preview a obecnou dostupností.

iex "& { $(irm https://aka.ms/func-cli/install.ps1) } -Prerelease"

Pokud upgradujete z předchozí instalace, přidejte -Force do příkazu (PowerShell) nebo --force Bash.

Ověřte instalaci:

func --version

Po instalaci základního nástroje CLI nainstalujte úlohy pro váš stack. Nejrychlejší způsob je func setup, který nainstaluje hostitele, pracovní proces jazyka, sady rozšíření (v případě potřeby), sadu úloh zásobníku a úlohy šablon v jednom kroku.

Příklad:

func setup --features dotnet

func setup --features node

func setup --features python

func setup --features go

Úlohy můžete také nainstalovat jednotlivě pomocí func workload install. V obou případech platí, že při prvním spuštění func init, func new nebo func run bez nainstalovaných potřebných úloh vás rozhraní příkazového řádku vyzve k jejich instalaci.

Workloads

Rozhraní příkazového řádku Azure Functions používá model workload. Základní func instalace je malá a nezávislá na jazyce. Sady úloh instalujete podle potřeby, abyste získali nástroje pro konkrétní zásobník, hostitele služby Functions, jazykové pracovní procesy, sady rozšíření a šablony.

Úlohy spadají do těchto kategorií:

  • Host: Běhové prostředí hostitele Azure Functions, které func run používá.
  • Bundles: Předem sestavené artefakty balíčku rozšíření, aby triggery a vazby fungovaly bez další konfigurace (vyžadováno pro platformy jiné než .NET).
  • Stack: Nástroje projektu specifické pro jazyk (například python, node, dotnet).
  • Pracovní proces: Pracovní proces jazyka, který hostitel používá za běhu (například python-worker, node-worker).
  • Šablony: Šablony funkcí zobrazené pomocí func new (například python-templates, node-templates).

Úplný seznam dostupných úloh a jejich popis najdete v referenčních informacích k dostupným úlohám v rozhraní příkazového řádku.

První spuštění

Při prvním spuštění func initfunc newnebo func runrozhraní příkazového řádku zkontroluje, jestli jsou nainstalované úlohy požadované pro váš scénář. Pokud ne, rozhraní příkazového řádku vás vyzve k jejich instalaci. Přijetím výzvy se nainstaluje doporučená sada pro vámi zvolenou sadu. Výzvu a instalaci úloh můžete odmítnout ručně pomocí příkazu func workload install, nebo spustit func setup a zřídit standardní sadu neinteraktivně.

Aktualizace úloh

Pravidelně spouštějte func workload search, abyste zkontrolovali nově dostupné workloady. Pokračujte v používání Core Tools (v4) pro nepodporované sady technologií nebo pokud potřebujete konkrétní funkce verze GA nástroje Core Tools.

Vytvoření místního projektu

K vytvoření nového projektu Functions použijte func init příkaz.

func init MyProjFolder --stack dotnet

func init MyProjFolder --stack node --language javascript

func init MyProjFolder --stack node --language typescript

func init MyProjFolder --stack python

func init MyProjFolder --stack go

Možnost --stack určuje, která jazyková sada se má použít. Nainstalovaná sada úloh pro daný technologický zásobník poskytuje vygenerování základní struktury projektu.

Vytvoření funkce

Pokud chcete přidat funkci ze šablony, použijte func new příkaz.

func new --template "HTTP trigger" --name MyHttpTrigger

Místní spouštění funkcí

Pokud chcete spustit hostitele Služby Functions a spustit projekt, použijte func run:

func run

func start se zachová jako zpětně kompatibilní alias. Hostitel automaticky spravuje Azurite (emulátor místního úložiště), pokud nezadáte --no-azurite.

Vytvoření kostry projektu ze šablon rychlého startu

Pokud si chcete procházet a vygenerovat kostru kompletních ukázkových aplikací (rozhraní HTTP API, procesy zpracovávající frontu, orchestrace Durable Functions), použijte func quickstart:

func quickstart --stack dotnet --resource http

func quickstart --stack node --resource http

func quickstart --stack python --resource http

func quickstart --stack go --resource http

Správa úloh

Slouží func workload k instalaci, aktualizaci a odebrání úloh. Úplný seznam dílčích příkazů a voleb najdete v referenční příručce k CLI func workload.

Profiles

Profily kódují omezení verze pro hostitele, sady rozšíření a pracovní procesy. Použijte profil za běhu pomocí func run --profile <name>. Úplný seznam dílčích příkazů a voleb najdete v referenční příručce k CLI func profile.

Související obsah

  • Last updated on