cdk import - AWS Cloud Development Kit (AWS CDK) v2
UtilizzoArgomentiOpzioni

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à.

cdk import

Usa le importazioni di AWS CloudFormation risorse per importare AWS le risorse esistenti in uno stack CDK.

Con questo comando, puoi prendere le risorse esistenti che sono state create con altri metodi e iniziare a gestirle utilizzando. AWS CDK

Quando si considera di spostare le risorse nella gestione CDK, a volte è accettabile creare nuove risorse, ad esempio con i ruoli IAM, le funzioni Lambda e le regole degli eventi. Per altre risorse, come le risorse stateful come i bucket Amazon S3 e le tabelle DynamoDB, la creazione di nuove risorse può avere un impatto sul servizio. Puoi utilizzarle cdk import per importare risorse esistenti con interruzioni minime dei tuoi servizi. Per un elenco delle AWS risorse supportate, consulta Resource type support nella Guida per l'AWS CloudFormation utente.

Per importare una risorsa esistente in uno stack CDK

  1. Esegui un comando cdk diff per assicurarti che lo stack CDK non abbia modifiche in sospeso. Quando si esegue uncdk import, le uniche modifiche consentite in un'operazione di importazione sono l'aggiunta di nuove risorse da importare.

  2. Aggiungi costrutti per le risorse che desideri importare nel tuo stack. Ad esempio, aggiungi quanto segue per un bucket Amazon S3:

    new s3.Bucket(this, 'ImportedS3Bucket', {});

    Non aggiungere altre modifiche. È inoltre necessario assicurarsi di modellare esattamente lo stato attuale della risorsa. Per l'esempio del bucket, assicurati di includere le AWS KMS chiavi, le politiche del ciclo di vita e qualsiasi altra cosa pertinente al bucket. In caso contrario, le successive operazioni di aggiornamento potrebbero non funzionare come previsto.

  3. Esegui cdk import. Se nell'app CDK sono presenti più stack, inserisci un nome di stack specifico come argomento.

  4. Il CDK ti CLI chiederà di inserire i nomi effettivi delle risorse che stai importando. Dopo aver fornito queste informazioni, l'importazione avrà inizio.

  5. Quando viene cdk import segnalato un esito positivo, la risorsa verrà gestita dal CDK. Eventuali modifiche successive nella configurazione del costrutto si rifletteranno sulla risorsa.

Questa funzionalità presenta attualmente le seguenti limitazioni:

  • L'importazione di risorse in pile annidate non è possibile.

  • Non è possibile verificare se le proprietà specificate sono corrette e complete per la risorsa importata. Prova ad avviare un'operazione di rilevamento della deriva dopo l'importazione.

  • Le risorse che dipendono da altre risorse devono essere importate tutte insieme o singolarmente, nell'ordine corretto. In caso contrario, la CloudFormation distribuzione avrà esito negativo con riferimenti irrisolti.

  • Questo comando utilizza le credenziali del ruolo deploy, necessarie per leggere il bucket di staging crittografato. Ciò richiede la versione 12 del modello di bootstrap, che include le autorizzazioni IAM necessarie per il ruolo di distribuzione.

Utilizzo

$ cdk import <arguments> <options>

Argomenti

ID logico dello stack CDK

L'ID logico dello stack CDK dell'app in cui importare le risorse. Questo argomento può essere fornito più volte in un unico comando.

▬Tipo: stringa

Required: No

Opzioni

Per un elenco delle opzioni globali che funzionano con tutti i CLI comandi CDK, consultaOpzioni globali.

--change-set-name STRING

Il nome del set di CloudFormation modifiche da creare.

--execute BOOLEAN

Specificare se eseguire il set di modifiche.

Valore predefinito: true

--force, -f BOOLEAN

Per impostazione predefinita, il CDK chiude il processo se CLI la differenza tra i modelli include aggiornamenti o eliminazioni. Specificate true di ignorare questo comportamento e continuate sempre con l'importazione.

--help, -h BOOLEAN

Mostra le informazioni di riferimento del cdk import comando.

--record-resource-mapping, -r STRING

Utilizzate questa opzione per generare una mappatura delle risorse fisiche esistenti rispetto alle risorse CDK che verranno importate. La mappatura verrà scritta nel percorso del file fornito. Non verrà eseguita alcuna operazione di importazione effettiva.

--resource-mapping, -m STRING

Utilizzate questa opzione per specificare un file che definisca la mappatura delle risorse. Il CDK CLI utilizzerà questo file per mappare le risorse fisiche alle risorse da importare invece di richiederle in modo interattivo.

Questa opzione può essere eseguita dagli script.

--rollback BOOLEAN

Ripristina lo stack allo stato stabile in caso di errore.

Per specificarefalse, puoi usare --no-rollback o-R.

Specificate false per iterare più rapidamente. Le distribuzioni contenenti risorse sostitutive falliranno sempre.

Valore predefinito: true

--toolkit-stack-name STRING

Il nome dello stack CDK Toolkit da creare