View a markdown version of this page

cdk orphan - AWS Cloud Development Kit (AWS CDK) v2
PenggunaanArgumenOpsiContoh

Ini adalah Panduan Pengembang AWS CDK v2. CDK v1 yang lebih lama memasuki pemeliharaan pada 1 Juni 2022 dan mengakhiri dukungan pada 1 Juni 2023.

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

cdk orphan

penting

cdk orphanPerintah dalam rilis pratinjau dan dapat berubah.

Anda harus memberikan --unstable=orphan opsi saat menggunakan perintah ini.

Lepaskan satu atau lebih sumber daya dengan aman dari AWS CloudFormation tumpukan tanpa menghapusnya. Ini berguna ketika Anda perlu memigrasikan sumber daya dari satu jenis konstruksi ke jenis konstruksi lainnya (misalnya, memigrasikan DynamoDB Table keTableV2) tanpa downtime atau kehilangan data.

Saat Anda mengubah jenis konstruksi dalam kode CDK Anda, CloudFormation menafsirkan ini sebagai pengganti sumber daya, yang menghapus sumber daya yang ada dan membuat yang baru. Untuk sumber daya stateful seperti database dan penyimpanan, ini menyebabkan hilangnya data. cdk orphanPerintah menyelesaikan ini dengan melepaskan sumber daya dari tumpukan terlebih dahulu, sehingga Anda dapat mengimpornya kembali di bawah jenis konstruksi baru menggunakan. cdk import

Dengan cdk orphan, Anda dapat:

  • Lepaskan sumber daya stateful dari tumpukan sebelum mengubah jenis konstruksinya.

  • Migrasi antar versi konstruksi (misalnya, DynamoDB ke) tanpa kehilangan dataTable. TableV2

  • Ubah jenis CloudFormation sumber daya yang mendukung konstruksi tanpa mengganti sumber daya fisik.

Perintah yatim piatu melakukan tiga CloudFormation penyebaran:

  1. Selesaikan referensi: Menyelesaikan referensi lintas sumber daya (Ref,Fn::GetAtt,Fn::Sub) ke sumber daya yatim piatu, sehingga sumber daya lain dalam tumpukan yang bergantung padanya terus berfungsi setelah sumber daya yatim piatu dihapus.

  2. Decouple: Mengganti semua referensi lintas sumber daya dengan nilai literal yang diselesaikan, menyetel DeletionPolicy keRetain, dan menghapus DependsOn entri untuk mengisolasi sumber daya dari sisa tumpukan.

  3. Hapus: Menghapus sumber daya dari CloudFormation template. Sumber daya fisik terus ada di AWS akun Anda.

Setelah menjadi yatim piatu, perbarui kode CDK Anda untuk menggunakan jenis konstruksi baru dan gunakan impor cdk untuk mengembalikan sumber daya di bawah pengelolaan.

Untuk menjadi yatim piatu sumber daya dan mengimpornya kembali di bawah tipe konstruksi baru

  1. Terapkan tumpukan Anda dan verifikasi sumber daya yang ada.

  2. Jalankan cdk orphan dengan jalur konstruksi sumber daya:

    $ cdk orphan MyStack/MyTable --unstable=orphan

  3. Perintah menghasilkan pemetaan sumber daya. Simpan ini untuk langkah impor.

  4. Perbarui kode CDK Anda untuk menggunakan jenis konstruksi baru (misalnya, ubah Table keTableV2).

  5. Jalankan cdk import dengan pemetaan sumber daya dari output yatim piatu:

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

  6. Setelah impor selesai, cdk import mendeteksi penyimpangan dan meminta Anda untuk menerapkan. Terima prompt untuk merekonsiliasi tumpukan.

Fitur ini saat ini memiliki batasan sebagai berikut:

  • Semua jalur konstruksi harus mereferensikan tumpukan yang sama. Sumber daya yatim piatu di beberapa tumpukan dalam satu perintah tidak didukung.

  • Pola wildcard tidak didukung. Jalur dicocokkan sebagai awalan yang tepat.

  • Perintah ini memerlukan versi 32 dari template bootstrap, yang mencakup izin IAM yang diperlukan untuk peran penerapan.

Penggunaan

$ cdk orphan <PATHS> <options>

Argumen

JALUR

Satu atau lebih membangun jalan menuju yatim piatu, dalam format. StackName/ConstructPath Misalnya, MyStack/MyTable. Beberapa jalur dapat disediakan untuk yatim piatu beberapa sumber daya dalam satu perintah.

Semua jalur harus mereferensikan tumpukan yang sama.

Tipe: String

Wajib: Ya

Opsi

Untuk daftar opsi global yang berfungsi dengan semua perintah CDK CLI, lihat Opsi global.

--help, -h <BOOLEAN>

Tampilkan informasi referensi perintah untuk cdk orphan perintah.

Contoh

Yatim piatu sumber daya tunggal

$ cdk orphan MyStack/MyTable --unstable=orphan

Beberapa sumber daya yatim piatu

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

Lewati prompt konfirmasi

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