Migrar trabalhos do Agendador do Azure para Aplicativos Lógicos do Azure

Importante

Os Aplicativos Lógicos do Azure substituíram o Agendador do Azure, que foi totalmente desativado desde 31 de janeiro de 2022. Migre os trabalhos do Agendador do Azure recriando-os como fluxos de trabalho nos Aplicativos Lógicos do Azure seguindo as etapas deste artigo. O Agendador do Azure não está mais disponível no portal do Azure. A API REST do Agendador do Azure e os cmdlets do PowerShell do Agendador do Azure deixaram de funcionar.

Este guia mostra como agendar trabalhos únicos e recorrentes criando fluxos de trabalho automatizados com os Aplicativos Lógicos do Azure, em vez de com o Agendador do Microsoft Azure. Ao criar trabalhos agendados com os Aplicativos Lógicos do Azure, você obtém os seguintes benefícios:

• Crie seu trabalho usando um designer visual e selecione entre mais de 1000 conectores prontos para uso, como Armazenamento de Blobs do Azure, Barramento de Serviço do Azure, Office 365 Outlook, SAP e muito mais.

• Gerencie cada fluxo de trabalho agendado como um recurso de primeira classe do Azure. Não é necessário se preocupar com o conceito de uma coleção de trabalhos, porque cada aplicativo lógico é um recurso individual do Azure.

• Execute vários trabalhos avulsos usando um só fluxo de trabalho de aplicativo lógico.

• Defina agendas que dão suporte a fusos horários e se ajustem automaticamente ao horário de verão (DST).

Para obter mais informações, consulte O que são os Aplicativos Lógicos do Azure? ou tente criar seu primeiro fluxo de trabalho de aplicativo lógico seguindo uma das seguintes etapas:

• Criar um exemplo de fluxo de trabalho de aplicativo lógico de consumo em Aplicativos Lógicos do Azure multilocatário

• Criar um exemplo de fluxo de trabalho de aplicativo lógico Standard nos Aplicativos Lógicos do Azure de locatário único

Pré-requisitos

• Uma conta e uma assinatura do Azure. Se você não tiver uma assinatura do Azure, inscreva-se em uma conta gratuita do Azure.

• Instale ou use uma ferramenta que possa enviar solicitações HTTP para testar sua solução, por exemplo:

  • Visual Studio Code com uma extensão do Visual Studio Marketplace
  • Invoke-RestMethod do PowerShell
  • Microsoft Edge – ferramenta Console de Rede
  • Bruno
  • curl

  Cuidado

  Para cenários em que você tem dados confidenciais, como credenciais, segredos, tokens de acesso, chaves de API e outras informações semelhantes, use uma ferramenta que proteja seus dados com os recursos de segurança necessários, funcione offline ou localmente, não sincronize seus dados com a nuvem e não exija que você entre em uma conta online. Dessa forma, você reduz o risco de expor dados confidenciais ao público.

Migração usando um script

Cada trabalho do Agendador é exclusivo, ou seja, não existe uma só ferramenta para migrar trabalhos do Agendador do Azure para os Aplicativos Lógicos do Azure. No entanto, você pode editar esse script para atender às suas necessidades.

Agendar um trabalho único

É possível executar vários trabalhos avulsos criando apenas um fluxo de trabalho de aplicativo lógico.

1. No portal do Azure, crie um recurso de aplicativo lógico e um fluxo de trabalho em branco.

2. Siga estas etapas gerais para adicionar o gatilho Solicitação chamado Quando uma solicitação HTTP for recebida.

3. No gatilho Solicitação, você pode, opcionalmente, fornecer um esquema JSON, que ajuda o Designer de Fluxo de Trabalho a entender a estrutura das entradas incluídas na chamada de entrada para o gatilho Solicitação e torna as saídas mais fáceis para você selecionar posteriormente em seu fluxo de trabalho.

   Insira o esquema na caixa Esquema JSON do Corpo da Solicitação, por exemplo:

   

   Se você não tem um esquema, mas tem um conteúdo de exemplo no formato JSON, você pode gerar um esquema com base nesse conteúdo.

   1. No gatilho de Solicitação, selecione Usar conteúdo de amostra para gerar o esquema.

   2. Em Inserir ou colar um conteúdo JSON de exemplo, forneça um conteúdo de exemplo e selecione Concluído, por exemplo:

      

      {
         "runat": "2012-08-04T00:00Z",
         "endpoint": "https://www.bing.com"
      }
      

4. No gatilho, adicione a ação Agendar chamada Atraso até

   Essa ação pausa a execução do fluxo de trabalho até uma data e hora especificadas, por exemplo:

   

5. Insira o carimbo de data/hora para quando você quiser iniciar o fluxo de trabalho.

   1. Selecione dentro da caixa Carimbo de data/hora e selecione a opção de lista de conteúdo dinâmico (ícone de relâmpago), que permite selecionar uma saída da operação anterior, que é o gatilho Solicitação neste exemplo.

   

6. Adicione outras ações que deseje executar selecionando entre os mais de 1000 conectores prontos para uso.

   Por exemplo, você pode incluir uma ação HTTP que envia uma solicitação para uma URL ou ações que funcionam com Filas de Armazenamento, filas do Barramento de Serviço ou tópicos do Barramento de Serviço:

   

7. Quando terminar, selecione Salvar na barra de ferramentas do designer.

   Quando você salva o fluxo de trabalho pela primeira vez, a URL do ponto de extremidade para o gatilho Solicitação do fluxo de trabalho é gerada e aparece na caixa URL HTTP POST, por exemplo:

   

   Para disparar manualmente o fluxo de trabalho com as entradas que você deseja que o fluxo de trabalho processe, você pode enviar uma solicitação HTTP para a URL do ponto de extremidade.

8. Copie e salve a URL do ponto de extremidade para que você possa testar seu fluxo de trabalho.

Testar seu fluxo de trabalho

Para disparar manualmente seu fluxo de trabalho, envie uma solicitação HTTP para a URL do ponto de extremidade no gatilho Solicitação do fluxo de trabalho. Com essa solicitação, inclua a entrada ou o conteúdo a ser enviado, que você pode ter descrito anteriormente especificando um esquema. Você pode enviar essa solicitação usando sua ferramenta de solicitação HTTP e suas instruções.

Por exemplo, você pode criar e enviar uma solicitação HTTP que usa o método esperado pelo gatilho Solicitação, por exemplo:

Método de solicitação	URL	Corpo	Cabeçalhos
POST	<endpoint-URL>	raw JSON(aplicativo/json) Na caixa raw, insira o conteúdo que você deseja enviar na solicitação. Observação: essa configuração define automaticamente os valores Cabeçalhos.	Chave: Content-Type Valor: aplicativo/json

Cancelar um trabalho único

Nos Aplicativos Lógicos do Azure, cada trabalho avulso é executado como uma instância de execução de aplicativo lógico individual. Para cancelar manualmente um trabalho único, você pode encontrar e copiar o valor de cabeçalho x-ms-workflow-run-id retornado na resposta do fluxo de trabalho e enviar outra solicitação HTTP com essa ID de execução de fluxo de trabalho para a URL do ponto de extremidade do fluxo de trabalho usando as seguintes APIs REST, com base em seu aplicativo lógico:

• Fluxos de trabalho de consumo: Execuções de fluxo de trabalho – Cancelar

• Fluxos de trabalho padrão: Execuções de fluxo de trabalho – Cancelar

Agendar trabalhos recorrentes

1. No portal do Azure, crie um recurso de aplicativo lógico e um fluxo de trabalho em branco.

2. Siga estas etapas gerais para adicionar o gatilho Agendar denominado de Recorrência.

3. Se desejar, configure um agendamento mais avançado.

   Para saber mais sobre opções de agendamento avançadas, veja Criar e executar tarefas e fluxos de trabalho recorrentes com o serviço de Aplicativos Lógicos do Azure.

4. Adicione outras ações que deseje executar selecionando entre os mais de 1000 conectores prontos para uso.

   Por exemplo, você pode incluir uma ação HTTP que envia uma solicitação para uma URL ou ações que funcionam com Filas de Armazenamento, filas do Barramento de Serviço ou tópicos do Barramento de Serviço:

   

5. Quando terminar, selecione Salvar na barra de ferramentas do designer.

Configuração avançada

As seções a seguir descrevem outras maneiras de personalizar seus trabalhos.

Política de Repetição

Para controlar a maneira como uma ação tenta ser executada novamente no fluxo de trabalho quando ocorrem falhas intermitentes, defina a política de repetição nas configurações de cada ação.

Manipular exceções e erros

No Agendador do Azure, se a ação padrão não for executada, será possível executar uma ação alternativa que resolva a condição de erro. Nos Aplicativos Lógicos do Azure, também é possível realizar a mesma tarefa. Para obter mais informações sobre o tratamento de exceções nos Aplicativos Lógicos do Azure, consulte Tratar erros e exceções – propriedade RunAfter.

1. No designer, acima da ação que você deseja manipular, adicione um branch paralelo.

2. Localize e selecione a ação que você deseja executa como a ação alternativa.

3. Na ação alternativa, localize e selecione a opção Configurar execução após.

4. Desmarque a caixa da propriedade for bem-sucedida. Selecione as propriedades chamadas falhou, foi ignorada e atingiu o tempo limite.

5. Quando tiver terminado, selecione Concluído.

Perguntas frequentes

P: Quando o Agendador do Microsoft Azure será desativado?
R: o Agendador do Azure foi totalmente desativado em 31 de janeiro de 2022. Para atualizações gerais, veja Atualizações do Azure – Agendador.

P: o que acontecerá com minhas coleções de trabalhos e meus trabalhos após a desativação do Agendador do Azure?
R: todas as coleções de trabalhos e os trabalhos do Agendador do Azure deixarão de ser executados e serão excluídos do sistema.

P: é necessário fazer backup ou executar outras tarefas antes de migrar meus trabalhos do Agendador do Azure para os Aplicativos Lógicos do Azure?
R: como melhor prática, sempre faça backup do seu trabalho. Verifique se os fluxos de trabalho criados estão sendo executados conforme o esperado antes de excluir ou desabilitar seus trabalhos do Agendador do Microsoft Azure.

P: O que acontecerá com meus Trabalhos Web do Azure agendados do Agendador do Microsoft Azure?
R: os WebJobs que usam essa maneira de agendar WebJobs não usam o Agendador do Azure internamente: "para que o agendamento funcione, ele exige que o site seja configurado como Always On e não seja um Agendador do Azure, mas uma implementação interna de um agendador". Os únicos WebJobs afetados são aqueles que usam especificamente o Agendador do Azure para executar o WebJob por meio da API do WebJobs. Você pode disparar esses WebJobs em um fluxo de trabalho de aplicativo lógico usando a ação HTTP.

P: há uma ferramenta que possa me ajudar a migrar os trabalhos do Agendador do Azure para os Aplicativos Lógicos do Azure?
R: cada trabalho do Agendador do Azure é exclusivo, ou seja, não existe uma ferramenta que funcione para todos os casos. No entanto, com base em suas necessidades, você pode editar esse script para migrar trabalhos do Agendador do Azure para o serviço de Aplicativos Lógicos do Azure.

P: onde posso obter suporte para a migração de trabalhos do Agendador do Azure?
R: veja algumas maneiras de obter suporte:

Portal do Azure

Se a assinatura do Azure tiver um plano de suporte pago, será possível criar uma solicitação de suporte técnico no portal do Azure. Caso contrário, será possível selecionar uma opção de suporte diferente.

1. No menu principal do Portal do Azure, selecione Ajuda + suporte.

2. No menu Suporte, selecione Nova solicitação de suporte. Forneça as seguintes informações sobre sua solicitação:

   Propriedade	Valor
   Tipo de problema	Técnico
   Assinatura	<sua-assinatura-Azure>
   Serviço	Em Monitoramento e gerenciamento, selecione Agendador. Se não encontrar Agendador, selecione Todos os serviços primeiro.

3. Escolha a opção de suporte desejada. Se tiver um plano de suporte pago, selecione Avançar.

Próximas etapas

• Criar um exemplo de fluxo de trabalho de aplicativo lógico de consumo em Aplicativos Lógicos do Azure multilocatário