Ceci est le guide du AWS CDK développeur de la version 2. L'ancienne CDK version 1 est entrée en maintenance le 1er juin 2022 et a pris fin le 1er juin 2023.
Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
cdk migrate
Migrez AWS les ressources, les AWS CloudFormation piles et les CloudFormation modèles déployés vers un nouveau AWS CDK projet.
Cette commande crée une nouvelle application CDK qui inclut une pile unique nommée avec la valeur que vous fournissez à l'aide --stack-name
de cette commande. Vous pouvez configurer la source de migration à l'aide de --from-scan
--from-stack
, ou--from-path
.
Pour plus d'informations sur l'utilisationcdk migrate
, consultezMigrez les ressources et les AWS CloudFormation modèles existants vers AWS CDK.
Note
La cdk migrate
commande est expérimentale et pourrait subir des modifications importantes à l'avenir.
Utilisation
$
cdk migrate
<options>
Options
Pour obtenir la liste des options globales qui fonctionnent avec toutes les CLI commandes CDK, consultezOptions globales.
Options requises
--stack-name
STRING
-
Nom de la AWS CloudFormation pile qui sera créée dans l'application CDK après la migration.
Obligatoire : oui
Options conditionnelles
--from-path
PATH
-
Le chemin d'accès au AWS CloudFormation modèle à migrer. Fournissez cette option pour spécifier un modèle local.
Obligatoire : selon les conditions. Obligatoire en cas de migration depuis un AWS CloudFormation modèle local.
--from-scan
STRING
-
Lorsque vous migrez des ressources déployées depuis un AWS environnement, utilisez cette option pour spécifier si un nouveau scan doit être lancé ou s'il AWS CDK CLI faut utiliser le dernier scan réussi.
Obligatoire : selon les conditions. Nécessaire lors de la migration à partir de AWS ressources déployées.
Valeurs acceptées :
most-recent
,new
--from-stack
BOOLEAN
-
Fournissez cette option pour migrer à partir d'une AWS CloudFormation pile déployée.
--stack-name
À utiliser pour spécifier le nom de la AWS CloudFormation pile déployée.Obligatoire : selon les conditions. Obligatoire en cas de migration depuis une AWS CloudFormation pile déployée.
Options facultatives
--account
STRING
-
Le compte à partir duquel récupérer le modèle de AWS CloudFormation pile.
Obligatoire : non
Par défaut : AWS CDK CLI obtient les informations du compte à partir de sources par défaut.
--compress
BOOLEAN
-
Fournissez cette option pour compresser le projet CDK généré dans un ZIP fichier.
Obligatoire : non
--filter
ARRAY
-
À utiliser lors de la migration des ressources déployées depuis un AWS compte et Région AWS. Cette option spécifie un filtre pour déterminer les ressources déployées à migrer.
Cette option accepte un tableau de paires clé-valeur, où la clé représente le type de filtre et la valeur représente la valeur à filtrer.
Les clés suivantes sont acceptées :
-
resource-identifier
— Identifiant de la ressource. La valeur peut être l'identifiant logique ou physique de la ressource. Par exemple,resource-identifier="ClusterName"
. -
resource-type-prefix
— Le préfixe du type de AWS CloudFormation ressource. Par exemple, spécifiezresource-type-prefix="AWS::DynamoDB::"
de filtrer toutes les ressources Amazon DynamoDB. -
tag-key
— La clé d'une balise de ressource. Par exemple,tag-key="myTagKey"
. -
tag-value
— La valeur d'une balise de ressource. Par exemple,tag-value="myTagValue"
.
Fournissez plusieurs paires clé-valeur pour la logique
AND
conditionnelle. L'exemple suivant filtre toute ressource DynamoDB étiquetéemyTagKey
avec comme clé de balise :.--filter resource-type-prefix="AWS::DynamoDB::", tag-key="myTagKey"
Fournissez l'
--filter
option plusieurs fois dans une seule commande pour la logiqueOR
conditionnelle. L'exemple suivant filtre toute ressource qui est une ressource DynamoDB ou qui est étiquetée comme clémyTagKey
de balise :.--filter resource-type-prefix="AWS::DynamoDB::" --filter tag-key="myTagKey"
Obligatoire : non
-
--help, -h
BOOLEAN
-
Afficher les informations de référence relatives à la
cdk migrate
commande. --language
STRING
-
Langage de programmation à utiliser pour le projet CDK créé lors de la migration.
Obligatoire : non
Valeurs valides :
typescript
,python
,java
,csharp
,go
.Par défaut :
typescript
--output-path
PATH
-
Le chemin de sortie pour le projet CDK migré.
Obligatoire : non
Par défaut : Par défaut, votre répertoire de travail actuel AWS CDK CLI sera utilisé.
--region
STRING
-
Le Région AWS pour récupérer le modèle de AWS CloudFormation pile.
Obligatoire : non
Par défaut : AWS CDK CLI obtient des Région AWS informations à partir de sources par défaut.
Exemples
Exemple simple de migration à partir d'une pile CloudFormation
Migrez à partir d'une CloudFormation pile déployée dans un AWS environnement spécifique à l'aide de--from-stack
. Indiquez --stack-name
le nom de votre nouvelle pile de CDK. Voici un exemple de migration myCloudFormationStack
vers une nouvelle application CDK qui utilise : TypeScript
$
cdk migrate --language typescript --from-stack --stack-name 'myCloudFormationStack'
Exemple simple de migration à partir d'un modèle local CloudFormation
Migrez à partir d'un CloudFormation modèle JSON ou YAML local à l'aide --from-path
de. Indiquez --stack-name
le nom de votre nouvelle pile de CDK. Voici un exemple de création d'une nouvelle application CDK TypeScript qui inclut une myCloudFormationStack
pile provenant d'un template.json
fichier local :
$
cdk migrate --stack-name "myCloudFormationStack" --language typescript --from-path "./template.json"
Exemple simple de migration à partir de ressources déployées AWS
Migrez AWS les ressources déployées depuis un AWS environnement spécifique qui ne sont pas associées à une CloudFormation pile à l'aide de--from-scan
. Le CDK CLI utilise le IaC generator service pour rechercher des ressources et générer un modèle. Le CDK CLI fait ensuite référence au modèle pour créer la nouvelle application CDK. Voici un exemple qui crée une nouvelle application CDK TypeScript avec une nouvelle myCloudFormationStack
pile contenant des ressources migrées AWS :
$
cdk migrate --language typescript --from-scan --stack-name "myCloudFormationStack"