Refatorar uma pilha usando o AWS Management Console Refatorar uma pilha usando o AWS CLI

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.

Se você não tiver familiaridade com a importação, recomendamos que primeiro revise as informações introdutórias no tópico Importe recursos da AWS para uma pilha do CloudFormation com uma importação de recursos.

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

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
                }
            }
        }
    }
}

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 Preparar modelo, escolha 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 Próximo.
5. Na página Configure stack options (Configurar opções de pilha) nenhuma alteração é necessária. Escolha Próximo.
6. Na página Analisar SourceStackName, analise as alterações. Se o seu modelo contém recursos do IAM, selecione I acknowledge that this template may create IAM 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.

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
                }
            }
        }
    }
}

Repita as etapas 2 e 3 para atualizar a pilha de origem novamente, desta vez para excluir o recurso de destino da pilha.
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).
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, escolha 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). Para ter mais informações, consulte Identificadores de recursos.
  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.
  3. Escolha 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 Analisar TargetStackName, confirme se o recurso correto está sendo importado e, em seguida, escolha Importar recursos. Isso inicia automaticamente o conjunto de alterações criadas 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.
  
  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 o AWS CLI

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
                }
            }
        }
    }
}

Atualize a pilha de origem para aplicar a política de exclusão ao recurso.
```
aws cloudformation update-stack --stack-name SourceStackName
```

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
                }
            }
        }
    }
}

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 SourceStackName
```
Componha uma lista com os recursos reais a serem importados e os identificadores exclusivos no formato de string JSON apresentado a seguir. Para ter mais informações, consulte Identificadores de recursos.
```
[{"ResourceType":"AWS::DynamoDB::Table","LogicalResourceId":"GamesTable","ResourceIdentifier":{"TableName":"Games"}}]
```
Como alternativa, é possível especificar os parâmetros formatados em JSON em um arquivo de configuração.

Por exemplo, para importar GamesTable, é possível criar um arquivo ResourcesToImport.txt que contém a configuração apresentada a seguir.
```
[
  {
      "ResourceType":"AWS::DynamoDB::Table",
      "LogicalResourceId":"GamesTable",
      "ResourceIdentifier": {
        "TableName":"Games"
      }
  }
]
```
Para criar um conjunto de alterações, use o comando create-change-set, apresentado a seguir, e substitua o texto do espaço reservado. Para a opção,--change-set-type especifique um valor de IMPORT. Para a opção --resources-to-import, substitua a string JSON de exemplo pela string JSON real que você acabou de criar.
```
aws cloudformation create-change-set \
    --stack-name TargetStackName --change-set-name ImportChangeSet \
    --change-set-type IMPORT \
    --template-body file://TemplateToImport.json \
    --resources-to-import "'[{"ResourceType":"AWS::DynamoDB::Table","LogicalResourceId":"GamesTable","ResourceIdentifier":{"TableName":"Games"}}]'"
```
nota
A opção --resources-to-import não oferece suporte para a linguagem YAML incorporada. Os requisitos para usar sequências de escape de aspas em uma string JSON variam de acordo com o terminal utilizado. Para obter mais informações, consulte Using quotation marks inside strings no Guia do usuário da AWS Command Line Interface.

Como alternativa, é possível usar um URL de arquivo como entrada para a opção --resources-to-import, conforme mostrado no exemplo a seguir.
```
--resources-to-import file://ResourcesToImport.txt
```
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
```
Para iniciar o conjunto de alterações e importar o recurso, use o comando execute-change-set, apresentado a seguir, e substitua o texto do espaço reservado. 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 --stack-name TargetStackName
```
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.

Atenção O Javascript está desativado ou não está disponível no seu navegador.

Para usar a documentação da AWS, o Javascript deve estar ativado. Consulte as páginas de Ajuda do navegador para obter instruções.

Convenções do documento

Importar recursos existentes para uma pilha

Aninhar uma pilha existente

Mover recursos entre pilhas

Importante

Refatorar uma pilha usando o AWS Management Console

exemplo JSON

exemplo JSON

exemplo JSON

Importante

nota

Refatorar uma pilha usando o AWS CLI

exemplo JSON

exemplo JSON

exemplo JSON

nota

nota