Schnellstart: Konfigurieren einer Durable Functions-App für die Verwendung eines dauerhaften Aufgabenplanungsmoduls

Verwenden Sie den Durable Task Scheduler als Back-End für Ihre Durable Functions-Apps zum Speichern des Orchestrierungs- und Entitätslaufzeitzustands. In dieser Schnellstartanleitung klonen Sie ein Hello Cities-Beispiel, das bereits für die Verwendung des Durable Task Scheduler konfiguriert ist, führen Sie es lokal mit dem Emulator aus, und stellen Sie es dann für Azure bereit.

Voraussetzungen

dotnet add package Microsoft.Azure.Functions.Worker.Extensions.DurableTask.AzureManaged --prerelease

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

{
  "extensions": {
    "durableTask": {
      "hubName": "default",
      "storageProvider": {
        "type": "azureManaged",
        "connectionStringName": "DURABLE_TASK_SCHEDULER_CONNECTION_STRING"
      }
    }
  }
}

{
  "Values": {
    "DURABLE_TASK_SCHEDULER_CONNECTION_STRING": "Endpoint=http://localhost:8080;TaskHub=default;Authentication=None"
  }
}

Ausführen Ihrer App in Azure

Erstellen der erforderlichen Ressourcen

Erstellen Sie eine Instanz des langlebigen Aufgabenplaners und eine Azure Functions-App in Azure, indem Sie dem integrierten Ablauf zur Erstellung von Funktions-Apps folgen. Diese Oberfläche richtet automatisch identitätsbasierten Zugriff ein und konfiguriert die erforderlichen Umgebungsvariablen für die App für den Zugriff auf den Scheduler.

1. Navigieren Sie zum Blade für die Erstellung von Apps.

   

2. Im Blade Funktions-App erstellen (Flex-Verbrauch) geben Sie die Informationen auf der Registerkarte Grundlagen ein.

   

   Feld	Beschreibung
   Subscription	Wählen Sie Ihr Azure-Abonnement.
   Ressourcengruppe	Wählen Sie eine vorhandene Ressourcengruppe aus, oder klicken Sie auf "Neu erstellen", um eine neue zu erstellen.
   Name der Funktions-App	Erstellen Sie einen eindeutigen Namen für Ihre Funktions-App.
   Möchten Sie Code oder ein Containerimage bereitstellen?	Lassen Sie die Option "Code " ausgewählt.
   Region	Wählen Sie eine der unterstützten Regionen aus.
   Runtime-Stack	Wählen Sie die Laufzeit aus, die Sie für diese Schnellstartanleitung verwenden.
   Version	Wählen Sie Ihre Version des Runtimestapels aus.
   Instanzgröße	Wählen Sie eine Instanzgröße aus, oder verwenden Sie die Standardauswahl. Weitere Informationen zu Instanzengrößen.
   Zonenredundanz	Verlassen Sie die Standardeinstellung "Deaktiviert ".

3. Wählen Sie die Registerkarte "Dauerhafte Funktionen" aus .

4. Wählen Sie Azure managed: Durable Task Scheduler als Back-End-Anbieter für Ihre Durable Functions aus.

5. Erstellen Sie eine Scheduler-Ressource. Diese Aktion erstellt automatisch einen Aufgabenhub.

   

   Feld	Beschreibung
   Speicher-Back-End	Wählen Sie Azure managed: Durable Task Scheduler aus.
   Region	Stellen Sie sicher, dass die Bereiche der Planer- und Funktions-App identisch sind.
   Dauerhafter Aufgabenplaner	Verwenden Sie den angebotenen Zeitplannamen, oder klicken Sie auf "Neu erstellen", um einen benutzerdefinierten Namen zu erstellen.
   Plan	Wählen Sie den Preisplan aus, der ihrem Projekt am besten entspricht. Überprüfen Sie das Handbuch zum Auswählen eines Orchestrierungsframeworks , um zu ermitteln, welcher Plan für die Produktionsverwendung am besten geeignet ist.
   Kapazitätseinheiten	Gilt nur, wenn der Tarifplan "Dediziert" ausgewählt ist. Sie können bis zu 3 Kapazitätseinheiten auswählen.

