Usar Application Manager para gerenciar modelos do AWS CloudFormation

O Application Manager, um recurso do AWS Systems Manager, inclui uma biblioteca de modelos e outras ferramentas para ajudar você a gerenciar modelos do AWS CloudFormation. Esta seção inclui as seguintes informações:

Trabalhar com a biblioteca de modelos

A biblioteca de modelos do Application Manager fornece ferramentas para ajudar você a exibir, criar, editar, excluir e clonar modelos. Você também pode provisionar pilhas diretamente da biblioteca de modelos. Os modelos são armazenados como documentos do Systems Manager (SSM), do tipo CloudFormation. Ao armazenar modelos como documentos SSM, você poderá usar controles de versão para trabalhar com diferentes versões de um modelo. Você também pode definir permissões e compartilhar modelos. Depois de provisionar uma pilha com êxito, a pilha e o modelo estarão disponíveis no Application Manager e no CloudFormation.

Antes de começar

Recomendamos que você leia os tópicos a seguir para saber mais sobre os documentos SSM antes de começar a trabalhar com modelos do CloudFormation no Application Manager.

Criar modelos

O procedimento a seguir descreve como criar um modelo do CloudFormation no Application Manager. Ao criar um modelo, você insere os detalhes da pilha do modelo em JSON ou YAML. Se você não estiver familiarizado com JSON ou YAML, poderá usar o AWS CloudFormationDesigner, uma ferramenta para criar e modificar modelos de maneira visual. Para obter mais informações, consulte O que é o AWS CloudFormation Designer? no Guia do usuário do AWS CloudFormation. Para obter informações sobre a estrutura e a sintaxe de um modelo, consulte Template anatomy (Anatomia de um modelo).

Você também pode construir um modelo a partir de vários trechos do modelo. Os trechos do modelo fornecem exemplos que demonstram como criar modelos para um recurso específico. Por exemplo, é possível visualizar trechos de instâncias do Amazon Elastic Compute Cloud (Amazon EC2), domínios do Amazon Simple Storage Service (Amazon S3), mapeamentos do AWS CloudFormation e muito mais. Os trechos são agrupados por recurso. Você pode encontrar trechos do AWS CloudFormation para fins gerais, na seção Trechos de modelos gerais do Manual do usuário do AWS CloudFormation.

Criar um modelo do CloudFormation usando o Application Manager (console)

Use o procedimento a seguir para criar um novo modelo do CloudFormation no Application Manager, usando o AWS Management Console.

Criar um modelo do CloudFormation usando o Application Manager (linha de comando)

Depois de criar o conteúdo do modelo do CloudFormation no JSON ou no YAML, você poderá usar o AWS Command Line Interface (AWS CLI) ou AWS Tools for PowerShell para salvar o modelo como um documento do SSM. Substitua cada espaço reservado para recurso de exemplo por suas próprias informações.

Antes de começar

Instale e configure a AWS CLI ou o AWS Tools for PowerShell, caso ainda não o tenha feito. Para obter informações, consulte Instalar ou atualizar a versão mais recente da AWS CLI e Instalar o AWS Tools for PowerShell.

Linux & macOS

aws ssm create-document \
    --content file://path/to/template_in_json_or_yaml \
    --name "a_name_for_the_template" \
    --document-type "CloudFormation" \
    --document-format "JSON_or_YAML" \
    --tags "Key=tag-key,Value=tag-value"

Windows

aws ssm create-document ^
    --content file://C:\path\to\template_in_json_or_yaml ^
    --name "a_name_for_the_template" ^
    --document-type "CloudFormation" ^
    --document-format "JSON_or_YAML" ^
    --tags "Key=tag-key,Value=tag-value"

PowerShell

$json = Get-Content -Path "C:\path\to\template_in_json_or_yaml | Out-String
New-SSMDocument `
    -Content $json `
    -Name "a_name_for_the_template" `
    -DocumentType "CloudFormation" `
    -DocumentFormat "JSON_or_YAML" `
    -Tags "Key=tag-key,Value=tag-value"

Se houver êxito, o comando retornará uma resposta semelhante à seguinte.

{
    "DocumentDescription": {
        "Hash": "c1d9640f15fbdba6deb41af6471d6ace0acc22f213bdd1449f03980358c2d4fb",
        "HashType": "Sha256",
        "Name": "MyTestCFTemplate",
        "Owner": "428427166869",
        "CreatedDate": "2021-06-04T09:44:18.931000-07:00",
        "Status": "Creating",
        "DocumentVersion": "1",
        "Description": "My test template",
        "PlatformTypes": [],
        "DocumentType": "CloudFormation",
        "SchemaVersion": "1.0",
        "LatestVersion": "1",
        "DefaultVersion": "1",
        "DocumentFormat": "YAML",
        "Tags": [
            {
                "Key": "Templates",
                "Value": "Test"
            }
        ]
    }

Edite um modelo

Use o procedimento a seguir para editar um modelo do CloudFormation no Application Manager. As alterações do modelo estão disponíveis no CloudFormation depois de provisionar uma pilha que usa o modelo atualizado.