cdk migrate - AWS Cloud Development Kit (AWS CDK) v2
UsoOpcionesEjemplos

Esta es la guía para AWS CDK desarrolladores de la versión 2. La versión anterior del CDK v1 entró en mantenimiento el 1 de junio de 2022 y dejó de ofrecer soporte el 1 de junio de 2023.

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

cdk migrate

Migre AWS los recursos, las AWS CloudFormation pilas y las CloudFormation plantillas desplegados a un nuevo AWS CDK proyecto.

Este comando crea una nueva aplicación de CDK que incluye una pila única que recibe el nombre del valor que usted proporciona. --stack-name Puede configurar la fuente de migración mediante --from-scan--from-stack, o--from-path.

Para obtener más información sobre el usocdk migrate, consulteMigre los recursos y AWS CloudFormation plantillas existentes a AWS CDK.

nota

El cdk migrate comando es experimental y puede tener cambios importantes en el futuro.

Uso

$ cdk migrate <options>

Opciones

Para obtener una lista de las opciones globales que funcionan con todos los CLI comandos de CDK, consulteOpciones globales.

Opciones obligatorias

--stack-name STRING

El nombre de la AWS CloudFormation pila que se creará en la aplicación CDK después de la migración.

Obligatorio: sí

Opciones condicionales

--from-path PATH

La ruta a la AWS CloudFormation plantilla que se va a migrar. Proporcione esta opción para especificar una plantilla local.

Obligatorio: condicional. Obligatorio si se migra desde una AWS CloudFormation plantilla local.

--from-scan STRING

Al migrar los recursos desplegados desde un AWS entorno, utilice esta opción para especificar si se debe iniciar un nuevo análisis o si se AWS CDK CLI debe utilizar el último análisis realizado correctamente.

Obligatorio: condicional. Se requiere cuando se migra desde recursos implementados AWS .

Valores aceptados:most-recent, new

--from-stack BOOLEAN

Proporcione esta opción para migrar desde una AWS CloudFormation pila implementada. Se utiliza --stack-name para especificar el nombre de la AWS CloudFormation pila implementada.

Obligatorio: condicional. Necesario si se migra desde una AWS CloudFormation pila implementada.

Opciones opcionales

--account STRING

La cuenta de la que se va a recuperar la plantilla de AWS CloudFormation pila.

Obligatorio: no

Predeterminada: AWS CDK CLI obtiene la información de la cuenta de las fuentes predeterminadas.

--compress BOOLEAN

Proporcione esta opción para comprimir el proyecto de CDK generado en un ZIP archivo.

Obligatorio: no

--filter ARRAY

Se utiliza al migrar los recursos desplegados desde una AWS cuenta y. Región de AWS Esta opción especifica un filtro para determinar qué recursos implementados se van a migrar.

Esta opción acepta una matriz de pares clave-valor, donde la clave representa el tipo de filtro y el valor representa el valor que se va a filtrar.

Se aceptan las siguientes claves:

  • resource-identifier— Un identificador del recurso. El valor puede ser el identificador lógico o físico del recurso. Por ejemplo, resource-identifier="ClusterName".

  • resource-type-prefix— El prefijo del tipo de AWS CloudFormation recurso. Por ejemplo, especifique filtrar todos resource-type-prefix="AWS::DynamoDB::" los recursos de Amazon DynamoDB.

  • tag-key— La clave de una etiqueta de recurso. Por ejemplo, tag-key="myTagKey".

  • tag-value— El valor de una etiqueta de recurso. Por ejemplo, tag-value="myTagValue".

Proporcione varios pares clave-valor para la lógica AND condicional. El siguiente ejemplo filtra cualquier recurso de DynamoDB que esté etiquetado como clave myTagKey de etiqueta:. --filter resource-type-prefix="AWS::DynamoDB::", tag-key="myTagKey"

Proporcione la --filter opción varias veces en un solo comando para la lógica OR condicional. El siguiente ejemplo filtra cualquier recurso que sea un recurso de DynamoDB o que esté etiquetado como clave myTagKey de etiqueta:. --filter resource-type-prefix="AWS::DynamoDB::" --filter tag-key="myTagKey"

Obligatorio: no

--help, -h BOOLEAN

Muestra la información de referencia del cdk migrate comando.

--language STRING

El lenguaje de programación que se utilizará en el proyecto de CDK creado durante la migración.

Obligatorio: no

Valores válidos:typescript,,python, javacsharp,go.

Valor predeterminado: typescript

--output-path PATH

La ruta de salida del proyecto de CDK migrado.

Obligatorio: no

Predeterminado: de forma predeterminada, AWS CDK CLI utilizará su directorio de trabajo actual.

--region STRING

El Región de AWS para recuperar la plantilla de AWS CloudFormation pila.

Obligatorio: no

Predeterminado: AWS CDK CLI obtiene Región de AWS información de las fuentes predeterminadas.

Ejemplos

Ejemplo sencillo de migración desde una pila CloudFormation

Migre desde una CloudFormation pila implementada en un AWS entorno específico utilizando--from-stack. --stack-nameIndique un nombre para su nueva pila de CDK. El siguiente es un ejemplo que myCloudFormationStack migra a una nueva aplicación de CDK que utiliza: TypeScript

$ cdk migrate --language typescript --from-stack --stack-name 'myCloudFormationStack'

Ejemplo sencillo de migración desde una plantilla local CloudFormation

Migre desde una CloudFormation plantilla JSON o YAML local utilizando. --from-path --stack-nameIndique un nombre para su nueva pila de CDK. El siguiente es un ejemplo en el que se crea una nueva aplicación de CDK TypeScript que incluye una myCloudFormationStack pila de un archivo localtemplate.json:

$ cdk migrate --stack-name "myCloudFormationStack" --language typescript --from-path "./template.json"

Ejemplo sencillo de migración desde recursos implementados AWS

Migre AWS los recursos desplegados desde un AWS entorno específico que no estén asociados a una CloudFormation pila utilizando--from-scan. El CDK CLI utiliza el IaC generator servicio para buscar recursos y generar una plantilla. A continuación, la CDK CLI hace referencia a la plantilla para crear la nueva aplicación de la CDK. A continuación, se muestra un ejemplo en el que se crea una nueva aplicación de CDK TypeScript con una myCloudFormationStack pila nueva que contiene los recursos migrados: AWS 

$ cdk migrate --language typescript --from-scan --stack-name "myCloudFormationStack"