Mover recursos entre pilhas - AWS CloudFormation

Mover recursos entre pilhas

Com o recurso resource import, é possível mover recursos entre pilhas ou refatorar pilhas. Primeiro, você precisa adicionar uma política de exclusão Retain ao recurso que você deseja mover para garantir que o recurso seja preservado ao removê-lo da pilha de origem e importá-lo na pilha de destino.

Importante

Nem todos os recursos são compatíveis com as operações de importação. Consulte Recursos compatíveis com as operações de importação antes de remover um recurso da pilha. Se você remover um recurso que não é compatível com operações de importação da pilha, não será possível importar o recurso para outra pilha ou trazê-lo de volta para a pilha de origem.

Refatorar uma pilha usando o AWS Management Console

  1. No modelo de origem, especifique uma DeletionPolicy Retain para o recurso que deseja mover.

    No modelo de origem de exemplo a seguir, Games é o destino desta refatoração.

    exemplo JSON

    { "AWSTemplateFormatVersion": "2010-09-09", "Description": "Import test", "Resources": { "ServiceTable":{ "Type":"AWS::DynamoDB::Table", "Properties":{ "TableName":"Service", "AttributeDefinitions":[ { "AttributeName":"key", "AttributeType":"S" } ], "KeySchema":[ { "AttributeName":"key", "KeyType":"HASH" } ], "ProvisionedThroughput":{ "ReadCapacityUnits":5, "WriteCapacityUnits":1 } } }, "GamesTable": { "Type": "AWS::DynamoDB::Table", "DeletionPolicy": "Retain", "Properties": { "TableName": "Games", "AttributeDefinitions": [ { "AttributeName": "key", "AttributeType": "S" } ], "KeySchema": [ { "AttributeName": "key", "KeyType": "HASH" } ], "ProvisionedThroughput": { "ReadCapacityUnits": 5, "WriteCapacityUnits": 1 } } } } }
  2. Abra o console do AWS CloudFormation para executar uma atualização de pilha para aplicar a política de exclusão.

    1. Na página Stacks (Pilhas) com a pilha selecionada, escolha Update (Atualizar).

    2. Em Prepare template (Preparar modelo), escolha Replace current template (Substituir modelo atual).

    3. Em Specify template (Especificar modelo), forneça o modelo de origem atualizado com o atributo DeletionPolicy na GamesTable e escolha Next (Próximo).

      • Escolha Amazon S3 URL (URL do Amazon S3) e especifique o URL para o modelo de origem atualizado na caixa de texto.

      • Escolha Upload a template file (Fazer upload de um arquivo de modelo) e procure o arquivo de modelo de origem atualizado.

    4. Na página Specify stack details (Especificar detalhes da pilha) nenhuma alteração é necessária. Escolha Next.

    5. Na página Configure stack options (Configurar opções de pilha) nenhuma alteração é necessária. Escolha Next.

    6. Na página Review (Revisar) stack_name revise suas alterações. Se o seu modelo contiver recursos do IAM, selecione I acknowledge that this template may create resources (Eu reconheço que este modelo pode criar recursos do IAM) para especificar que você deseja usar recursos do IAM no modelo. Para obter mais informações sobre o uso de recursos do IAM em modelos, consulte Controlar o acesso com o AWS Identity and Access Management. Depois, atualize sua pilha de origem criando um conjunto de alterações ou atualize sua pilha de origem diretamente.

  3. Remova o recurso, os parâmetros relacionados e as saídas do modelo de origem e adicione-os ao modelo de destino.

    O modelo de origem agora se parece com o seguinte.

    exemplo JSON

    { "AWSTemplateFormatVersion": "2010-09-09", "Description": "Import test", "Resources": { "ServiceTable":{ "Type":"AWS::DynamoDB::Table", "Properties":{ "TableName":"Service", "AttributeDefinitions":[ { "AttributeName":"key", "AttributeType":"S" } ], "KeySchema":[ { "AttributeName":"key", "KeyType":"HASH" } ], "ProvisionedThroughput":{ "ReadCapacityUnits":5, "WriteCapacityUnits":1 } } } } }

    O modelo de destino de exemplo a seguir tem atualmente o recurso PlayersTable e agora também contém GamesTable.

    exemplo JSON

    { "AWSTemplateFormatVersion": "2010-09-09", "Description": "Import test", "Resources": { "PlayersTable": { "Type": "AWS::DynamoDB::Table", "Properties": { "TableName": "Players", "AttributeDefinitions": [ { "AttributeName": "key", "AttributeType": "S" } ], "KeySchema": [ { "AttributeName": "key", "KeyType": "HASH" } ], "ProvisionedThroughput": { "ReadCapacityUnits": 5, "WriteCapacityUnits": 1 } } }, "GamesTable": { "Type": "AWS::DynamoDB::Table", "DeletionPolicy": "Retain", "Properties": { "TableName": "Games", "AttributeDefinitions": [ { "AttributeName": "key", "AttributeType": "S" } ], "KeySchema": [ { "AttributeName": "key", "KeyType": "HASH" } ], "ProvisionedThroughput": { "ReadCapacityUnits": 5, "WriteCapacityUnits": 1 } } } } }
  4. Repita as etapas 2–3 para atualizar a pilha de origem novamente, desta vez para excluir o recurso de destino da pilha.

  5. Execute uma operação de importação para adicionar GamesTable à pilha de destino.

    1. Na página Stacks (Pilhas), com a pilha pai selecionada, escolha Stack actions (Ações da pilha) e Import resources into stack (Importar recursos para a pilha).

      
                        A opção Importar recursos para a pilha no console.
    2. Leia a página Import overview (Visão geral da importação) para obter uma lista de itens que você deve fornecer durante esta operação. Em seguida, selecione Next (Próximo).

    3. Na página Specify template (Especificar modelo) siga um destes procedimentos e escolha Next (Próximo).

      • Escolha Amazon S3 URL (URL do Amazon S3) e especifique um URL na caixa de texto.

      • Escolha Upload a template file (Fazer upload de um arquivo de modelo) e procure um arquivo a ser carregado.

    4. Na página Identify resources (Identificar recursos) identifique o recurso que você está movendo (neste exemplo, GamesTable).

      1. Em Identifier property (Propriedade do identificador), escolha o tipo de identificador do recurso. Por exemplo, um recurso AWS::DynamoDB::Table pode ser identificado usando a propriedade TableName.

      2. Em Identifier value (Valor do identificador), digite o valor real da propriedade. Por exemplo, GamesTables.

        
                        A página Identificar recursos no console.
      3. Escolha Next (Próximo).

    5. Na página Specify stack details (Especificar detalhes da pilha), modifique os parâmetros e escolha Next (Próximo). Isso cria automaticamente um conjunto de alterações.

      Importante

      A operação de importação falhará se você modificar os parâmetros existentes que iniciam uma operação de criação, atualização ou exclusão.

    6. Na página Review stack_name (Review stack_name), confirme se o recurso correto está sendo importado e escolha Import resources (Importar recursos). Isso executa automaticamente o conjunto de alterações criado na última etapa. As tags no nível da pilha são aplicadas aos recursos importados no momento.

    7. O painel Events (Eventos) da página Stack details (Detalhes da pilha) de sua pilha pai será exibido.

      
                  A guia Eventos no console.
      nota

      Não é necessário executar a detecção de desvio na pilha pai após essa operação de importação, pois o recurso AWS::CloudFormation::Stack já é gerenciado pelo AWS CloudFormation.

