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.
Migrasikan AWS sumber daya, AWS CloudFormation tumpukan, dan CloudFormation templat yang diterapkan ke dalam proyek baru. AWS CDK
Perintah ini membuat aplikasi CDK baru yang menyertakan satu tumpukan yang diberi nama dengan nilai yang Anda berikan. --stack-name Anda dapat mengonfigurasi sumber migrasi menggunakan--from-scan,--from-stack, atau--from-path.
Untuk informasi lebih lanjut tentang penggunaancdk migrate, lihatMigrasikan sumber daya dan AWS CloudFormation templat yang ada ke AWS CDK.
catatan
cdk migratePerintah ini bersifat eksperimental dan mungkin memiliki perubahan yang melanggar di masa depan.
Penggunaan
$cdk migrate<options>
Opsi
Untuk daftar opsi global yang berfungsi dengan semua CDK CLI perintah, lihatOpsi global.
Opsi yang diperlukan
--stack-nameSTRING-
Nama AWS CloudFormation tumpukan yang akan dibuat dalam aplikasi CDK setelah bermigrasi.
Wajib: Ya
Opsi bersyarat
--from-pathPATH-
Jalur ke AWS CloudFormation template untuk bermigrasi. Berikan opsi ini untuk menentukan template lokal.
Diperlukan: Bersyarat. Diperlukan jika bermigrasi dari AWS CloudFormation templat lokal.
--from-scanSTRING-
Saat memigrasikan sumber daya yang disebarkan dari AWS lingkungan, gunakan opsi ini untuk menentukan apakah pemindaian baru harus dimulai atau apakah AWS CDK CLI harus menggunakan pemindaian terakhir yang berhasil.
Diperlukan: Bersyarat. Diperlukan saat bermigrasi dari sumber daya yang diterapkan AWS .
Nilai yang diterima:
most-recent,new --from-stackBOOLEAN-
Berikan opsi ini untuk bermigrasi dari tumpukan yang diterapkan AWS CloudFormation . Gunakan
--stack-nameuntuk menentukan nama AWS CloudFormation tumpukan yang digunakan.Diperlukan: Bersyarat. Diperlukan jika bermigrasi dari tumpukan yang diterapkan AWS CloudFormation .
Opsi opsional
--accountSTRING-
Akun untuk mengambil template AWS CloudFormation tumpukan dari.
Wajib: Tidak
Default: AWS CDK CLI memperoleh informasi akun dari sumber default.
--compressBOOLEAN-
Berikan opsi ini untuk mengompres proyek CDK yang dihasilkan menjadi ZIP berkas.
Wajib: Tidak
--filterARRAY-
Gunakan saat memigrasikan sumber daya yang diterapkan dari AWS akun dan. Wilayah AWS Opsi ini menentukan filter untuk menentukan sumber daya yang digunakan untuk bermigrasi.
Opsi ini menerima array pasangan kunci-nilai, di mana kunci mewakili jenis filter dan nilai mewakili nilai untuk memfilter.
Berikut ini adalah kunci yang diterima:
-
resource-identifier— Pengenal untuk sumber daya. Nilai dapat berupa ID logis atau fisik sumber daya. Misalnya,resource-identifier="ClusterName". -
resource-type-prefix— Awalan tipe AWS CloudFormation sumber daya. Misalnya, tentukanresource-type-prefix="AWS::DynamoDB::"untuk memfilter semua sumber daya Amazon DynamoDB. -
tag-key— Kunci dari tag sumber daya. Misalnya,tag-key="myTagKey". -
tag-value— Nilai tag sumber daya. Misalnya,tag-value="myTagValue".
Berikan beberapa pasangan kunci-nilai untuk logika
ANDbersyarat. Contoh berikut memfilter untuk sumber daya DynamoDB apa pun yang ditandaimyTagKeydengan sebagai kunci tag:.--filter resource-type-prefix="AWS::DynamoDB::", tag-key="myTagKey"Berikan
--filteropsi beberapa kali dalam satu perintah untuk logikaORbersyarat. Contoh berikut memfilter untuk sumber daya apa pun yang merupakan sumber daya DynamoDB atau ditandaimyTagKeydengan sebagai kunci tag:.--filter resource-type-prefix="AWS::DynamoDB::" --filter tag-key="myTagKey"Wajib: Tidak
-
--help, -hBOOLEAN-
Tampilkan informasi referensi perintah untuk
cdk migrateperintah. --languageSTRING-
Bahasa pemrograman yang digunakan untuk proyek CDK yang dibuat selama migrasi.
Wajib: Tidak
Nilai yang valid:
typescript,python,java,csharp,go.Default:
typescript --output-pathPATH-
Jalur keluaran untuk proyek CDK yang dimigrasi.
Wajib: Tidak
Default: Secara default, AWS CDK CLI akan menggunakan direktori kerja Anda saat ini.
--regionSTRING-
Wilayah AWS Untuk mengambil template AWS CloudFormation tumpukan dari.
Wajib: Tidak
Default: AWS CDK CLI memperoleh Wilayah AWS informasi dari sumber default.
Contoh
Contoh sederhana migrasi dari tumpukan CloudFormation
Bermigrasi dari CloudFormation tumpukan yang diterapkan di AWS lingkungan tertentu menggunakan. --from-stack Berikan --stack-name nama tumpukan CDK baru Anda. Berikut ini adalah contoh yang bermigrasi myCloudFormationStack ke aplikasi CDK baru yang menggunakan TypeScript:
$cdk migrate --language typescript --from-stack --stack-name 'myCloudFormationStack'
Contoh sederhana migrasi dari template lokal CloudFormation
Migrasi dari template JSON atau YAMB lokal menggunakan. CloudFormation --from-path Berikan --stack-name nama tumpukan CDK baru Anda. Berikut ini adalah contoh yang membuat aplikasi CDK baru di TypeScript yang mencakup myCloudFormationStack tumpukan dari template.json file lokal:
$cdk migrate --stack-name "myCloudFormationStack" --language typescript --from-path "./template.json"
Contoh sederhana migrasi dari sumber daya yang digunakan AWS
Migrasikan AWS sumber daya yang diterapkan dari AWS lingkungan tertentu yang tidak terkait dengan CloudFormation tumpukan yang digunakan. --from-scan CDK CLI memanfaatkan IaC generator layanan untuk memindai sumber daya dan menghasilkan template. Kemudian, CDK CLI mereferensikan template untuk membuat aplikasi CDK baru. Berikut ini adalah contoh yang membuat aplikasi CDK baru di TypeScript dengan myCloudFormationStack tumpukan baru yang berisi AWS sumber daya yang dimigrasi:
$cdk migrate --language typescript --from-scan --stack-name "myCloudFormationStack"
