Kommentar
Åtkomst till den här sidan kräver auktorisering. Du kan prova att logga in eller ändra kataloger.
Åtkomst till den här sidan kräver auktorisering. Du kan prova att ändra kataloger.
Azure Functions CLI är nästa huvudversion (v5) av den lokala utvecklingskörningen och verktygen för Azure Functions. Den här versionen av func.exe har en arbetsbelastningsbaserad arkitektur, så du laddar bara ned det du behöver för stacken som du utvecklar på.
Important
Azure Functions CLI (v5) är för närvarande i förhandsvisning. Denna förhandsversion stöder ännu inte Java och PowerShell. För att arbeta med för närvarande ej stödda språk, fortsätt använda Azure Functions Core Tools v4.
Det finns två versioner av func.exe som används för lokal Azure Functions utveckling:
| v4 | v5 | |
|---|---|---|
| API-namn | Azure Functions Core Tools | Azure Functions CLI |
| Supportnivå | Allmän tillgänglighet (GA) | Förhandsversion |
| Installera fotavtryck | Fullständig binär fil som innehåller alla kommandon och funktioner för alla inbyggda språk. | Liten basinstallation, plus arbetsbelastningar per språk och andra funktioner som du lägger till efter behov. Värdprogrammet distribueras som en separat arbetsbelastning, så du får den senaste versionen av värdprogrammet utan att ladda ned CLI igen. |
| Använd när... | Du behöver fullständigt GA-stöd för alla utvecklingsarbetsflöden. | Du vill ha en enkel, arbetsbelastningsbaserad upplevelse med nya funktioner som snabbstartsmallar och profiler som håller din lokala miljö synkroniserad med konfigurationen av din Azure värdplan. |
Kommandoreferensen finns i Azure Functions CLI-referens.
Exempel är för närvarande inte tillgängliga på grund av brist på stöd för språkstacken.
Installera Azure Functions CLI
Azure Functions CLI distribueras som en liten basinstallation samt arbetslaster som du lägger till för de teknikstackar som du utvecklar för. Microsoft publicerar installationspaket för Windows, macOS och Linux. Efter installation finns binären func i din PATH.
Note
Även om Azure Functions CLI är i förhandsversion installerar du den senaste versionen av förhandsversionen från sidan Azure Functions Core Tools. Slutlig installationsvägledning publiceras med den allmänna tillgänglighetsversionen.
Kontrollera installationen:
func --version
När du har installerat bas-CLI installerar du arbetsbelastningarna för din stack. Det snabbaste sättet är func setup, som installerar värdprogrammet, språkarprocessen, tilläggspaketen (vid behov), stackworkloaden och mallworkloaden i ett steg.
Ett exempel:
func setup --features dotnet
func setup --features node
func setup --features python
func setup --features go
Du kan också installera arbetsbelastningar individuellt med hjälp av func workload install. Oavsett vilket, första gången du kör func init, func neweller func run utan de nödvändiga arbetsbelastningarna installerade, uppmanar CLI dig att installera dem.
Workloads
Azure Functions CLI använder en workload-modell. Basinstallationen func är liten och språkagnostisk. Du installerar arbetslaster vid behov för att få stackspecifika verktyg, värdprocessen för Functions, språk-arbetare, tilläggspaket och mallar.
Arbetsbelastningar delas in i följande kategorier:
-
Host: Den Azure Functions värdkörning som
func runanvänder. - Bundles: Fördefinierade tilläggspaketartefakter så att utlösare och bindningar fungerar direkt (krävs för icke-.NET stacks).
-
Stack: Språkspecifik projektverktyg (till exempel
python,node,dotnet). -
Worker: Det språkspecifika worker-program som värden använder under körning (till exempel
python-worker,node-worker). -
Mallar: Funktionsmallar som visas av
func new(till exempelpython-templates,node-templates).
Den fullständiga listan över tillgängliga arbetsbelastningar och deras beskrivningar finns i Tillgängliga arbetsbelastningar i CLI-referensen.
Upplevelse vid första körningen
Första gången du kör func init, func neweller func run, kontrollerar CLI om de arbetsbelastningar som krävs för ditt scenario är installerade. Om de inte är det uppmanar CLI dig att installera dem. Om du godkänner uppmaningen installeras den rekommenderade uppsättningen för den stack som du har valt. Du kan tacka nej till uppmaningen och installera arbetsbelastningar manuellt med func workload install, eller köra func setup för att installera standarduppsättningen utan interaktion.
Arbetsbelastningsuppdateringar
Kör func workload search regelbundet för att kontrollera om det finns nya tillgängliga arbetsbelastningar. Fortsätt att använda Core Tools (v4) för staplar som inte stöds eller när du behöver specifika GA-funktioner i Core Tools.
Skapa ett lokalt projekt
Använd kommandot func init för att skapa ett nytt Functions-projekt.
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
Alternativet --stack anger vilken språkstack som ska användas. Den installerade arbetsuppsättningen för den stacken skapar grundstrukturen.
Skapa en funktion
Om du vill lägga till en funktion från en mall använder du func new kommandot .
func new --template "HTTP trigger" --name MyHttpTrigger
Köra funktioner lokalt
Använd func run om du vill starta Functions-värden och köra projektet:
func run
func start bevaras som ett bakåtkompatibelt alias. Värdprocessen hanterar automatiskt Azurite (lokal emulator för lagring) om du inte anger --no-azurite.
Generera struktur utifrån snabbstartsmallar
Om du vill bläddra bland och generera fullständiga exempelappar (HTTP-API:er, köbearbetare, Durable Functions-orkestreringar) använder du följande: 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
Hantera arbetsbelastningar
Använd func workload för att installera, uppdatera och ta bort arbetsbelastningar. Den fullständiga listan över underkommandon och alternativ func workload finns i CLI-referensen.
Profiles
Profiler kodar versionsbegränsningar för värden, tilläggspaket och arbetare. Tillämpa en profil vid körning med func run --profile <name>. Den fullständiga listan över underkommandon och alternativ func profile finns i CLI-referensen.