Udostępnij przez


Programowanie za pomocą harmonogramu zadań trwałych

Harmonogram zadań Durable Task Scheduler jest wysoce wydajnym, w pełni zarządzanym dostawcą zaplecza dla rozszerzenia Durable Functions z wbudowanym pulpitem nawigacyjnym monitorowania. Platforma Azure oferuje dwa zorientowane na deweloperów frameworki orkiestracji, które współpracują z Durable Functions w celu tworzenia aplikacji: Durable Task SDK i Durable Functions.

Z tego artykułu dowiesz się, jak:

  • Uruchamianie emulatora harmonogramu zadań trwałych
  • Wykonywanie operacji CRUD na harmonogramie i hubie zadań.

Dowiedz się więcej o funkcjach harmonogramu zadań Durable Task Scheduler, obsługiwanych regionach i planach.

Emulator harmonogramu zadań trwałych

Emulator odpornego harmonogramu zadań jest aktualnie dostępny tylko jako obraz platformy Docker.

  1. Pobierz obraz Dockera zawierający emulator.

    docker pull mcr.microsoft.com/dts/dts-emulator:latest
    
  2. Uruchom emulator.

    docker run -itP mcr.microsoft.com/dts/dts-emulator:latest
    

    To polecenie uwidacznia pojedyncze centrum zadań o nazwie default. Jeśli potrzebujesz więcej niż jednego centrum zadań, możesz ustawić zmienną środowiskową DTS_TASK_HUB_NAMES w kontenerze na rozdzielaną przecinkami listę nazw centrum zadań, na przykład w następującym poleceniu:

    docker run -itP -e DTS_TASK_HUB_NAMES=taskhub1,taskhub2,taskhub3 mcr.microsoft.com/dts/dts-emulator:latest
    

Wymagania wstępne

Konfigurowanie interfejsu wiersza polecenia

  1. Zaloguj się do interfejsu wiersza polecenia platformy Azure i upewnij się, że masz zainstalowaną najnowszą wersję.

    az login
    az upgrade
    
  2. Zainstaluj rozszerzenie interfejsu wiersza polecenia narzędzia Durable Task Scheduler.

    az extension add --name durabletask
    
  3. Jeśli zainstalowano już rozszerzenie interfejsu wiersza polecenia narzędzia Durable Task Scheduler, przeprowadź uaktualnienie do najnowszej wersji.

    az extension update --name durabletask
    
  4. Sprawdź zainstalowaną wersję:

    az extension show --name durabletask
    

Dowiedz się więcej o różnych az durabletask poleceniach, których można użyć.

Tworzenie harmonogramu i centrum zadań

  1. Utwórz grupę zasobów.

    az group create --name YOUR_RESOURCE_GROUP --location LOCATION
    
  2. Za pomocą rozszerzenia CLI durabletask utwórz harmonogram.

    az durabletask scheduler create --name "YOUR_SCHEDULER" --resource-group "YOUR_RESOURCE_GROUP" --location "LOCATION" --ip-allowlist "[0.0.0.0/0]" --sku-name "dedicated" --sku-capacity "1"
    

    Proces tworzenia może potrwać do 15 minut.

    Wynik

    {
        "id": "/subscriptions/YOUR_SUBSCRIPTION_ID/resourceGroups/YOUR_RESOURCE_GROUP/providers/Microsoft.DurableTask/schedulers/YOUR_SCHEDULER",
        "location": "northcentralus",
        "name": "YOUR_SCHEDULER",
        "properties": {
            "endpoint": "https://YOUR_SCHEDULER.northcentralus.durabletask.io",
            "ipAllowlist": [
                "0.0.0.0/0"
            ],
            "provisioningState": "Succeeded",
            "sku": {
                "capacity": 1,
                "name": "Dedicated",
                "redundancyState": "None"
            }
        },
        "resourceGroup": "YOUR_RESOURCE_GROUP",
        "systemData": {
            "createdAt": "2025-01-06T21:22:59Z",
            "createdBy": "YOUR_EMAIL@example.com",
            "createdByType": "User",
            "lastModifiedAt": "2025-01-06T21:22:59Z",
            "lastModifiedBy": "YOUR_EMAIL@example.com",
            "lastModifiedByType": "User"
        },
        "tags": {}
    }
    
  3. Utwórz centrum zadań.

    az durabletask taskhub create --resource-group YOUR_RESOURCE_GROUP --scheduler-name YOUR_SCHEDULER --name YOUR_TASKHUB
    

    Wynik

    {
      "id": "/subscriptions/YOUR_SUBSCRIPTION_ID/resourceGroups/YOUR_RESOURCE_GROUP/providers/Microsoft.DurableTask/schedulers/YOUR_SCHEDULERS/taskHubs/YOUR_TASKHUB",
      "name": "YOUR_TASKHUB",
      "properties": {
        "provisioningState": "Succeeded"
      },
      "resourceGroup": "YOUR_RESOURCE_GROUP",
      "systemData": {
        "createdAt": "2024-09-18T22:13:56.5467094Z",
        "createdBy": "OBJECT_ID",
        "createdByType": "User",
        "lastModifiedAt": "2024-09-18T22:13:56.5467094Z",
        "lastModifiedBy": "OBJECT_ID",
        "lastModifiedByType": "User"
      },
      "type": "microsoft.durabletask/scheduler/taskhubs"
    }
    
  1. W portalu Azure wyszukaj Durable Task Scheduler i wybierz go z wyników.

    Zrzut ekranu przedstawiający wyszukiwanie harmonogramu zadań trwałych w portalu.

  2. Kliknij przycisk Utwórz , aby otworzyć okienko Azure Functions: Durable Task Scheduler .

    Zrzut ekranu przedstawiający stronę tworzenia harmonogramu zadań trwałych.

  3. Wypełnij pola na karcie Podstawy. Kliknij Przejrzyj + utwórz.

    Uwaga / Notatka

    Jednostka SKU Zużycie jest obecnie dostępna w wersji zapoznawczej. Dowiedz się więcej o kombinacjach jednostek SKU i struktury aranżacji zalecanych do użycia w środowisku produkcyjnym.

  4. Po zakończeniu walidacji kliknij przycisk Utwórz.

    Wdrożenie może potrwać od około 15 do 20 minut.

