Nota
O acesso a esta página requer autorização. Podes tentar iniciar sessão ou mudar de diretório.
O acesso a esta página requer autorização. Podes tentar mudar de diretório.
O Durable Task Scheduler é um provedor de back-end de alto desempenho e totalmente gerenciado para funções duráveis com um painel de monitoramento pronto para uso. O Azure oferece duas estruturas de orquestração orientadas para desenvolvedores que funcionam com Funções Duráveis para criar aplicativos: SDKs de Tarefas Duráveis e Funções Duráveis.
Neste artigo, você aprende a:
- Execute o emulador do Durable Task Scheduler
- Execute operações CRUD em um agendador e hub de tarefas.
Saiba mais sobre os recursos do Agendador de Tarefas Duráveis, regiões suportadas e planos.
Emulador durável do Agendador de Tarefas
Atualmente, o emulador do Durable Task Scheduler só está disponível como uma imagem do Docker.
Puxe a imagem Docker que contenha o emulador.
docker pull mcr.microsoft.com/dts/dts-emulator:latestExecute o emulador.
docker run -itP mcr.microsoft.com/dts/dts-emulator:latestEste 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 como uma lista delimitada por vírgulas de nomes de hub de tarefas, como no comando a seguir:docker run -itP -e DTS_TASK_HUB_NAMES=taskhub1,taskhub2,taskhub3 mcr.microsoft.com/dts/dts-emulator:latest
Pré-requisitos
Configurar a CLI
Inicie sessão na CLI do Azure e certifique-se de que tem a mais recente instalada.
az login az upgradeInstale a extensão CLI do Durable Task Scheduler.
az extension add --name durabletaskSe você já instalou a extensão CLI do Durable Task Scheduler, atualize para a versão mais recente.
az extension update --name durabletaskVerifique a sua versão instalada:
az extension show --name durabletask
Saiba mais sobre os vários az durabletask comandos que pode usar.
Criar um agendador e um hub de tarefas
Crie um grupo de recursos.
az group create --name YOUR_RESOURCE_GROUP --location LOCATIONUsando a
durabletaskextensão CLI, 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.
Realização
{ "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": {} }Crie um hub de tarefas.
az durabletask taskhub create --resource-group YOUR_RESOURCE_GROUP --scheduler-name YOUR_SCHEDULER --name YOUR_TASKHUBRealização
{ "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, procure Agendador de Tarefas Duráveis e selecione-o nos resultados.
Clique em Criar para abrir o painel Azure Functions: Durable Task Scheduler .
Preencha os campos no separador Básico. Clique em Rever + criar.
Observação
O SKU de Consumo está atualmente em pré-visualização. Saiba mais sobre as combinações de SKU e framework de orquestração recomendadas para uso em produção.
Quando a validação for aprovada, clique em 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 executando o 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, procure 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ável
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 o agendador e o hub de tarefas
Exclua o agendador:
az durabletask scheduler --resource-group YOUR_RESOURCE_GROUP --scheduler-name YOUR_SCHEDULERExcluir um hub de tarefas:
az durabletask taskhub delete --resource-group YOUR_RESOURCE_GROUP --scheduler-name YOUR_SCHEDULER --name YOUR_TASKHUB
Abra o recurso do agendador no portal do Azure e clique em Excluir:
Localize o agendador com o hub de tarefas que você deseja excluir e clique nesse hub de tarefas. Clique em Excluir:
Configurar a autenticação baseada em identidade para o aplicativo acessar o Agendador de Tarefas Duráveis
O Agendador de Tarefas Durável suporta apenas a autenticação de identidade gerida atribuída ao utilizador ou ao sistema. As identidades atribuídas pelo usuário são recomendadas, pois não estão vinculadas ao ciclo de vida do aplicativo e podem ser reutilizadas depois que o aplicativo for desprovisionado.
Saiba mais sobre o acesso baseado em identidade no Agendador de Tarefas Duráveis.
Acesse o painel do Agendador de Tarefas Duráveis
Atribua a função necessária à sua identidade de desenvolvedor (e-mail) para obter acesso ao painel do Agendador de Tarefas Duráveis.
Próximos passos
Para usar o Agendador de Tarefas Durável com Funções Duráveis:
Para usar o Agendador de Tarefas Duráveis com os SDKs de Tarefas Duráveis: