Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Die Azure Functions CLI ist die nächste Hauptversion (v5) der lokalen Entwicklungslaufzeit und Tools für Azure Functions. Diese Version von func.exe verfügt über eine workloadbasierte Architektur, sodass Sie nur das herunterladen, was Sie für den von Ihnen entwickelten Stapel benötigen.
Important
Die Azure Functions CLI (v5) befindet sich derzeit in der Vorschau. Diese Vorschauversion unterstützt Java und PowerShell noch nicht. Um mit derzeit nicht unterstützten Sprachen zu arbeiten, verwenden Sie weiterhin Azure Functions Core Tools v4.
Es gibt zwei Versionen von func.exe, die für die lokale Entwicklung von Azure Functions verwendet werden:
| v4 | v5 | |
|---|---|---|
| API-Name | Azure Functions Core Tools | Azure Functions CLI |
| Supportstufe | Allgemeine Verfügbarkeit (GA) | Preview |
| Installationsgröße | Vollständige Binärdatei, die alle Befehle und Funktionen für alle nativen Sprachen enthält. | Kleine Basisinstallation sowie Workloads pro Sprache und andere Features, die Sie nach Bedarf hinzufügen. Der Host wird als eigene Workload ausgeliefert, sodass Sie die neueste Hostversion erhalten, ohne die CLI erneut herunterzuladen. |
| Verwenden Sie, wenn... | Sie benötigen vollständige GA-Unterstützung für alle Entwicklungsworkflows. | Sie möchten eine einfache, workloadbasierte Erfahrung mit neuen Features wie Schnellstartvorlagen und Profilen, die Ihre lokale Umgebung mit Ihrer Azure Hostingplankonfiguration synchronisieren. |
Informationen zur Befehlsreferenz finden Sie unter Azure Functions CLI-Referenz.
Beispiele sind derzeit mangels Unterstützung für den Sprach-Stack nicht verfügbar.
Installieren der Azure Functions CLI
Die Azure Functions CLI wird als kleine Basisinstallation sowie als Workloads bereitgestellt, die Sie für die Technologiestapel hinzufügen, in denen Sie entwickeln. Microsoft veröffentlicht Installer-Pakete für Windows, macOS und Linux. Nach der Installation befindet sich die func Binärdatei auf Ihrem PATH.
Note
Da die Azure Functions CLI derzeit als Vorschau verfügbar ist, installieren Sie die neueste Vorschauversion von der Seite mit den Azure Functions Core Tools-Versionen. Der endgültige Installationsleitfaden wird mit der allgemeinen Verfügbarkeitsversion veröffentlicht.
Überprüfen Sie die Installation:
func --version
Nachdem Sie die Basis-CLI installiert haben, installieren Sie die Workloads für Ihren Stapel. Am schnellsten geht es mit func setup, wodurch der Host, der Sprachworker, die Erweiterungsbundles (bei Bedarf), die Stack-Workload und die Vorlagen-Workload in einem Schritt installiert werden.
Beispiel:
func setup --features dotnet
func setup --features node
func setup --features python
func setup --features go
Sie können Workloads auch einzeln mithilfe von func workload install. In beiden Fällen fordert Sie die CLI beim ersten Ausführen von func init, func new oder func run auf, die erforderlichen Workloads zu installieren, wenn diese noch nicht installiert sind.
Workloads
Die Azure Functions CLI verwendet ein Workload-Modell. Die Basisinstallation func ist klein und sprachunabhängig. Sie installieren Workloads bei Bedarf, um Tools für den jeweiligen Stack, den Functions-Host, Sprachworker, Erweiterungsbundles und Vorlagen zu erhalten.
Workloads sind in diese Kategorien unterteilt:
-
Host: Die Azure Functions Hostlaufzeit, die
func runverwendet. - Bundles: Vorgefertigte Artefakte von Erweiterungspaketen, damit Trigger und Bindungen sofort funktionieren (erforderlich für Nicht-.NET-Stacks).
-
Stack: Sprachspezifisches Projekt-Tooling (zum Beispiel
python,node,dotnet). -
Worker: Der Sprachworker, den der Host zur Laufzeit verwendet (z. B.
python-worker,node-worker). -
Vorlagen: Funktionsvorlagen, die von
func newbereitgestellt werden (z. B.python-templates,node-templates).
Die vollständige Liste der verfügbaren Workloads und deren Beschreibungen finden Sie unter "Verfügbare Workloads " in der CLI-Referenz.
Erlebnis beim ersten Start
Wenn Sie zum ersten Mal die CLI ausführenfunc init, func newfunc runüberprüft die CLI, ob die für Ihr Szenario erforderlichen Workloads installiert sind. Falls das nicht der Fall ist, fordert Sie die CLI auf, diese zu installieren. Wenn Sie die Eingabeaufforderung akzeptieren, wird das empfohlene Paket für den von Ihnen gewählten Stack installiert. Sie können die Aufforderung ablehnen und Workloads manuell mit func workload install installieren oder func setup ausführen, um den Standardumfang ohne Benutzereingriff einzurichten.
Workload-Aktualisierungen
Führen Sie func workload search regelmäßig aus, um auf neu verfügbare Workloads zu prüfen. Verwenden Sie weiterhin Core Tools (v4) für nicht unterstützte Stapel oder wenn Sie bestimmte GA-Features von Core Tools benötigen.
Erstellen eines lokalen Projekts
Verwenden Sie den func init Befehl, um ein neues Funktionsprojekt zu erstellen.
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
Die --stack Option gibt an, welcher Sprachstapel verwendet werden soll. Die für diesen Stack installierte Workload stellt das Grundgerüst bereit.
Funktion erstellen
Verwenden Sie den func new Befehl, um eine Funktion aus einer Vorlage hinzuzufügen.
func new --template "HTTP trigger" --name MyHttpTrigger
Lokales Ausführen von Funktionen
Um den Functions-Host zu starten und Ihr Projekt auszuführen, verwenden Sie func run:
func run
func start wird als abwärtskompatibler Alias beibehalten. Der Host verwaltet Azurite (lokaler Speicher-Emulator) automatisch, es sei denn, Sie übergeben --no-azurite.
Gerüst aus Schnellstartvorlagen
Verwenden Sie func quickstart, um vollständige Beispiel-Apps (HTTP-APIs, Warteschlangenmitarbeiter, Durable Functions Orchestrierungen) zu durchsuchen und zu erstellen:
func quickstart --stack dotnet --resource http
func quickstart --stack node --resource http
func quickstart --stack python --resource http
func quickstart --stack go --resource http
Verwalten von Workloads
Verwenden Sie func workload, um Workloads zu installieren, zu aktualisieren und zu entfernen. Eine vollständige Liste der Unterbefehle und Optionen finden Sie in func workload der CLI-Referenz.
Profile
Profile codieren Versionsbeschränkungen für den Host, erweiterungsbündel und Worker. Ein Profil zur Laufzeit mithilfe von func run --profile <name> anwenden. Eine vollständige Liste der Unterbefehle und Optionen finden Sie in func profile der CLI-Referenz.