View a markdown version of this page

cdk orphan - AWS Cloud Development Kit (AWS CDK) v2
UtilizzoArguments (Argomenti)OpzioniEsempi

Questa è la AWS CDK v2 Developer Guide. 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 orphan

Importante

Il cdk orphan comando è in versione di anteprima ed è soggetto a modifiche.

È necessario fornire l'--unstable=orphanopzione quando si utilizza questo comando.

Scollega in modo sicuro una o più risorse da una AWS CloudFormation pila senza eliminarle. Ciò è utile quando è necessario migrare una risorsa da un tipo di costrutto a un altro (ad esempio, migrando un DynamoDB a) senza tempi di inattività o perdita Table di TableV2 dati.

Quando modificate un tipo di costrutto nel codice CDK, lo CloudFormation interpreta come una risorsa sostitutiva, che elimina la risorsa esistente e ne crea una nuova. Per le risorse statiche come database e storage, ciò causa la perdita di dati. Il cdk orphan comando risolve questo problema scollegando prima la risorsa dallo stack, in modo da poterla reimportare con il nuovo tipo di costrutto utilizzando. cdk import

Con il cdk orphan puoi:

  • Scollega le risorse stateful da una pila prima di modificarne il tipo di costrutto.

  • Esegui la migrazione tra le versioni di build (ad esempio, DynamoDB to) senza perdita di datiTable. TableV2

  • Cambia il tipo di CloudFormation risorsa su cui si basa un costrutto senza sostituire la risorsa fisica.

Il comando orphan esegue tre distribuzioni: CloudFormation

  1. Risolvi riferimenti: risolve i riferimenti tra risorse (Ref,,Fn::Sub) alle risorse orfaneFn::GetAtt, in modo che le altre risorse dello stack che dipendono da esse continuino a funzionare dopo la rimozione delle risorse orfane.

  2. Disaccoppia: sostituisce tutti i riferimenti tra risorse con i relativi valori letterali risolti, imposta e rimuove le DependsOn voci DeletionPolicy per isolare le Retain risorse dal resto dello stack.

  3. Rimuovi: rimuove le risorse dal modello. CloudFormation Le risorse fisiche continuano a esistere nel tuo AWS account.

Dopo l'orfano, aggiorna il codice CDK per utilizzare il nuovo tipo di costrutto e usa cdk import per riportare la risorsa in gestione.

Per rendere orfana una risorsa e reimportarla con un nuovo tipo di costrutto

  1. Distribuisci il tuo stack e verifica l'esistenza della risorsa.

  2. Esegui cdk orphan con il percorso di costruzione della risorsa:

    $ cdk orphan MyStack/MyTable --unstable=orphan

  3. Il comando genera una mappatura delle risorse. Salvalo per la fase di importazione.

  4. Aggiorna il codice CDK per utilizzare il nuovo tipo di costrutto (ad esempio, cambia Table inTableV2).

  5. Esegui cdk import con la mappatura delle risorse dall'output orfano:

    $ cdk import MyStack --resource-mapping-inline '{"MyTable":{"TableName":"my-table"}}'

  6. Una volta completata l'importazione, cdk import rileva la deriva e richiede all'utente di eseguire la distribuzione. Accettate la richiesta di riconciliare lo stack.

Questa funzionalità presenta attualmente le seguenti limitazioni:

  • Tutti i percorsi di costruzione devono fare riferimento allo stesso stack. La creazione di risorse orfane su più stack in un unico comando non è supportata.

  • I pattern wildcard non sono supportati. I percorsi vengono abbinati come prefissi esatti.

  • Questo comando richiede la versione 32 del modello bootstrap, che include le autorizzazioni IAM necessarie per il ruolo di distribuzione.

Utilizzo

$ cdk orphan <PATHS> <options>

Arguments (Argomenti)

PERCORSI

Uno o più percorsi di costruzione verso l'orfano, nel formato. StackName/ConstructPath Ad esempio, MyStack/MyTable. È possibile fornire più percorsi per rendere orfane diverse risorse in un unico comando.

Tutti i percorsi devono fare riferimento allo stesso stack.

▬Tipo: stringa

Obbligatorio: sì

Opzioni

Per un elenco di opzioni globali che funzionano con tutti i comandi CDK CLI, vedete Opzioni globali.

--help, -h <BOOLEAN>

Mostra le informazioni di riferimento relative al cdk orphan comando.

Esempi

Orfana: una sola risorsa

$ cdk orphan MyStack/MyTable --unstable=orphan

Risorse multiple orfane

$ cdk orphan MyStack/MyTable MyStack/MyBucket --unstable=orphan

Salta la richiesta di conferma

$ cdk orphan MyStack/MyTable --unstable=orphan --yes