Azure Functions lokal runtime och verktygsreferens

Den här artikeln innehåller referensdokumentation för den lokala runtime och verktyg som stödjer Azure Functions. Använd dessa verktyg för att utveckla, hantera och köra Azure Functions-projekt från din lokala dator. Det binära namnet är func (eller func.exe på Windows).

Två lokala utvecklingsupplevelser levereras somfunc.exe: Azure Functions Core Tools (GA) och Azure Functions CLI (förhandsvisning). Använd väljaren för att välja vilken upplevelse du ska titta på.

Viktigt!

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å kommandoradsverktyg som levereras som func.exe för Azure Functions:

Azure Functions Core Tools Azure Functions CLI
func.exe version v4 v5
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ärden levereras som en egen arbetsbelastning, så du får den senaste värdversionen 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.

Mer information om hur du använder Core Tools finns i Work with Azure Functions Core Tools.

Core Tools-kommandon ordnas i följande kontexter, var och en ger en unik uppsättning åtgärder.

Kommandokontext beskrivning
func Kommandon för att skapa och köra funktioner på den lokala datorn.
func azure Kommandon för att arbeta med Azure resurser, inklusive publicering.
func azurecontainerapps Kommandon för att distribuera en containerbaserad funktionsapp till Azure Container Apps.
func bundles Kommandon för att hantera tilläggspaket.
func durable Kommandon för att arbeta med Durable Functions.
func extensions Kommandon för att installera och hantera tillägg.
func kubernetes Kommandon för att arbeta med Kubernetes och Azure Functions.
func settings Kommandon för att hantera miljöinställningar för den lokala Functions-värden.
func templates Kommandon för att visa tillgängliga funktionsmallar.

Installera Core Tools innan du använder kommandona i den här artikeln.

Viktigt!

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.

För att lära dig mer om hur man använder CLI:n, inklusive installation och arbetsbelastningar, se Utveckla Azure Functions lokalt med hjälp av Azure Functions CLI.

Följande inbyggda kommandon levereras med bas-CLI-installationen:

Command beskrivning
func init Initiera ett nytt Azure Functions-projekt.
func new Skapa en ny funktion från en mall.
func run Starta Azure Functions-hostruntime lokalt. func start är ett bakåtkompatibelt alias.
func quickstart Bläddra bland och bygg upp kompletta funktionsappar från quickstart-mallkatalogen.
func profile Inspect and manage Azure Functions CLI-profiler.
func setup Förbered lokala Azure Functions CLI-beroenden (host runtime, language workers, extension bundles).
func workload Hantera installerade CLI-arbetsbelastningar.

Arbetsbelastningar kan bidra med ytterligare kommandon på högsta nivå. Dessa kommandon dyker bara upp efter att du installerat den bidragande arbetsbelastningen.

func init

Skapar ett nytt Functions-projekt på ett visst språk.

func init [<PROJECT_FOLDER>]

När du tillhandahåller <PROJECT_FOLDER>, skapar kommandot projektet i en ny mapp med detta namn. Annars använder den den aktuella mappen.

Kommandot func init stöder dessa alternativ, som beror på versionen:

Alternativ beskrivning
--bundles-channel, -c Versionskanal för tilläggspaket. Värden som stöds är: GA (standard), Previewoch Experimental. Gäller endast för icke-.NET projekt.
--configuration-profile Initierar ett projekt med en värdkonfigurationsprofil. Alternativet --configuration-profile är för närvarande i förhandsversion. Mer information finns i Konfigurationsprofiler.
--csx Skapar .NET fungerar som C#-skript. Endast giltigt med --worker-runtime dotnet.
--docker Skapar en Dockerfile för en container genom att använda en basavbildning baserad på den valda --worker-runtime. Använd det här alternativet när du planerar att distribuera en containerbaserad funktionsapp.
--docker-only Lägger till en Dockerfile i ett befintligt projekt. Frågar efter worker-runtime om det inte anges eller anges i local.settings.json. Använd det här alternativet när du planerar att distribuera en containerbaserad funktionsapp och projektet redan finns.
--force Initierar projektet även när det finns befintliga filer i projektet. Den här inställningen skriver över befintliga filer med samma namn. Andra filer i projektmappen påverkas inte.
--language, -l Initierar ett språkspecifikt projekt. Stöds för närvarande när --worker-runtime är inställt på node. Alternativen är typescript och javascript. Du kan också använda --worker-runtime javascript eller --worker-runtime typescript.
--managed-dependencies Installerar hanterade beroenden. För närvarande har endast PowerShell-arbetskörningen stöd för den här funktionen.
--model, -m Anger programmeringsmodellen för ett målspråk när mer än en modell är tillgänglig. Alternativen som stöds är V1 och V2 för Python och V3 och V4 för Node.js. Mer information finns i utvecklarguiden Python och utvecklarguiden Node.js.
--no-bundle Konfigurera inte tilläggspaketet i host.json. Gäller endast för icke-.NET projekt.
--no-docs Hoppar över att generera dokumentationsfilerna "Komma igång". Gäller för Python projekt.
--skip-npm-install Hoppa över körningen npm install när projektet har skapats. Gäller för Node.js projekt.
--source-control Styr om en Git-lagringsplats skapas. Som standard skapas inte en lagringsplats. När trueskapas en lagringsplats.
--worker-runtime Anger språkkörningen för projektet. Värden som stöds är: csharp, dotnet, dotnet-isolated, javascript( node JavaScript), powershell, pythonoch typescript. För Java använder du Maven. Om du vill generera ett språkagnostiskt projekt med bara projektfilerna använder du custom. När du inte har angetts uppmanas du att välja din körning under initieringen.
--target-framework Anger målramverket för funktionsappprojektet. Endast giltigt med --worker-runtime dotnet-isolated. Värden som stöds är: net10.0 (förhandsversion), net9.0, net8.0 (standard), net6.0 och net48 (.NET Framework 4.8).

Kommentar

När du använder alternativet --docker eller --docker-only skapar Core Tools automatiskt Dockerfile för funktionerna C#, JavaScript, Python och PowerShell. För Java funktioner måste du skapa Dockerfile manuellt. Mer information finns i Skapa containerbaserade funktionsappar.

Konfigurationsprofiler

Viktigt!

Stöd för konfigurationsprofiler finns för närvarande i förhandsversion.

När du använder alternativet --configuration-profile skapar du en fördefinierad uppsättning projektkonfigurationer och inställningar. När du anger en konfigurationsprofil kan initieringen hoppa över alla andra initieringssteg.

Profilvärde beskrivning Specifika åtgärder
mcp-custom-handler Skapar ett projekt som använder anpassade hanterare som värd för en MCP-server (Model Context Protocol) som AI-agenter och andra MCP-klienter kan ansluta till. • Konfigurerar elementet "configurationProfile": "mcp-custom-handler" i host.json-filen med specifika anpassade hanteringsinställningar.
• Anger MCP_EXTENSION_ENABLED till true i local.settings.json.		 
func init [<PATH>] [options]

När du tillhandahåller <PATH>, skapas projektet i den mappen. Annars används den aktuella mappen.

Kommandot func init stöder dessa inbyggda alternativ:

