Dapr-Erweiterung für Azure Functions

Artikel
05/21/2024

Die Dapr-Erweiterung für Azure Functions umfasst mehrere Tools und Dienste, mit denen Entwickler*innen Azure Functions problemlos mit der Dapr-Plattform (Distributed Application Runtime) integrieren können.

Azure Functions ist ein ereignisgesteuerter Computedienst, der mehrere Trigger und Bindungen bereitstellt, um das Herstellen von Verbindungen mit anderen Azure-Diensten zu vereinfachen. Dapr bietet eine Reihe von Bausteinen und bewährten Methoden zum Erstellen verteilter Anwendungen, einschließlich Microservices, Zustandsverwaltung, Pub/Sub-Messaging und mehr.

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

Aktion	Direction	Typ
Trigger für eine Dapr-Eingabebindung	Nicht zutreffend	daprBindingTrigger
Trigger bei einem Dapr-Dienstaufruf	Nicht zutreffend	daprServiceInvocationTrigger
Trigger bei einem Dapr-Themenabonnement	Nicht zutreffend	daprTopicTrigger
Ruft den Dapr-Zustand für eine Ausführung ab	In	daprState
Ruft Dapr-Geheimnisse für eine Ausführung ab	In	daprSecret
Speichert einen Wert in einem Dapr-Zustand	aus	daprState
Ruft eine andere Dapr-App auf	aus	daprInvoke
Veröffentlicht eine Nachricht in einem Dapr-Thema	aus	daprPublish
Sendet einen Wert an eine Dapr-Ausgabebindung	aus	daprBinding

Installieren der Erweiterung

Das NuGet-Erweiterungspaket, das Sie installieren, hängt vom C#-Modus (In-Process oder isolierter Workerprozess) ab, den Sie in Ihrer Funktions-App verwenden:

In-Process
Isolierter Prozess

Diese Erweiterungsversion wird verfügbar, wenn 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 Ihrem Projekt hinzu indem Sie die NuGet-Paket Version 1.0.0. installieren.

Verwenden der .NET-CLI:

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

Installieren des Pakets

Paket v4.x

Sie können die Erweiterung hinzufügen, indem Sie den folgenden Code in Ihrer host.json -Datei hinzufügen oder ersetzen:

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

Dapr-Aktivierung

Sie können Dapr mithilfe verschiedener [Argumente und Anmerkungen][dapr-args] auf Grundlage des Laufzeitkontexts konfigurieren. Sie können Dapr für Azure Functions über zwei Kanäle konfigurieren:

„Infrastructure-as-Code“Vorlagen (Infrastruktur als Code, IaC) wie in Bicep- oder Azure Resource Manager (ARM)-Vorlagen
Das Azure-Portal

Geben Sie beim Verwenden einer IaC-Vorlage 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 Änderungen des Anwendungsbereichs (application-scope). Wenn Sie eine Container-App im Multirevisionsmodus ausführen, führen Änderungen an diesen Einstellungen nicht zum Erstellen einer neuen Revision. Stattdessen werden alle vorhandenen Revisionen neu gestartet, um sicherzustellen, dass sie mit den aktuellsten Werten konfiguriert sind.

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

Ein Screenshot, der darstellt, wo die Dapr-Aktivierung für eine Funktions-App im Azure-Portal gefunden werden kann.

Dapr-Ports und -Listener

Wenn Sie eine Funktion aus Dapr auslösen, macht die Erweiterung den Port 3001 automatisch verfügbar, um auf eingehende Anforderungen vom Dapr-Sidecar zu lauschen.

Wichtig

Port 3001 wird nur verfügbar gemacht und überwacht, wenn in der Funktions-App ein Dapr-Trigger 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 Anmerkung dapr.io/port oder --app-port nur, wenn Sie einen Trigger haben. Andernfalls kann Ihre Anwendung vom Dapr-Sidecar gesperrt werden.

Wenn Sie nur Ein- 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 es Dapr über den aus der Umgebungsvariable DAPR_HTTP_PORT aufgelösten Port auf. Wenn diese Variable NULL ist, wird standardmäßig Port 3500 verwendet.

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

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

Bindungstypen

Die für .NET unterstützten Bindungstypen hängen sowohl von der Erweiterungsversion als auch von dem C#-Ausführungsmodus ab, der einer der folgenden sein kann:

In-Process-Klassenbibliothek
Isolierter Prozess

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

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

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

Beispiele für die Verwendung dieser Typen finden Sie im GitHub-Repository für die jeweilige Erweiterung.