Importe recursos da AWS para uma pilha do CloudFormation com uma importação de recursos

O gerador de IaC é uma ferramenta que verifica automaticamente seus recursos existentes e gera um modelo do CloudFormation com base em seu estado atual. Esse modelo pode então ser usado para importar esses recursos em uma pilha.

A importação de recursos é um \processo manual em que você descreve os recursos existentes em seu modelo do CloudFormation e depois os importa para uma pilha. Essa abordagem exige que você especifique manualmente as propriedades e configurações do recurso no modelo.

Movendo recursos entre pilhas: você pode importar recursos de uma pilha para outra, permitindo que você reorganize sua infraestrutura conforme necessário.

Aninhamento de pilhas existentes: você pode importar uma pilha existente como uma pilha aninhada dentro de outra pilha, permitindo projetos de infraestrutura modulares e reutilizáveis.

Um modelo que descreve toda a pilha, incluindo os recursos de pilha originais e os recursos que estão sendo importados. Todos os recursos que serão importados deverão ter um Atributo DeletionPolicy.

Identificadores para os recursos que você está importando, que o CloudFormation pode usar para realizar o mapeamento dos IDs lógicos no modelo com os recursos existentes.

Uma propriedade identificadora. Esta é uma propriedade de recursos que pode ser usada para identificar cada tipo de recurso. Por exemplo, um recurso AWS::S3::Bucket pode ser identificado usando o BucketName.

A propriedade do recurso usada para identificar o recurso que está sendo importado varia de acordo com o tipo de recurso. É possível encontrar a propriedade do recurso no console do CloudFormation. Depois de criar um modelo que inclua o recurso a ser importado, você poderá iniciar o processo de importação, no qual encontrará as propriedades do identificador para os recursos que estão sendo importados. Para alguns tipos de recursos, pode existir diversas maneiras de identificá-los, e você pode selecionar qual propriedade deseja usar nas listas suspensas.

Como alternativa, é possível obter as propriedades do identificador para os recursos que estão sendo importados ao chamar o comando get-template-summary da CLI e ao selecionar o URL do S3 do modelo de pilha como o valor da opção --template-url.

Um valor do identificador. Esse é o valor real da propriedade do recurso. Por exemplo, o valor real da propriedade BucketName deve ser MyS3Bucket.

É possível obter o valor da propriedade do identificador usando o console de serviço do recurso.

O recurso a ser importado já existe.

As propriedades e os valores de configuração de cada recurso a ser importado aderem ao esquema do tipo do recurso, que define as propriedades aceitas, as propriedades obrigatórias e os valores de propriedades compatíveis.

As propriedades obrigatórias são especificadas no modelo. As propriedades obrigatórias de cada tipo de recurso estão listadas na Referência de tipos de propriedades e recursos da AWS.

O recurso a ser importado não pertence a outra pilha na mesma região.

Após a importação ter sido concluída, e antes de realizar as operações de pilhas subsequentes, recomendamos executar a detecção de desvios nos recursos importados. A detecção de desvios garante que a configuração do modelo corresponda à configuração real. Para ter mais informações, consulte Detectar desvio em uma pilha inteira do CloudFormation.

As operações de importação não permitem criações de novos recursos, exclusões de recursos ou alterações para configurações de propriedade.

Cada recurso a ser importado deve ter um atributo DeletionPolicy para que a operação de importação tenha êxito. O DeletionPolicy pode ser definido como qualquer valor possível. Somente os recursos que você está importando precisam de uma DeletionPolicy. Os recursos que já fazem parte da pilha não precisam de DeletionPolicy.

Não é possível importar o mesmo recurso em várias pilhas.

Você pode usar a condição da política cloudformation:ImportResourceTypes do IAM para controlar com quais tipos de recursos os usuários podem trabalhar durante uma operação de importação. Para ter mais informações, consulte Condições do CloudFormation.

Os limites de pilha do CloudFormation se aplicam à importação de recursos. Para obter mais informações sobre limites, consulte Entender as cotas do CloudFormation.