6. Klicken Sie auf "Überprüfen" und "Erstellen ", um die Ressourcenerstellung zu überprüfen.

   Eine vom Benutzer zugewiesene verwaltete Identität mit der erforderlichen rollenbasierten Zugriffssteuerungsberechtigung (RBAC) wird automatisch erstellt und der Funktions-App hinzugefügt. In der Zusammenfassungsansicht finden Sie Informationen zur verwalteten Identitätsressource, z. B.:

   • Die zugewiesene Rolle (Mitwirkende an langlebigen Aufgabendaten)

   • Die Zuordnung, die sich auf die Ebene des Aufgabenhubs bezieht

     

7. Klicken Sie auf "Erstellen ", nachdem die Überprüfung bestanden wurde.

Die Ressourcenbereitstellung kann etwa 15 bis 20 Minuten dauern. Sobald dies abgeschlossen ist, können Sie Ihre App für Azure bereitstellen.

Bereitstellen Ihrer Funktions-App in Azure

1. Geben Sie in der Befehlspalette Azure Functions: Deploy to Function App ein und wählen Sie dann.

2. Wählen Sie die eben erstellte Funktions-App aus. Wenn Sie aufgefordert werden, vorherige Bereitstellungen zu überschreiben, wählen Sie Bereitstellen aus, um Ihren Funktionscode in der neuen Funktions-App-Ressource bereitzustellen.

3. Wenn die Bereitstellung abgeschlossen ist, wählen Sie View Output aus, um die Erstellungs- und Bereitstellungsergebnisse anzuzeigen, einschließlich der Azure Ressourcen, die Sie erstellt haben. Wenn Sie die Benachrichtigung übersehen haben, wählen Sie unten rechts das Glockensymbol aus, um sie erneut anzuzeigen.

   

Apps im Functions Premium-Plan

Wenn Ihre App im Functions Premium-Plan ausgeführt wird, aktivieren Sie nach der Bereitstellung die Einstellung zur Laufzeitskalierungsüberwachung, um sicherzustellen, dass Ihre App basierend auf der Last automatisch skaliert wird.

az resource update -g <resource_group> -n <function_app_name>/config/web --set properties.functionsRuntimeScaleMonitoringEnabled=1 --resource-type Microsoft.Web/sites

Testen Ihrer Funktionsanwendung

Führen Sie den folgenden Befehl aus, um die URL Ihrer Funktion abzurufen:

az functionapp function list --resource-group <RESOURCE_GROUP_NAME> --name <FUNCTION_APP_NAME>  --query '[].{Function:name, URL:invokeUrlTemplate}' --output json

Orchestrierungsstatus überprüfen

Überprüfen Sie den Status der Orchestrierungsinstanz und der Aktivitätsdetails im Dashboard "Durable Task Scheduler". Für den Zugriff auf das Dashboard müssen Sie sich anmelden.

1. Navigieren Sie im Portal zur Ressource "Durable Task Scheduler".

2. Wählen Sie einen Aufgabenhubnamen aus.

3. Wählen Sie im linken Menü Zugriffssteuerung (IAM) aus.

4. Klicken Sie auf "Hinzufügen" , um eine Rollenzuweisung hinzuzufügen.

   

5. Suchen Sie Mitwirkender an langlebigen Aufgabendaten, und wählen Sie die Rolle aus. Klicke auf Weiter.

   

6. Wählen Sie auf der Registerkarte " Mitglieder " für "Zugriff zuweisen"die Option "Benutzer", "Gruppe" oder "Dienstprinzipal" aus.

7. Klicken Sie für Mitglieder auf +Mitglieder auswählen.

8. Suchen Sie im Bereich "Mitglieder auswählen " nach Ihrem Namen oder Ihrer E-Mail:

   

9. Wählen Sie Ihre E-Mail aus, und klicken Sie auf die Schaltfläche " Auswählen ".

10. Klicken Sie auf "Überprüfen" und "Zuweisen ", um die Zuweisung der Rolle abzuschließen.

11. Nachdem die Rolle zugewiesen wurde, klicken Sie im linken Menü der Task Hub-Ressource auf "Übersicht ", und navigieren Sie zur Dashboard-URL im oberen Essentials-Abschnitt .

Bereinigen von Ressourcen

Wenn Sie die Ressourcen, die Sie zur Ausführung des Schnellstarts erstellt haben, nicht mehr benötigen, löschen Sie die Ressourcengruppe und alle zugehörigen Ressourcen, um Kosten in Ihrem Azure-Abonnement zu vermeiden.

Nächste Schritte

• Erfahren Sie mehr über das Dashboard "Durable Task Scheduler".
• Beheben Sie fehler, die beim Verwenden des durable Task Scheduler auftreten können.