Naslaginformatie over Azure Functions Core Tools

Dit artikel bevat referentiedocumentatie voor de Azure Functions Core Tools, waarmee u Azure Functions-projecten kunt ontwikkelen, beheren en implementeren vanaf uw lokale computer. Zie Werken met Azure Functions Core Tools voor meer informatie over het gebruik van Core Tools.

Core Tools-opdrachten zijn ingedeeld in de volgende contexten, die elk een unieke set acties bieden.

Opdrachtcontext Beschrijving
func Opdrachten die worden gebruikt om functies op uw lokale computer te maken en uit te voeren.
func azure Opdrachten voor het werken met Azure-resources, waaronder publiceren.
func azurecontainerapps Een containerfunctie-app implementeren in Azure Container Apps.
func durable Opdrachten voor het werken met Durable Functions.
func extensions Opdrachten voor het installeren en beheren van extensies.
func kubernetes Opdrachten voor het werken met Kubernetes en Azure Functions.
func settings Opdrachten voor het beheren van omgevingsinstellingen voor de lokale Functions-host.
func templates Opdrachten voor het weergeven van beschikbare functiesjablonen.

Voordat u de opdrachten in dit artikel gebruikt, moet u de Core Tools installeren.

func init

Hiermee maakt u een nieuw Functions-project in een specifieke taal.

func init <PROJECT_FOLDER>

Wanneer u het project opgeeft <PROJECT_FOLDER>, wordt het gemaakt in een nieuwe map met deze naam. Anders wordt de huidige map gebruikt.

func init ondersteunt de volgende opties, die geen ondersteuning bieden voor versie 1.x, tenzij anders vermeld:

Optie Beschrijving
--csx Hiermee maakt u .NET-functies als C#-script. Dit is het gedrag van versie 1.x. Alleen geldig met --worker-runtime dotnet.
--docker Hiermee maakt u een Dockerfile voor een container met behulp van een basisinstallatiekopieën die is gebaseerd op de gekozen --worker-runtime. Gebruik deze optie wanneer u van plan bent om een containerfunctie-app te implementeren.
--docker-only Hiermee voegt u een Dockerfile toe aan een bestaand project. Vraagt om de worker-runtime als deze niet is opgegeven of ingesteld in local.settings.json. Gebruik deze optie wanneer u van plan bent een containerfunctie-app te implementeren en het project al bestaat.
--force Initialiseer het project zelfs wanneer er bestaande bestanden in het project zijn. Met deze instelling worden bestaande bestanden met dezelfde naam overschreven. Andere bestanden in de projectmap worden niet beïnvloed.
--language Initialiseert een taalspecifiek project. Momenteel ondersteund wanneer --worker-runtime deze is ingesteld op node. Opties zijn typescript en javascript. U kunt ook --worker-runtime javascript gebruiken of --worker-runtime typescript.
--managed-dependencies Hiermee worden beheerde afhankelijkheden geïnstalleerd. Momenteel ondersteunt alleen de PowerShell-werkruntime deze functionaliteit.
--model Hiermee stelt u het gewenste programmeermodel in voor een doeltaal wanneer er meer dan één model beschikbaar is. Ondersteunde opties zijn V1 en V2 voor Python en V3V4 voor Node.js. Zie de ontwikkelaarshandleiding voor Python en de ontwikkelaarshandleiding voor Node.js voor meer informatie.
--source-control Hiermee bepaalt u of er een Git-opslagplaats wordt gemaakt. Standaard wordt er geen opslagplaats gemaakt. Wanneer true, wordt er een opslagplaats gemaakt.
--worker-runtime Hiermee stelt u de taalruntime voor het project in. Ondersteunde waarden zijn: csharp, dotnet, dotnet-isolated, ,nodejavascript(JavaScript), powershell, en pythontypescript. Gebruik Maven voor Java. Als u een taalneutraal project wilt genereren met alleen de projectbestanden, gebruikt u custom. Wanneer deze niet is ingesteld, wordt u gevraagd om uw runtime te kiezen tijdens de initialisatie.
--target-framework Hiermee stelt u het doelframework voor het functie-app-project in. Alleen geldig met --worker-runtime dotnet-isolated. Ondersteunde waarden zijn: net6.0 (standaard), net7.0en net8.0net48 (.NET Framework 4.8).

Notitie

Wanneer u een --docker van beide of --dockerfile opties gebruikt, maakt Core Tools automatisch de Dockerfile voor C#-, JavaScript-, Python- en PowerShell-functies. Voor Java-functies moet u het Dockerfile handmatig maken. Zie Containerized Functie-apps maken voor meer informatie.

