Dapr-Erweiterung für Azure-Funktionen

Die Dapr-Erweiterung für Azure-Funktionen ist eine Reihe von Tools und Diensten, mit denen Entwickler Azure-Funktionen problemlos in die Dapr-Plattform (Distributed Application Runtime) integrieren können.

Azure Functions ist ein ereignisgesteuerter Computedienst, der eine Reihe von Triggern und Bindungen bereitstellt, um problemlos eine Verbindung mit anderen Azure-Diensten herzustellen. Dapr bietet eine Reihe von Bausteinen und bewährten Methoden zum Erstellen verteilter Anwendungen, einschließlich Microservices, Statusverwaltung, Pub/Sub Messaging und mehr.

Mit der Integration zwischen Dapr und Funktionen können Sie Funktionen erstellen, die auf Ereignisse von Dapr oder externen Systemen reagieren.

Maßnahme	Richtung	Typ
Trigger für eine Dapr-Eingabebindung	N/A	daprBindingTrigger
Auslösen eines Aufrufs eines Dapr-Diensts	N/A	daprServiceInvocationTrigger
Auslösen eines Dapr-Themenabonnements	N/A	daprTopicTrigger
Abrufen des Dapr-Zustands für eine Ausführung	In	daprState
Abrufen von geheimen Dapr-Schlüsseln für eine Ausführung	In	daprSecret
Speichern eines Werts in einem Dapr-Zustand	Out	daprState
Aufrufen einer anderen Dapr-App	Out	daprInvoke
Veröffentlichen einer Nachricht in einem Dapr-Thema	Out	daprPublish
Senden eines Werts an eine Dapr-Ausgabebindung	Out	daprBinding

Installieren der Erweiterung

Das zu installierende NuGet-Erweiterungspaket hängt vom C# -Modus im Prozess- oder isolierten Arbeitsprozess ab, den Sie in Ihrer Funktions-App verwenden:

In-Process
Isolierter Prozess

Diese Erweiterung ist verfügbar, indem Sie das NuGet-Paket, Version 1.0.0, installieren.

Verwenden der .NET CLI:

dotnet add package Microsoft.Azure.WebJobs.Extensions.Dapr

Fügen Sie die Erweiterung zu Ihrem Projekt hinzu, indem Sie das NuGet-Paket, Version 1.0.0, installieren.

Verwenden der .NET CLI:

dotnet add package Microsoft.Azure.Functions.Worker.Extensions.Dapr

Installieren des Bundles

Um diese Bindungserweiterung in Ihrer App verwenden zu können, stellen Sie sicher, dass die host.json Datei im Stammverzeichnis Ihres Projekts diesen extensionBundle Verweis enthält:

{
    "version": "2.0",
    "extensionBundle": {
        "id": "Microsoft.Azure.Functions.ExtensionBundle",
        "version": "[4.0.0, 5.0.0)"
    }
}

In diesem Beispiel weist der version Wert des [4.0.0, 5.0.0) Funktionenhosts an, eine Bundleversion zu verwenden, die mindestens 4.0.0 aber kleiner ist als 5.0.0, die alle potenziellen Versionen von 4.x enthält. Diese Notation verwaltet Ihre App effektiv auf der neuesten verfügbaren Nebenversion des v4.x-Erweiterungspakets.

Wenn möglich, sollten Sie die neueste Hauptversion des Erweiterungspakets verwenden und der Laufzeit erlauben, die neueste Nebenversion automatisch zu verwalten. Sie können den Inhalt des neuesten Bundles auf der Releaseseite der Erweiterungspakete anzeigen. Weitere Informationen finden Sie unter Azure Functions-Erweiterungspakete.

Dapr-Aktivierung

Sie können Dapr mithilfe verschiedener [Argumente und Anmerkungen][dapr-args] basierend auf dem Laufzeitkontext konfigurieren. Sie können Dapr für Azure-Funktionen über zwei Kanäle konfigurieren:

Infrastructure as Code (IaC)-Vorlagen, wie in Bicep- oder Azure Resource Manager(ARM)-Vorlagen
Azure-Portal

