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á.
Migre AWS recursos, AWS CloudFormation pilhas e CloudFormation modelos implantados para um novo projeto. AWS CDK
Esse comando cria um nova aplicação CDK que inclui uma única pilha nomeada com o valor que você fornece usando o --stack-name. Você pode configurar a fonte de migração usando o --from-scan, --from-stack ou --from-path.
Para obter mais informações sobre como usar o cdk migrate, consulte Migre os recursos e AWS CloudFormation modelos existentes para o AWS CDK.
nota
O comando cdk migrate é experimental e pode ter alterações significativas no futuro.
Uso
$cdk migrate<options>
Opções
Para obter uma lista de opções globais que funcionam com todos os CDK CLI comandos, vejaOpções globais.
Opções obrigatórias
--stack-nameSTRING-
O nome da AWS CloudFormation pilha que será criada no aplicativo CDK após a migração.
Obrigatório: Sim
Opções condicionais
--from-pathPATH-
O caminho para o AWS CloudFormation modelo a ser migrado. Forneça essa opção para especificar um modelo local.
Obrigatório: condicional. Obrigatório ao migrar de um AWS CloudFormation modelo local.
--from-scanSTRING-
Ao migrar recursos implantados de um AWS ambiente, use essa opção para especificar se uma nova verificação deve ser iniciada ou se o AWS CDK CLI deve usar a última verificação bem-sucedida.
Obrigatório: condicional. Necessário ao migrar dos recursos implantados. AWS
Valores aceitos:
most-recent,new --from-stackBOOLEAN-
Forneça essa opção para migrar de uma pilha implantada. AWS CloudFormation Use
--stack-namepara especificar o nome da AWS CloudFormation pilha implantada.Obrigatório: condicional. Obrigatório ao migrar de uma pilha implantada. AWS CloudFormation
Opções opcionais
--accountSTRING-
A conta da qual recuperar o modelo de AWS CloudFormation pilha.
Obrigatório: não
Padrão: O AWS CDK CLI obtém informações da conta de fontes padrão.
--compressBOOLEAN-
Forneça essa opção para compactar o projeto CDK gerado em um ZIP file.
Obrigatório: não
--filterARRAY-
Use ao migrar recursos implantados de uma AWS conta e. Região da AWS Essa opção especifica um filtro para determinar quais recursos implantados devem ser migrados.
Essa opção aceita uma matriz de pares de valores-chave, em que chave representa o tipo de filtro e valor representa o valor a ser filtrado.
As seguintes chaves são aceitas:
-
resource-identifier— Um identificador para o recurso. O valor pode ser o ID lógico ou físico do recurso. Por exemplo,resource-identifier="ClusterName". -
resource-type-prefix— O prefixo do tipo de AWS CloudFormation recurso. Por exemplo, especifiqueresource-type-prefix="AWS::DynamoDB::"para filtrar todos os recursos do Amazon DynamoDB. -
tag-key– A chave de uma tag de recurso. Por exemplo,tag-key="myTagKey". -
tag-value– O valor de uma tag de recurso. Por exemplo,tag-value="myTagValue".
Forneça vários pares de valores-chave para lógica
ANDcondicional. O exemplo a seguir filtra qualquer recurso do DynamoDB marcado commyTagKeycomo a chave da tag:--filter resource-type-prefix="AWS::DynamoDB::", tag-key="myTagKey".Forneça a opção
--filtervárias vezes em um único comando para a lógica condicionalOR. O exemplo a seguir filtra qualquer recurso que seja um recurso do DynamoDB ou que esteja marcado commyTagKeycomo a chave da tag:--filter resource-type-prefix="AWS::DynamoDB::" --filter tag-key="myTagKey".Obrigatório: não
-
--help, -hBOOLEAN-
Mostrar as informações de referência do comando
cdk migrate. --languageSTRING-
A linguagem de programação a ser usada no projeto CDK criado durante a migração.
Obrigatório: não
Valores válidos:
typescript,python,java,csharp,go.Padrão:
typescript --output-pathPATH-
O caminho de saída para o projeto CDK migrado.
Obrigatório: não
Padrão: Por padrão, o AWS CDK CLI usará seu diretório de trabalho atual.
--regionSTRING-
O Região da AWS para recuperar o modelo de AWS CloudFormation pilha.
Obrigatório: não
Padrão: O AWS CDK CLI obtém Região da AWS informações de fontes padrão.
Exemplos
Exemplo simples de migração de uma pilha CloudFormation
Migre de uma CloudFormation pilha implantada em um ambiente específico usando o. AWS --from-stack Forneça um nome --stack-name para sua nova pilha de CDK. Veja a seguir um exemplo que migra myCloudFormationStack para um novo aplicativo CDK que está usando TypeScript:
$cdk migrate --language typescript --from-stack --stack-name 'myCloudFormationStack'
Exemplo simples de migração de um modelo local CloudFormation
Migre de um modelo JSON ou YAML CloudFormation local usando o. --from-path Forneça um nome --stack-name para sua nova pilha de CDK. Veja a seguir um exemplo que cria um novo aplicativo CDK no TypeScript que inclui uma myCloudFormationStack pilha de um template.json arquivo local:
$cdk migrate --stack-name "myCloudFormationStack" --language typescript --from-path "./template.json"
Exemplo simples de migração de recursos implantados AWS
Migre AWS os recursos implantados de um AWS ambiente específico que não estão associados a uma CloudFormation pilha usando. --from-scan O CDK CLI utiliza o IaC generator serviço para verificar recursos e gerar um modelo. Então, o CDK CLI faz referência ao modelo para criar o novo aplicativo CDK. Veja a seguir um exemplo que cria um novo aplicativo CDK no TypeScript com uma nova myCloudFormationStack pilha contendo recursos migrados AWS :
$cdk migrate --language typescript --from-scan --stack-name "myCloudFormationStack"