func-logboeken

Hiermee haalt u logboeken op voor functies die worden uitgevoerd in een Kubernetes-cluster.

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

De func logs actie ondersteunt de volgende opties:

Optie Beschrijving
--platform Hostingplatform voor de functie-app. Ondersteunde opties: kubernetes.
--name Naam van functie-app in Azure.

Zie Azure Functions in Kubernetes met KEDA voor meer informatie.

func nieuw

Hiermee maakt u een nieuwe functie in het huidige project op basis van een sjabloon.

func new

Wanneer u zonder de --template optie uitvoertfunc new, wordt u gevraagd een sjabloon te kiezen. In versie 1.x moet u ook de taal kiezen.

De func new actie ondersteunt de volgende opties:

Optie Beschrijving
--authlevel Hiermee kunt u het autorisatieniveau voor een HTTP-trigger instellen. Ondersteunde waarden zijn: function, anonymous, admin. Autorisatie wordt niet afgedwongen wanneer deze lokaal wordt uitgevoerd. Zie het HTTP-bindingsartikel voor meer informatie.
--csx (Versie 2.x en latere versies.) Hiermee worden dezelfde C#-scriptsjablonen (.csx) gegenereerd die worden gebruikt in versie 1.x en in de portal.
--language, -l De programmeertaal van de sjabloon, zoals C#, F# of JavaScript. Deze optie is vereist in versie 1.x. In versie 2.x en latere versies gebruikt u deze optie niet omdat de taal is gedefinieerd door de werkrolruntime.
--name, -n De naam van de functie.
--template, -t Gebruik de func templates list opdracht om de volledige lijst met beschikbare sjablonen voor elke ondersteunde taal weer te geven.

Zie Een functie maken voor meer informatie.

func run

Alleen versie 1.x.

Hiermee kunt u een functie rechtstreeks aanroepen, wat vergelijkbaar is met het uitvoeren van een functie met behulp van het tabblad Testen in Azure Portal. Deze actie wordt alleen ondersteund in versie 1.x. Voor latere versies gebruikt func start en roept u het functie-eindpunt rechtstreeks aan.

func run

De func run actie ondersteunt de volgende opties:

Optie Beschrijving
--content Inline-inhoud doorgegeven aan de functie.
--debug Koppel een foutopsporingsprogramma aan het hostproces voordat u de functie uitvoert.
--file De bestandsnaam die moet worden gebruikt als inhoud.
--no-interactive Er wordt niet om invoer gevraagd. Dit is handig voor automatiseringsscenario's.
--timeout Tijd die moet worden gewacht (in seconden) totdat de lokale Functions-host gereed is.

Als u bijvoorbeeld een door HTTP geactiveerde functie wilt aanroepen en de hoofdtekst van de inhoud wilt doorgeven, voert u de volgende opdracht uit:

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

func start

Start de lokale runtimehost en laadt het functieproject in de huidige map.

De specifieke opdracht is afhankelijk van de runtimeversie.

func start

func start ondersteunt de volgende opties:

Optie Beschrijving
--cert Het pad naar een PFX-bestand dat een persoonlijke sleutel bevat. Alleen ondersteund met --useHttps.
--cors Een door komma's gescheiden lijst met CORS-oorsprongen, zonder spaties.
--cors-credentials Sta geverifieerde aanvragen voor cross-origin toe met behulp van cookies en de verificatieheader.
--dotnet-isolated-debug Als dit is ingesteld true, wordt het .NET-werkproces onderbroken totdat een foutopsporingsprogramma is gekoppeld aan het geïsoleerde .NET-project dat wordt opgespoord.
--enable-json-output Verzendt waar mogelijk consolelogboeken als JSON.
--enableAuth Schakel de pijplijn voor volledige verificatieafhandeling in, met autorisatievereisten.
--functions Een door spaties gescheiden lijst met functies die moeten worden geladen.
--language-worker Argumenten voor het configureren van de taalwerker. U kunt bijvoorbeeld foutopsporing inschakelen voor taalwerkrol door foutopsporingspoort en andere vereiste argumenten op te geven.
--no-build Bouw het huidige project niet voordat u het uitvoert. Alleen voor .NET-klasseprojecten. De standaardwaarde is false.
--password Het wachtwoord of een bestand dat het wachtwoord voor een PFX-bestand bevat. Alleen gebruikt met --cert.
--port De lokale poort waarop moet worden geluisterd. Standaardwaarde: 7071.
--timeout De time-out voor de Functions-host die in seconden moet worden gestart. Standaard: 20 seconden.
--useHttps Binden aan https://localhost:{port} in plaats van aan http://localhost:{port}. Met deze optie maakt u standaard een vertrouwd certificaat op uw computer.

