Notitie
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen u aan te melden of de directory te wijzigen.
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen de mappen te wijzigen.
De Azure Functions CLI is de volgende primaire versie (v5) van de lokale ontwikkelruntime en hulpprogramma's voor Azure Functions. Deze versie van func.exe bevat een architectuur op basis van workloads, zodat u alleen downloadt wat u nodig hebt voor de stack waarop u ontwikkelt.
Important
De Azure Functions CLI (v5) is momenteel als preview beschikbaar. Deze previewversie ondersteunt nog geen Java en PowerShell. Om te werken met momenteel niet ondersteunde talen, blijf je Azure Functions Core Tools v4 gebruiken.
Er zijn twee versies van func.exe gebruikt voor lokale Azure Functions ontwikkeling:
| v4 | v5 | |
|---|---|---|
| API-naam | Azure Functions Core Tools | Azure Functions CLI |
| Ondersteuningsniveau | Algemene beschikbaarheid (GA) | Voorvertoning |
| Installatiegrootte | Volledig binair systeem dat alle commando's en mogelijkheden voor alle moedertalen bevat. | Kleine basisinstallatie, plus workloads per taal en andere functies die je indien nodig toevoegt. De host wordt geleverd als een eigen workload, zodat u de nieuwste hostversie krijgt zonder de CLI opnieuw te downloaden. |
| Gebruiken wanneer... | U hebt volledige GA-ondersteuning nodig voor alle ontwikkelwerkstromen. | U wilt een lichtgewicht, workloadgebaseerde ervaring met nieuwe functies, zoals quickstartsjablonen en profielen die uw lokale omgeving synchroon houden met de configuratie van uw Azure hostingabonnement. |
Zie Azure Functions CLI-naslagwerk voor het naslagwerk voor opdrachten.
Voorbeelden zijn momenteel niet beschikbaar vanwege gebrek aan taalstackondersteuning.
De Azure Functions CLI installeren
De Azure Functions CLI wordt gedistribueerd als een kleine basisinstallatie plus workloads die u toevoegt voor de stacks waarin u ontwikkelt. Microsoft publiceert installatiepakketten voor Windows, macOS en Linux. Na de installatie bevindt het func binaire bestand zich op uw PATH.
Note
Terwijl de Azure Functions CLI in preview is, installeert u de meest recente preview-versie vanaf de Azure Functions core tools-releasespagina. Definitieve installatierichtlijnen worden gepubliceerd met de release voor algemene beschikbaarheid.
Controleer de installatie:
func --version
Nadat u de basis-CLI hebt geïnstalleerd, installeert u de workloads voor uw stack. De snelste manier is func setup, waarmee de host, de taalwerker, de uitbreidingsbundels (indien nodig), de stackworkload en de workload sjablonen in één stap worden geïnstalleerd.
Voorbeeld:
func setup --features dotnet
func setup --features node
func setup --features python
func setup --features go
U kunt workloads ook afzonderlijk installeren met behulp van func workload install. Hoe dan ook, de eerste keer dat u uitvoert func init, func newof func run zonder dat de benodigde workloads zijn geïnstalleerd, wordt u door de CLI gevraagd deze te installeren.
Workloads
De Azure Functions CLI maakt gebruik van een workloadmodel. De basisinstallatie func is klein en taalneutraal. U installeert workloads op aanvraag om stackspecifieke hulpprogramma's, de Functions-host, taalwerkers, extensiebundels en sjablonen op te halen.
Workloads worden onderverdeeld in deze categorieën:
-
Host: de Azure Functions hostruntime die
func rungebruikt. - Bundles: Vooraf gebouwde artefacten van uitbreidingsbundels, zodat triggers en bindingen direct werken (vereist voor niet-.NET-technologiestacks).
-
Stack: Taalspecifieke projecthulpprogramma's (bijvoorbeeld
python,node,dotnet). -
Worker: de taalworker die de host tijdens runtime gebruikt (bijvoorbeeld
python-worker,node-worker). -
Sjablonen: Functiesjablonen die worden weergegeven door
func new(bijvoorbeeldpython-templates,node-templates).
Zie Beschikbare workloads in de CLI-verwijzing voor de volledige lijst met beschikbare workloads en de bijbehorende beschrijvingen.
First-run-ervaring
De eerste keer dat u de CLI uitvoert func init, func newof func runde CLI controleert of de vereiste workloads voor uw scenario zijn geïnstalleerd. Als dat niet zo is, wordt u door de CLI gevraagd deze te installeren. Als u de prompt accepteert, wordt de aanbevolen set geïnstalleerd voor de stack die u hebt gekozen. U kunt de prompt weigeren en workloads handmatig installeren met behulp van func workload install, of uitvoeren func setup om de standaardset niet-interactief in te richten.
Updates van werklast
Voer func workload search regelmatig uit om te controleren op nieuw beschikbare workloads. Ga door met het gebruik van Core Tools (v4) voor niet-ondersteunde stacks of wanneer u specifieke GA-functies van Core Tools nodig hebt.
Een lokaal project maken
Gebruik de func init opdracht om een nieuw Functions-project te maken.
func init MyProjFolder --stack dotnet
func init MyProjFolder --stack node --language javascript
func init MyProjFolder --stack node --language typescript
func init MyProjFolder --stack python
func init MyProjFolder --stack go
De --stack optie geeft aan welke taalstack moet worden gebruikt. De geïnstalleerde workload voor die stack levert de basisstructuur.
Een functie maken
Als u een functie uit een sjabloon wilt toevoegen, gebruikt u de func new opdracht.
func new --template "HTTP trigger" --name MyHttpTrigger
Functies lokaal uitvoeren
Als u de Functions-host wilt starten en uw project wilt uitvoeren, gebruikt u func run:
func run
func start blijft behouden als een achterwaarts compatibele alias. De host beheert automatisch Azurite (lokale opslagemulator) tenzij u doorgeeft --no-azurite.
Scaffold van quickstart-sjablonen
Gebruik func quickstart om volledige voorbeeld-apps (HTTP-API's, wachtrijwerkers, Durable Functions-orchestraties) te bekijken en te genereren:
func quickstart --stack dotnet --resource http
func quickstart --stack node --resource http
func quickstart --stack python --resource http
func quickstart --stack go --resource http
Workloads beheren
Gebruik func workload dit om workloads te installeren, bij te werken en te verwijderen. Zie de CLI-verwijzing voor de volledige lijst met subopdrachten en opties func workload .
Profiles
Profielen coderen versiebeperkingen voor de host, extensiebundels en werkrollen. Een profiel tijdens runtime toepassen met behulp van func run --profile <name>. Zie de CLI-verwijzing voor de volledige lijst met subopdrachten en opties func profile .