Ini adalah Panduan Pengembang AWS CDK v2. CDKV1 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
-
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. -
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.
-
Jalankan
cdk import
. Jika ada beberapa tumpukan di aplikasi CDK, berikan nama tumpukan tertentu sebagai argumen. -
CDK CLI akan meminta Anda untuk meneruskan nama sebenarnya dari sumber daya yang Anda impor. Setelah Anda memberikan informasi ini, impor akan dimulai.
-
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 menentukan
false
, 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