Refatorar uma pilha usando a AWS CLI

  1. No modelo de origem, especifique uma DeletionPolicy Retain para o recurso que deseja mover.

    No modelo de origem de exemplo a seguir, GamesTable é o destino desta refatoração.

    exemplo JSON

    { "AWSTemplateFormatVersion": "2010-09-09", "Description": "Import test", "Resources": { "ServiceTable":{ "Type":"AWS::DynamoDB::Table", "Properties":{ "TableName":"Service", "AttributeDefinitions":[ { "AttributeName":"key", "AttributeType":"S" } ], "KeySchema":[ { "AttributeName":"key", "KeyType":"HASH" } ], "ProvisionedThroughput":{ "ReadCapacityUnits":5, "WriteCapacityUnits":1 } } }, "GamesTable": { "Type": "AWS::DynamoDB::Table", "DeletionPolicy": "Retain", "Properties": { "TableName": "Games", "AttributeDefinitions": [ { "AttributeName": "key", "AttributeType": "S" } ], "KeySchema": [ { "AttributeName": "key", "KeyType": "HASH" } ], "ProvisionedThroughput": { "ReadCapacityUnits": 5, "WriteCapacityUnits": 1 } } } } }
  2. Atualize a pilha de origem para aplicar a política de exclusão ao recurso.

    update-stack --stack-name "source-stack-name"
  3. Remova o recurso, os parâmetros relacionados e as saídas do modelo de origem e adicione-os ao modelo de destino.

    O modelo de origem agora se parece com o seguinte.

    exemplo JSON

    { "AWSTemplateFormatVersion": "2010-09-09", "Description": "Import test", "Resources": { "ServiceTable":{ "Type":"AWS::DynamoDB::Table", "Properties":{ "TableName":"Service", "AttributeDefinitions":[ { "AttributeName":"key", "AttributeType":"S" } ], "KeySchema":[ { "AttributeName":"key", "KeyType":"HASH" } ], "ProvisionedThroughput":{ "ReadCapacityUnits":5, "WriteCapacityUnits":1 } } } } }

    O modelo de destino de exemplo a seguir tem atualmente o recurso PlayersTable e agora também contém GamesTable.

    exemplo JSON

    { "AWSTemplateFormatVersion": "2010-09-09", "Description": "Import test", "Resources": { "PlayersTable": { "Type": "AWS::DynamoDB::Table", "Properties": { "TableName": "Players", "AttributeDefinitions": [ { "AttributeName": "key", "AttributeType": "S" } ], "KeySchema": [ { "AttributeName": "key", "KeyType": "HASH" } ], "ProvisionedThroughput": { "ReadCapacityUnits": 5, "WriteCapacityUnits": 1 } } }, "GamesTable": { "Type": "AWS::DynamoDB::Table", "DeletionPolicy": "Retain", "Properties": { "TableName": "Games", "AttributeDefinitions": [ { "AttributeName": "key", "AttributeType": "S" } ], "KeySchema": [ { "AttributeName": "key", "KeyType": "HASH" } ], "ProvisionedThroughput": { "ReadCapacityUnits": 5, "WriteCapacityUnits": 1 } } } } }
  4. Atualize a pilha de origem para excluir o recurso GamesTable e os parâmetros relacionados, além das saídas da pilha.

    aws cloudformation update-stack --stack-name "source-stack-name"
  5. Crie um conjunto de alterações do tipo IMPORT com os seguintes parâmetros. O --resources-to-import não é compatível com o YAML incorporado.

    > aws cloudformation create-change-set --stack-name TargetStack --change-set-name ImportChangeSet --change-set-type IMPORT --resources-to-import "[{\"ResourceType\":\"AWS::DynamoDB::Table\",\"LogicalResourceId\":\"GamesTable\",\"ResourceIdentifier\":{\"TableName\":\"Games\"}}]" --template-body file://templateToImport.json

    A AWS CLI também oferece suporte a arquivos de texto como entrada para o parâmetro resources-to-import, conforme exibido no exemplo a seguir.

    --resources-to-import: file://resourcesToImport.txt

    Nesta demonstração, file://resourcesToImport.txt contém o seguinte.

    [ { "ResourceType":"AWS::DynamoDB::Table", "LogicalResourceId":"GamesTable", "ResourceIdentifier": { "TableName":"Games" } } ]
  6. Revise o conjunto de alterações para certificar-se de que o recurso correto está sendo importado para a pilha de destino.

    > aws cloudformation describe-change-set --change-set-name ImportChangeSet
  7. Execute o conjunto de alterações para importar o recurso para a pilha de destino. As tags no nível da pilha são aplicadas aos recursos importados no momento. Após a conclusão com êxito da operação (IMPORT_COMPLETE), o recurso será importado com êxito.

    > aws cloudformation execute-change-set --change-set-name ImportChangeSet
    nota

    Não é necessário executar a detecção de desvio na pilha de destino após a operação de importação porque o recurso já está gerenciado pelo AWS CloudFormation.