Criação dos seus próprios runbooks - AWS Systems Manager

Criação dos seus próprios runbooks

Um runbook do Automation define as ações que o Systems Manager realizará nas instâncias gerenciadas e outros recursos da AWS quando uma automação for executada. O Automation é um recurso do AWS Systems Manager. Um runbook contém uma ou mais etapas que são executadas em ordem sequencial. Cada etapa se baseia em uma única ação. A saída de uma etapa pode ser usada como entrada de uma etapa posterior.

O processo de execução dessas ações e suas etapas é chamado de automação.

Os tipos de ação compatíveis com runbooks permitem automatizar uma ampla variedade de operações em seu ambiente da AWS. Por exemplo, usando o tipo de ação executeScript, você pode incorporar um script do Python ou PowerShell diretamente em seu runbook. (Ao criar um runbook personalizado, você pode adicionar seu script em linha ou anexá-lo de um bucket do S3 ou de sua máquina local.) Você pode automatizar o gerenciamento de seus recursos do AWS CloudFormation usando os tipos de ação createStack e deleteStack. Além disso, usando o tipo de ação executeAwsApi, uma etapa pode executar qualquer operação de API em qualquer AWS service (Serviço da AWS), incluindo criar ou excluir recursos da AWS, iniciar outros processos, acionar notificações e muito mais.

Para obter uma lista de todos os 20 tipos de ação compatíveis com o Automation, consulte Referência de ações do Systems Manager Automation.

O AWS Systems Manager Automation inclui vários runbooks com etapas predefinidas que você pode usar para executar tarefas comuns, como reiniciar uma ou mais instâncias do Amazon Elastic Compute Cloud (Amazon EC2) ou criar uma Amazon Machine Image (AMI). Você também pode criar seus próprios runbooks de automação e compartilhá-los com outras contas da Contas da AWS ou torná-los públicos para todos os usuários do Automation.

Os runbooks são escritos em YAML ou JSON. No entanto, usando o Document Builder no console do Systems Manager Automation, você pode criar um runbook sem precisar criar em JSON ou YAML nativo.

Importante

Se você executar um fluxo de trabalho de automação que chama outros serviços usando uma função de serviço do AWS Identity and Access Management (IAM), esteja ciente de que esta função deve ser configurada com permissão para chamar esses serviços. Esse requisito aplica-se a todos os runbooks do Automation da AWS (runbooks da AWS-*), como os runbooks AWS-ConfigureS3BucketLogging, AWS-CreateDynamoDBBackup e AWS-RestartEC2Instance, entre outros. Esse requisito também se aplica a todos os runbooks personalizados do Automation criados que invoquem outros Serviços da AWS, usando ações que chamam outros serviços. Por exemplo, se você usar as ações aws:executeAwsApi, aws:createStack ou aws:copyImage, configure a função de serviço com permissão para invocar esses serviços. É possível habilitar permissões para outros Serviços da AWS, adicionando uma política em linha do IAM à função. Para ter mais informações, consulte (Opcional) Adicione uma política em linha ou uma política gerenciada pelo cliente para invocar outros Serviços da AWS.

Para obter informações sobre as ações que podem ser especificadas em um runbook, consulte Referência de ações do Systems Manager Automation.

Para obter informações sobre como usar o AWS Toolkit for Visual Studio Code para criar runbooks, consulteTrabalhar com documentos do Systems Manager Automation no Manual do usuário do AWS Toolkit for Visual Studio Code.

Para obter informações sobre como usar o designer visual para criar um runbook personalizado, consulte Experiência de design visual para runbooks de automação.

Sumário