Usar o Application Manager para gerenciar pilhas do AWS CloudFormation - AWS Systems Manager
Criar uma pilhaAtualizar uma pilha

Usar o Application Manager para gerenciar pilhas do AWS CloudFormation

O Application Manager, um recurso do AWS Systems Manager, ajuda você a provisionar e gerenciar recursos para suas aplicações integrando-se ao AWS CloudFormation. Você pode criar, editar e excluir modelos e pilhas do CloudFormation no Application Manager. Uma pilha é um conjunto de recursos da AWS que você pode gerenciar como uma unidade. Isso significa que você pode criar, atualizar ou excluir uma coleção de recursos da AWS usando pilhas do CloudFormation. O modelo é um arquivo de texto formatado no JSON ou YAML que especifica os recursos que você quer provisionar nas pilhas. Esta seção inclui as seguintes informações:

Criar uma pilha

O procedimento a seguir descreve como criar uma pilha do CloudFormation usando o Application Manager. Uma pilha é baseada em um modelo. Ao criar uma pilha, você poderá escolher um modelo existente ou criar um novo. Depois de criar a pilha, o sistema tenta imediatamente criar os recursos identificados nela. Depois que o sistema provisionar os recursos com êxito, o modelo e a pilha estarão disponíveis para visualização e edição no Application Manager e no CloudFormation

nota

Não há nenhum custo para usar o Application Manager na criação de uma pilha, mas você será cobrado pelos recursos da AWS criados na pilha.

Criar uma pilha do CloudFormation usando o Application Manager (console)

Use o procedimento a seguir para criar uma pilha usando o Application Manager no AWS Management Console.

Para criar uma pilha do CloudFormation

  1. Abra o console AWS Systems Manager em https://console.aws.amazon.com/systems-manager/.

  2. No painel de navegação, escolha Application Manager.

  3. Na seção Applications (Aplicações), selecione CloudFormation stacks (Pilhas do CloudFormation).

  4. Na seção Prepare a template (Preparar um modelo), escolha uma opção. Se escolher Use an existing template (Usar um modelo existente), você poderá usar as guias na seção Choose a template (Escolher um modelo) para localizar o modelo que você quiser.. Se você escolher uma das outras opções, conclua o assistente para preparar um modelo.

  5. Na página Specify template details (Especificar detalhes do modelo), verifique os detalhes do modelo para garantir que o processo crie os recursos desejados.

    • (Opcional) Na seção Tags, aplique um ou mais pares de nome/valor de chave de tag ao modelo.

    • Tags são metadados opcionais que você atribui a um recurso. Usando tags, você pode categorizar um recurso de diferentes formas, como por finalidade, proprietário ou ambiente.

    • Escolha Próximo.

  6. Na página Edit stack details (Editar detalhes da pilha), para Stack name (Nome da pilha), insira um nome que ajude a identificar os recursos criados pela pilha ou pela sua finalidade.

    • A seção Parameters (Parâmetros) inclui todos os parâmetros opcionais e obrigatórios especificados no modelo. Insira um ou mais parâmetros em cada campo.

    • (Opcional) Na seção Tags, aplique um ou mais pares de nome/valor de chave de tag à pilha.

    • (Opcional) Na seção Permissions (Permissões), especifique um nome de função (IAM) do AWS Identity and Access Management ou um nome do recurso da Amazon (ARN) do IAM. O sistema usa a função de serviço especificada para criar todos os recursos especificados em sua pilha. Se você não especificar uma função do IAM, o AWS CloudFormation usará uma sessão temporária que o sistema gera a partir de suas credenciais de usuário. Para obter mais informações sobre essa função do IAM, consulte Função de serviço do AWS CloudFormation no Manual do usuário do AWS CloudFormation.

    • Escolha Próximo.

  7. Na página Review and provision (Análise e provisão), examine todos os detalhes da pilha. Escolha um botão Edit (Editar) nesta página para fazer alterações.

  8. Selecione Provision stack (Provisionar pilha).