Wanneer het project wordt uitgevoerd, kunt u afzonderlijke functie-eindpunten verifiëren.

func azure functionapp fetch-app-settings

Hiermee haalt u instellingen op van een specifieke functie-app.

func azure functionapp fetch-app-settings <APP_NAME> 

Zie Toepassingsinstellingen downloaden voor meer informatie.

Instellingen worden gedownload naar het bestand local.settings.json voor het project. Waarden op het scherm worden gemaskeerd voor beveiliging. U kunt instellingen in het bestand local.settings.json beveiligen door lokale versleuteling in te schakelen.

func azure functionapp list-functions

Retourneert een lijst met de functies in de opgegeven functie-app.

func azure functionapp list-functions <APP_NAME>

func azure functionapp logstream

Verbinding maken de lokale opdrachtprompt voor het streamen van logboeken voor de functie-app in Azure.

func azure functionapp logstream <APP_NAME>

De standaardtime-out voor de verbinding is 2 uur. U kunt de time-out wijzigen door een app-instelling met de naam SCM_LOGSTREAM_TIMEOUT toe te voegen, met een time-outwaarde in seconden. Nog niet ondersteund voor Linux-apps in het verbruiksabonnement. Gebruik voor deze apps de --browser optie om logboeken in de portal weer te geven.

De deploy actie ondersteunt de volgende opties:

Optie Beschrijving
--browser Open Azure-toepassing Insights Live Stream voor de functie-app in de standaardbrowser.

Zie Logboeken voor streaming-uitvoering inschakelen in Azure Functions voor meer informatie.

func azure functionapp publish

Implementeert een Functions-project naar een bestaande functie-app-resource in Azure.

func azure functionapp publish <APP_NAME>

Zie Projectbestanden implementeren voor meer informatie.

De volgende publicatieopties zijn van toepassing op basis van versie:

Optie Beschrijving
--access-token Hiermee kunt u een specifiek toegangstoken gebruiken bij het uitvoeren van geverifieerde Azure-acties.
--access-token-stdin Leest een specifiek toegangstoken uit een standaardinvoer. Gebruik dit bij het lezen van het token rechtstreeks vanuit een vorige opdracht, zoals az account get-access-token.
--additional-packages Lijst met pakketten die moeten worden geïnstalleerd bij het bouwen van systeemeigen afhankelijkheden. Bijvoorbeeld: python3-dev libevent-dev.
--build, -b Hiermee wordt een buildactie uitgevoerd bij het implementeren naar een Linux-functie-app. Accepteert: remote en local.
--build-native-deps Hiermee wordt het genereren van de map overgeslagen bij het .wheels publiceren van Python-functie-apps.
--csx Publiceer een C#-scriptproject (.csx).
--dotnet-cli-params Bij het publiceren van gecompileerde C#-functies (.csproj) worden de belangrijkste hulpprogramma's aangeroepen dotnet build --output bin/publish. Alle parameters die hieraan worden doorgegeven, worden toegevoegd aan de opdrachtregel.
--force Verificatie vooraf publiceren negeren in bepaalde scenario's.
--list-ignored-files Geeft een lijst weer met bestanden die tijdens het publiceren worden genegeerd. Dit is gebaseerd op het .funcignore bestand.
--list-included-files Geeft een lijst weer met bestanden die zijn gepubliceerd, die zijn gebaseerd op het .funcignore bestand.
--management-url Hiermee stelt u de beheer-URL voor uw cloud in. Gebruik deze optie bij het uitvoeren in een onafhankelijke cloud.
--no-build Project is niet gebouwd tijdens het publiceren. Voor Python pip install wordt dit niet uitgevoerd.
--nozip Hiermee schakelt u de standaardmodus Run-From-Package uit.
--overwrite-settings -y Onderdrukt de prompt om app-instellingen te overschrijven wanneer --publish-local-settings -i deze wordt gebruikt.
--publish-local-settings -i Publiceer instellingen in local.settings.json naar Azure, waarbij u wordt gevraagd om te overschrijven als de instelling al bestaat. Als u een lokale opslagemulator gebruikt, wijzigt u eerst de app-instelling in een werkelijke opslagverbinding.
--publish-settings-only, -o Publiceer alleen instellingen en sla de inhoud over. De standaardinstelling is een prompt.
--slot Optionele naam van een specifieke site waarop moet worden gepubliceerd.
--subscription Hiermee stelt u het standaardabonnement in dat moet worden gebruikt.

