Importação de pilhas autogerenciadas para o CloudFormation StackSets

A operação importação de pilha do AWS CloudFormation pode importar pilhas existentes em conjuntos de pilhas novos ou existentes, para que você possa migrar pilhas existentes para um conjunto de pilhas em uma só operação. Ao utilizar a importação de pilhas, você evita tempo de inatividade e interrupções por não precisar excluir e recriar esses recursos. Depois que a pilha é importada para um conjunto de pilhas, a pilha original se torna uma instância da pilha do conjunto de pilhas especificado.

Considerações sobre as importações de pilhas autogerenciadas

• A operação de importação de pilhas requer uma conta de administrador na qual criar um conjunto de pilhas e uma conta de destino que contenha uma pilha.

• A conta de destino deve ter permissão para utilizar a operação GetTemplate com a especificação do ID da pilha ou do ARN. Por isso, as permissões AWSCloudFormationStackSetsAdminstration ou AWSCloudFormationStackSetsExectionRole devem ser concedidas à sua conta de administrador.

Importar uma pilha existente para um novo conjunto de pilhas (console)

Antes de começar, identifique a pilha que deseja importar.

1. Faça login no AWS Management Console e abra o console AWS CloudFormation em https://console.aws.amazon.com/cloudformation.

2. No painel de navegação, escolha StackSets.

3. No topo da página StackSets, escolha Create StackSet (Criar StackSet).

4. Na página Escolher um modelo, escolha um modelo por meio de uma das seguintes opções e escolha Avançar.

   • Escolha Amazon S3 URL e especifique o URL do modelo na caixa de texto.

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

   • Escolha From stack ID (Do ID da pilha) e insira seu ID da pilha.

5. Na página Especificar detalhes do StackSet, insira o nome de um conjunto de pilhas que você deseja criar e escolha Avançar.

   (Opcional) Insira uma descrição do conjunto de pilhas.

6. Na página Configurar opções do StackSet, reveja suas seleções e escolha Avançar.

7. Na página Definir opções de implantação, escolha Importar pilhas para o conjunto de pilhas.

8. Insira o ID da pilha a ser importada no campo Stacks to import (Pilhas para importar). Por exemplo, arn:aws:cloudformation:us-east-1:123456789012:stack/StackToImport/f449b250-b969-11e0-a185-5081d0136786.

   (Opcional) Escolha Adicionar outro ID de pilha e insira o ID da outra pilha que você deseja importar. É possível adicionar até 10 pilhas por operação de importação.

9. Revise as opções de implantação e escolha Avançar.

10. Na página Revisão, revise suas escolhas e as propriedades do seu conjunto de pilhas. Quando estiver pronto para importar a pilha para o conjunto de pilhas, escolha Enviar.

Resultados: a pilha importada é agora uma instância de pilha do conjunto de pilhas especificado. Para saber mais sobre o status de importação das pilhas, consulte Códigos de status do StackSets.

Importar uma pilha existente para um conjunto de pilhas existente (console)

Antes de começar, identifique a pilha que deseja importar.

1. Faça login no AWS Management Console e abra o console AWS CloudFormation em https://console.aws.amazon.com/cloudformation.

2. No painel de navegação, escolha StackSets.

3. Na página StackSets, escolha o conjunto de pilhas para o qual você deseja importar uma pilha.

4. Com o conjunto de pilhas selecionado, escolha Add stacks to StackSet (Adicionar pilhas ao StackSet) no menu Actions (Ações).

5. Na página Definir opções de implantação, escolha Importar pilhas para o conjunto de pilhas e insira o ID da pilha que você deseja importar no campo Pilhas a importar. Por exemplo, arn:aws:cloudformation:us-east-1:123456789012:stack/StackToImport/f449b250-b969-11e0-a185-5081d0136786.

   (Opcional) Escolha Adicionar outro ID de pilha e insira o ID da outra pilha que você deseja importar. É possível adicionar até 10 pilhas por operação de importação.

6. Escolha Próximo.

7. Na página Especificar substituições, verifique suas seleções e escolha Avançar.

8. Na página Revisão, revise suas escolhas e as propriedades do seu conjunto de pilhas. Quando estiver pronto para criar seu conjunto de pilhas, escolha Submit (Enviar).

Resultados: a pilha importada é agora uma instância de pilha do conjunto de pilhas especificado. Para saber mais sobre o status de importação das pilhas, consulte Códigos de status do StackSets.

Importar uma pilha para um conjunto de pilhas (AWS CLI)

Para importar uma pilha existente para um novo conjunto de pilhas

O comando create-stack-set, apresentado a seguir, cria um conjunto de pilhas e importa a pilha especificada. A pilha a ser importada é identificada pelo ARN. Substitua o espaço reservado de texto por suas próprias informações.

aws cloudformation create-stack-set \
  --stack-set-name MyStackSet \
  --stack-id arn:aws:cloudformation:us-east-1:123456789012:stack/StackToImport/466df9e0-0dff-08e3-8e2f-5088487c4896 \
  --administration-role-arn arn:aws:iam::123456789012:role/AWSCloudFormationStackSetAdministrationRole \
  --execution-role-name AWSCloudFormationStackSetExecutionRole

Para importar uma pilha existente para um conjunto de pilhas existente

O comando import-stacks-to-stack-sets, apresentado a seguir, importa a pilha especificada para o conjunto de pilhas MyStackSet. A pilha a ser importada é identificada pelo ARN. Substitua o espaço reservado de texto por suas próprias informações.

aws cloudformation import-stacks-to-stack-set \
  --stack-set MyStackSet \
  --stack-ids arn:aws:cloudformation:us-east-1:123456789012:stack/StackToImport/f449b250-b969-11e0-a185-5081d0136786

Para especificar mais de uma pilha, use o formato apresentado a seguir para o valor da opção --stack-ids.

--stack-ids "arn_1" "arn_2"

Para clonar a pilha importada em outras regiões e contas

O comando create-stack-instances, apresentado a seguir, adiciona instâncias de pilha ao conjunto de pilhas. Substitua o espaço reservado de texto por suas próprias informações.

aws cloudformation create-stack-instances \
  --stack-set-name MyStackSet \
  --accounts '["account_ID_1","account_ID_2"]' \
  --regions '["region_1","region_2"]'