Alternativ beskrivning
--stack, -s Stacken som ska användas för projektet (till exempel python, node, dotnet, ). go Kör func workload list för att se stackarna som dina installerade arbetsbelastningar bidrar med.
--name, -n Namnet på funktionsappprojektet.
--language, -l Programmeringsspråket (till exempel C#, F#, JavaScript, TypeScript, Python). Används när en stack stödjer mer än ett språk. Stödda värden beräknas från installerade stackarbetsbelastningar.
--force Starta om även när målmappen inte är tom. Rensar mappen (förutom .git) innan byggnadsställningen.

Arbetsbelastningar bidrar med ytterligare alternativ som grupperas under arbetsbelastningens namn i func init --help. Se arbetsbelastningsspecifika alternativ för alternativ per stack.

Om ingen arbetsbelastning tillhandahåller den begärda stacken, skriver CLI:n ut en ledtråd som pekar på func workload install och avslutar med en icke-noll exitkod.

Arbetsbelastningsspecifika alternativ

Kommandot init utökas när du installerar en eller flera av dessa arbetsbelastningar:

Alternativ beskrivning
--target-framework, -tfm Målet .NET ramverket för projektet (till exempel net10.0). Förvald: net10.0.

.NET initieraren skriver inte ett extension bundle-block, så --no-bundles och --bundles-channel är inte tillämpliga.

När mer än en installerad arbetsbelastning bidrar med samma alternativ visas alternativet en gång i func init --help.

Delade alternativ

För närvarande är --no-bundles de delade alternativen och --bundles-channel. Det standard-tilläggspaket-ID du skriver till host.json beror på den valda kanalen:

Channel Paket-ID
GA (standardinställning) Microsoft.Azure.Functions.ExtensionBundle
Preview Microsoft.Azure.Functions.ExtensionBundle.Preview
Experimental Microsoft.Azure.Functions.ExtensionBundle.Experimental

Standardversionsintervallet är [4.*, 5.0.0).

func new

Skapar en ny funktion i det aktuella projektet baserat på en mall.

func new

Kommandot func new stöder dessa alternativ, som beror på versionen:

Alternativ beskrivning
--authlevel, -a Anger auktoriseringsnivån för en HTTP-utlösare. Värden som stöds är: function, anonymous, admin. Auktorisering tillämpas inte när den körs lokalt. Mer information finns i auktoriseringsnivå.
--csx Genererar samma C#-skript (.csx)-mallar som används i version 1 och i portalen.
--file, -f Målfilen för den nya funktionen. För Python v2-projekt anger filen som funktionen ska läggas till i (standardvärdet function_app.py). För Node.js v4-projekt anger utdatafilens namn i src/functions mappen. Gäller inte för kompilerade .NET projekt.
--name, -n Funktionsnamnet.
--template, -t func templates list Använd kommandot för att se den fullständiga listan över tillgängliga mallar för varje språk som stöds.

Mer information finns i Skapa en funktion.

func new [<PATH>] [options]

Viktigt!

func new är för närvarande en förhandsvisningsstub. Den skriver ut en arbetsbelastningsinstallations-hint och avslutar med en icke-noll utgångskod tills en mallarbetsbelastning installeras och kopplas in med tråd. Mallspecifika alternativ är dynamiskt hydrerade från mallmetadata, så att lägga till ett nytt mallalternativ kräver ingen CLI-release.

Kommandot func new stöder dessa inbyggda alternativ:

Alternativ beskrivning
--name, -n Funktionsnamnet.
--template, -t Namnet på funktionsmallen. Tillgängliga mallar kommer från den installerade <stack>-templates arbetsbelastningen för projektets stack.
--force Skriv över befintliga filer.

Ytterligare alternativ bidrar dynamiskt av den valda mallen. Kör func new --template <name> --help för att se alternativen för en specifik mall.

Om ingen mallar är installerad för det aktuella projektet, skriver CLI:n ut en ledtråd som pekar på func workload install.

func logs

Hämtar loggar för funktioner som körs i ett Kubernetes-kluster.

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

Kommandot func logs stöder följande alternativ:

Alternativ beskrivning
--platform Värdplattform för funktionsappen. Giltiga alternativ: kubernetes.
--name Funktionsappens namn i Azure.

Mer information finns i Azure Functions på Kubernetes med KEDA.

func pack

Skapar ett distributionspaket som innehåller projektkoden i ett körbart tillstånd. Använd den här metoden när du behöver skapa ett distributionspaket för appen manuellt på den lokala datorn utanför func azure functionapp publish kommandot. Som standard func pack skapar du projektet när det behövs.

För Go-funktionsappar bygger func pack ett Linux x64-distributionspaket som du kan distribuera med kommandot Azure CLI az functionapp deployment source config-zip.

func pack [<FOLDER_PATH>]

Som standard func pack paketeras den aktuella katalogen och utdata .zip-filen har samma namn som rotmappen för projektet. Kör func pack i katalogen som innehåller din host.json projektfil. Om du behöver köra func pack i en annan katalog anger du <FOLDER_PATH> som sökväg till projektroten, till exempel func pack ./myprojectroot. Om den specifika .zip filen redan finns tas den först bort och ersätts sedan med en uppdaterad version.

Kommandot func pack stöder följande alternativ:

Alternativ beskrivning
--output, -o Anger sökvägen till den plats där distributionen .zip paketfilen skapas.
--no-build Project skapas inte innan du packar. För C#-appar använder du bara när du redan har genererat dina binärfiler. Både och npm install hoppas över för Node.js apparnpm run build. För Go-appar, använd endast när bin/app redan innehåller en Linux x64-binär.
--skip-install Hoppar över körning npm install när du packar Node.js-baserad funktionsapp. Används för att undvika att skriva över anpassade npm-moduler.
--build-native-deps Installerar Python beroenden lokalt med hjälp av en avbildning som matchar miljön som används i Azure. När det är aktiverat startar Core Tools en Docker-container, skapar appen i containern och skapar en .zip fil med alla beroenden återställda i .python_packages. Använd det här alternativet när du kör på Windows för att undvika eventuella biblioteksproblem när du distribuerar till Linux i Azure.

func run (endast v1)

Kommentar

Detta kommando gäller endast för version 1 av Core Tools och är föråldrat. För version 4, använd func start och anropa funktionsändpunkten direkt.

Anropar en funktion direkt, liknande att köra en funktion genom att använda fliken Test i Azure portalen.

func run

Kommandot func run stöder följande alternativ:

Alternativ beskrivning
--content Infogat innehåll som skickas till funktionen.
--debug Koppla ett felsökningsprogram till värdprocessen innan du kör funktionen.
--file Filnamnet som ska användas som innehåll.
--no-interactive Frågar inte efter indata, vilket är användbart för automatiseringsscenarier.
--timeout Tid att vänta (i sekunder) tills den lokala Functions-värden är klar.

Om du till exempel vill anropa en HTTP-utlöst funktion och skicka innehållstexten kör du det här kommandot:

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

func start

Startar den lokala körningsvärden och läser in funktionsprojektet i den aktuella mappen.

Det specifika kommandot beror på körningsversionen.

func start

Kommandot func start stöder följande alternativ:

Alternativ beskrivning
--cert Sökvägen till en .pfx-fil som innehåller en privat nyckel. Stöds endast med --useHttps.
--cors En kommaavgränsad lista över CORS-ursprung, utan blanksteg.
--cors-credentials Tillåter autentiserade begäranden mellan ursprung som använder cookies och autentiseringshuvudet.
--dotnet-isolated-debug När den är inställd på true pausar .NET arbetsprocessen tills ett felsökningsprogram är kopplat från det .NET isolerade projekt som debuggas.
--enable-json-output Genererar konsolloggar som JSON när det är möjligt.
--enableAuth Aktiverar den fullständiga pipelinen för autentiseringshantering med auktoriseringskrav.
--functions En blankstegsavgränsad lista över funktioner som ska läsas in.
--json-output-file Om det finns en sökväg till filen som används för att skriva utdata när du använder --enable-json-output.
--language-worker Argument för att konfigurera språkarbetaren. Du kan till exempel aktivera felsökning för språkarbetare genom att ange debugport och andra nödvändiga argument.
--no-build Skapa inte det aktuella projektet innan du kör det. Endast för .NET klassprojekt. Standard är false.
--password Antingen lösenordet eller en fil som innehåller lösenordet för en .pfx-fil. Används endast med --cert.
--port, -p Den lokala porten att lyssna på. Standardvärde: 7071.
--runtime Anger vilken version av värden som ska startas. Tillåtna värden är: inproc6, inproc8och default (som kör out-of-process-värden).
--timeout, -t Tidsgränsen för att Functions-värden ska starta i sekunder. Standard: 20 sekunder.
--useHttps Binda till i stället för https://localhost:{port} till http://localhost:{port}. Som standard skapar det här alternativet ett betrott certifikat på datorn.
--user-log-level Anger den lägsta loggnivån för användarloggar. Giltiga värden är: Trace, Debug, Information, Warning, Error, Criticaloch None. Den här inställningen påverkar inte systemloggar. För .NET isolerade projekt anger du även miniminivån i Program.cs med hjälp av builder.Logging.SetMinimumLevel(LogLevel.Debug) för att det här alternativet ska börja gälla.

När projektet körs kontrollerar du enskilda funktionsslutpunkter.

func run

Startar Functions värdkörning och laddar projektet i den aktuella mappen.

func run [<PATH>] [options]

func start bevaras som ett bakåtkompatibelt alias och accepterar samma argument och alternativ.

Kommandot func run stöder följande alternativ:

Alternativ beskrivning
--port, -p Den lokala porten att lyssna på. Förvald: 7071.
--cors En kommaavgränsad lista över CORS-ursprung, utan blanksteg.
--cors-credentials Tillåt autentiserade förfrågningar över ursprung som använder cookies och Authentication headern.
--functions En blankstegsavgränsad lista över funktioner som ska läsas in.
--no-build Bygg inte projektet innan du startar.
--enable-auth Aktivera hela autentiseringshanteringskedjan, inklusive auktorisationskrav.
--host-version, -v Värdversionen för körtid att använda (till exempel 4.1049.0).
--profile Azure Functions-profilen ska tillämpas vid lösningen av värd-, arbets- och bundleversioner. Se även func profile.
--offline Använd endast lokalt installerade arbetsbelastningar och hoppa över nätverksinstallationer.
--output Utdataläge: compact (interaktiv TUI), plain (CI / icke-TTY), eller json (NDJSON för programmatiska konsumenter och AI-agenter). Standardinställningen är autodetekterad baserat på terminalen.
--no-tui Alias för --output=plain. Inaktiverar den interaktiva TUI.
--log-file Spegelspegla alla värdhändelser till den angivna loggfilen.
--no-azurite Inaktivera hanterad Azurite. Värden startar utan att undersöka eller starta en lokal emulator.

När projektet körs, anropa funktionsändpunkterna direkt för att verifiera beteendet.

Managed Azurite

När ditt projekt använder lokal lagring (till exempel AzureWebJobsStorage=UseDevelopmentStorage=true), func run kontrollerar automatiskt om det finns en Azurite-emulator som körs och startar en om den inte hittar någon. Emulatorn stannar när func run den avslutar. Klara --no-azurite av att välja bort och hantera Azurite själv.

Utdatalägen

func run Väljer automatiskt ett utgångsläge baserat på terminalen:

Tillstånd Mode
Interaktiv terminal (TTY) compact
Icke-interaktiv stdout, omdirigerad utdata eller CI miljövariabeluppsättning plain
Explicit --output=json json

CLI:n väljer aldrig automatiskt json. Om compact det begärs men stdout inte är en TTY, nedgraderar CLI till plain och skriver en enradig notis till stderr. Läget json avger nyradsavgränsad JSON (NDJSON), ett objekt per rad, med en schema_version av 1.

func quickstart

Bläddrar och ställer fullständiga funktionsappar från Azure Functions snabbstartskatalog. Quickstart-mallar är fullständiga exempelappar, såsom ett HTTP-API, en kö-utlöst worker eller en Durable Functions-orkestrering. Stackarbetsbelastningar bidrar med de språkspecifika resolvers. Katalogen hämtas vid kommando-invocation-tidpunkten.

func quickstart [<PATH>] [options]

När du tillhandahåller <PATH>, skapas projektet i den mappen. Annars används den aktuella mappen.

Kommandot func quickstart stöder följande alternativ:

Alternativ beskrivning
--stack, -s Stacken som ska användas, såsom python, node, , eller dotnet.
--language, -l Programmeringsspråket. Stödda värden kommer från installerade snabbstartsleverantörer.
--template, -t Mall-ID från katalogen, såsom http-trigger-python-azd. Hoppar över alla interaktiva promptar.
--resource, -r Filtrera efter trigger eller bindningsresurs, såsom http, , , timer, blob, eventhubservicebus, cosmossql, eller mcp. durable
--iac Filtrera efter infrastruktur-som-kod-typ, såsom bicep, terraform, eller none.
--search Kasus-insensitivt substrängfilter applicerat på mallnamn och beskrivningar.
--fetch Kataloghämtningsstrategi: auto (standard), git, eller http. auto undersöker och git faller tillbaka på HTTP.
--force Ställning även när målmappen inte är tom. Rensar mappen (förutom .git) innan byggnadsställningen.

Underkommandon:

Subcommand beskrivning
func quickstart list Lista tillgängliga mallar i katalogen.
func quickstart info Visa detaljer om en specifik mall.

func quickstart list

Listar tillgängliga mallar från katalogen, valfritt filtrerade.

func quickstart list [options]
Alternativ beskrivning
--stack, -s Stacken som ska användas, såsom python, node, , eller dotnet.
--language, -l Programmeringsspråket. Stödda värden kommer från installerade snabbstartsleverantörer.
--resource, -r Filtrera efter trigger eller bindningsresurs.
--iac Filtrera efter infrastruktur-som-kod-typ.
--search Mellanlägeskänslig delsträngsmatchning mot ID:n, mallnamn, resurstyp, Infrastruktur som kodtyp och beskrivningar.
--json Generera maskinläsbar JSON istället för en tabell.

func quickstart info

Visar detaljerad information om en specifik mall.

func quickstart info <ID> [options]

<ID> är mall-ID:t från katalogen. Använd func quickstart list för att hitta tillgängliga ID:n.

Alternativ beskrivning
--json Generera maskinläsbar JSON istället för formaterad utdata.

func profile

Inspekterar och hanterar Azure Functions CLI-profiler. Profiler kodar versionsbegränsningar, såsom värdversionsintervallet, versionsintervallet för extension bundle och arbetarversionens intervall. De definierar också arv från andra profiler. Profilkällor inkluderar projekt-lokal (.func/profiles/), användar-global (~/.azure-functions/profiles/) och inbyggda profiler. Använd func run --profile <name> alternativet för att välja vilka profilbegränsningar som gäller när du startar värden.

func profile <subcommand>

Underkommandon:

Subcommand beskrivning
func profile list Lista profiler tillgängliga från projekt-, användar- och inbyggda källor.
func profile show Visa detaljer för en profil.
func profile set Sätt standardprofilen för ett projekt.

func profile list

Listar profiler tillgängliga från projekt-, användar- och inbyggda källor. Renderar en tabell med namn, källa, värdversion, tilläggspaket och status.

func profile list [<PATH>] [options]
Alternativ beskrivning
--source Kommaseparerad lista över källor som inkluderar: project, user, built-in. Använder alla källor som standard.
--json Generera maskinläsbar JSON istället för en tabell.

func profile show

Visar detaljer för en enskild profil, antingen upplöst (med ärvda värden applicerade) eller råa (definition som skriven, utan arvsexpansion).

func profile show <NAME> [<PATH>] [options]
Alternativ beskrivning
--raw Visa den råa profildefinitionen utan ärvda värden.

func profile set

Sätter standardprofilen för ett Functions-projekt genom att skriva profilnamnet i projektets .func/config.json. Om profilen inte redan finns i projektets profillista, lägg till den.

func profile set <NAME> [<PATH>]

func setup

Förbereder den lokala maskinen för att köra Azure Functions-projekt. Installerar eller verifierar värdens runtime, språkarbetare, tilläggspaket och mallar för de stackar du specificerar. Stöder profilbaserade versionsbegränsningar, prerelease-val, icke-interaktivt CI-läge och kontroll-only-läge.

func setup [<PATH>] [options]

--features Väljer vad som ska installeras eller verifieras. Funktionerna och arbetsbelastningarna som varje enhet löser är:

Feature Installerade arbetsbelastningar
node host, bundles, node, , , node-workernode-templates
python host, bundles, python, , , python-workerpython-templates
go host, bundles, , gogo-worker
dotnet host, , dotnetdotnet-templates
runtime host, bundles
host host bara

--features är upprepbar och accepterar kommaseparerade värden, så du kan kombinera funktioner i ett enda anrop (till exempel, func setup --features node,python). dotnet-isolated accepteras som alias för dotnet.

Alternativ beskrivning
--features Komponenter att installera eller verifiera. Upprepningsbar eller komma-separerad. Se tabellen ovan för de arbetsbelastningar varje funktion installerar.
--profile Azure Functions-profil att använda för versionsbegränsningar. Repeterbar. Sammanslagen med --profiles.
--profiles Kommaseparerad lista över Azure Functions-profiler att använda för versionsbegränsningar.
--install-policy Installationspolicy: latest-compatible (standard) eller if-needed.
--source NuGet-paketkälla att använda för arbetsbelastningslösning och installation.
--prerelease Tillåt förhandsversioner av arbetsbelastning när du löser från katalogen. Standard: aktiverat medan arbetsbelastningar är i förhandsvisning.
--non-interactive Be inte om input.
--yes, -y Svara ja på installationsfrågor.
--check Verifiera om de valda beroendena är installerade, utan att göra ändringar.
--output Utgångsläge: plain (standard) eller json (NDJSON).

func workload

Hanterar arbetsbelastningar installerade för Azure Functions CLI.

func workload <subcommand>

Underkommandon:

Subcommand beskrivning
func workload list Lista installerade arbetsbelastningar.
func workload search Sök i arbetsbelastningskatalogen.
func workload install Installera en arbetsbelastning.
func workload update Uppdatera en installerad arbetsbelastning på plats.
func workload uninstall Avinstallera en arbetsbelastning.
func workload prune Ta bort inaktiva installationer sida vid sida.

func workload list

Visar en lista över installerade arbetsbelastningar. Som standard visar kommandot endast den laddade versionen (högst installerade semver) av varje arbetsbelastning. Jag brukade --all-versions se varje sida vid sida-installation.

func workload list [options]
Alternativ beskrivning
--all-versions, -a Lista varje installerad version av varje arbetsbelastning. Standard: endast laddad version.
--json Generera maskinläsbar JSON istället för en tabell.

Söker i den konfigurerade arbetsbelastningskatalogen efter tillgängliga arbetsbelastningspaket.

func workload search [<QUERY>] [options]

När du utelämnar <QUERY>, listar kommandot alla arbetsbelastningar i katalogen.

Alternativ beskrivning
--source Katalogkäll-URL för att söka i. Standardinställningen är den konfigurerade katalogen.
--prerelease Inkludera förhandsversioner i resultaten. Standard: aktiverat medan arbetsbelastningar är i förhandsvisning.
--json Generera maskinläsbar JSON istället för en tabell.

func workload install

Löser ett arbetsbelastningspaket-ID (eller alias) genom den konfigurerade katalogen och installerar det.

func workload install <ID> [options]

<ID> kan vara ett arbetsbelastningspaket-ID, ett alias (till exempel python), eller en väg till en lokal arbetsbelastningspaketfil.

Alternativ beskrivning
--version, -v Specifik version att installera. Standard: den senaste stabila versionen i katalogen.
--source Katalogkäll-URL eller lokal katalog för att lösa från. Standard: den konfigurerade katalogen.
--prerelease Tillåt förhandsversioner när du löser från katalogen. Standard: aktiverat medan arbetsbelastningar är i förhandsvisning.
--force, -f Skriv över en befintlig installation med samma ID och version. Hoppar också över "använd uppdatera istället"-prompten.
--exact, -e Inaktivera aliasmatchning. <ID> måste vara det bokstavliga paket-ID:t.

Om en version av arbetsbelastningen redan är installerad, uppmanar CLI:n dig att använda func workload update istället. Icke-interaktiva kontexter behandlar prompten som en nedgång.

func workload update

Utför en atomär versionsbyte på plats för en installerad arbetsbelastning. Uppdateringar är inte sida vid sida; För sid-vid-sida-installationer använd func workload install --force.

func workload update [<ID>] [options]

Pass an <ID> för att uppdatera en enskild arbetsbelastning, eller --all för att uppdatera varje installerad arbetsbelastning. Specificera exakt ett av dessa två alternativ.

Alternativ beskrivning
--version, -v Installerad version för att byta ut. Standard: den högst installerade versionen.
--all Uppdatera varje installerad arbetsbelastning. Ömsesidigt uteslutande med <ID>.
--major Tillåt att man korsar en huvudlinje. Standard: bara samma huvudämne.
--source Katalogkäll-URL eller lokal katalog för att lösa från. Standard: den konfigurerade katalogen.
--prerelease Tillåt förhandsversioner när du löser från katalogen. Standard: aktiverat medan arbetsbelastningar är i förhandsvisning.
--exact, -e Inaktivera aliasmatchning. <ID> måste vara det bokstavliga paket-ID:t.

func workload uninstall

Tar bort en eller alla installerade versioner av en arbetsbelastning.

func workload uninstall <ID> [options]
Alternativ beskrivning
--version, -v Specifik version att avinstallera. Standard: den enda installerade versionen.
--all-versions, -a Avinstallera alla installerade versioner av arbetsbelastningen. Ömsesidigt uteslutande med --version.
--exact, -e Inaktivera aliasmatchning. <ID> måste vara det bokstavliga paket-ID:t.

func workload prune

Tar bort inaktiva sid-vid-sida-installationer av arbetsbelastning. För varje paket-ID i scope behåller kommandot den högst installerade versionen och avinstallerar äldre versioner. Detta kommando är endast lokalt och rör aldrig katalogen.

func workload prune [<ID>] [options]

När du utelämnar <ID>, beskär kommandot varje installerad arbetsbelastning.

Alternativ beskrivning
--exact, -e Inaktivera aliasmatchning. <ID> måste vara det bokstavliga paket-ID:t.

func azure functionapp

Kontexten func azure functionapp innehåller följande kommandon:

Alla func azure functionapp kommandon har stöd för följande alternativ:

Alternativ beskrivning
--slot Riktar in sig på ett specifikt namngivet distributionsfack, om det är konfigurerat.
--access-token Tillhandahåller en annan åtkomsttoken än standardtoken som ska användas för att utföra autentiserade åtgärder i Azure.
--access-token-stdin Läser en specifik åtkomsttoken från standardindata. Använd det här alternativet när du läser token direkt från ett tidigare kommando som az account get-access-token.
--management-url Anger hanterings-URL:en för det Azure molnet, som standard är https://management.azure.com. Använd det här alternativet när funktionsappen körs i ett nationellt moln.
--subscription Anger standardprenumerationen Azure.

func azure functionapp fetch-app-settings

Hämtar inställningar från en specifik funktionsapp.

func azure functionapp fetch-app-settings <APP_NAME>

Mer information finns i Ladda ned programinställningar.

Kommandot laddar ner inställningar till local.settings.json-filen för projektet. Värden på skärmen är maskerade för säkerhet. Du kan skydda inställningarna i local.settings.json-filen genom att aktivera lokal kryptering.

func azure functionapp list-functions

Visar en lista över funktionerna i den angivna funktionsappen.

func azure functionapp list-functions <APP_NAME>

Kommandot func azure functionapp list-functions stöder det här alternativet:

Alternativ beskrivning
--show-keys Inkludera åtkomstnyckelvärden på funktionsnivå i de returnerade funktionsslutpunkts-URL:erna.

func azure functionapp logstream

Ansluter den lokala kommandotolken till strömmande loggar för funktionsappen i Azure.

func azure functionapp logstream <APP_NAME>

Standardtimeouten för anslutningen är 2 timmar. Ändra tidsgränsen genom att lägga till en appinställning med namnet SCM_LOGSTREAM_TIMEOUT med ett timeout-värde i sekunder. Stöds ännu inte för Linux i en flexförbruknings - eller förbrukningsplan . För de här apparna använder du alternativet --browser för att visa loggar i portalen.

Kommandot func azure functionapp logstream stöder det här alternativet:

Alternativ beskrivning
--browser Öppna Azure Application Insights Live Stream för funktionsappen i standardwebbläsaren.

Mer information finns i Aktivera körningsloggar för direktuppspelning i Azure Functions.

func azure functionapp publish

Distribuerar ett Functions-projekt till en befintlig funktionsappresurs i Azure.

func azure functionapp publish <APP_NAME>

Mer information finns i Distribuera projektfiler.

Följande publiceringsalternativ gäller baserat på version:

Alternativ beskrivning
--additional-packages Lista över paket som ska installeras när inbyggda beroenden skapas. Till exempel: python3-dev libevent-dev.
--build, -b Utför en byggåtgärd när du distribuerar till en Linux-funktionsapp. Accepterar: remote och local.
--build-native-deps Hoppar över att generera mappen .wheels när du publicerar Python funktionsappar.
--csx Publicera ett C#-skriptprojekt (.csx).
--dotnet-cli-params När du publicerar kompilerade C#-funktioner (.csproj) anropar dotnet build --output bin/publishkärnverktygen . Alla parametrar som skickas till det här alternativet läggs till på kommandoraden.
--dotnet-version För dotnet-isolated-program anger du målversionen .NET (till exempel 8.0).
--force Ignorerar förberedelseverifiering i vissa scenarier.
--list-ignored-files Visar en lista över filer som ignoreras under publiceringen, baserat på .funcignore-filen .
--list-included-files Visar en lista över filer som publiceras, som baseras på .funcignore-filen .
--no-build Project skapas inte under publiceringen. För Python körs inte pip install.
--nozip Inaktiverar standardläget Run-From-Package . Extraherar filer till wwwroot mappen på servern i stället för att köra dem direkt från distributionspaketet.
--overwrite-settings, -y Undertrycker uppmaningen att skriva över appinställningar när du använder --publish-local-settings -i.
--publish-local-settings, -i Publicerar inställningar i local.settings.json till Azure och uppmanar till att skriva över om inställningen redan finns. Om du använder en lokal lagringsemulator ändrar du först appinställningen till en faktisk lagringsanslutning.
--publish-settings-only, -o Publicerar endast inställningar och hoppar över innehållet. Standardinställningen är prompt.
--show-keys Lägger till funktionsnycklar till url:erna som visas i loggarna.

func azure storage fetch-connection-string

Hämtar reťazec pripojenia för det angivna Azure Storage kontot.

func azure storage fetch-connection-string <STORAGE_ACCOUNT_NAME>

Mer information finns i ladda ned en lagring reťazec pripojenia.

func azurecontainerapps deploy

Distribuerar en containerbaserad funktionsapp till en Azure Container Apps miljö. Standardvärdens lagringskonto, funktionsappen och miljön måste redan existera. Mer information finns i Azure Container Apps värd för 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>

Följande distributionsalternativ gäller:

Alternativ beskrivning
--environment Namnet på en befintlig Container Apps-miljö.
--image-build Ange till för att true hoppa över den lokala Docker-versionen.
--image-name Namnet på en befintlig containeravbildning i ett containerregister, inklusive taggnamnet.
--location Region för distributionen. Helst är den här regionen samma som miljö- och lagringskontoresurserna.
--name Namnet som används för funktionsappdistributionen i Container Apps-miljön. Det här namnet visas också när du hanterar funktionsappen i portalen. Namnet måste vara unikt i miljön.
--registry När den har angetts körs en Docker-version och avbildningen skickas till registret som anges i --registry. Du kan inte använda --registry med --image-name. För Docker Hub använder du även --registry-username.
--registry-password Lösenordet eller token som används för att hämta avbildningen från ett privat register.
--registry-username Användarnamnet som används för att hämta avbildningen från ett privat register.
--resource-group Den resursgrupp där de funktionsrelaterade resurserna ska skapas.
--storage-account Connection string för lagringskontot som ska användas av funktionsappen.
--worker-runtime Anger körningsspråket för funktionsappen. Den här parametern används endast med --image-name och --image-build. Annars bestäms språket under den lokala versionen. Värden som stöds är: dotnet, dotnetIsolated, node, python, powershelloch custom (för anpassade hanterare).

Viktigt!

Lagring anslutningssträng och andra autentiseringsuppgifter för tjänsten är viktiga hemligheter. Lagra alla skriptfiler som använder func azurecontainerapps deploy och inte lagrar dem i någon offentligt tillgänglig källkontroll på ett säkert sätt.

func deploy

Kommandot func deploy är inaktuellt. Använd func kubernetes deployi stället .

func bundles add

Lägger till tilläggspaketkonfiguration i host.json-filen .

func bundles add

Kommandot func bundles add stöder följande alternativ:

Alternativ beskrivning
--force, -f Skriver över befintlig tilläggspaketkonfiguration om den finns.
--channel, -c Versionskanal för tilläggspaket. Värden som stöds är: GA (standard), Previewoch Experimental.

func bundles download

Laddar ned tilläggspaketet som har konfigurerats i host.json.

func bundles download

Kommandot func bundles download stöder följande alternativ:

Alternativ beskrivning
--force, -f Tvingar fram en ny nedladdning av tilläggspaketet även om det redan finns.

func bundles list

Listar nedladdade tilläggspaket.

func bundles list

func bundles path

Hämtar sökvägen till det nedladdade tilläggspaketet.

func bundles path

func durable delete-task-hub

Tar bort alla lagringsartefakter i Durable Functions aktivitetshubben.

func durable delete-task-hub

Kommandot func durable delete-task-hub stöder följande alternativ:

Alternativ beskrivning
--connection-string-setting Namnet på den inställning som innehåller lagringen reťazec pripojenia att använda.
--task-hub-name Namnet på den durable-aktivitetshubb som ska användas.

Mer information finns i dokumentationen Durable Functions.

func durable get-history

Returnerar historiken för en angiven orkestreringsinstans.

func durable get-history --id <INSTANCE_ID>

Kommandot func durable get-history stöder följande alternativ:

Alternativ beskrivning
--id ID för en orkestreringsinstans. (Obligatoriskt)
--connection-string-setting Namnet på den inställning som har den lagring reťazec pripojenia att använda.
--task-hub-name Namnet på den durable-aktivitetshubb som ska användas.

Mer information finns i dokumentationen Durable Functions.

func durable get-instances

Returnerar status för alla orkestreringsinstanser. Detta kommando stödjer sidsökning genom att använda parametern top .

func durable get-instances

Kommandot func durable get-instances stöder följande alternativ:

Alternativ beskrivning
--continuation-token Token som anger en specifik sida eller ett visst avsnitt av begäranden som ska returneras.
--connection-string-setting Namnet på appinställningen som innehåller lagringsinställningen reťazec pripojenia att använda.
--created-after Hämta de instanser som skapats efter detta datum och tid (UTC). Alla ISO 8601-formaterade datetimes godkänns.
--created-before Hämta de instanser som skapats före ett visst datum och en viss tid (UTC). Alla ISO 8601-formaterade datetimes godkänns.
--runtime-status Hämta de instanser vars status matchar en specifik status, inklusive running, completedoch failed. Du kan ange en eller flera blankstegsavgränsade statusar.
--top Begränsa antalet poster som returneras i en viss begäran.
--task-hub-name Namnet på den Durable Functions aktivitetshubben som ska användas.

Mer information finns i Durable Functions dokumentation.

func durable get-runtime-status

Returnerar status för en angiven orkestreringsinstans.

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

Kommandot func durable get-runtime-status stöder följande alternativ:

Alternativ beskrivning
--connection-string-setting Namnet på den inställning som innehåller lagringen reťazec pripojenia att använda.
--id ID för en orkestreringsinstans. (Obligatoriskt)
--show-input När svaret har angetts innehåller det indata för funktionen.
--show-output När svaret anges innehåller det körningshistoriken.
--task-hub-name Namnet på den Durable Functions aktivitetshubben som ska användas.

Mer information finns i Durable Functions dokumentation.

func durable purge-history

Rensar orkestreringsinstanstillstånd, historik och bloblagring för orkestreringar som är äldre än det angivna tröskelvärdet.

func durable purge-history

Kommandot func durable purge-history stöder följande alternativ:

Alternativ beskrivning
--connection-string-setting Namnet på den inställning som innehåller lagringen reťazec pripojenia att använda.
--created-after Ta bort historiken för instanser som skapats efter detta datum/tid (UTC). Alla ISO 8601-formaterade datetime-värden accepteras.
--created-before Ta bort historiken för instanser som skapats före detta datum/tid (UTC). Alla ISO 8601-formaterade datetime-värden accepteras.
--runtime-status Ta bort historiken för instanser vars status matchar en specifik status, inklusive completed, terminated, canceledoch failed. Ange en eller flera blankstegsavgränsade statusar. Om du inte inkluderar --runtime-statustas instanshistoriken bort oavsett status.
--task-hub-name Namnet på den Durable Functions aktivitetshubben som ska användas.

Mer information finns i dokumentationen Durable Functions.

func durable raise-event

Genererar en händelse till den angivna orkestreringsinstansen.

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

Kommandot func durable raise-event stöder följande alternativ:

Alternativ beskrivning
--connection-string-setting Namnet på den inställning som innehåller lagringen reťazec pripojenia att använda.
--event-data Data som ska skickas till händelsen, antingen infogade eller från en JSON-fil. För filer prefixar du sökvägen till filen med ett vidtecken (@), till exempel @path/to/file.json. (Obligatoriskt)
--event-name Namnet på den händelse som ska genereras. (Obligatoriskt)
--id ID för en orkestreringsinstans. (Obligatoriskt)
--task-hub-name Namnet på den Durable Functions aktivitetshubben som ska användas.

Mer information finns i Durable Functions dokumentation.

func durable rewind

Spolar tillbaka den angivna orkestreringsinstansen.

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

Kommandot func durable rewind stöder följande alternativ:

Alternativ beskrivning
--connection-string-setting Namnet på den inställning som innehåller lagringen reťazec pripojenia att använda.
--id ID för en orkestreringsinstans. (Obligatoriskt)
--reason Orsak till att orkestreringen spolas tillbaka. (Obligatoriskt)
--task-hub-name Namnet på den Durable Functions aktivitetshubben som ska användas.

Mer information finns i Durable Functions dokumentation.

func durable start-new

Startar en ny instans av den angivna orchestrator-funktionen.

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

Kommandot func durable start-new stöder följande alternativ:

Alternativ beskrivning
--connection-string-setting Namnet på den inställning som innehåller lagringen reťazec pripojenia att använda.
--function-name Namnet på orkestreringsfunktionen som ska startas. (Obligatoriskt)
--id Anger ID för en orkestreringsinstans. (Obligatoriskt)
--input Indata till orchestrator-funktionen, antingen infogad eller från en JSON-fil. För filer prefixar du sökvägen till filen med ett et-tecken (@), till exempel @path/to/file.json. (Obligatoriskt)
--task-hub-name Namnet på den Durable Functions aktivitetshubben som ska användas.

Mer information finns i Durable Functions dokumentation.

func durable terminate

Avslutar den angivna orkestreringsinstansen.

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

Kommandot func durable terminate stöder följande alternativ:

Alternativ beskrivning
--connection-string-setting Namnet på den inställning som innehåller lagringen reťazec pripojenia att använda.
--id Anger ID för en orkestreringsinstans. (Obligatoriskt)
--reason Anledning till att avsluta orkestreringen. (Obligatoriskt)
--task-hub-name Namnet på den Durable Functions aktivitetshubben som ska användas.

Mer information finns i dokumentationen Durable Functions.

func extensions install

Installerar Functions-tillägg manuellt i ett icke-.NET projekt eller ett C#-skriptprojekt.

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

Kommandot func extensions install stöder följande alternativ:

Alternativ beskrivning
--configPath, -c Sökväg till katalogen som innehåller filen extensions.csproj.
--csx Stöd för C#-skriptprojekt (.csx).
--force, -f Uppdatera versionerna av befintliga tillägg.
--output, -o Utdatasökväg för tilläggen.
--package, -p Identifierare för ett specifikt tilläggspaket. När de inte anges installeras alla refererade tillägg, som med func extensions sync.
--source, -s NuGet-feedkälla när du inte använder NuGet.org.
--version, -v Tilläggspaketversion.

I följande exempel installeras version 5.0.1 av Event Hubs-tillägget i det lokala projektet:

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

Dessa överväganden gäller när du använder func extensions install:

  • För kompilerade C#-projekt (både pågående och isolerade arbetsprocesser) använder du standardinstallationsmetoder för NuGet-paket i stället, till exempel dotnet add package.

  • Om du vill installera tillägg manuellt med core tools måste du ha .NET SDK installerat.

  • När det är möjligt bör du i stället använda tilläggspaket. Här följer några orsaker till varför du kan behöva installera tillägg manuellt:

    • Du måste komma åt en specifik version av ett tillägg som inte är tillgängligt i ett paket.
    • Du måste komma åt ett anpassat tillägg som inte är tillgängligt i ett paket.
    • Du måste komma åt en specifik kombination av tillägg som inte är tillgängliga i ett enda paket.

  • Innan du kan installera tillägg manuellt måste du först ta bort extensionBundle objektet från denhost.json fil som definierar paketet. Ingen åtgärd vidtas när ett tilläggspaket redan har angetts i dinhost.json-fil .

  • Första gången du uttryckligen installerar ett tillägg läggs en .NET projektfil med namnet extensions.csproj till i roten för ditt appprojekt. Den här filen definierar den uppsättning NuGet-paket som krävs av dina funktioner. Du kan arbeta med NuGet-paketreferenserna i den här filen, men med Core Tools kan du installera tillägg utan att behöva redigera C#-projektfilen manuellt.

func extensions sync

Installerar alla tillägg som krävs av din funktionsapp.

Kommandot func extensions sync stöder följande alternativ:

Alternativ beskrivning
--configPath, -c Sökvägen till katalogen som innehåller extensions.csproj filen.
--csx Stöder C#-skriptprojekt (.csx).
--output, -o Utdatasökväg för tilläggen.

Återställer en saknad extensions.csproj fil. Tar ingen åtgärd när ett tilläggspaket definieras i din host.json fil.

func kubernetes deploy

Distribuerar ett Functions-projekt som en anpassad Docker-container till ett Kubernetes-kluster.

func kubernetes deploy

Det här kommandot skapar projektet som en anpassad container och publicerar det till ett Kubernetes-kluster. Anpassade containrar måste ha en Dockerfile. Om du vill skapa en app med en Dockerfile använder du --docker alternativet med func init kommandot .

Kommandot func kubernetes deploy stöder följande alternativ:

Alternativ beskrivning
--dry-run Visar distributionsmallen utan körning.
--config-map-name Namnet på en befintlig konfigurationskarta med funktionsappinställningar som ska användas i distributionen. Kräver --use-config-map. Standardbeteendet är att skapa inställningar baserat på Values objektet i local.settings.json-filen .
--cooldown-period Nedkylningsperioden (i sekunder) när alla utlösare inte längre är aktiva innan distributionen skalar ned till noll, med standardvärdet 300 s.
--ignore-errors Fortsätt distributionen när en resurs returnerar ett fel. Standardbeteendet är att stoppa vid fel.
--image-name Namnet på avbildningen som ska användas för podddistributionen och från vilken du kan läsa funktioner.
--keda-version Ange vilken version av KEDA som ska installeras. Giltiga alternativ är: v1 och v2 (standard).
--keys-secret-name Namnet på en Kubernetes Secrets-samling som ska användas för att lagra åtkomstnycklar.
--max-replicas Ange maximalt antal repliker som HPA skalar (Horizontal Pod Autoscaler).
--min-replicas Ange det minsta antalet repliker under vilket HPA inte skalar.
--mount-funckeys-as-containervolume Montera åtkomstnycklarna som en containervolym.
--name Namnet som används för distributionen och andra artefakter i Kubernetes.
--namespace Ange kubernetes-namnområdet som ska distribueras till. Standardvärdet är standardnamnområdet.
--no-docker Läs funktioner från den aktuella katalogen i stället för från en bild. Kräver montering av bildfilsystemet.
--registry När den har angetts körs en Docker-version och avbildningen skickas till ett register med det namnet. Du kan inte använda --registry med --image-name. Använd ditt användarnamn för Docker.
--polling-interval Avsökningsintervallet (i sekunder) för att kontrollera icke-HTTP-utlösare med standardvärdet 30s.
--pull-secret Hemligheten som används för att komma åt autentiseringsuppgifter för privata register.
--secret-name Namnet på en befintlig Kubernetes Secrets-samling som har funktionsappinställningar som ska användas i distributionen. Standardbeteendet är att skapa inställningar baserat på Values objektet i local.settings.json-filen .
--show-service-fqdn Visa URL:er för HTTP-utlösare med Kubernetes FQDN i stället för standardbeteendet för att använda en IP-adress.
--service-type Ange typen av Kubernetes Service. Värden som stöds är: ClusterIP, NodePortoch LoadBalancer (standard).
--use-config-map Använd ett ConfigMap objekt (v1) i stället för ett Secret objekt (v1) för att konfigurera inställningar för funktionsappen. Kartnamnet anges med hjälp av --config-map-name.
--use-git-hash-version Använd Git-hashen som version för containeravbildningen.
--write-configs Mata ut Kubernetes-konfigurationerna som YAML-filer i stället för att distribuera.
--config-file Utdatafilsökväg när du använder --write-configs. Standard: functions.yaml.
--hash-files Filer till hash för att fastställa avbildningsversionen.
--image-build När värdet är inställt falsepå hoppar du över Docker-versionen.
--key-secret-annotations Anteckningar som ska läggas till i nyckelhemligheten, i key1=val1,key2=val2 format.

Core Tools använder det lokala Docker CLI för att skapa och publicera avbildningen. Kontrollera att Docker redan är installerat lokalt. docker login Kör kommandot för att ansluta till ditt konto.

Azure Functions har stöd för värdtjänster för dina containerbaserade funktioner i Azure Container Apps eller i Azure Functions. Azure Functions stöder inte officiellt körning av containrar direkt i ett Kubernetes-kluster eller i Azure Kubernetes Service (AKS). Mer information finns i Linux-containerstöd i Azure Functions.

func kubernetes delete

Tar bort en Functions-distribution från ett Kubernetes-kluster.

func kubernetes delete --name <APP_NAME>

Kommandot func kubernetes delete stöder följande alternativ:

Alternativ beskrivning
--name Namnet på distributionen och andra artefakter i Kubernetes. (Obligatoriskt)
--namespace Ange Kubernetes-namnområdet. Standardvärdet är default namnområdet.
--registry Namnet på containerregistret.
--image-name Avbildningen som ska användas för podddistributionen.
--keda-version Ange versionen av KEDA. Giltiga alternativ är v1 och v2 (standard).

func kubernetes install

Installerar KEDA i ett Kubernetes-kluster

func kubernetes install

Installerar KEDA till klustret som definierats i kubectl-konfigurationsfilen.

Kommandot func kubernetes install stöder följande alternativ:

Alternativ beskrivning
--dry-run Visar distributionsmallen utan körning.
--keda-version Anger vilken version av KEDA som ska installeras. Giltiga alternativ är: v1 och v2 (standard).
--namespace Installerar till ett specifikt Kubernetes-namnområde. När den inte har angetts används standardnamnområdet.

Mer information finns i Hantera KEDA och funktioner i Kubernetes.

func kubernetes remove

Tar bort KEDA från Kubernetes-klustret som definierats i konfigurationsfilen kubectl .

func kubernetes remove

Tar bort KEDA från klustret som definierats i konfigurationsfilen kubectl .

Kommandot func kubernetes remove stöder det här alternativet:

Alternativ beskrivning
--namespace Avinstallerar från ett specifikt Kubernetes-namnområde. När den inte har angetts används standardnamnområdet.

Mer information finns i Avinstallera KEDA från Kubernetes.

func settings add

Lägger till en ny inställning i Values samlingen i filen local.settings.json.

func settings add <SETTING_NAME> <VALUE>

Ersätt <SETTING_NAME> med namnet på appinställningen.

Kommandot func settings add stöder det här alternativet:

Alternativ beskrivning
--connectionString Lägger till namn/värde-paret i ConnectionStrings samlingen i stället för samlingen Values . ConnectionStrings Använd samlingen endast när vissa ramverk kräver den. Mer information finns ilocal.settings.json fil.

func settings decrypt

Dekrypterar krypterade värden i Values samlingen i local.settings.json-filen .

func settings decrypt

Det här kommandot dekrypterar också reťazec pripojenia värden i samlingen ConnectionStrings. I local.settings.json, sätter IsEncrypted kommandot till false. Kryptera lokala inställningar för att minska risken att känslig information exponeras från local.settings.json. I Azure lagras programinställningarna alltid krypterade.

func settings delete

Tar bort en befintlig inställning från Values samlingen i local.settings.json-filen.

func settings delete <SETTING_NAME>

Ersätt <SETTING_NAME> med namnet på appinställningen och <VALUE> med värdet för inställningen.

Kommandot func settings delete stöder det här alternativet:

Alternativ beskrivning
--connectionString Tar bort namn/värde-paret från ConnectionStrings samlingen i stället för Values samlingen.

func settings encrypt

Krypterar värdena för enskilda objekt i Values samlingen i local.settings.json-filen.

func settings encrypt

Kommandot krypterar även anslutningssträngsvärden i ConnectionStrings samlingen. I local.settings.json, sätter IsEncrypted kommandot till true, vilket specificerar att den lokala runtimen dekrypterar inställningar innan de används. Kryptera lokala inställningar för att minska risken att känslig information exponeras från local.settings.json. I Azure lagras programinställningarna alltid som krypterade.

func settings list

Visar en lista med inställningar i Values samlingen i local.settings.json-filen.

func settings list

Utdata innehåller även anslutningssträngar från ConnectionStrings samlingen. Som standard maskerar kommandot värden för säkerhetens skull. Använd alternativet --showValue för att visa det faktiska värdet.

Kommandot func settings list stöder det här alternativet:

Alternativ beskrivning
--showValue, -a Visa de faktiska avmaskerade värdena i utdata.

func templates list

Visar en lista över tillgängliga funktionsmallar (utlösare).

Kommandot func templates list stöder det här alternativet:

Alternativ beskrivning
--language, -l Språk som du vill filtrera returnerade mallar för. Returnerar alla språk som standard.

Globala alternativ

De flesta Core Tools-kommandon stöder dessa alternativ:

Alternativ beskrivning
--script-root Anger funktionsappens rotkatalog och ändrar arbetskatalogen för kommandot.
--verbose Aktiverar utförliga utdata för detaljerad loggning. Alla kommandon stöder inte detta alternativ.
--offline Körs i offlineläge utan att göra externa nätverksanrop. , func startfunc init, och func new kommandona stöder detta alternativ. Du kan också ställa in det via miljövariabeln FUNCTIONS_CORE_TOOLS_OFFLINE .
--version, -v Visar versionen av Azure Functions Core Tools.
--help, -h Visar hjälpinformation.
--pause-on-error Pausar för ytterligare indata innan processen avslutas. Detta alternativ är användbart när du startar Core Tools från en integrerad utvecklingsmiljö (IDE).

De flesta kommandon stöder dessa alternativ:

Alternativ beskrivning
--help, -h Visa hjälp för kommandot.
--version Display the Azure Functions CLI-version. Använd --verbose tillsammans --version för detaljerad bygginformation.
--verbose Aktivera utförliga utdata. Propagerar till alla underkommandon. När den skickas vid roten utan underkommando skriver den ut detaljerad information om byggnation, körtid, operativsystem och arkitektur.

Tillgängliga arbetsbelastningar

Spring func workload search för att se den aktuella katalogen. Följande arbetsbelastningar finns för närvarande tillgängliga:

Name beskrivning
host Den Azure Functions värdens runtime används av func run.
bundles Installera tilläggspaket som aktiverar alla bindningstillägg. Använd denna arbetsbelastning för vilken stack som helst som inte är .NET. .NET-projekt använder inte denna arbetsbelastning. Istället refererar de direkt till tillägg i sina projekt.
dotnet Azure Functions CLI-verktyg för .NET (C#, F#)-projekt. Bidrar också med mallar för func quickstart. .NET kräver inte en separat arbetsbelastning, eftersom arbetaren är en del av det kompilerade projektet självt.
dotnet-templates Funktions-schafott-mallar för .NET isolerade arbetsprojekt.
python Azure Functions CLI-verktyg för Python-projekt. Bidrar också med mallar för func quickstart.
python-worker Python-språkarbetaren som används av Functions-värden.
python-templates Funktions-schafott-mallar för Python (v1 och v2 programmeringsmodeller).
node Azure Functions CLI-verktyg för Node.js projekt (JavaScript, TypeScript). Bidrar också med mallar för func quickstart.
node-worker Den Node.js språkarbetaren som används av Functions-värden.
node-templates Funktions-sacfitt-mallar för Node.js (JavaScript, TypeScript).
go Azure Functions CLI-verktyg för Go-projekt. Bidrar också med mallar för func quickstart.
go-worker Go-språkarbetaren som används av Functions-värden.

Kommentar

Alla Functions-språkstackar finns inte tillgängliga som arbetsbelastningar för tillfället. Java- och PowerShell-stackar stöds för närvarande inte i Azure Functions CLI.

  • Last updated on