O Application Manager exibe a página CloudFormation stacks (Pilhas do CloudFormation) e o status da criação e implantação da pilha. Se o CloudFormation não conseguir criar e provisionar a pilha, consulte os tópicos a seguir no Manual do usuário do AWS CloudFormation.

Após os recursos de pilha serem provisionados e executados, os usuários podem editar recursos diretamente usando o serviço subjacente que o criou. Por exemplo, um usuário pode usar o console do Amazon Elastic Compute Cloud (Amazon EC2) para atualizar uma instância de servidor que foi criada como parte de uma pilha do CloudFormation. Algumas mudanças podem ser acidentais e algumas podem ser feitas intencionalmente para responder a eventos operacionais sensíveis ao tempo. Independentemente disso, as alterações feitas fora do CloudFormation podem complicar as operações de atualização ou exclusão de pilha. Você pode usar o status do desvio para identificar os recursos da pilha para os quais as alterações de configuração foram feitas fora do gerenciamento do CloudFormation. Para obter informações sobre status de desvios, consulte Detectar alterações de configuração não gerenciadas para pilhas e recursos.

Criar uma pilha do CloudFormation usando o Application Manager (linha de comando)

Use o seguinte procedimento da AWS Command Line Interface(AWS CLI) para provisionar uma pilha usando um modelo do CloudFormation armazenado como um documento do SSM no Systems Manager. Substitua cada espaço reservado para recurso de exemplo por suas próprias informações. Para obter informações sobre outros procedimentos da AWS CLI para criar pilhas, consulte Criar uma pilha no Manual do usuário do AWS CloudFormation.

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 cloudformation create-stack \
    --stack-name a_name_for_the_stack \
    --template-url "ssm-doc://arn:aws:ssm:Region:account_ID:document/template_name" \
Windows
aws cloudformation create-stack ^
     --stack-name a_name_for_the_stack ^
     --template-url "ssm-doc://arn:aws:ssm:Region:account_ID:document/template_name" ^
PowerShell
New-CFNStack `
    -StackName "a_name_for_the_stack" `
    -TemplateURL "ssm-doc://arn:aws:ssm:Region:account_ID:document/template_name" `

Atualizar uma pilha

Você pode implantar atualizações em uma pilha do CloudFormation editando diretamente a pilha no Application Manager. Com uma atualização direta, você especifica atualizações para um modelo ou parâmetros de entrada. Depois de salvar e implantar as alterações, o CloudFormation atualiza os recursos da AWS de acordo com as alterações que você especificou.

Você pode visualizar as alterações que o CloudFormation fará em sua pilha antes de atualizá-la, usando conjuntos de alterações. Para obter mais informações, consulte Atualizar pilhas usando conjuntos de alterações no Manual do usuário do AWS CloudFormation.

Para atualizar uma pilha do CloudFormation no Application Manager

  1. Abra o console AWS Systems Manager em https://console.aws.amazon.com/systems-manager/.

  2. No painel de navegação, escolha Application Manager.

  3. Na seção Applications (Aplicações), selecione CloudFormation stacks (Pilhas do CloudFormation).

  4. Escolha uma pilha na lista e escolha Actions (Ações), Update stack (Atualizar pilha).

  5. Na página Specify template source (Especificar origem do modelo), escolha uma das seguintes opções e selecione Next (Próximo).

    • Selecione Use the template code currently provisioned in the stack (Usar o código de modelo provisionado atualmente na pilha) para exibir um modelo. Use a lista Versions (Versões) para selecionar um modelo de versão e escolha Next (Próximo).

    • Selecione Switch to a different template (Alternar para um modelo diferente) para escolher ou criar um novo modelo para a pilha.

  6. Após terminar de fazer as alterações no modelo, selecione Next (Próximo).

  7. Na página Edit stack details (Editar detalhes da pilha), você pode editar parâmetros, tags e permissões. Não é possível mudar o nome de uma pilha. Faça suas alterações e escolha Next (Salvar).

  8. Na página Review and provision (Análise e provisão), examine todos os detalhes da pilha e escolha Provision stack (Provisionar pilha).