Wyświetlanie wszystkich zasobów harmonogramu zadań trwałych w subskrypcji

  1. Pobierz listę wszystkich nazw harmonogramu w ramach subskrypcji, uruchamiając następujące polecenie.

    az durabletask scheduler list --subscription <SUBSCRIPTION_ID>
    
  2. Możesz zawęzić wyniki do określonej grupy zasobów, dodając flagę --resource-group .

    az durabletask scheduler list --subscription <SUBSCRIPTION_ID> --resource-group <RESOURCE_GROUP_NAME>
    

W portalu Azure wyszukaj Durable Task Scheduler i wybierz go z wyników.

Zrzut ekranu przedstawiający wyszukiwanie usługi Durable Task Scheduler w portalu.

Możesz wyświetlić listę zasobów harmonogramu utworzonych we wszystkich subskrypcjach, do których masz dostęp.

Wyświetlanie wszystkich centrów zadań w harmonogramie zadań trwałych

Pobierz listę centrów zadań w określonym harmonogramie, uruchamiając polecenie:

az durabletask taskhub list --resource-group <RESOURCE_GROUP_NAME> --scheduler-name <SCHEDULER_NAME>

Wszystkie centra zadań utworzone w harmonogramie można zobaczyć w sekcji Przegląd zasobu w portalu Azure.

Zrzut ekranu przedstawiający kartę przeglądu narzędzia Durable Task Scheduler w portalu.

Usuwanie harmonogramu i centrum zadań

  1. Usuń harmonogram:

    az durabletask scheduler --resource-group YOUR_RESOURCE_GROUP --scheduler-name YOUR_SCHEDULER
    
  2. Usuń centrum zadań:

    az durabletask taskhub delete --resource-group YOUR_RESOURCE_GROUP --scheduler-name YOUR_SCHEDULER --name YOUR_TASKHUB
    
  1. Otwórz zasób harmonogramu w witrynie Azure Portal i kliknij pozycję Usuń:

    Zrzut ekranu przedstawiający zasób harmonogramu w portalu z wyróżnionym przyciskiem do usuwania.

  2. Znajdź harmonogram z centrum zadań, które chcesz usunąć, a następnie kliknij w tym centrum zadań. Kliknij pozycję Usuń:

    Zrzut ekranu przedstawiający zasób centrum zadań w portalu z wyróżnionym przyciskiem usuwania.

Konfigurowanie uwierzytelniania opartego na tożsamościach dla aplikacji w celu uzyskania dostępu do narzędzia Durable Task Scheduler

Trwały harmonogram zadań obsługuje tylko uwierzytelnianie tożsamości zarządzanej przypisanej przez użytkownika lub przypisaną przez system . Zalecane są tożsamości przypisane przez użytkownika, ponieważ nie są one powiązane z cyklem życia aplikacji i mogą być ponownie używane po anulowaniu aprowizacji aplikacji.

Dowiedz się więcej o dostępie opartym na tożsamościach w narzędziu Durable Task Scheduler.

Uzyskiwanie dostępu do pulpitu nawigacyjnego narzędzia Durable Task Scheduler

Przypisz wymaganą rolę do tożsamości dewelopera (e-mail), aby uzyskać dostęp do pulpitu nawigacyjnego narzędzia Durable Task Scheduler.

Następne kroki

Aby używać rozszerzenia Durable Task Scheduler z rozszerzeniami Durable Functions:

W przypadku używania harmonogramu zadań Durable Task z zestawami SDK Durable Task: