do ArcGIS Notebook Server permitem implementar vários métodos de automação do fluxo de trabalho, incluindo automação por meio de notebooks agendados, webhooks e seus scripts personalizados usando a API administrativa de Executar Notebook.
Anotação:
Para automatizar um notebook usando tarefas agendadas, webhooks ou Executar API do Notebook, o notebook deve usar um tempo de execução da versão 3.0 ou posterior.
Agendar tarefas do notebook
Os autores de notebooks podem agendar o ArcGIS Notebooks para execução automatizada em um horário fixo no futuro, uma vez ou de forma recorrente. A criação de tarefas para agendar notebooks permite automatizar fluxos de trabalho de rotina, executar processos com uso intensivo de dados durante o horário de menor uso e atualizar regularmente conjuntos de dados. Por exemplo, você pode programar um notebook para fazer o seguinte:
- Importar dados de uma fonte online que atualizam mensalmente, limpa automaticamente os dados e aplica transformações necessárias, e move os dados para sua área de trabalho
- Executar um fluxo de trabalho de análise do big data que exija alta capacidade de processamento durante a noite, quando os recursos da sua máquina estiverem sem uso
- Gerenciar usuários que criaram contas na sua organização durante a semana passada e enviar a lista para você em um e-mail
Você pode criar uma ou mais tarefas para um notebook. Por padrão, o autor ou administrador do notebook pode criar no máximo 20 tarefas. Se a propriedade do notebook for alterada, todas as tarefas associadas a este notebook serão desativadas e atribuídas ao novo proprietário.
Tarefas agendadas permitem parametrizar notebooks. Quando um notebook é parametrizado, ele permite escrever um código genérico que pode ser adaptado a várias entradas sem sua interação. Os parâmetros escolhidos são inseridos no notebook quando uma tarefa é executada e, opcionalmente, podem ser salvos no notebook. Por exemplo, um notebook parametrizado pode ser usado para gerar relatórios de poluição do ar em toda a região de forma recorrente. O notebook pode ter várias tarefas agendadas, uma para cada região a ser estudada, e para cada tarefa, entradas parametrizadas, como nome da cidade e tipo de poluição, podem ser inseridas no notebook.
Anotação:
O número de tarefas do notebook em execução simultânea é limitado pela propriedade do sistema maxExecuteNotebookContainersPerNode no Notebook Server.
Você pode configurar a tarefa para salvar o estado do notebook no item original do notebook após a conclusão.
Uma visualização de HTML estática do notebook será salva para cada tarefa agendada que é executada.
Usando a janela Gerenciar tarefas na página inicial do ArcGIS Notebook Server ou a página Tarefas no ArcGIS Notebook Server Manager, os administradores podem visualizar detalhes, editar, pausar e retomar ou excluir cada tarefa ativa do notebook no site. Os administradores e autores do notebook com o privilégio de agendar notebook podem visualizar detalhes, editar, pausar e retomar ou excluir uma tarefa do notebook na página de detalhes do notebook ou no painel de tarefas do editor de notebook.
Se uma execução anterior de uma tarefa ainda estiver em execução, uma nova execução de tarefa agendada será ignorada. Por exemplo, se uma tarefa for agendada para ser executada a cada 15 minutos, mas uma instância dessa tarefa for executada por 20 minutos, a próxima execução agendada será ignorada. Se isso ocorrer regularmente, o proprietário da tarefa deverá ajustar o intervalo de tempo agendado para que não haja sobreposição entre as execuções.
Para mais informações sobre as tarefas agendadas do notebook, consulte o tópico de ajuda Agendar uma tarefa do notebook.
Limites de tarefas agendadas
Há determinados limites de nível do usuário, organizacional e de site do ArcGIS Notebook Server (máquina) relacionados a tarefas agendadas do notebook.
Alterar o máximo de execuções simultâneas automatizadas do notebook (maxExecuteNotebookContainersPerNode)
Quando um notebook é executado por uma tarefa agendada, webhook ou pela API de Execute Notebook, os do ArcGIS Notebook Serverabrem automaticamente uma nova de contêiner e executam o notebook sem interação do usuário. Por padrão, os do ArcGIS Notebook Serverestão configurados para realizar no máximo 10 execuções simultâneas de notebook por cada do Notebook Server. Considerando os recursos (CPU e RAM) disponíveis em cada máquina do site Notebook Server, um administrador pode ajustar esse limite modificando a propriedade do sistema maxExecuteNotebookContainersPerNode no Notebook Server. Qualquer solicitação de notebook automatizado enviada após esse limite ser excedido será adicionada a uma fila e executada quando o número de execuções de tarefas automatizadas ficar abaixo desse limite. As tarefas enfileiradas falharão se o tempo de espera exceder o tempo limite.
Anotação:
Isso não limita o número de notebooks executados interativamente no editor de notebook.
Você pode alterar o limite de maxExecuteNotebookContainersPerNode seguindo as etapas abaixo.
Anotação:
Aumentar o limite pode resultar em recursos adicionais usados em de máquina do Notebook Server.
- Entre no seu portal do ArcGIS Enterprise como um administrador.
- Abra o ArcGIS Notebook Server Manager.
- Clique em Configurações > Site.
- Altere o valor da propriedade maxExecuteNotebookContainersPerNode.
- Clique em Salvar.
- Revise o aviso sobre a reinicialização do Notebook Server e clique em Salvar e Reiniciar para salvar as alterações.
Máximo de tarefas agendadas do notebook ativas por usuário
Cada autor de notebook com privilégio de agendar notebooks pode criar no máximo 20 tarefas ativas de notebook. Quando esse limite for atingido, o usuário não poderá criar novas tarefas agendadas. Uma nova tarefa pode ser criada quando uma tarefa existente muda de Ativa para Concluída, Com Falha ou Inativa. Este limite pode ser alterado atualizando a propriedade ExecuteNotebooksUserLimit utilizando a operação Atualizar Limites do Sistema no ArcGIS Portal Administrator API.
Máximo de tarefas agendadas do notebook ativas por organização
O número máximo de tarefas agendadas do notebook ativas para uma organização é limitado a 200. Este limite representa o número total de tarefas ativas que podem ser de propriedade de todos os usuários de uma organização. Quando esse limite for atingido, os usuários não poderão criar novas tarefas de notebook agendadas. Este limite pode ser alterado atualizando a operação Atualizar Limites do Sistema de ExecuteNotebooksOrgLimit no ArcGIS Portal Administrator API.
Número de resultados relatados para uma tarefa agendada
Os resultados de uma tarefa são relatados e mantidos por 30 execuções. Qualquer tarefa executada antes das 30 execuções mais recentes de uma tarefa será excluída permanentemente. Este limite pode ser alterado atualizando a propriedade TaskRunHistoryCount utilizando a operação Atualizar Limites do Sistema no ArcGIS Portal Administrator API.
Falha automática de uma tarefa
Quaisquer tarefas que falharem cinco vezes consecutivas serão automaticamente alteradas para um estado de falha e não serão mais executadas. O proprietário da tarefa deve garantir que o notebook possa ser executado com sucesso sem qualquer interação do usuário antes de reativar a tarefa. Para garantir que as tarefas continuem em execução, o proprietário da tarefa deve identificar e corrigir a falha e alterar a tarefa para o estado Ativo. Este limite pode ser alterado atualizando a propriedade FailedRunsDisableTask utilizando a operação Atualizar Limites do Sistema no ArcGIS Portal Administrator API.
Executar API do Notebook
Os administradores e autores do notebook também podem automatizar um notebook para ser executado sem interação do usuário, usando a operação Executar Notebook no ArcGIS Notebook ServerAdministrator Directory. Essa operação executará automaticamente um notebook quando solicitada, mas usando um script personalizado, você pode agendá-la para ser executada automaticamente em um horário definido ou em um agendamento regular. Um trabalho cron ou agendador do Windows também pode ser usado para agendar a operação Executar Notebook para ser executada em um horário definido ou em um intervalo recorrente.
Para saber mais, consulte o tópico da operação Executar Notebook no guia de referência do Diretório de Administrador.