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`
<a name="ref-cli-cdk-migrate"></a>

Migrasikan AWS sumber daya, AWS CloudFormation tumpukan, dan CloudFormation templat yang diterapkan ke dalam proyek CDK baru AWS .

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 selengkapnya tentang penggunaan`cdk migrate`, lihat [Memigrasikan sumber daya dan AWS CloudFormation templat yang ada ke AWS CDK](migrate.md).

**catatan**  
`cdk migrate`Perintah ini bersifat eksperimental dan mungkin memiliki perubahan yang melanggar di masa depan.

## Penggunaan
<a name="ref-cli-cdk-migrate-usage"></a>

```
$ cdk migrate <options>
```

## Opsi
<a name="ref-cli-cdk-migrate-options"></a>

Untuk daftar opsi global yang berfungsi dengan semua perintah CDK CLI, [lihat](ref-cli-cmd.md#ref-cli-cmd-options) Opsi global.

### Opsi yang diperlukan
<a name="ref-cli-cdk-migrate-options-required"></a><a name="ref-cli-cdk-migrate-options-stack-name"></a>

 `--stack-name <STRING>`   
Nama AWS CloudFormation tumpukan yang akan dibuat dalam aplikasi CDK setelah bermigrasi.  
 *Wajib*: Ya

### Opsi bersyarat
<a name="ref-cli-cdk-migrate-options-conditional"></a><a name="ref-cli-cdk-migrate-options-from-path"></a>

 `--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.<a name="ref-cli-cdk-migrate-options-from-scan"></a>

 `--from-scan <STRING>`   
Saat memigrasikan sumber daya yang diterapkan dari AWS lingkungan, gunakan opsi ini untuk menentukan apakah pemindaian baru harus dimulai atau apakah CLI AWS CDK harus menggunakan pemindaian terakhir yang berhasil.  
 *Diperlukan*: Bersyarat. Diperlukan saat bermigrasi dari sumber daya yang diterapkan AWS .  
 *Nilai yang diterima*:`most-recent`, `new` <a name="ref-cli-cdk-migrate-options-from-stack"></a>

 `--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
<a name="ref-cli-cdk-migrate-options-optional"></a><a name="ref-cli-cdk-migrate-options-account"></a>

 `--account <STRING>`   
Akun untuk mengambil template AWS CloudFormation tumpukan dari.  
 *Wajib*: Tidak  
 *Default*: AWS CDK CLI memperoleh informasi akun dari sumber default.<a name="ref-cli-cdk-migrate-options-compress"></a>

 `--compress <BOOLEAN>`   
Berikan opsi ini untuk mengompres proyek CDK yang dihasilkan menjadi `ZIP` file.  
 *Wajib*: Tidak<a name="ref-cli-cdk-migrate-options-filter"></a>

 `--filter <ARRAY>`   
Gunakan saat memigrasikan sumber daya yang diterapkan dari AWS akun dan AWS Wilayah. 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<a name="ref-cli-cdk-migrate-options-help"></a>

 `--help, -h <BOOLEAN>`   
Tampilkan informasi referensi perintah untuk `cdk migrate` perintah.<a name="ref-cli-cdk-migrate-options-language"></a>

 `--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` <a name="ref-cli-cdk-migrate-options-output-path"></a>

 `--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.<a name="ref-cli-cdk-migrate-options-region"></a>

 `--region <STRING>`   
 AWS Wilayah untuk mengambil template AWS CloudFormation tumpukan dari.  
 *Wajib*: Tidak  
 *Default*: AWS CDK CLI AWS memperoleh informasi Wilayah dari sumber default.

## Contoh
<a name="ref-cli-cdk-migrate-examples"></a>

### Contoh sederhana migrasi dari tumpukan CloudFormation
<a name="ref-cli-cdk-migrate-examples-1"></a>

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 dari migrasi dari template lokal CloudFormation
<a name="ref-cli-cdk-migrate-examples-2"></a>

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
<a name="ref-cli-cdk-migrate-examples-3"></a>

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"
```