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

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 import

Gunakan impor AWS CloudFormation sumber daya untuk mengimpor AWS sumber daya yang ada ke tumpukan CDK.

Dengan perintah ini, Anda dapat mengambil sumber daya yang ada yang dibuat menggunakan metode lain dan mulai mengelolanya menggunakan AWS CDK.

Saat mempertimbangkan untuk memindahkan sumber daya ke manajemen CDK, terkadang membuat sumber daya baru dapat diterima, seperti dengan peran IAM, fungsi Lambda, dan aturan acara. Untuk sumber daya lain, seperti sumber daya stateful seperti bucket Amazon S3 dan tabel DynamoDB, membuat sumber daya baru dapat berdampak pada layanan Anda. Anda dapat menggunakan cdk import untuk mengimpor sumber daya yang ada dengan gangguan minimal ke layanan Anda. Untuk daftar AWS sumber daya yang didukung, lihat Dukungan jenis sumber daya di Panduan AWS CloudFormation Pengguna.

Untuk mengimpor sumber daya yang ada ke tumpukan CDK

  1. Jalankan a cdk diff untuk memastikan tumpukan CDK Anda tidak memiliki perubahan yang tertunda. Saat melakukan acdk import, satu-satunya perubahan yang diizinkan dalam operasi impor adalah penambahan sumber daya baru yang diimpor.

  2. Tambahkan konstruksi untuk sumber daya yang ingin Anda impor ke tumpukan Anda. Misalnya, tambahkan yang berikut ini untuk bucket Amazon S3:

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

    Jangan menambahkan perubahan lainnya. Anda juga harus memastikan untuk secara tepat memodelkan status yang dimiliki sumber daya saat ini. Untuk contoh bucket, pastikan untuk menyertakan AWS KMS kunci, kebijakan siklus hidup, dan hal lain yang relevan tentang bucket. Jika tidak, operasi pembaruan berikutnya mungkin tidak melakukan apa yang Anda harapkan.

  3. Jalankan cdk import. Jika ada beberapa tumpukan di aplikasi CDK, berikan nama tumpukan tertentu sebagai argumen.

  4. CDK CLI akan meminta Anda untuk meneruskan nama sebenarnya dari sumber daya yang Anda impor. Setelah Anda memberikan informasi ini, impor akan dimulai.

  5. Ketika cdk import melaporkan keberhasilan, sumber daya akan dikelola oleh CDK. Setiap perubahan selanjutnya dalam konfigurasi konstruksi akan tercermin pada sumber daya.

Fitur ini saat ini memiliki batasan sebagai berikut:

  • Mengimpor sumber daya ke tumpukan bersarang tidak dimungkinkan.

  • Tidak ada pemeriksaan apakah properti yang Anda tentukan benar dan lengkap untuk sumber daya yang diimpor. Coba mulai operasi deteksi drift setelah mengimpor.

  • Sumber daya yang bergantung pada sumber daya lain semuanya harus diimpor bersama, atau secara individual, dalam urutan yang benar. Jika tidak, CloudFormation penerapan akan gagal dengan referensi yang belum terselesaikan.

  • Perintah ini menggunakan kredenal peran penerapan, yang diperlukan untuk membaca bucket staging terenkripsi. Ini membutuhkan versi 12 dari template bootstrap, yang mencakup izin IAM yang diperlukan untuk peran penerapan.

Penggunaan

$ cdk import <arguments> <options>

Pendapat

ID logis tumpukan CDK

ID logis tumpukan CDK dari aplikasi Anda untuk mengimpor resource. Argumen ini dapat diberikan beberapa kali dalam satu perintah.

Tipe: String

Wajib: Tidak

Opsi

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

--change-set-name STRING

Nama CloudFormation perubahan diatur untuk membuat.

--execute BOOLEAN

Tentukan apakah akan mengeksekusi set perubahan.

Nilai default: true

--force, -f BOOLEAN

Secara default, CDK CLI keluar dari proses jika perbedaan template menyertakan pembaruan atau penghapusan. Tentukan true untuk mengganti perilaku ini dan selalu lanjutkan dengan mengimpor.

--help, -h BOOLEAN

Tampilkan informasi referensi perintah untuk cdk import perintah.

--record-resource-mapping, -r STRING

Gunakan opsi ini untuk menghasilkan pemetaan sumber daya fisik yang ada ke sumber daya CDK yang akan diimpor. Pemetaan akan ditulis ke jalur file yang Anda berikan. Tidak ada operasi impor aktual yang akan dilakukan.

--resource-mapping, -m STRING

Gunakan opsi ini untuk menentukan file yang mendefinisikan pemetaan sumber daya Anda. CDK CLI akan menggunakan file ini untuk memetakan sumber daya fisik ke sumber daya untuk diimpor alih-alih meminta Anda secara interaktif.

Opsi ini dapat dijalankan dari skrip.

--rollback BOOLEAN

Putar kembali tumpukan ke keadaan stabil saat gagal.

Untuk menentukanfalse, Anda dapat menggunakan --no-rollback atau-R.

Tentukan false untuk mengulangi lebih cepat. Penerapan yang berisi penggantian sumber daya akan selalu gagal.

Nilai default: true

--toolkit-stack-name STRING

Nama tumpukan CDK Toolkit untuk dibuat