Share via

Compilar e testar runbooks

  • Artigo

Importante

Esta versão do Orchestrator chegou ao fim do suporte. Recomendamos que você atualize para o Orchestrator 2022.

O runbook Designer é a ferramenta que você usa para criar, gerenciar e executar runbooks. Você também pode executar runbooks e exibir seus status no Console de Orquestração.

Para criar um runbook, arraste as atividades para o workspace. As atividades são os blocos de construção de runbooks. Em geral, atividades individuais realizam três ações:

  • Acessar dados publicados

  • Realizam alguma ação

  • Publicam novos dados

Para obter mais informações sobre os tipos de atividades, consulte Controlar atividades de runbook.

Painéis do Runbook Designer

A interface do Runbook Designer é organizada nos quatro painéis a seguir.

Painel Descrição
Conexões A estrutura de pastas na qual você pode organizar fluxos de trabalho no sistema Orchestrator e editar permissões em pastas. Também fornece acesso a Runbook Servers e Configurações Globais.
Workspace do Runbook Designer O workspace em que você cria runbooks do Orchestrator. Os runbooks na seleção de pasta no painel Connections são listados como guias na parte superior do workspace. Quando você seleciona uma guia em um runbook, ela é exibida no workspace runbook Designer.
Atividades Contém todas as atividades disponíveis (atividades padrão ou disponíveis em pacotes de integração) para uso em runbooks. Arraste as atividades do painel Atividades para o workspace Design e as vincule para formar runbooks.
Log Registros que mostram a atividade e o histórico do runbook atual. Para obter mais informações, consulte Logs do Orchestrator.

Classificando atividades por nome da atividade e nome da categoria

O Orchestrator permite classificar atividades em ordem alfabética pelo nome da atividade ou pelo nome da categoria. Por padrão, as atividades são classificadas por categoria, como Controle de Runbook, Email, Gerenciamento de Arquivos, Monitoramento, Notificação, Agendamento, Sistema, Gerenciamento de Arquivos de Texto e Ferramentas.

Use as etapas a seguir para classificar as atividades pelo nome da atividade e pelo nome da categoria.

Classificar atividades em ordem alfabética pelo nome da atividade

  • No painel Atividades, clique com o botão direito do mouse em um nome de categoria para selecionar Todas as Atividades.

    As atividades são classificadas em ordem alfabética pelo nome da atividade.

Classificar atividades em ordem alfabética por nome da categoria

  • No painel Atividades, clique com o botão direito do mouse em um nome de categoria para selecionar Padrão.

    As atividades são classificadas em ordem alfabética pelo nome da categoria.

Alterando ícones

Você pode alterar o tamanho padrão de cada ícone de atividade de pequeno para grande clicando com o botão direito do mouse em um nome de atividade e selecionando Pequeno ou Grande.

Iniciar um runbook no Designer

Siga estas etapas para iniciar um runbook no Designer:

  1. No painel Connections, selecione a pasta Runbooks para ver os runbooks disponíveis.

  2. No workspace Design, selecione uma guia runbook.

  3. Se o runbook for Check-Out, selecione o botão Check In.

  4. No workspace Design, clique com o botão direito do mouse na guia runbook e selecione Executar.

  5. Na caixa de diálogo Iniciar Runbook , vá para a caixa Servidores de Runbook Disponíveis e selecione o servidor aplicável.

  6. Selecione o botão Seta para que o nome do servidor esteja agora na caixa Servidores runbook selecionados .

  7. Selecione Iniciar.

Interromper um trabalho do runbook Designer

Siga estas etapas para interromper um trabalho do runbook Designer:

  1. Selecione a guia Monitorar Runbook .

  2. Na barra de ferramentas, selecione Parar.

Testar seu runbook

Depois de criar um runbook, você pode testá-lo antes que ele seja executado em produção. Para testar, use o Runbook Tester iniciado no runbook Designer. O Runbook Tester permite executar o runbook para exibir os Dados Publicados de cada atividade. Você pode executar todo o runbook, percorrer cada atividade uma de cada vez ou definir pontos de interrupção em determinadas atividades.

Importante

O Runbook Tester realmente executa cada atividade no fluxo de trabalho. As etapas não são realizadas em um ambiente simulado ou virtualizado. Todas as conexões referenciadas no runbook são ativas e totalmente funcionais. Portanto, qualquer atividade que modifique ou destrua dados em sistemas conectados faz com que esses dados sejam modificados ou destruídos. Por exemplo, se você usar a atividade banco de dados de consulta para DROP TABLE ImportantTable, ele realmente excluirá a ImportantTable da instância do Microsoft SQL Server.

Importante

Note que a conta usada para iniciar o runbook precisa ter permissão no computador local para ser executada com êxito. Esses requisitos de permissão também se aplicam a testar o runbook com o Runbook Tester. Para testar com êxito seu runbook, inicie o runbook Designer como Administrador. Por associação, o Runbook Tester é executado como Administrador e usa o token de segurança de nível superior.

Testar um runbook

Siga estas etapas para testar um runbook:

  1. No runbook Designer, abra o runbook e, na barra de menus, selecione Runbook Tester.

  2. Se solicitado, selecione Sim para marcar o runbook.

  3. Para executar o runbook do início ao fim sem parar, selecione Executar para Ponto de Interrupção.

    Se você quiser percorrer uma atividade por vez, selecione Etapa.

  4. Exiba o painel Log para ver o status de conclusão de cada atividade. Para exibir os detalhes e Os Dados Publicados de uma atividade, selecione a atividade e selecione Mostrar Detalhes.

Definir um ponto de interrupção

Siga estas etapas para definir um ponto de interrupção:

  1. Selecione a atividade na qual definir o ponto de interrupção.

  2. Selecione Alternar Ponto de Interrupção.

  3. Selecione Executar para Ponto de Interrupção.

    Cada atividade até o ponto de interrupção é executada. O runbook pausa antes de executar a atividade com o ponto de interrupção.

  4. Para continuar até o final do runbook, selecione Executar para Ponto de Interrupção novamente ou para percorrer uma atividade de cada vez, selecione Etapa.

Próximas etapas