Referens för Azure Functions Core Tools
Den här artikeln innehåller referensdokumentation för Azure Functions Core Tools, där du kan utveckla, hantera och distribuera Azure Functions-projekt från din lokala dator. Mer information om hur du använder Core Tools finns i Arbeta med 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 som används 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 |
Distribuera en containerbaserad funktionsapp till Azure Container Apps. |
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. |
Innan du använder kommandona i den här artikeln måste du installera Core Tools.
func init
Skapar ett nytt Functions-projekt på ett visst språk.
func init <PROJECT_FOLDER>
När du anger <PROJECT_FOLDER>
skapas projektet i en ny mapp med det här namnet. Annars används den aktuella mappen.
func init
stöder följande alternativ, som inte stöder version 1.x om inget annat anges:
Alternativ | Description |
---|---|
--csx |
Skapar .NET-funktioner som C#-skript, vilket är version 1.x-beteendet. Endast giltigt med --worker-runtime dotnet . |
--docker |
Skapar en Dockerfile för en container med en basavbildning som baseras 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 |
Initiera 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 |
Initierar ett språkspecifikt projekt. Stöds för närvarande när --worker-runtime det ä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 stöder endast PowerShell-arbetskörningen den här funktionen. |
--model |
Anger önskad programmeringsmodell för ett målspråk när mer än en modell är tillgänglig. Alternativ som stöds är V1 och V2 för Python och V3 för V4 Node.js. Mer information finns i utvecklarguiden för Python och Node.js utvecklarguiden. |
--source-control |
Styr om en git-lagringsplats skapas. Som standard skapas inte en lagringsplats. När true skapas 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 , python och 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: net9.0 (förhandsversion), net8.0 (standard), net6.0 och net48 (.NET Framework 4.8). |
Kommentar
När du använder antingen --docker
eller --docker-only
alternativ skapar Core Tools automatiskt Funktionerna Dockerfile för C#, JavaScript, Python och PowerShell. För Java-funktioner måste du manuellt skapa Dockerfile. Mer information finns i Skapa containerbaserade funktionsappar.
func logs
Hämtar loggar för funktioner som körs i ett Kubernetes-kluster.
func logs --platform kubernetes --name <APP_NAME>
Åtgärden func logs
stöder följande alternativ:
Alternativ | Description |
---|---|
--platform |
Värdplattform för funktionsappen. Alternativ som stöds: kubernetes . |
--name |
Funktionsappens namn i Azure. |
Mer information finns i Azure Functions på Kubernetes med KEDA.
func new
Skapar en ny funktion i det aktuella projektet baserat på en mall.
func new
När du kör func new
utan --template
alternativet uppmanas du att välja en mall. I version 1.x måste du också välja språk.
Åtgärden func new
stöder följande alternativ:
Alternativ | Description |
---|---|
--authlevel |
Gör att du kan ange 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 |
(Version 2.x och senare versioner.) Genererar samma C#-skriptmallar (.csx) som används i version 1.x och i portalen. |
--language , -l |
Programmeringsspråket för mallar, till exempel C#, F# eller JavaScript. Det här alternativet krävs i version 1.x. I version 2.x och senare versioner använder du inte det här alternativet eftersom språket definieras av arbetskörningen. |
--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 run
Endast version 1.x.
Gör att du kan anropa en funktion direkt, vilket liknar att köra en funktion med hjälp av fliken Test i Azure Portal. Den här åtgärden stöds endast i version 1.x. För senare versioner använder func start
och anropar du funktionsslutpunkten direkt.
func run
Åtgärden func run
stöder följande alternativ:
Alternativ | Description |
---|---|
--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 följande kommando:
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
func start
stöder följande alternativ:
Alternativ | Description |
---|---|
--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åt autentiserade begäranden mellan ursprung med hjälp av cookies och autentiseringshuvudet. |
--dotnet-isolated-debug |
När det är inställt 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 |
Aktivera en fullständig pipeline för autentiseringshantering med auktoriseringskrav. |
--functions |
En blankstegsavgränsad lista över funktioner som ska läsas in. |
--language-worker |
Argument för att konfigurera språkarbetaren. Du kan till exempel aktivera felsökning för språkarbetare genom att tillhandahålla felsökningsport och andra obligatoriska argument. |
--no-build |
Skapa inte det aktuella projektet innan du kör det. Endast för .NET-klassprojekt. Standardvärdet ä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 |
Den lokala porten att lyssna på. Standardvärde: 7071. |
--timeout |
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. |
När projektet körs kan du verifiera enskilda funktionsslutpunkter.
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.
Inställningarna laddas ned 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 filen local.settings.json genom att aktivera lokal kryptering.
func azure functionapp list-functions
Returnerar en lista över funktionerna i den angivna funktionsappen.
func azure functionapp list-functions <APP_NAME>
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. Du kan ä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-appar i förbrukningsplanen. För de här apparna använder du alternativet --browser
för att visa loggar i portalen.
Åtgärden deploy
stöder följande alternativ:
Alternativ | Description |
---|---|
--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 | Description |
---|---|
--access-token |
Gör att du kan använda en specifik åtkomsttoken när du utför autentiserade azure åtgärder. |
--access-token-stdin |
Läser en specifik åtkomsttoken från en standardinmatning. Använd detta när du läser token direkt från ett tidigare kommando, till exempel az account get-access-token . |
--additional-packages |
Lista över paket som ska installeras när inbyggda beroenden skapas. Exempel: python3-dev libevent-dev . |
--build , -b |
Utför byggåtgärd när du distribuerar till en Linux-funktionsapp. Accepterar: remote och local . |
--build-native-deps |
Hoppar över att generera .wheels mappen 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/publish kärnverktygen . Alla parametrar som skickas till detta läggs till på kommandoraden. |
--force |
Ignorera prepublishing-verifiering i vissa scenarier. |
--list-ignored-files |
Visar en lista över filer som ignoreras under publiceringen .funcignore , som baseras på filen. |
--list-included-files |
Visar en lista över filer som publiceras, som baseras på .funcignore filen. |
--management-url |
Anger hanterings-URL:en för ditt moln. Använd detta när du kör i ett nationellt moln. |
--no-build |
Projektet skapas inte under publiceringen. För Python pip install utförs inte. |
--nozip |
Inaktiverar standardläget Run-From-Package . |
--overwrite-settings -y |
Ignorera uppmaningen att skriva över appinställningar när --publish-local-settings -i används. |
--publish-local-settings -i |
Publicera inställningar i local.settings.json till Azure, där du uppmanas 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 |
Publicera endast inställningar och hoppa över innehållet. Standardinställningen är prompt. |
--slot |
Valfritt namn på ett specifikt fack som ska publiceras till. |
--subscription |
Anger den standardprenumeration som ska användas. |
func azure storage fetch-connection-string
Hämtar anslutningssträng för det angivna Azure Storage-kontot.
func azure storage fetch-connection-string <STORAGE_ACCOUNT_NAME>
Mer information finns i Ladda ned en lagrings-anslutningssträng.
func azurecontainerapps deploy
Distribuerar en containerbaserad funktionsapp till en Azure Container Apps-miljö. Både det lagringskonto som används av funktionsappen och miljön måste redan finnas. Mer information finns i Azure Container Apps-värdtjänster 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 | Description |
---|---|
--access-token |
Gör att du kan använda en specifik åtkomsttoken när du utför autentiserade azure åtgärder. |
--access-token-stdin |
Läser en specifik åtkomsttoken från en standardinmatning. Använd detta när du läser token direkt från ett tidigare kommando, till exempel az account get-access-token . |
--environment |
Namnet på en befintlig Container Apps-miljö. |
--image-build |
När värdet är inställt true på hoppar över den lokala Docker-versionen. |
--image-name |
Avbildningsnamnet för en befintlig container i ett containerregister. Avbildningsnamnet innehåller taggnamnet. |
--location |
Region för distributionen. Helst är detta samma region som miljö- och lagringskontoresurserna. |
--management-url |
Anger hanterings-URL:en för ditt moln. Använd detta när du kör i nationella moln. |
--name |
Namnet som används för funktionsappdistributionen i Container Apps-miljön. Samma namn används också när du hanterar funktionsappen i portalen. Namnet ska vara unikt i miljön. |
--registry |
När den har angetts körs en Docker-version och avbildningen skickas till registeruppsättningen i --registry . Du kan inte använda --registry med --image-name . För Docker Hub använder du --registry-username också . |
--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 |
Anslutningssträng för lagringskontot som ska användas av funktionsappen. |
--subscription |
Anger den standardprenumeration som ska användas. |
--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 , powershell och custom (för kundhanterare). |
Viktigt!
Lagring anslutningssträng och andra autentiseringsuppgifter för tjänsten är viktiga hemligheter. Se till att lagra skriptfiler på ett säkert sätt med och func azurecontainerapps deploy
lagra dem inte i någon offentligt tillgänglig källkontroll.
func deploy
Kommandot func deploy
är inaktuellt. Använd func kubernetes deploy
i stället .
func durable delete-task-hub
Tar bort alla lagringsartefakter i aktivitetshubben Durable Functions.
func durable delete-task-hub
Åtgärden delete-task-hub
stöder följande alternativ:
Alternativ | Description |
---|---|
--connection-string-setting |
Valfritt namn på inställningen som innehåller den lagring anslutningssträng att använda. |
--task-hub-name |
Valfritt namn på den durable task hub som ska användas. |
Mer information finns i dokumentationen om Durable Functions.
func durable get-history
Returnerar historiken för den angivna orkestreringsinstansen.
func durable get-history --id <INSTANCE_ID>
Åtgärden get-history
stöder följande alternativ:
Alternativ | Description |
---|---|
--id |
Anger ID för en orkestreringsinstans (krävs). |
--connection-string-setting |
Valfritt namn på inställningen som innehåller den lagring anslutningssträng att använda. |
--task-hub-name |
Valfritt namn på den durable task hub som ska användas. |
Mer information finns i dokumentationen om Durable Functions.
func durable get-instances
Returnerar status för alla orkestreringsinstanser. Stöder växling med hjälp av parametern top
.
func durable get-instances
Åtgärden get-instances
stöder följande alternativ:
Alternativ | Description |
---|---|
--continuation-token |
Valfri token som anger en specifik sida/ett visst avsnitt av begäranden som ska returneras. |
--connection-string-setting |
Valfritt namn på appinställningen som innehåller lagringen anslutningssträng att använda. |
--created-after |
Du kan också hämta de instanser som skapats efter detta datum/tid (UTC). Alla ISO 8601-formaterade datetimes godkänns. |
--created-before |
Du kan också hämta de instanser som skapats före ett specifikt datum/tid (UTC). Alla ISO 8601-formaterade datetimes godkänns. |
--runtime-status |
Du kan också hämta de instanser vars status matchar en specifik status, inklusive running , completed och failed . Du kan ange en eller flera rymdavgränsade statyer. |
--top |
Du kan också begränsa antalet poster som returneras i en viss begäran. |
--task-hub-name |
Valfritt namn på uppgiftshubben Durable Functions som ska användas. |
Mer information finns i dokumentationen om Durable Functions.
func durable get-runtime-status
Returnerar status för den angivna orkestreringsinstansen.
func durable get-runtime-status --id <INSTANCE_ID>
Åtgärden get-runtime-status
stöder följande alternativ:
Alternativ | Description |
---|---|
--connection-string-setting |
Valfritt namn på inställningen som innehåller den lagring anslutningssträng att använda. |
--id |
Anger ID för en orkestreringsinstans (krävs). |
--show-input |
När svaret har angetts innehåller det indata för funktionen. |
--show-output |
När svaret har angetts innehåller det körningshistoriken. |
--task-hub-name |
Valfritt namn på uppgiftshubben Durable Functions som ska användas. |
Mer information finns i dokumentationen om Durable Functions.
func durable purge-history
Rensa orkestreringsinstanstillstånd, historik och bloblagring för orkestreringar som är äldre än det angivna tröskelvärdet.
func durable purge-history
Åtgärden purge-history
stöder följande alternativ:
Alternativ | Description |
---|---|
--connection-string-setting |
Valfritt namn på inställningen som innehåller den lagring anslutningssträng att använda. |
--created-after |
Du kan också ta bort historiken för instanser som skapats efter detta datum/tid (UTC). Alla ISO 8601-formaterade datetime-värden accepteras. |
--created-before |
Du kan också ta bort historiken för instanser som skapats före detta datum/tid (UTC). Alla ISO 8601-formaterade datetime-värden accepteras. |
--runtime-status |
Du kan också ta bort historiken för instanser vars status matchar en specifik status, inklusive completd , terminated , canceled och failed . Du kan ange en eller flera rymdavgränsade statyer. Om du inte inkluderar --runtime-status tas instanshistoriken bort oavsett status. |
--task-hub-name |
Valfritt namn på uppgiftshubben Durable Functions som ska användas. |
Mer information finns i dokumentationen om 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>
Åtgärden raise-event
stöder följande alternativ:
Alternativ | Description |
---|---|
--connection-string-setting |
Valfritt namn på inställningen som innehåller den lagring anslutningssträng att använda. |
--event-data |
Data som ska skickas till händelsen, antingen infogade eller från en JSON-fil (krävs). För filer prefixar du sökvägen till filen med ett et-tecken (@ ), till exempel @path/to/file.json . |
--event-name |
Namnet på händelsen som ska genereras (krävs). |
--id |
Anger ID för en orkestreringsinstans (krävs). |
--task-hub-name |
Valfritt namn på uppgiftshubben Durable Functions som ska användas. |
Mer information finns i dokumentationen om Durable Functions.
func durable rewind
Spolar tillbaka den angivna orkestreringsinstansen.
func durable rewind --id <INSTANCE_ID> --reason <REASON>
Åtgärden rewind
stöder följande alternativ:
Alternativ | Description |
---|---|
--connection-string-setting |
Valfritt namn på inställningen som innehåller den lagring anslutningssträng att använda. |
--id |
Anger ID för en orkestreringsinstans (krävs). |
--reason |
Orsak till att orkestreringen (krävs) spolas tillbaka. |
--task-hub-name |
Valfritt namn på uppgiftshubben Durable Functions som ska användas. |
Mer information finns i dokumentationen om Durable Functions.
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>
Åtgärden start-new
stöder följande alternativ:
Alternativ | Description |
---|---|
--connection-string-setting |
Valfritt namn på inställningen som innehåller den lagring anslutningssträng att använda. |
--function-name |
Namnet på orkestreringsfunktionen som ska startas (krävs). |
--id |
Anger ID för en orkestreringsinstans (krävs). |
--input |
Indata till orchestrator-funktionen, antingen infogad eller från en JSON-fil (krävs). För filer prefixar du sökvägen till filen med ett et-tecken (@ ), till exempel @path/to/file.json . |
--task-hub-name |
Valfritt namn på uppgiftshubben Durable Functions som ska användas. |
Mer information finns i dokumentationen om Durable Functions.
func durable terminate
Stoppar den angivna orkestreringsinstansen.
func durable terminate --id <INSTANCE_ID> --reason <REASON>
Åtgärden terminate
stöder följande alternativ:
Alternativ | Description |
---|---|
--connection-string-setting |
Valfritt namn på inställningen som innehåller den lagring anslutningssträng att använda. |
--id |
Anger ID för en orkestreringsinstans (krävs). |
--reason |
Orsak till att orkestreringen stoppas (krävs). |
--task-hub-name |
Valfritt namn på uppgiftshubben Durable Functions som ska användas. |
Mer information finns i dokumentationen om Durable Functions.
func extensions install
Installerar Functions-tillägg manuellt i ett non-.NET projekt eller i ett C#-skriptprojekt.
func extensions install --package Microsoft.Azure.WebJobs.Extensions.<EXTENSION> --version <VERSION>
Åtgärden install
stöder följande alternativ:
Alternativ | Description |
---|---|
--configPath |
Sökväg till katalogen som innehåller filen extensions.csproj. |
--csx |
Stöder C#-skriptprojekt (.csx). |
--force |
Uppdatera versionerna av befintliga tillägg. |
--output |
Utdatasökväg för tilläggen. |
--package |
Identifierare för ett specifikt tilläggspaket. När de inte anges installeras alla refererade tillägg, som med func extensions sync . |
--source |
NuGet-feedkälla när du inte använder NuGet.org. |
--version |
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
Följande ö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 i stället standardinstallationsmetoder för NuGet-paket, till exempel
dotnet add package
.Om du vill installera tillägg manuellt med Core Tools måste du ha .NET 6.0 SDK installerat.
När det är möjligt bör du i stället använda tilläggspaket. Följande är 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 den host.json fil som definierar paketet. Ingen åtgärd vidtas när ett tilläggspaket redan har angetts i din host.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 lagts till i funktionsappen.
Åtgärden sync
stöder följande alternativ:
Alternativ | Description |
---|---|
--configPath |
Sökväg till katalogen som innehåller filen extensions.csproj. |
--csx |
Stöder C#-skriptprojekt (.csx). |
--output |
Utdatasökväg för tilläggen. |
Återskapar en fil som saknas i extensions.csproj. Ingen åtgärd vidtas 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 --dockerfile
alternativet med func init
kommandot .
Följande Kubernetes-distributionsalternativ är tillgängliga:
Alternativ | Description |
---|---|
--dry-run |
Du kan också visa distributionsmallen utan körning. |
--config-map-name |
Valfritt namn 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 skalas ned till noll igen, med standardvärdet 300 s. |
--ignore-errors |
Fortsätter 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 |
Anger 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 |
Anger det maximala antalet repliker som HPA (Horizontal Pod Autoscaler) skalar till. |
--min-replicas |
Anger det minsta antalet repliker under vilket HPA inte skalar. |
--mount-funckeys-as-containervolume |
Monterar åtkomstnycklarna som en containervolym. |
--name |
Namnet som används för distributionen och andra artefakter i Kubernetes. |
--namespace |
Anger det Kubernetes-namnområde som ska distribueras till, vilket är standardnamnområdet. |
--no-docker |
Funktioner läss 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 innehåller 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 |
Visar 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 |
Anger typen av Kubernetes Service. Värden som stöds är: ClusterIP , NodePort och 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 . |
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.
Mer information finns i Distribuera en funktionsapp till Kubernetes.
func kubernetes install
Installerar KEDA i ett Kubernetes-kluster.
func kubernetes install
Installerar KEDA till klustret som definierats i kubectl-konfigurationsfilen.
Åtgärden install
stöder följande alternativ:
Alternativ | Description |
---|---|
--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 |
Stöder installation 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 kubectl-konfigurationsfilen.
func kubernetes remove
Tar bort KEDA från klustret som definierats i kubectl-konfigurationsfilen.
Åtgärden remove
stöder följande alternativ:
Alternativ | Description |
---|---|
--namespace |
Stöder avinstallation 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 och <VALUE>
med värdet för inställningen.
Åtgärden add
stöder följande alternativ:
Alternativ | Description |
---|---|
--connectionString |
Lägger till namn/värde-paret i ConnectionStrings samlingen i stället för samlingen Values . Använd endast samlingen ConnectionStrings när det krävs av vissa ramverk. Mer information finns i local.settings.json fil. |
func settings decrypt
Dekrypterar tidigare krypterade värden i Values
samlingen i local.settings.json-filen.
func settings decrypt
Anslutningssträngvärden ConnectionStrings
i samlingen dekrypteras också. I local.settings.json IsEncrypted
anges även till false
. Kryptera lokala inställningar för att minska risken för att värdefull information läcker 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.
Åtgärden delete
stöder följande alternativ:
Alternativ | Description |
---|---|
--connectionString |
Tar bort namn/värde-paret från ConnectionStrings samlingen i stället för från Values samlingen. |
func settings encrypt
Krypterar värdena för enskilda objekt i Values
samlingen i local.settings.json-filen.
func settings encrypt
Anslutningssträngvärdena ConnectionStrings
i samlingen krypteras också. I local.settings.json IsEncrypted
anges också till true
, som anger att inställningarna för lokal körning dekrypterar inställningarna innan de används. Kryptera lokala inställningar för att minska risken för att värdefull information läcker från local.settings.json. I Azure lagras programinställningarna alltid krypterade.
func settings list
Visar en lista med inställningar i Values
samlingen i local.settings.json-filen.
func settings list
Anslutningssträngar från ConnectionStrings
samlingen matas också ut. Som standard maskeras värden för säkerhet. Du kan använda alternativet --showValue
för att visa det faktiska värdet.
Åtgärden list
stöder följande alternativ:
Alternativ | Description |
---|---|
--showValue |
Visar de faktiska avmaskerade värdena i utdata. |
func templates list
Visar en lista över tillgängliga funktionsmallar (utlösare).
Åtgärden list
stöder följande alternativ:
Alternativ | Description |
---|---|
--language |
Språk som du vill filtrera returnerade mallar för. Standardvärdet är att returnera alla språk. |