Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
O Agendador de Tarefas Duráveis é um provedor de back-end totalmente gerenciado de alto desempenho para Tarefa Durável com um painel de monitoramento pronto para uso. Azure oferece duas estruturas de orquestração orientadas para desenvolvedores que funcionam com o Durable Task Scheduler para criar aplicativos: SDKs de Tarefas Duráveis e Durable Functions.
Neste artigo, você aprenderá a:
- Executar o emulador do Agendador de Tarefas Duráveis
- Execute operações CRUD em um agendador e hub de tarefas.
Saiba mais sobre os recursos do Agendador de Tarefas Duráveis, regiões com suporte e planos.
Emulador do Agendador de Tarefas Durável
O emulador do Agendador de Tarefas Duráveis só está disponível como uma imagem do Docker hoje.
Baixe a imagem do Docker que contém o emulador.
docker pull mcr.microsoft.com/dts/dts-emulator:latestExecutar o emulador.
docker run -itP mcr.microsoft.com/dts/dts-emulator:latestEsse comando expõe um único hub de tarefas chamado
default. Se você precisar de mais de um hub de tarefas, poderá definir a variávelDTS_TASK_HUB_NAMESde ambiente no contêiner para uma lista delimitada por vírgulas de nomes de hub de tarefas, como no seguinte comando:docker run -itP -e DTS_TASK_HUB_NAMES=taskhub1,taskhub2,taskhub3 mcr.microsoft.com/dts/dts-emulator:latest
Pré-requisitos
Configurar a CLI
Entre no Azure e verifique se você tem a versão mais recente da CLI.
az login az upgradeInstale a extensão da CLI do Agendador de Tarefas Duráveis.
az extension add --name durabletaskSe você já instalou a extensão da CLI do Agendador de Tarefas Duráveis, atualize para a versão mais recente.
az extension update --name durabletaskVerifique sua versão instalada:
az extension show --name durabletask
Criar um agendador e um hub de tarefas
Crie um grupo de recursos.
az group create --name YOUR_RESOURCE_GROUP --location LOCATIONUsando a extensão da
durabletaskCLI, crie um agendador.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"O processo de criação pode levar até 15 minutos para ser concluído.
Output
{ "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": {} }Criar um hub de tarefas.
az durabletask taskhub create --resource-group YOUR_RESOURCE_GROUP --scheduler-name YOUR_SCHEDULER --name YOUR_TASKHUBOutput
{ "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" }
No portal do Azure, pesquise o Agendador de Tarefas Duráveis e selecione-o nos resultados.
Selecione Criar para abrir o painel Agendador de Tarefas Duráveis .
Preencha os campos na guia Noções básicas . Selecione Examinar + criar.
Depois que a validação for aprovada, selecione Criar.
A implantação pode levar cerca de 15 a 20 minutos.
Exibir todos os recursos do Agendador de Tarefas Duráveis em uma assinatura
Obtenha uma lista de todos os nomes de agendadores em uma assinatura por meio da execução do seguinte comando.
az durabletask scheduler list --subscription <SUBSCRIPTION_ID>Você pode restringir os resultados a um grupo de recursos específico adicionando o
--resource-groupsinalizador.az durabletask scheduler list --subscription <SUBSCRIPTION_ID> --resource-group <RESOURCE_GROUP_NAME>
No portal do Azure, pesquise o Agendador de Tarefas Duráveis e selecione-o nos resultados.
Você pode ver a lista de recursos do agendador criados em todas as assinaturas às quais você tem acesso.
Exibir todos os hubs de tarefas em um Agendador de Tarefas Duráveis
Recupere uma lista de hubs de tarefas em um agendador específico executando:
az durabletask taskhub list --resource-group <RESOURCE_GROUP_NAME> --scheduler-name <SCHEDULER_NAME>
Você pode ver todos os hubs de tarefas criados em um agendador na visão geral do recurso no portal do Azure.
Excluir um agendador e um hub de tarefas
Exclua primeiro o hub de tarefas:
az durabletask taskhub delete --resource-group YOUR_RESOURCE_GROUP --scheduler-name YOUR_SCHEDULER --name YOUR_TASKHUBExclua o agendador:
az durabletask scheduler delete --resource-group YOUR_RESOURCE_GROUP --scheduler-name YOUR_SCHEDULER
Abra o recurso do agendador no portal do Azure e selecione Delete:
Localize o agendador com o hub de tarefas que você deseja excluir e selecione esse hub de tarefas. Selecione Excluir:
Configurar a autenticação baseada em identidade para seu aplicativo acessar o Agendador de Tarefas Duráveis
O Agendador de Tarefas Duráveis dá suporte apenas à autenticação de identidade gerenciada usando identidades atribuídas pelo usuário ou atribuídas pelo sistema . As identidades atribuídas pelo usuário são recomendadas porque não estão vinculadas ao ciclo de vida do aplicativo e podem ser reutilizados depois que o aplicativo é desprovisionado.
Para conceder acesso ao aplicativo, atribua a função Colaborador de Dados da Tarefa Durável à identidade gerenciada. Para obter as etapas completas de instalação, consulte Configurar o acesso baseado em identidade no Agendador de Tarefas Duráveis.
Acessar o painel do Agendador de Tarefas Duráveis
Para acessar o painel do Agendador de Tarefas Duráveis, atribua a função Visualizador do Painel de Tarefas Duráveis à sua identidade de desenvolvedor. Para obter detalhes, consulte o painel do Agendador de Tarefas Duráveis.
Conteúdo relacionado
- Quickstart: configurar um aplicativo Durable Functions para usar o Agendador de Tarefas Duráveis
- Início Rápido: Criar um aplicativo com SDKs de Tarefas Duráveis e Agendador de Tarefas Duráveis
- Quickstart: hospedar um aplicativo SDK de Tarefa Durável em Aplicativos de Contêiner do Azure
- Cobrança do Agendador de Tarefas Duráveis
- Recursos e limitações do Agendador de Tarefas Duráveis