Usar a experiência de design visual

Aprenda a criar, editar e executar fluxos de trabalho do runbook usando a experiência de design visual. Depois que seu fluxo de trabalho estiver pronto, você poderá salvá-lo ou exportá-lo. Você também pode usar a experiência de design visual para prototipagem rápida.

Criar um runbook

1. Faça login no console do Systems Manager Automation.

2. Escolha Criar runbook.

3. Na caixa Nome, insira um nome para o runbook, por exemplo, MyNewRunbook.

4. Ao lado do botão Design e Código, selecione o ícone de lápis e insira um nome para o seu runbook.

Agora você pode criar um fluxo de trabalho para seu novo runbook.

Desenvolver um runbook

Para criar um fluxo de trabalho de runbook usando a experiência de design visual, arraste uma ação de automação do navegador Ações para a tela, colocando-a onde desejar no fluxo de trabalho do seu runbook. Você também pode reordenar as ações em seu fluxo de trabalho arrastando-as para um local diferente. Quando você arrasta uma ação para a tela, uma linha aparece nos locais em que é possível soltar a ação no fluxo de trabalho. Após uma ação ser colocada na tela, seu código é gerado automaticamente e adicionado ao conteúdo do seu runbook.

Se você souber o nome da ação que deseja adicionar, use a caixa de pesquisa na parte superior do navegador Ações para encontrá-la.

Depois de soltar uma ação na tela, configure-a usando o painel Formulário à direita. Esse painel contém as guias Geral, Entradas, Saídas e Configuração para cada ação de automação ou ação de API que você coloca na tela. Por exemplo, a guia Geral consiste nas seguintes seções:

• O Nome da etapa identifica a etapa. Especifique um valor exclusivo para o nome da etapa.

• A Descrição ajuda você a descrever o que a ação está fazendo no fluxo de trabalho do seu runbook.

A guia Entradas contém campos que variam com base na ação. Por exemplo, a ação de automação aws:executeScript consiste nas seguintes seções:

• O Runtime é a linguagem que será usada para executar o script fornecido.

• O Manipulador é o nome da sua função. É necessário garantir que a função definida no manipulador tenha dois parâmetros: events e context. O runtime do PowerShell não é compatível com este parâmetro.

• O Script é um script incorporado que você deseja executar durante o fluxo de trabalho.

• (Opcional) O Anexo é para scripts autônomos ou arquivos.zip que podem ser invocados pela ação. Esse parâmetro é obrigatório para runbooks JSON.

A guia Saídas ajuda a especificar os valores que você deseja gerar de uma ação. Você pode referenciar valores de saída em ações posteriores do seu fluxo de trabalho ou gerar resultados de ações para fins de registro. Nem todas as ações terão uma guia Saídas porque nem todas as ações oferecem suporte a saídas. Por exemplo, a ação aws:pause não aceita saídas. Para ações que oferecem suporte a saídas, a guia Saídas consiste nas seguintes seções:

• O Nome é o nome a ser usado para o valor de saída. Você pode referenciar saídas em ações posteriores do seu fluxo de trabalho.

• O Seletor é uma string de expressão JSONPath que começa com "$." e é usada para selecionar um ou mais componentes em um elemento JSON.

• O Tipo é o tipo de dados para o valor de saída. Por exemplo, o tipo de dados String ou Integer.

A guia Configuração contém propriedades e opções que todas as ações de automação podem usar. A ação consiste nas seguintes seções:

• A propriedade Máximo de tentativas é o número tentativas de executar uma ação em caso de falha.

• A propriedade Tempo limite em segundos especifica o valor do tempo limite para uma ação.

• A propriedade É crítica determina se a falha na ação interrompe toda a automação.

• A propriedade Próxima etapa determina qual ação a automação executará em seguida no runbook.

• A propriedade Em falha determina qual ação a automação executará em seguida no runbook se a ação falhar.

• A propriedade Em cancelamento determina qual ação a automação executará em seguida no runbook se a ação for cancelada por um usuário.

Para excluir uma ação, você pode usar o backspace, a barra de ferramentas acima da tela ou clicar com o botão direito do mouse e escolher Excluir ação.

À medida que seu fluxo de trabalho cresce, ele pode não caber na tela. Para ajudar a ajustar o fluxo de trabalho à tela, tente uma das opções a seguir:

• Use os controles nos painéis laterais para redimensionar ou fechar os painéis.

• Use a barra de ferramentas na parte superior da tela para ampliar ou reduzir o gráfico do fluxo de trabalho.

Atualizar seu runbook

Você pode atualizar um fluxo de trabalho de runbook existente criando uma nova versão do seu runbook. As atualizações em seus runbooks podem ser feitas usando a experiência de design visual ou editando o código diretamente. Para atualizar um runbook existente, use o procedimento a seguir:

1. Faça login no console do Systems Manager Automation.

2. Escolha o runbook que deseja atualizar.

3. Escolha Create new version (Criar nova versão).

4. A experiência de design visual tem dois painéis: um painel de código e um painel de fluxo de trabalho visual. Escolha Design no painel de fluxo de trabalho visual para editar seu fluxo de trabalho com a experiência de design visual. Ao concluir, escolha Criar nova versão para salvar as alterações e sair.

5. (Opcional) Use o painel de código para editar o conteúdo do runbook em YAML ou JSON.

Exportar seu runbook

Para exportar o código YAML ou JSON do fluxo de trabalho do seu runbook e também um gráfico do seu fluxo de trabalho, use o procedimento a seguir:

1. Escolha seu runbook no console Documentos.

2. Escolha Create new version (Criar nova versão).

3. No menu suspenso Ações, escolha se você deseja exportar o gráfico ou o runbook, além do formato preferido.