AWS Cloud9 não está mais disponível para novos clientes. Os clientes atuais do AWS Cloud9 podem continuar usando o serviço normalmente. Saiba mais

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Como trabalhar com documentos de automação do Systems Manager

Com AWS Systems Manager, você tem visibilidade e controle de sua infraestrutura ativados AWS. O Systems Manager fornece uma interface de usuário unificada que você pode usar para visualizar dados operacionais de vários Serviços da AWS e automatizar tarefas operacionais em seus AWS recursos.

Um documento do Systems Manager define as ações que o Systems Manager realiza nas suas instâncias gerenciadas. Um documento de automação é um tipo de documento do Systems Manager que é usado para realizar tarefas comuns de manutenção e implantação. Isso inclui criar ou atualizar uma Amazon Machine Image (AMI). Este tópico descreve como criar, editar, publicar e excluir documentos de automação com o AWS Toolkit.

Suposições e pré-requisitos

Antes de começar, as seguintes condições devem ser atendidas:

IAMpermissões para documentos do Systems Manager Automation

Para criar, editar, publicar e excluir documentos de automação do Systems Manager, você deve ter um perfil de credenciais que contenha as permissões necessárias AWS Identity and Access Management (IAM). O documento de política a seguir define as IAM permissões necessárias que podem ser usadas em uma política principal.

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "ssm:ListDocuments",
                "ssm:ListDocumentVersions",
                "ssm:DescribeDocument",
                "ssm:GetDocument",
                "ssm:CreateDocument",
                "ssm:UpdateDocument",
                "ssm:UpdateDocumentDefaultVersion",
                "ssm:DeleteDocument"
            ],
            "Resource": "*"
        }
    ]
}

Para obter informações sobre como atualizar uma IAM política, consulte Criação de IAM políticas no Guia IAM do usuário.

Criar um novo documento de automação do Systems Manager

É possível criar um documento de automação em JSON ou YAML usando o AWS Toolkit. Quando você cria um documento de automação, ele é apresentado em um arquivo sem título. Você pode fornecer um nome ao seu arquivo e salvá-lo. No entanto, o arquivo não é carregado AWS até que você o publique.

Como publicar um documento de automação do Systems Manager

Depois de criar ou editar seu documento de automação no AWS Toolkit, você pode publicá-lo AWS no.

Editar um documento de automação do Systems Manager já existente

Você usa o AWS Explorer para encontrar documentos de automação existentes do Systems Manager. Quando você abre um documento existente, ele aparece como um arquivo sem título em um AWS Cloud9 editor. Você pode baixar três tipos de documento de automação:

Os únicos tipos de documentos que você pode atualizar AWS são aqueles que são de minha propriedade. Você também pode baixar documentos de automação que são compartilhados ou de propriedade da Amazon e editá-los no AWS Cloud9. No entanto, ao publicar em AWS, você deve criar um novo documento ou atualizar um documento existente de sua propriedade. Você não pode criar novas versões de documentos que tenham outro proprietário ou que sejam de propriedade da Amazon.

Para mais informações, consulte Documentos do AWS Systems Manager no Guia do usuário do AWS Systems Manager .

Depois de terminar a edição, você pode usar o comando AWS: Publish a new Systems Manager Document para criar um novo documento na AWS nuvem ou atualizar um documento existente de sua propriedade.

Como trabalhar com versões

Os documentos de automação do Systems Manager usam versões para gerenciamento de alterações. Com o AWS Toolkit, você pode definir a versão padrão do documento, que é a versão usada ao executar o documento.

Como excluir um documento de automação do Systems Manager

Você pode excluir os documentos de automação que você possui no AWS Toolkit. A exclusão de um documento de automação exclui o documento e todas as versões do documento.

Como executar um documento de automação do Systems Manager

Depois que seu documento de automação for publicado no AWS, você poderá executá-lo para realizar tarefas em seu nome no seu Conta da AWS. Para executar seu documento de automação, você usa o AWS Management Console, o Systems Manager APIs AWS CLI, o ou AWS Tools for PowerShell o. Para obter instruções sobre como executar um documento de automação, consulte Executar uma automação simples no Guia do usuário do AWS Systems Manager .

Como alternativa, se você quiser usar um dos AWS SDKs com o Systems Manager APIs para executar seu documento de automação, consulte as AWS SDKreferências.