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

Questa è la guida per sviluppatori AWS CDK v2. La versione precedente della CDK versione 1 è entrata 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à.

cdk migrate

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 su 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 CLI comandi CDK, consultaOpzioni globali.

Opzioni richieste

--stack-name STRING

Il nome dello AWS CloudFormation stack che verrà creato all'interno dell'app CDK dopo la migrazione.

Campo obbligatorio: sì

Opzioni condizionali

--from-path PATH

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-scan STRING

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 utilizzare l'ultima scansione riuscita.

Obbligatorio: condizionale. Richiesto per la migrazione dalle risorse distribuite. AWS

Valori accettati:, most-recent new

--from-stack BOOLEAN

Fornisci questa opzione per migrare da uno stack distribuito AWS CloudFormation . Utilizzare --stack-name per specificare il nome dello stack distribuito. AWS CloudFormation

Obbligatorio: condizionale. Obbligatorio in caso di migrazione da uno stack distribuito. AWS CloudFormation

Opzioni opzionali

--account STRING

L'account da cui recuperare il modello dello AWS CloudFormation stack.

Required: No

Predefinito: AWS CDK CLI ottiene le informazioni sull'account da fonti predefinite.

--compress BOOLEAN

Fornite questa opzione per comprimere il progetto CDK generato in un file. ZIP

Required: No

--filter ARRAY

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 esempio, resource-identifier="ClusterName".

  • resource-type-prefix— Il prefisso del tipo di AWS CloudFormation risorsa. Ad esempio, specifica di resource-type-prefix="AWS::DynamoDB::" filtrare tutte le risorse Amazon DynamoDB.

  • tag-key— La chiave di un tag di risorsa. Ad esempio, tag-key="myTagKey".

  • tag-value— Il valore di un tag di risorsa. Ad esempio, tag-value="myTagValue".

Fornisci più coppie chiave-valore per la logica AND condizionale. L'esempio seguente filtra per qualsiasi risorsa DynamoDB myTagKey etichettata come chiave tag:. --filter resource-type-prefix="AWS::DynamoDB::", tag-key="myTagKey"

Fornisci l'--filteropzione più volte in un unico comando per la logica OR condizionale. 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, -h BOOLEAN

Mostra le informazioni di riferimento del cdk migrate comando.

--language STRING

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-path PATH

Il percorso di output per il progetto CDK migrato.

Required: No

Impostazione predefinita: per impostazione predefinita, AWS CDK CLI utilizzerà la directory di lavoro corrente.

--region STRING

Regione AWS Da cui recuperare il modello dello AWS CloudFormation stack.

Required: No

Predefinito: 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 TypeScript che include uno myCloudFormationStack stack da un file locale: template.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 TypeScript con un nuovo myCloudFormationStack stack contenente risorse migrate: AWS 

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