func azure storage fetch-connection-string

Hiermee haalt u de verbindingsreeks op voor het opgegeven Azure Storage-account.

func azure storage fetch-connection-string <STORAGE_ACCOUNT_NAME>

Zie Een opslag verbindingsreeks downloaden voor meer informatie.

func azurecontainerapps deploy

Implementeert een functie-app in een container in een Azure Container Apps-omgeving. Zowel het opslagaccount dat door de functie-app als de omgeving wordt gebruikt, moet al bestaan. Zie Azure Container Apps die als host fungeren voor Azure Functions voor meer informatie.

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>

De volgende implementatieopties zijn van toepassing:

Optie Beschrijving
--access-token Hiermee kunt u een specifiek toegangstoken gebruiken bij het uitvoeren van geverifieerde Azure-acties.
--access-token-stdin Leest een specifiek toegangstoken uit een standaardinvoer. Gebruik dit bij het lezen van het token rechtstreeks vanuit een vorige opdracht, zoals az account get-access-token.
--environment De naam van een bestaande Container Apps-omgeving.
--image-build Als dit is ingesteld true, wordt de lokale Docker-build overgeslagen.
--image-name De installatiekopieënnaam van een bestaande container in een containerregister. De naam van de installatiekopieën bevat de tagnaam.
--location Regio voor de implementatie. Idealiter is dit dezelfde regio als de resources voor de omgeving en het opslagaccount.
--management-url Hiermee stelt u de beheer-URL voor uw cloud in. Gebruik deze optie bij het uitvoeren in een onafhankelijke cloud.
--name De naam die wordt gebruikt voor de implementatie van de functie-app in de Container Apps-omgeving. Dezelfde naam wordt ook gebruikt bij het beheren van de functie-app in de portal. De naam moet uniek zijn in de omgeving.
--registry Wanneer deze is ingesteld, wordt een Docker-build uitgevoerd en wordt de installatiekopieën gepusht naar de registerset in --registry. U kunt niet gebruiken --registry met --image-name. Gebruik ook --registry-usernamevoor Docker Hub.
--registry-password Het wachtwoord of token dat wordt gebruikt om de installatiekopieën op te halen uit een privéregister.
--registry-username De gebruikersnaam die wordt gebruikt om de installatiekopieën op te halen uit een privéregister.
--resource-group De resourcegroep waarin de functies gerelateerde resources moeten worden gemaakt.
--storage-account De verbindingsreeks voor het opslagaccount dat moet worden gebruikt door de functie-app.
--subscription Hiermee stelt u het standaardabonnement in dat moet worden gebruikt.
--worker-runtime Hiermee stelt u de runtimetaal van de functie-app in. Deze parameter wordt alleen gebruikt met --image-name en --image-build, anders wordt de taal bepaald tijdens de lokale build. Ondersteunde waarden zijn: dotnet, dotnetIsolated, node, python, , en custompowershell(voor handlers van klanten).

Belangrijk

Opslag verbindingsreeks s en andere servicereferenties zijn belangrijke geheimen. Zorg ervoor dat u alle scriptbestanden veilig opslaat en func azurecontainerapps deploy deze niet opslaat in een openbaar toegankelijk broncodebeheer.

func deploy

De func deploy opdracht is afgeschaft. Gebruik in plaats daarvan func kubernetes deploy.

func durable delete-task-hub

Hiermee verwijdert u alle opslagartefacten in de Durable Functions-taakhub.

func durable delete-task-hub

De delete-task-hub actie ondersteunt de volgende opties:

Optie Beschrijving
--connection-string-setting Optionele naam van de instelling met de opslag verbindingsreeks te gebruiken.
--task-hub-name Optionele naam van de Durable Task Hub die moet worden gebruikt.

Zie de Durable Functions-documentatie voor meer informatie.

func durable get-history

Retourneert de geschiedenis van het opgegeven orchestration-exemplaar.

func durable get-history --id <INSTANCE_ID>

De get-history actie ondersteunt de volgende opties:

Optie Beschrijving
--id Hiermee geeft u de id van een indelingsinstantie (vereist).
--connection-string-setting Optionele naam van de instelling met de opslag verbindingsreeks te gebruiken.
--task-hub-name Optionele naam van de Durable Task Hub die moet worden gebruikt.