Wenn Sie eine IaC-Vorlage verwenden, geben Sie die folgenden Argumente im properties Abschnitt der Container-App-Ressourcendefinition an.

Bicep
ARM

DaprConfig: {
  enabled: true
  appId: '${envResourceNamePrefix}-funcapp'
  appPort: 3001
  httpReadBufferSize: ''
  httpMaxRequestSize: ''
  logLevel: ''
  enableApiLogging: true
}

"DaprConfig": {
  "enabled": true,
  "appId": "${envResourceNamePrefix}-funcapp",
  "appPort": 3001,
  "httpReadBufferSize": "",
  "httpMaxRequestSize": "",
  "logLevel": "",
  "enableApiLogging": true
}

Die oben genannten Dapr-Konfigurationswerte gelten als Anwendungsbereichsänderungen. Wenn Sie eine Container-App im Modus mit mehreren Überarbeitungen ausführen, werden änderungen an diesen Einstellungen keine neue Revision erstellen. Stattdessen werden alle vorhandenen Überarbeitungen neu gestartet, um sicherzustellen, dass sie mit den meisten up-to-date-Werten konfiguriert sind.

Navigieren Sie beim Konfigurieren von Dapr über das Azure-Portal zu Ihrer Funktions-App, und wählen Sie "Dapr " im linken Menü aus:

Screenshot, der zeigt, wo sie die Dapr-Aktivierung für eine Funktions-App im Azure-Portal finden.

Dapr-Ports und Listener

Wenn Sie eine Funktion von Dapr auslösen, macht die Erweiterung den Port 3001 automatisch verfügbar, um eingehende Anforderungen vom Dapr-Sidecar abzuhören.

Von Bedeutung

Port 3001 wird nur verfügbar gemacht und überwacht, wenn ein Dapr-Trigger in der Funktions-App definiert ist. Bei Verwendung von Dapr wartet das Sidecar auf den Empfang einer Antwort vom definierten Port, bevor die Instanziierung abgeschlossen wird. Definieren Sie die dapr.io/port Anmerkung nicht, oder --app-port es sei denn, Sie haben einen Trigger. Auf diese Weise kann Ihre Anwendung vom Dapr-Sidecar gesperrt werden.

Wenn Sie nur Eingabe- und Ausgabebindungen verwenden, muss der Port 3001 nicht verfügbar gemacht oder definiert werden.

Wenn Azure Functions standardmäßig versucht, mit Dapr zu kommunizieren, ruft sie Dapr über den von der Umgebungsvariablen DAPR_HTTP_PORTaufgelösten Port auf. Wenn diese Variable null ist, wird standardmäßig portiert 3500.

Sie können die von Eingabe- und Ausgabebindungen verwendete Dapr-Adresse überschreiben, indem Sie die DaprAddress Eigenschaft für function.json die Bindung (oder das Attribut) festlegen. Standardmäßig wird es verwendet http://localhost:{DAPR_HTTP_PORT}.

Die Funktions-App macht weiterhin einen anderen Port und Endpunkt für Dinge wie HTTP-Trigger verfügbar, die lokal standardmäßig auf 7071, aber in einem Container standardmäßig verwendet werden 80.

Bindungstypen

Die für .NET unterstützten Bindungstypen hängen sowohl vom Erweiterungsversions- als auch vom C#-Ausführungsmodus ab. Dies kann eine der folgenden Sein:

In-Process-Klassenbibliothek
Isolierter Prozess

Eine In-Process-Klassenbibliothek ist eine kompilierte C#-Funktion, die im gleichen Prozess wie die Funktionslaufzeit ausgeführt wird.

Die Dapr-Erweiterung unterstützt Parametertypen gemäß der folgenden Tabelle.

Binding	Parametertypen
Dapr-Trigger	daprBindingTrigger daprServiceInvocationTrigger daprTopicTrigger
Dapr-Eingabe	daprState daprSecret
Dapr-Ausgabe	daprState daprInvoke daprPublish daprBinding

Beispiele für diese Typen finden Sie im GitHub-Repository für die Erweiterung.