cdk import - AWS Cloud Development Kit (AWS CDK) v2
UsoArgumentosOpções

Este é o Guia do Desenvolvedor AWS CDK v2. O CDK v1 antigo entrou em manutenção em 1º de junho de 2022 e encerrou o suporte em 1º de junho de 2023.

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

cdk import

Use importações AWS CloudFormation de recursos para importar AWS recursos existentes em uma pilha de CDK.

Com esse comando, você pode pegar os recursos existentes que foram criados usando outros métodos e começar a gerenciá-los usando AWS CDK o.

Ao considerar a transferência de recursos para o gerenciamento do CDK, às vezes é aceitável criar novos recursos, como com funções do IAM, funções do Lambda e regras de eventos. Para outros recursos, como recursos com estado, como buckets do Amazon S3 e tabelas do DynamoDB, a criação de novos recursos pode causar impactos em seu serviço. Você pode usar cdk import para importar recursos existentes com o mínimo de interrupção em seus serviços. Para obter uma lista dos AWS recursos compatíveis, consulte Suporte ao tipo de recurso no Guia AWS CloudFormation do usuário.

Para importar um recurso existente para uma pilha de CDK

  1. Execute um cdk diff para garantir que sua pilha de CDK não tenha alterações pendentes. Ao realizar umacdk import, as únicas alterações permitidas em uma operação de importação são a adição de novos recursos sendo importados.

  2. Adicione construções para os recursos que você deseja importar para sua pilha. Por exemplo, adicione o seguinte para um bucket do Amazon S3:

    new s3.Bucket(this, 'ImportedS3Bucket', {});

    Não adicione nenhuma outra alteração. Você também deve se certificar de modelar exatamente o estado que o recurso tem atualmente. Para o exemplo do bucket, não se esqueça de incluir AWS KMS chaves, políticas de ciclo de vida e qualquer outra coisa que seja relevante sobre o bucket. Caso contrário, as operações de atualização subsequentes podem não fazer o que você espera.

  3. Executar cdk import. Se houver várias pilhas no aplicativo CDK, passe um nome de pilha específico como argumento.

  4. O CDK CLI solicitará que você informe os nomes reais dos recursos que você está importando. Depois de fornecer essas informações, a importação será iniciada.

  5. Quando o cdk import relatório for bem-sucedido, o recurso será gerenciado pelo CDK. Quaisquer alterações subsequentes na configuração da construção serão refletidas no recurso.

No momento, esse recurso tem as seguintes limitações:

  • Não é possível importar recursos para pilhas aninhadas.

  • Não há verificação se as propriedades especificadas estão corretas e completas para o recurso importado. Tente iniciar uma operação de detecção de desvio após a importação.

  • Os recursos que dependem de outros recursos devem ser importados juntos ou individualmente, na ordem correta. Caso contrário, a CloudFormation implantação falhará com referências não resolvidas.

  • Esse comando usa as credenciais da função de implantação, que são necessárias para ler o bucket de teste criptografado. Isso requer a versão 12 do modelo de bootstrap, que inclui as permissões necessárias do IAM para a função de implantação.

Uso

$ cdk import <arguments> <options>

Argumentos

ID lógica da pilha CDK

O ID lógico da pilha de CDK do seu aplicativo para a qual importar recursos. Esse argumento pode ser fornecido várias vezes em um único comando.

Tipo: string

Obrigatório: não

Opções

Para obter uma lista das opções globais que funcionam com todos os CLI comandos do CDK, consulteOpções globais.

--change-set-name STRING

O nome do conjunto de CloudFormation alterações a ser criado.

--execute BOOLEAN

Especifique se deseja executar o conjunto de alterações.

Valor padrão: true

--force, -f BOOLEAN

Por padrão, o CDK CLI sai do processo se a diferença do modelo incluir atualizações ou exclusões. Especifique true para substituir esse comportamento e sempre continue com a importação.

--help, -h BOOLEAN

Mostra as informações de referência do cdk import comando.

--record-resource-mapping, -r STRING

Use essa opção para gerar um mapeamento dos recursos físicos existentes para os recursos do CDK que serão importados. O mapeamento será gravado no caminho do arquivo que você fornecer. Nenhuma operação de importação real será executada.

--resource-mapping, -m STRING

Use essa opção para especificar um arquivo que define seu mapeamento de recursos. O CDK CLI usará esse arquivo para mapear recursos físicos em recursos para importação, em vez de perguntar interativamente a você.

Essa opção pode ser executada a partir de scripts.

--rollback BOOLEAN

Reverta a pilha para o estado estável em caso de falha.

Para especificarfalse, você pode usar --no-rollback ou-R.

Especifique false para iterar mais rapidamente. Implantações contendo substituições de recursos sempre falharão.

Valor padrão: true

--toolkit-stack-name STRING

O nome da pilha do CDK Toolkit a ser criada