Zie de Durable Functions-documentatie voor meer informatie.

func durable get-instances

Retourneert de status van alle indelingsexemplaren. Ondersteunt paging met behulp van de top parameter.

func durable get-instances

De get-instances actie ondersteunt de volgende opties:

Optie Beschrijving
--continuation-token Optioneel token dat een specifieke pagina/sectie aangeeft van de aanvragen die moeten worden geretourneerd.
--connection-string-setting Optionele naam van de app-instelling die de opslag-verbindingsreeks bevat die u wilt gebruiken.
--created-after U kunt eventueel de exemplaren ophalen die na deze datum/tijd (UTC) zijn gemaakt. Alle ISO 8601-indelingen voor datum/tijd worden geaccepteerd.
--created-before U kunt eventueel de exemplaren ophalen die zijn gemaakt vóór een specifieke datum/tijd (UTC). Alle ISO 8601-indelingen voor datum/tijd worden geaccepteerd.
--runtime-status U kunt desgewenst de exemplaren ophalen waarvan de status overeenkomt met een specifieke status, inclusief running, completeden failed. U kunt een of meer door ruimte gescheiden beelden leveren.
--top Beperk eventueel het aantal records dat wordt geretourneerd in een bepaalde aanvraag.
--task-hub-name Optionele naam van de Durable Functions-taakhub die moet worden gebruikt.

Zie de Durable Functions-documentatie voor meer informatie.

func durable get-runtime-status

Retourneert de status van het opgegeven orchestration-exemplaar.

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

De get-runtime-status actie ondersteunt de volgende opties:

Optie Beschrijving
--connection-string-setting Optionele naam van de instelling met de opslag verbindingsreeks te gebruiken.
--id Hiermee geeft u de id van een indelingsinstantie (vereist).
--show-input Wanneer dit is ingesteld, bevat het antwoord de invoer van de functie.
--show-output Wanneer dit is ingesteld, bevat het antwoord de uitvoeringsgeschiedenis.
--task-hub-name Optionele naam van de Durable Functions-taakhub die moet worden gebruikt.

Zie de Durable Functions-documentatie voor meer informatie.

func durable purge-history

De instantiestatus, geschiedenis en blobopslag opschonen voor indelingen die ouder zijn dan de opgegeven drempelwaarde.

func durable purge-history

De purge-history actie ondersteunt de volgende opties:

Optie Beschrijving
--connection-string-setting Optionele naam van de instelling met de opslag verbindingsreeks te gebruiken.
--created-after Verwijder eventueel de geschiedenis van exemplaren die na deze datum/tijd (UTC) zijn gemaakt. Alle ISO 8601 opgemaakte datum/tijd-waarden worden geaccepteerd.
--created-before Verwijder eventueel de geschiedenis van exemplaren die vóór deze datum/tijd (UTC) zijn gemaakt. Alle ISO 8601 opgemaakte datum/tijd-waarden worden geaccepteerd.
--runtime-status Verwijder desgewenst de geschiedenis van exemplaren waarvan de status overeenkomt met een specifieke status, inclusief completd, terminated, canceleden failed. U kunt een of meer door ruimte gescheiden beelden leveren. Als u dit niet opneemt --runtime-status, wordt de exemplaargeschiedenis verwijderd, ongeacht de status.
--task-hub-name Optionele naam van de Durable Functions-taakhub die moet worden gebruikt.

Zie de Durable Functions-documentatie voor meer informatie.

func durable raise-event

Hiermee wordt een gebeurtenis gegenereerd voor het opgegeven orchestration-exemplaar.

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

De raise-event actie ondersteunt de volgende opties:

