Dapr-Erweiterung für Azure Functions

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.

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

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

{
  "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.

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:

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.

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.

Problembehandlung

Dieser Abschnitt beschreibt, wie eine Behandlung vorgenommen werden kann, wenn Probleme bei der Verwendung der Dapr-Erweiterung für Azure Functions auftreten.

Stellen Sie sicher, dass Dapr in Ihrer Umgebung aktiviert ist

Wenn Sie Dapr-Bindungen und -Auslöser in Azure Functions verwenden und Dapr in Ihrer Umgebung nicht aktiviert ist, erhalten Sie unter Umständen die Fehlermeldung: Dapr sidecar isn't present. Please see (https://aka.ms/azure-functions-dapr-sidecar-missing) for more information. Um Dapr in Ihrer Umgebung zu aktivieren:

• Falls Ihre Azure-Function in Azure Container Apps bereitgestellt wurde, erfahren Sie mehr unter Dapr-Aktivierungsinstruktionen für die Dapr-Erweiterung für Azure Functions.

• Stellen Sie sicher, dass Ihre Bereitstellung der YAML-Konfiguration über die folgenden Anmerkungen verfügt, falls Ihre Azure Function in Kubernetes bereitgestellt wurde:

  annotations:
    ...
    dapr.io/enabled: "true"
    dapr.io/app-id: "functionapp"
    # You should only set app-port if you are using a Dapr trigger in your code.
    dapr.io/app-port: "<DAPR_APP_PORT>"
    ...
  

• Sollten Sie Ihre Azure Function lokal ausführen, führen Sie den folgenden Befehl aus, um sicherzugehen, dass Sie die Function App mit Dapr ausführen:

  dapr run --app-id functionapp --app-port <DAPR_APP_PORT>  --components-path <COMPONENTS_PATH> -- func host start 
  

Verifizieren Sie den App-Portwert in der Dapr-Konfiguration

Die Dapr-Erweiterung für Azure Functions startet standardmäßig einen HTTP-Server auf Port 3001. Sie können diesen Port mithilfe der DAPR_APP_PORT Umgebungsvariable konfigurieren.

Wenn Sie den falschen App-Portwert angeben während Sie eine Azure Functions-App ausführen, erhalten Sie möglicherweise die Fehlermeldung: The Dapr sidecar is configured to listen on port {portInt}, but the app server is running on port {appPort}. This may cause unexpected behavior. For more information, visit [this link](https://aka.ms/azfunc-dapr-app-config-error). Um diese Fehlermeldung zu lösen:

1. In den Dapr-Einstellungen Ihrer Container-App:

   • Wenn Sie einen Dapr-Trigger in Ihrem Code verwenden, stellen Sie sicher, dass der App-Port auf 3001 oder auf den Wert der DAPR_APP_PORT -Umgebungsvariable festgelegt ist.

   • Sollten Sie keinen Dapr-Trigger in Ihrem Code verwenden, stellen Sie sicher, dass der App-Port nicht festgelegt ist. Er sollte leer sein.

2. Stellen Sie sicher, dass Sie den richtigen App-Portwert in der Dapr-Konfiguration verwenden.

   • Geben Sie den App-Port in Bicep an, wenn Sie Azure Container Apps verwenden:

     DaprConfig: {
        ...
        appPort: <DAPR_APP_PORT>
        ...
     }
     

   • Legen Sie die dapr.io/app-port -Anmerkung fest, wenn Sie eine Kubernetes-Umgebung verwenden:

     annotations:
        ...
        dapr.io/app-port: "<DAPR_APP_PORT>"
        ...
     

   • Stellen Sie sicher, dass Sie --app-port festlegen, wenn Sie lokal entwickeln und die Funktions-App mit Dapr ausführen:

     dapr run --app-id functionapp --app-port <DAPR_APP_PORT> --components-path <COMPONENTS_PATH> -- func host start 
     

Nächste Schritte

Erfahren Sie mehr über Dapr.