Questa è la guida per sviluppatori AWS CDK v2. Il vecchio CDK v1 è entrato in manutenzione il 1° giugno 2022 e ha terminato il supporto il 1° giugno 2023.
Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
Migra AWS le risorse, gli AWS CloudFormation stack e i CloudFormation modelli distribuiti in un nuovo progetto. AWS CDK
Questo comando crea una nuova app CDK che include un singolo stack denominato con il valore fornito utilizzando. --stack-name È possibile configurare l'origine della migrazione utilizzando --from-scan--from-stack, o. --from-path
Per ulteriori informazioni sull'utilizzocdk migrate, vedereMigra le risorse e i AWS CloudFormation modelli esistenti in AWS CDK.
Nota
Il cdk migrate comando è sperimentale e potrebbe subire modifiche sostanziali in futuro.
Utilizzo
$cdk migrate<options>
Opzioni
Per un elenco di opzioni globali che funzionano con tutti i CDK CLI comandi, vediOpzioni globali.
Opzioni richieste
--stack-nameSTRING-
Il nome dello AWS CloudFormation stack che verrà creato all'interno dell'app CDK dopo la migrazione.
Campo obbligatorio: sì
Opzioni condizionali
--from-pathPATH-
Il percorso del AWS CloudFormation modello da migrare. Fornisci questa opzione per specificare un modello locale.
Obbligatorio: condizionale. Obbligatorio in caso di migrazione da un AWS CloudFormation modello locale.
--from-scanSTRING-
Quando si migrano le risorse distribuite da un AWS ambiente, utilizzate questa opzione per specificare se avviare una nuova scansione o se AWS CDK CLI dovrebbe utilizzare l'ultima scansione riuscita.
Obbligatorio: condizionale. Richiesto per la migrazione dalle risorse distribuite AWS .
Valori accettati:,
most-recentnew --from-stackBOOLEAN-
Fornisci questa opzione per migrare da uno stack distribuito AWS CloudFormation . Utilizzare
--stack-nameper specificare il nome dello stack distribuito. AWS CloudFormationObbligatorio: condizionale. Obbligatorio in caso di migrazione da uno stack distribuito. AWS CloudFormation
Opzioni opzionali
--accountSTRING-
L'account da cui recuperare il modello dello AWS CloudFormation stack.
Required: No
Impostazione predefinita: AWS CDK CLI ottiene informazioni sull'account da fonti predefinite.
--compressBOOLEAN-
Fornite questa opzione per comprimere il progetto CDK generato in un ZIP file.
Required: No
--filterARRAY-
Da utilizzare per la migrazione delle risorse distribuite da un account e. AWS Regione AWS Questa opzione specifica un filtro per determinare quali risorse distribuite migrare.
Questa opzione accetta una matrice di coppie chiave-valore, dove key rappresenta il tipo di filtro e value rappresenta il valore da filtrare.
Sono accettate le seguenti chiavi:
-
resource-identifier— Un identificatore per la risorsa. Il valore può essere l'ID logico o fisico della risorsa. Ad esempioresource-identifier="ClusterName". -
resource-type-prefix— Il prefisso del tipo di AWS CloudFormation risorsa. Ad esempio, specifica diresource-type-prefix="AWS::DynamoDB::"filtrare tutte le risorse Amazon DynamoDB. -
tag-key— La chiave di un tag di risorsa. Ad esempiotag-key="myTagKey". -
tag-value— Il valore di un tag di risorsa. Ad esempiotag-value="myTagValue".
Fornisci più coppie chiave-valore per la logica
ANDcondizionale. L'esempio seguente filtra per qualsiasi risorsa DynamoDBmyTagKeyetichettata come chiave tag:.--filter resource-type-prefix="AWS::DynamoDB::", tag-key="myTagKey"Fornisci l'
--filteropzione più volte in un unico comando per la logicaORcondizionale. L'esempio seguente filtra per qualsiasi risorsa che sia una risorsa DynamoDB o contrassegnata come chiave tagmyTagKey:.--filter resource-type-prefix="AWS::DynamoDB::" --filter tag-key="myTagKey"Required: No
-
--help, -hBOOLEAN-
Mostra le informazioni di riferimento del
cdk migratecomando. --languageSTRING-
Il linguaggio di programmazione da utilizzare per il progetto CDK creato durante la migrazione.
Required: No
Valori validi:
typescript,python,,javacsharp,go.Default:
typescript --output-pathPATH-
Il percorso di output per il progetto CDK migrato.
Required: No
Impostazione predefinita: per impostazione predefinita, AWS CDK CLI utilizzerà la cartella di lavoro corrente.
--regionSTRING-
Il Regione AWS da cui recuperare il modello di AWS CloudFormation pila.
Required: No
Impostazione predefinita: AWS CDK CLI ottiene Regione AWS informazioni da fonti predefinite.
Esempi
Semplice esempio di migrazione da uno stack CloudFormation
Esegui la migrazione da uno CloudFormation stack distribuito in un ambiente specifico utilizzando. AWS --from-stack Fornisci un nome --stack-name al tuo nuovo stack CDK. Di seguito è riportato un esempio di migrazione myCloudFormationStack a una nuova app CDK che utilizza TypeScript:
$cdk migrate --language typescript --from-stack --stack-name 'myCloudFormationStack'
Semplice esempio di migrazione da un modello locale CloudFormation
Esegui la migrazione da un modello JSON o CloudFormation YAML locale utilizzando. --from-path Fornisci un nome --stack-name al tuo nuovo stack CDK. Di seguito è riportato un esempio che crea una nuova app CDK in TypeScript che include uno myCloudFormationStack stack da un file localetemplate.json:
$cdk migrate --stack-name "myCloudFormationStack" --language typescript --from-path "./template.json"
Semplice esempio di migrazione dalle risorse distribuite AWS
Migra AWS le risorse distribuite da un AWS ambiente specifico che non sono associate a uno stack che utilizza. CloudFormation --from-scan Il CDK CLI utilizza il IaC generator servizio per cercare risorse e generare un modello. Quindi, il CDK CLI fa riferimento al modello per creare la nuova app CDK. Di seguito è riportato un esempio che crea una nuova app CDK in TypeScript con un nuovo myCloudFormationStack stack contenente risorse migrate AWS :
$cdk migrate --language typescript --from-scan --stack-name "myCloudFormationStack"