Optie Beschrijving
--connection-string-setting Optionele naam van de instelling met de opslag verbindingsreeks te gebruiken.
--event-data Gegevens die moeten worden doorgegeven aan de gebeurtenis, hetzij inline of uit een JSON-bestand (vereist). Voor bestanden moet u het pad naar het bestand vooraf laten gaan met een ampersand (@zoals @path/to/file.json.
--event-name Naam van de gebeurtenis die moet worden gegenereerd (vereist).
--id Hiermee geeft u de id van een indelingsinstantie (vereist).
--task-hub-name Optionele naam van de Durable Functions-taakhub die moet worden gebruikt.

Zie de Durable Functions-documentatie voor meer informatie.

func duurzaam terugspoelen

Hiermee wordt het opgegeven indelingsexemplaar terugspoelen.

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

De rewind actie ondersteunt de volgende opties:

Optie Beschrijving
--connection-string-setting Optionele naam van de instelling met de opslag verbindingsreeks te gebruiken.
--id Hiermee geeft u de id van een indelingsinstantie (vereist).
--reason Reden voor het terugspoelen van de indeling (vereist).
--task-hub-name Optionele naam van de Durable Functions-taakhub die moet worden gebruikt.

Zie de Durable Functions-documentatie voor meer informatie.

func durable start-new

Hiermee start u een nieuw exemplaar van de opgegeven orchestratorfunctie.

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

De start-new actie ondersteunt de volgende opties:

Optie Beschrijving
--connection-string-setting Optionele naam van de instelling met de opslag verbindingsreeks te gebruiken.
--function-name Naam van de orchestratorfunctie die moet worden gestart (vereist).
--id Hiermee geeft u de id van een indelingsinstantie (vereist).
--input Invoer voor de orchestratorfunctie, inline of vanuit een JSON-bestand (vereist). Voor bestanden moet u het pad naar het bestand vooraf laten gaan met een ampersand (@zoals @path/to/file.json.
--task-hub-name Optionele naam van de Durable Functions-taakhub die moet worden gebruikt.

Zie de Durable Functions-documentatie voor meer informatie.

func durable terminate

Hiermee stopt u het opgegeven indelingsexemplaar.

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

De terminate actie ondersteunt de volgende opties:

Optie Beschrijving
--connection-string-setting Optionele naam van de instelling met de opslag verbindingsreeks te gebruiken.
--id Hiermee geeft u de id van een indelingsinstantie (vereist).
--reason Reden voor het stoppen van de indeling (vereist).
--task-hub-name Optionele naam van de Durable Functions-taakhub die moet worden gebruikt.

Zie de Durable Functions-documentatie voor meer informatie.

func-extensies installeren

Hiermee worden Functions-extensies handmatig geïnstalleerd in een non-.NET project of in een C#-scriptproject.

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

De install actie ondersteunt de volgende opties:

Optie Beschrijving
--configPath Pad naar de map met extensions.csproj-bestand.
--csx Ondersteunt C#-scriptprojecten (.csx).
--force Werk de versies van bestaande extensies bij.
--output Uitvoerpad voor de extensies.
--package Id voor een specifiek uitbreidingspakket. Wanneer dit niet is opgegeven, worden alle extensies waarnaar wordt verwezen, zoals bij func extensions sync.
--source NuGet-feedbron wanneer u NuGet.org niet gebruikt.
--version Versie van extensiepakket.

In het volgende voorbeeld wordt versie 5.0.1 van de Event Hubs-extensie in het lokale project geïnstalleerd:

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

De volgende overwegingen zijn van toepassing bij gebruik func extensions install:

  • Voor gecompileerde C#-projecten (zowel in-process als geïsoleerd werkproces) gebruikt u in plaats daarvan standaard NuGet-pakketinstallatiemethoden, zoals dotnet add package.

  • Als u extensies handmatig wilt installeren met Core Tools, moet de .NET 6.0 SDK zijn geïnstalleerd.

  • Indien mogelijk moet u in plaats daarvan extensiebundels gebruiken. Hier volgen enkele redenen waarom u extensies mogelijk handmatig moet installeren:

    • U moet toegang krijgen tot een specifieke versie van een extensie die niet beschikbaar is in een bundel.
    • U moet toegang krijgen tot een aangepaste extensie die niet beschikbaar is in een bundel.
    • U moet toegang krijgen tot een specifieke combinatie van extensies die niet beschikbaar zijn in één bundel.
  • Voordat u extensies handmatig kunt installeren, moet u eerst het extensionBundle object verwijderen uit het host.json-bestand dat de bundel definieert. Er wordt geen actie ondernomen wanneer een extensiebundel al is ingesteld in uw host.json-bestand.

  • De eerste keer dat u expliciet een extensie installeert, wordt een .NET-projectbestand met de naam extensions.csproj toegevoegd aan de hoofdmap van uw app-project. Dit bestand definieert de set NuGet-pakketten die vereist zijn voor uw functies. Hoewel u met de NuGet-pakketverwijzingen in dit bestand kunt werken, kunt u met Core Tools extensies installeren zonder dat u dit C#-projectbestand handmatig hoeft te bewerken.

Func-extensies synchroniseren

Installeert alle extensies die zijn toegevoegd aan de functie-app.

De sync actie ondersteunt de volgende opties:

Optie Beschrijving
--configPath Pad naar de map met extensions.csproj-bestand.
--csx Ondersteunt C#-scriptprojecten (.csx).
--output Uitvoerpad voor de extensies.

Hiermee wordt een ontbrekend extensions.csproj-bestand opnieuw gegenereerd. Er wordt geen actie ondernomen wanneer een extensiebundel is gedefinieerd in uw host.json-bestand.

func kubernetes implementeren

Hiermee wordt een Functions-project geïmplementeerd als een aangepaste Docker-container in een Kubernetes-cluster.

func kubernetes deploy 

Met deze opdracht wordt uw project gebouwd als een aangepaste container en gepubliceerd naar een Kubernetes-cluster. Aangepaste containers moeten een Dockerfile hebben. Als u een app wilt maken met een Dockerfile, gebruikt u de --dockerfile optie met de func init opdracht.

De volgende Kubernetes-implementatieopties zijn beschikbaar:

Optie Beschrijving
--dry-run U kunt eventueel de implementatiesjabloon weergeven zonder uitvoering.
--config-map-name Optionele naam van een bestaande configuratietoewijzing met functie-app-instellingen die in de implementatie moeten worden gebruikt. Vereist --use-config-map. Het standaardgedrag is het maken van instellingen op basis van het Values object in het bestand local.settings.json.
--cooldown-period De afkoelperiode (in seconden) nadat alle triggers niet meer actief zijn voordat de implementatie omlaag wordt geschaald naar nul, met een standaardwaarde van 300 s.
--ignore-errors Hiermee wordt de implementatie voortgezet nadat een resource een fout heeft geretourneerd. Het standaardgedrag is om de fout te stoppen.
--image-name De naam van de installatiekopieën die moeten worden gebruikt voor de podimplementatie en van waaruit functies moeten worden gelezen.
--keda-version Hiermee stelt u de keda-versie in die moet worden geïnstalleerd. Geldige opties zijn: v1 en v2 (standaard).
--keys-secret-name De naam van een Kubernetes Secrets-verzameling die moet worden gebruikt voor het opslaan van functietoegangssleutels.
--max-replicas Hiermee stelt u het maximumaantal replica's in waarvoor de horizontale schaalaanpassing van pods (HPA) wordt geschaald.
--min-replicas Hiermee stelt u het minimale aantal replica's in waaronder HPA niet wordt geschaald.
--mount-funckeys-as-containervolume Koppelt de functietoegangssleutels als een containervolume.
--name De naam die wordt gebruikt voor de implementatie en andere artefacten in Kubernetes.
--namespace Hiermee stelt u de Kubernetes-naamruimte in waarop moet worden geïmplementeerd. Deze wordt standaard ingesteld op de standaardnaamruimte.
--no-docker Functies worden gelezen uit de huidige map in plaats van uit een afbeelding. Vereist het koppelen van het bestandssysteem van de installatiekopieën.
--registry Wanneer deze is ingesteld, wordt een Docker-build uitgevoerd en wordt de installatiekopieën naar een register met die naam gepusht. U kunt niet gebruiken --registry met --image-name. Gebruik uw gebruikersnaam voor Docker.
--polling-interval Het polling-interval (in seconden) voor het controleren van niet-HTTP-triggers, met een standaardwaarde van 30.
--pull-secret Het geheim dat wordt gebruikt voor toegang tot persoonlijke registerreferenties.
--secret-name De naam van een bestaande Kubernetes Secrets-verzameling die functie-app-instellingen bevat die in de implementatie moeten worden gebruikt. Het standaardgedrag is het maken van instellingen op basis van het Values object in het bestand local.settings.json.
--show-service-fqdn Geeft de URL's van HTTP-triggers weer met de Kubernetes FQDN in plaats van het standaardgedrag van het gebruik van een IP-adres.
--service-type Hiermee stelt u het type Kubernetes Service in. Ondersteunde waarden zijn: ClusterIP, NodePorten LoadBalancer (standaard).
--use-config-map Gebruik een ConfigMap object (v1) in plaats van een Secret object (v1) om instellingen voor functie-apps te configureren. De kaartnaam wordt ingesteld met behulp van --config-map-name.

Core Tools maakt gebruik van de lokale Docker CLI om de installatiekopieën te bouwen en te publiceren. Zorg ervoor dat Docker al lokaal is geïnstalleerd. Voer de docker login opdracht uit om verbinding te maken met uw account.

Zie Een functie-app implementeren in Kubernetes voor meer informatie.

func kubernetes installeren

Hiermee installeert u KEDA in een Kubernetes-cluster.

func kubernetes install 

Hiermee wordt KEDA geïnstalleerd op het cluster dat is gedefinieerd in het kubectl-configuratiebestand.

De install actie ondersteunt de volgende opties:

Optie Beschrijving
--dry-run Geeft de implementatiesjabloon weer zonder uitvoering.
--keda-version Hiermee stelt u de keda-versie in die moet worden geïnstalleerd. Geldige opties zijn: v1 en v2 (standaard).
--namespace Ondersteunt de installatie van een specifieke Kubernetes-naamruimte. Als deze niet is ingesteld, wordt de standaardnaamruimte gebruikt.

Zie Keda en functies beheren in Kubernetes voor meer informatie.

func kubernetes verwijderen

Hiermee verwijdert u KEDA uit het Kubernetes-cluster dat is gedefinieerd in het kubectl-configuratiebestand.

func kubernetes remove 

Hiermee verwijdert u KEDA uit het cluster dat is gedefinieerd in het kubectl-configuratiebestand.

De remove actie ondersteunt de volgende opties:

Optie Beschrijving
--namespace Ondersteunt het verwijderen van een specifieke Kubernetes-naamruimte. Als deze niet is ingesteld, wordt de standaardnaamruimte gebruikt.

Zie KEDA verwijderen uit Kubernetes voor meer informatie.

func-instellingen toevoegen

Voegt een nieuwe instelling toe aan de Values verzameling in het bestand local.settings.json.

func settings add <SETTING_NAME> <VALUE>

Vervang <SETTING_NAME> door de naam van de app-instelling en <VALUE> door de waarde van de instelling.

De add actie ondersteunt de volgende optie:

Optie Beschrijving
--connectionString Voegt het naam-waardepaar toe aan de ConnectionStrings verzameling in plaats van de Values verzameling. Gebruik de ConnectionStrings verzameling alleen wanneer dit is vereist voor bepaalde frameworks. Zie het bestand local.settings.json voor meer informatie.

func-instellingen ontsleutelen

Ontsleutelt eerder versleutelde waarden in de Values verzameling in het bestand local.settings.json.

func settings decrypt

Verbinding maken iontekenreekswaarden in de ConnectionStrings verzameling worden ook ontsleuteld. In local.settings.json IsEncrypted is ook ingesteld op false. Versleutel lokale instellingen om het risico te verminderen dat waardevolle informatie uit local.settings.json wordt gelekt. In Azure worden toepassingsinstellingen altijd versleuteld opgeslagen.

func-instellingen verwijderen

Hiermee verwijdert u een bestaande instelling uit de Values verzameling in het bestand local.settings.json.

func settings delete <SETTING_NAME>

Vervang <SETTING_NAME> door de naam van de app-instelling en <VALUE> door de waarde van de instelling.

De delete actie ondersteunt de volgende optie:

Optie Beschrijving
--connectionString Hiermee verwijdert u het naam-waardepaar uit de ConnectionStrings verzameling in plaats van uit de Values verzameling.

func-instellingen versleutelen

Versleutelt de waarden van afzonderlijke items in de Values verzameling in het bestand local.settings.json.

func settings encrypt

Verbinding maken iontekenreekswaarden in de ConnectionStrings verzameling worden ook versleuteld. In local.settings.json IsEncrypted wordt ook ingesteld op true, waarmee wordt aangegeven dat de lokale runtime instellingen ontsleutelt voordat u ze gebruikt. Versleutel lokale instellingen om het risico te verminderen dat waardevolle informatie uit local.settings.json wordt gelekt. In Azure worden toepassingsinstellingen altijd versleuteld opgeslagen.

Lijst met func-instellingen

Hiermee wordt een lijst met instellingen in de Values verzameling uitgevoerd in het bestand local.settings.json.

func settings list

Verbinding maken iontekenreeksen uit de ConnectionStrings verzameling worden ook uitgevoerd. Standaard worden waarden gemaskeerd voor beveiliging. U kunt de --showValue optie gebruiken om de werkelijke waarde weer te geven.

De list actie ondersteunt de volgende optie:

Optie Beschrijving
--showValue Toont de werkelijke niet-ontmaskerde waarden in de uitvoer.

Lijst met func-sjablonen

Hiermee worden de beschikbare functiesjablonen (triggersjablonen) weergegeven.

De list actie ondersteunt de volgende optie:

Optie Beschrijving
--language Taal voor het filteren van geretourneerde sjablonen. Standaard wordt alle talen geretourneerd.