cdk migrate - AWS Cloud Development Kit (AWS CDK) v2
PenggunaanOpsiContoh

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 migrate

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 CLI perintah CDK, lihatOpsi global.

Opsi yang diperlukan

--stack-name STRING

Nama AWS CloudFormation tumpukan yang akan dibuat dalam aplikasi CDK setelah bermigrasi.

Wajib: Ya

Opsi bersyarat

--from-path PATH

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-scan STRING

Saat memigrasikan sumber daya yang digunakan dari AWS lingkungan, gunakan opsi ini untuk menentukan apakah pemindaian baru harus dimulai atau apakah AWS CDK CLI pemindaian terakhir yang berhasil.

Diperlukan: Bersyarat. Diperlukan saat bermigrasi dari sumber daya yang diterapkan AWS .

Nilai yang diterima:most-recent, new

--from-stack BOOLEAN

Berikan opsi ini untuk bermigrasi dari tumpukan yang diterapkan AWS CloudFormation . Gunakan --stack-name untuk menentukan nama AWS CloudFormation tumpukan yang digunakan.

Diperlukan: Bersyarat. Diperlukan jika bermigrasi dari tumpukan yang diterapkan AWS CloudFormation .

Opsi opsional

--account STRING

Akun untuk mengambil template AWS CloudFormation tumpukan dari.

Wajib: Tidak

Default: AWS CDK CLI Memperoleh informasi akun dari sumber default.

--compress BOOLEAN

Berikan opsi ini untuk mengompres proyek CDK yang dihasilkan menjadi ZIP file.

Wajib: Tidak

--filter ARRAY

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, tentukan resource-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 AND bersyarat. Contoh berikut memfilter untuk sumber daya DynamoDB apa pun yang ditandai myTagKey dengan sebagai kunci tag:. --filter resource-type-prefix="AWS::DynamoDB::", tag-key="myTagKey"

Berikan --filter opsi beberapa kali dalam satu perintah untuk logika OR bersyarat. Contoh berikut memfilter untuk sumber daya apa pun yang merupakan sumber daya DynamoDB atau ditandai myTagKey dengan sebagai kunci tag:. --filter resource-type-prefix="AWS::DynamoDB::" --filter tag-key="myTagKey"

Wajib: Tidak

--help, -h BOOLEAN

Tampilkan informasi referensi perintah untuk cdk migrate perintah.

--language STRING

Bahasa pemrograman yang digunakan untuk proyek CDK yang dibuat selama migrasi.

Wajib: Tidak

Nilai yang valid:typescript,python,java,csharp,go.

Default: typescript

--output-path PATH

Jalur keluaran untuk proyek CDK yang dimigrasi.

Wajib: Tidak

Default: Secara default, AWS CDK CLI akan menggunakan direktori kerja Anda saat ini.

--region STRING

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 TypeScript yang menyertakan 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 menggunakan 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 TypeScript dengan myCloudFormationStack tumpukan baru yang berisi sumber daya yang dimigrasi AWS :

$ cdk migrate --language typescript --from-scan --stack-name "myCloudFormationStack"