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.

# AWS Referensi perintah CDK CLI
<a name="ref-cli-cmd"></a>

Bagian ini berisi informasi referensi perintah untuk AWS Cloud Development Kit (AWS CDK) Command Line Interface (CLI). CDK CLI juga disebut sebagai CDK Toolkit.

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

```
$ cdk <command> <arguments> <options>
```

## Perintah
<a name="ref-cli-cmd-commands"></a><a name="ref-cli-cmd-commands-acknowledge"></a>

 ` acknowledge ack `   
Akui pemberitahuan berdasarkan nomor terbitan dan sembunyikan agar tidak ditampilkan lagi.<a name="ref-cli-cmd-commands-bootstrap"></a>

 ` bootstrap `   
Siapkan AWS lingkungan untuk penerapan CDK dengan menyebarkan tumpukan bootstrap CDK, bernama`CDKToolkit`, ke lingkungan. AWS <a name="ref-cli-cmd-commands-context"></a>

 ` context `   
Kelola nilai konteks cache untuk aplikasi CDK Anda.<a name="ref-cli-cmd-commands-deploy"></a>

 ` deploy `   
Terapkan satu atau lebih tumpukan CDK ke lingkungan Anda. AWS <a name="ref-cli-cmd-commands-destroy"></a>

 ` destroy `   
Hapus satu atau beberapa tumpukan CDK dari lingkungan Anda AWS .<a name="ref-cli-cmd-commands-diff"></a>

 ` diff `   
Lakukan diff untuk melihat perubahan infrastruktur di antara tumpukan CDK.<a name="ref-cli-cmd-commands-docs"></a>

 ` docs doc `   
Buka dokumentasi CDK di browser Anda.<a name="ref-cli-cmd-commands-doctor"></a>

 ` doctor `   
Periksa dan tampilkan informasi berguna tentang proyek CDK lokal dan lingkungan pengembangan Anda.<a name="ref-cli-cmd-commands-drift"></a>

 ` drift `   
Deteksi penyimpangan konfigurasi untuk sumber daya yang Anda tentukan, kelola, dan terapkan menggunakan CDK.<a name="ref-cli-cmd-commands-flags"></a>

 ` flags `   
Lihat dan ubah konfigurasi flag fitur Anda untuk CDK CLI.<a name="ref-cli-cmd-commands-import"></a>

 ` import `   
Gunakan impor AWS CloudFormation sumber daya untuk mengimpor AWS sumber daya yang ada ke tumpukan CDK.<a name="ref-cli-cmd-commands-init"></a>

 ` init `   
Buat proyek CDK baru dari template.<a name="ref-cli-cmd-commands-list"></a>

 ` list, ls `   
Buat daftar semua tumpukan CDK dan dependensinya dari aplikasi CDK.<a name="ref-cli-cmd-commands-metadata"></a>

 ` metadata `   
Tampilkan metadata yang terkait dengan tumpukan CDK.<a name="ref-cli-cmd-commands-migrate"></a>

 ` migrate `   
Migrasikan AWS sumber daya, AWS CloudFormation tumpukan, dan AWS CloudFormation templat ke dalam proyek CDK baru.<a name="ref-cli-cmd-commands-notices"></a>

 ` notices `   
Tampilkan pemberitahuan untuk aplikasi CDK Anda.<a name="ref-cli-cmd-commands-refactor"></a>

 ` refactor `   
Pertahankan sumber daya yang diterapkan saat memfaktorkan ulang kode di aplikasi CDK Anda.<a name="ref-cli-cmd-commands-synthesize"></a>

 ` synthesize, synth `   
Sintesis aplikasi CDK untuk menghasilkan rakitan cloud, termasuk AWS CloudFormation template untuk setiap tumpukan.<a name="ref-cli-cmd-commands-watch"></a>

 ` watch `   
Terus menonton proyek CDK lokal untuk perubahan untuk melakukan penerapan dan hotswap.

## Opsi global
<a name="ref-cli-cmd-options"></a>

Opsi berikut kompatibel dengan semua perintah CDK CLI.<a name="ref-cli-cmd-options-app"></a>

 `--app, -a <STRING>`   
Berikan perintah untuk menjalankan aplikasi atau direktori perakitan cloud Anda.  
 *Wajib*: Ya<a name="ref-cli-cmd-options-asset-metadata"></a>

 `--asset-metadata <BOOLEAN>`   
Sertakan `aws:asset:*` AWS CloudFormation metadata untuk sumber daya yang menggunakan aset.  
 *Wajib*: Tidak  
 *Nilai default*: `true` <a name="ref-cli-cmd-options-build"></a>

 `--build <STRING>`   
Perintah untuk menjalankan build pra-sintesis.  
 *Wajib*: Tidak<a name="ref-cli-cmd-options-ca-bundle-path"></a>

 `--ca-bundle-path <STRING>`   
Jalur ke sertifikat CA untuk digunakan saat memvalidasi permintaan HTTPS.  
Jika opsi ini tidak disediakan, CDK CLI akan membaca dari variabel lingkungan`AWS_CA_BUNDLE`.  
 *Wajib*: Ya<a name="ref-cli-cmd-options-ci"></a>

 `--ci <BOOLEAN>`   
Tunjukkan bahwa perintah CDK CLI sedang dijalankan dalam lingkungan integrasi berkelanjutan (CI).  
Opsi ini memodifikasi perilaku CLI CDK agar lebih sesuai dengan operasi otomatis yang khas di saluran pipa CI.  
Saat Anda memberikan opsi ini, log dikirim ke `stdout` alih-alih`stderr`.  
 *Wajib*: Tidak  
 *Nilai default*: `false` <a name="ref-cli-cmd-options-context"></a>

 `--context, -c <ARRAY>`   
Tambahkan parameter string kontekstual sebagai pasangan kunci-nilai.<a name="ref-cli-cmd-options-debug"></a>

 `--debug <BOOLEAN>`   
Aktifkan informasi debugging terperinci. Opsi ini menghasilkan output verbose yang mencakup lebih banyak detail tentang apa yang dilakukan CDK CLI di belakang layar.  
 *Wajib*: Tidak  
 *Nilai default*: `false` <a name="ref-cli-cmd-options-ec2creds"></a>

 `--ec2creds, -i <BOOLEAN>`   
Paksa CLI CDK untuk mencoba dan mengambil kredenal instans Amazon EC2 .  
Secara default, CDK CLI menebak status instans EC2 Amazon.  
 *Wajib*: Tidak  
 *Nilai default*: `false` <a name="ref-cli-cmd-options-help"></a>

 `--help, -h <BOOLEAN>`   
Tampilkan informasi referensi perintah untuk CDK CLI.  
 *Wajib*: Tidak  
 *Nilai default*: `false` <a name="ref-cli-cmd-options-ignore-errors"></a>

 `--ignore-errors <BOOLEAN>`   
Abaikan kesalahan sintesis, yang kemungkinan akan menghasilkan output yang tidak valid.  
 *Wajib*: Tidak  
 *Nilai default*: `false` <a name="ref-cli-cmd-options-json"></a>

 `--json, -j <BOOLEAN>`   
Gunakan JSON alih-alih YAMAL untuk AWS CloudFormation template yang dicetak ke output standar ()`stdout`.  
 *Wajib*: Tidak  
 *Nilai default*: `false` <a name="ref-cli-cmd-options-lookups"></a>

 `--lookups <BOOLEAN>`   
Lakukan pencarian konteks.  
Sintesis akan gagal jika nilai ini `false` dan pencarian konteks perlu dilakukan.  
 *Wajib*: Tidak  
 *Nilai default*: `true` <a name="ref-cli-cmd-options-no-color"></a>

 `--no-color <BOOLEAN>`   
Hapus warna dan gaya lainnya dari output konsol.  
 *Wajib*: Tidak  
 *Nilai default*: `false` <a name="ref-cli-cmd-options-notices"></a>

 `--notices <BOOLEAN>`   
Tampilkan pemberitahuan yang relevan.  
 *Wajib*: Tidak  
 *Nilai default*: `false` <a name="ref-cli-cmd-options-output"></a>

 `--output, -o <STRING>`   
Tentukan direktori untuk menampilkan rakitan cloud yang disintesis.  
 *Wajib*: Ya  
 *Nilai default*: `cdk.out` <a name="ref-cli-cmd-options-path-metadata"></a>

 `--path-metadata <BOOLEAN>`   
Sertakan `aws::cdk::path` AWS CloudFormation metadata untuk setiap sumber daya.  
 *Wajib*: Tidak  
 *Nilai default*: `true` <a name="ref-cli-cmd-options-plugin"></a>

 `--plugin, -p <ARRAY>`   
Nama atau jalur paket node yang memperluas fitur CDK. Opsi ini dapat diberikan beberapa kali dalam satu perintah.  
Anda dapat mengonfigurasi opsi ini di `cdk.json` file proyek atau `~/.cdk.json` di mesin pengembangan lokal Anda:  

```
{
   // ...
   "plugin": [
      "module_1",
      "module_2"
   ],
   // ...
}
```
 *Wajib*: Tidak<a name="ref-cli-cmd-options-profile"></a>

 `--profile <STRING>`   
Tentukan nama AWS profil, yang berisi informasi AWS lingkungan Anda, untuk digunakan dengan CDK CLI.  
 *Wajib*: Ya<a name="ref-cli-cmd-options-proxy"></a>

 `--proxy <STRING>`   
Gunakan proxy yang ditunjukkan.  
Jika opsi ini tidak disediakan, CDK CLI akan membaca dari variabel lingkungan`HTTPS_PROXY`.  
 *Wajib*: Ya  
 *Nilai default*: Baca dari variabel `HTTPS_PROXY` lingkungan.<a name="ref-cli-cmd-options-role-arn"></a>

 `--role-arn, -r <STRING>`   
ARN dari peran IAM yang akan diasumsikan oleh CDK CLI saat berinteraksi. AWS CloudFormation  
 *Wajib*: Tidak<a name="ref-cli-cmd-options-staging"></a>

 `--staging <BOOLEAN>`   
Salin aset ke direktori output.  
Tentukan `false` untuk mencegah penyalinan aset ke direktori output. Hal ini memungkinkan AWS SAM CLI untuk mereferensikan file sumber asli saat melakukan debugging lokal.  
 *Wajib*: Tidak  
 *Nilai default*: `true` <a name="ref-cli-cmd-options-strict"></a>

 `--strict <BOOLEAN>`   
Jangan membuat tumpukan yang berisi peringatan.  
 *Wajib*: Tidak  
 *Nilai default*: `false` <a name="ref-cli-cmd-options-trace"></a>

 `--trace <BOOLEAN>`   
Cetak jejak untuk peringatan tumpukan.  
 *Wajib*: Tidak  
 *Nilai default*: `false` <a name="ref-cli-cmd-options-verbose"></a>

 `--verbose, -v <COUNT>`   
Tampilkan log debug. Anda dapat menentukan opsi ini beberapa kali untuk meningkatkan verbositas.  
 *Wajib*: Tidak<a name="ref-cli-cmd-options-version"></a>

 `--version <BOOLEAN>`   
Tampilkan nomor versi CDK CLI.  
 *Wajib*: Tidak  
 *Nilai default*: `false` <a name="ref-cli-cmd-options-version-reporting"></a>

 `--version-reporting <BOOLEAN>`   
Sertakan ` AWS::CDK::Metadata` sumber daya dalam AWS CloudFormation templat yang disintesis.  
 *Wajib*: Tidak  
 *Nilai default*: `true` 

## Menyediakan dan mengonfigurasi opsi
<a name="ref-cli-cmd-configure"></a>

Anda dapat meneruskan opsi melalui argumen baris perintah. Untuk sebagian besar opsi, Anda dapat mengonfigurasinya dalam file `cdk.json` konfigurasi. Saat Anda menggunakan beberapa sumber konfigurasi, CDK CLI mematuhi prioritas berikut:

1.  **Nilai baris perintah** - Opsi apa pun yang disediakan pada opsi penggantian baris perintah yang dikonfigurasi dalam file. `cdk.json`

1.  **File konfigurasi proyek** — `cdk.json` File di direktori proyek CDK Anda.

1.  **File konfigurasi pengguna** — `cdk.json` File yang terletak `~/.cdk.json` di mesin lokal Anda.

## Melewati opsi di baris perintah
<a name="ref-cli-cmd-pass"></a><a name="ref-cli-cmd-pass-bool"></a>

 **Melewati nilai boolean**   
Untuk opsi yang menerima nilai boolean, Anda dapat menentukannya dengan cara berikut:  
+ Gunakan `true` dan `false` nilai - Berikan nilai boolean dengan perintah. Berikut ini adalah contohnya:

  ```
  $ cdk deploy --watch=true
  $ cdk deploy --watch=false
  ```
+ Berikan mitra opsi - Ubah nama opsi dengan menambahkan `no` untuk menentukan `false` nilai. Berikut ini adalah contohnya:

  ```
  $ cdk deploy --watch
  $ cdk deploy --no-watch
  ```
+ Untuk opsi yang default ke `true` atau`false`, Anda tidak perlu memberikan opsi kecuali Anda ingin mengubah dari default.

# `cdk acknowledge`
<a name="ref-cli-cmd-ack"></a>

Akui pemberitahuan berdasarkan nomor terbitan dan sembunyikan agar tidak ditampilkan lagi.

Ini berguna untuk menyembunyikan pemberitahuan yang telah ditangani atau tidak berlaku untuk Anda.

Ucapan terima kasih disimpan di tingkat proyek CDK. Jika Anda mengakui pemberitahuan dalam satu proyek CDK, itu akan tetap ditampilkan di proyek lain sampai diakui di sana.

## Penggunaan
<a name="ref-cli-cmd-ack-usage"></a>

```
$ cdk acknowledge <arguments> <options>
```

## Pendapat
<a name="ref-cli-cmd-ack-args"></a><a name="ref-cli-cmd-ack-args-notice-id"></a>

 **ID Pemberitahuan**   
ID pemberitahuan.  
 *Tipe*: String  
 *Wajib*: Tidak

## Opsi
<a name="ref-cli-cmd-ack-options"></a>

Untuk daftar opsi global yang berfungsi dengan semua perintah CDK CLI, [lihat](ref-cli-cmd.md#ref-cli-cmd-options) Opsi global.<a name="ref-cli-cmd-ack-options-help"></a>

 `--help, -h <BOOLEAN>`   
Tampilkan informasi referensi perintah untuk `cdk acknowledge` perintah.

## Contoh
<a name="ref-cli-cmd-ack-examples"></a>

### Akui dan sembunyikan pemberitahuan yang ditampilkan saat menjalankan perintah CDK CLI lainnya
<a name="ref-cli-cmd-ack-examples-1"></a>

```
$ cdk deploy
... # Normal output of the command

NOTICES

16603   Toggling off auto_delete_objects for Bucket empties the bucket

        Overview: If a stack is deployed with an S3 bucket with
                  auto_delete_objects=True, and then re-deployed with
                  auto_delete_objects=False, all the objects in the bucket
                  will be deleted.

        Affected versions: <1.126.0.

        More information at: https://github.com/aws/aws-cdk/issues/16603


17061   Error when building EKS cluster with monocdk import

        Overview: When using monocdk/aws-eks to build a stack containing
                  an EKS cluster, error is thrown about missing
                  lambda-layer-node-proxy-agent/layer/package.json.

        Affected versions: >=1.126.0 <=1.130.0.

        More information at: https://github.com/aws/aws-cdk/issues/17061

$ cdk acknowledge 16603
```

# `cdk bootstrap`
<a name="ref-cli-cmd-bootstrap"></a>

Siapkan AWS lingkungan untuk penerapan CDK dengan menyebarkan tumpukan bootstrap CDK, bernama`CDKToolkit`, ke lingkungan. AWS 

Tumpukan bootstrap adalah CloudFormation tumpukan yang menyediakan bucket Amazon S3 dan repositori Amazon ECR di lingkungan. AWS AWS CDK CLI menggunakan sumber daya ini untuk menyimpan templat yang disintesis dan aset terkait selama penerapan.

## Penggunaan
<a name="ref-cli-cmd-bootstrap-usage"></a>

```
$ cdk bootstrap <arguments> <options>
```

## Pendapat
<a name="ref-cli-cmd-bootstrap-args"></a><a name="ref-cli-cmd-bootstrap-args-env"></a>

 ** AWS lingkungan**   
 AWS Lingkungan target untuk menyebarkan tumpukan bootstrap ke dalam format berikut:`aws://<account-id>/<region>`.  
Contoh: `aws://123456789012/us-east-1`   
Argumen ini dapat diberikan beberapa kali dalam satu perintah untuk menyebarkan tumpukan bootstrap ke beberapa lingkungan.  
Secara default, CDK CLI akan mem-bootstrap semua lingkungan yang direferensikan dalam aplikasi CDK atau akan menentukan lingkungan dari sumber default. Ini bisa berupa lingkungan yang ditentukan menggunakan `--profile` opsi, dari variabel lingkungan, atau sumber AWS CLI default.

## Opsi
<a name="ref-cli-cmd-bootstrap-options"></a>

Untuk daftar opsi global yang berfungsi dengan semua perintah CDK CLI, [lihat](ref-cli-cmd.md#ref-cli-cmd-options) Opsi global.<a name="ref-cli-cmd-bootstrap-options-bootstrap-bucket-name"></a>

 `--bootstrap-bucket-name, --toolkit-bucket-name, -b <STRING>`   
Nama bucket Amazon S3 yang akan digunakan oleh CDK CLI. Bucket ini akan dibuat dan saat ini tidak boleh ada.  
Berikan opsi ini untuk mengganti nama default bucket Amazon S3.  
Saat Anda menggunakan opsi ini, Anda mungkin harus menyesuaikan sintesis. Untuk mempelajari lebih lanjut, lihat [Menyesuaikan sintesis tumpukan CDK](configure-synth.md#bootstrapping-custom-synth).  
 *Nilai default*: Tidak terdefinisi<a name="ref-cli-cmd-bootstrap-options-bootstrap-customer-key"></a>

 `--bootstrap-customer-key <BOOLEAN>`   
Buat Customer Master Key (CMK) untuk bucket bootstrap (Anda akan dikenakan biaya tetapi dapat menyesuaikan izin, hanya bootstrap modern).  
Opsi ini tidak kompatibel dengan`--bootstrap-kms-key-id`.  
 *Nilai default*: Tidak terdefinisi<a name="ref-cli-cmd-bootstrap-options-bootstrap-kms-key-id"></a>

 `--bootstrap-kms-key-id <STRING>`   
ID kunci master AWS KMS yang digunakan untuk `SSE-KMS` enkripsi.  
Berikan opsi ini untuk mengganti kunci AWS KMS default yang digunakan untuk mengenkripsi bucket Amazon S3.  
Opsi ini tidak kompatibel dengan`--bootstrap-customer-key`.  
 *Nilai default*: Tidak terdefinisi<a name="ref-cli-cmd-bootstrap-options-cloudformation-execution-policies"></a>

 `--cloudformation-execution-policies <ARRAY>`   
Kebijakan IAM terkelola ARNs yang harus dilampirkan ke peran penerapan yang diasumsikan AWS CloudFormation selama penerapan tumpukan Anda.  
Secara default, tumpukan digunakan dengan izin administrator penuh menggunakan kebijakan. `AdministratorAccess`  
Anda dapat memberikan opsi ini beberapa kali dalam satu perintah. Anda juga dapat memberikan beberapa ARNs sebagai string tunggal, dengan individu ARNs dipisahkan dengan koma. Berikut ini adalah contohnya:  

```
$ cdk bootstrap --cloudformation-execution-policies "arn:aws:iam::aws:policy/AWSLambda_FullAccess,arn:aws:iam::aws:policy/AWSCodeDeployFullAccess"
```
Untuk menghindari kegagalan penerapan, pastikan bahwa kebijakan yang Anda tentukan cukup untuk penerapan apa pun yang akan Anda lakukan ke lingkungan yang di-bootstrap.  
Opsi ini hanya berlaku untuk bootstrap modern.  
Template bootstrap modern secara efektif memberikan izin yang tersirat oleh `--cloudformation-execution-policies` ke AWS akun mana pun dalam daftar. `--trust` Secara default, ini memperluas izin untuk membaca dan menulis ke sumber daya apa pun di akun bootstrap. Pastikan untuk [mengonfigurasi tumpukan bootstrap](bootstrapping-customizing.md) dengan kebijakan dan akun tepercaya yang nyaman bagi Anda.
 *Nilai default*: `[]` <a name="ref-cli-cmd-bootstrap-options-custom-permissions-boundary"></a>

 `--custom-permissions-boundary, -cpb <STRING>`   
Tentukan nama batas izin yang akan digunakan.  
Opsi ini tidak kompatibel dengan`--example-permissions-boundary`.  
 *Nilai default*: Tidak terdefinisi<a name="ref-cli-cmd-bootstrap-options-example-permissions-boundary"></a>

 `--example-permissions-boundary, -epb <BOOLEAN>`   
Gunakan batas izin contoh, yang disediakan oleh CDK. AWS   
Opsi ini tidak kompatibel dengan`--custom-permissions-boundary`.  
Kebijakan batas izin yang diberikan CDK harus dianggap sebagai contoh. Edit konten dan referensikan kebijakan contoh jika Anda menguji fitur tersebut. Ubah menjadi kebijakan baru untuk penerapan aktual, jika belum ada. Kekhawatirannya adalah untuk menghindari drift. Kemungkinan besar, batas izin dipertahankan dan memiliki konvensi khusus, termasuk penamaan.  
Untuk informasi selengkapnya tentang mengonfigurasi izin, termasuk menggunakan batas izin, lihat Panduan Pengembang [Keamanan dan Keselamatan](https://github.com/aws/aws-cdk/wiki/Security-And-Safety-Dev-Guide).  
 *Nilai default*: Tidak terdefinisi<a name="ref-cli-cmd-bootstrap-options-execute"></a>

 `--execute <BOOLEAN>`   
Konfigurasikan apakah akan menjalankan set perubahan.  
 *Nilai default*: `true` <a name="ref-cli-cmd-bootstrap-options-force"></a>

 `--force, -f <BOOLEAN>`   
Selalu bootstrap, bahkan jika itu akan menurunkan versi template bootstrap.  
 *Nilai default*: `false` <a name="ref-cli-cmd-bootstrap-options-help"></a>

 `--help, -h <BOOLEAN>`   
Tampilkan informasi referensi perintah untuk `cdk bootstrap` perintah.<a name="ref-cli-cmd-bootstrap-options-previous-parameters"></a>

 `--previous-parameters <BOOLEAN>`   
Gunakan nilai sebelumnya untuk parameter yang ada.  
Setelah template bootstrap digunakan dengan serangkaian parameter, Anda harus mengatur opsi ini `false` untuk mengubah parameter apa pun pada penerapan masa depan. Kapan`false`, Anda harus memasok ulang semua parameter yang disediakan sebelumnya.  
 *Nilai default*: `true` <a name="ref-cli-cmd-bootstrap-options-public-access-block-configuration"></a>

 `--public-access-block-configuration <BOOLEAN>`   
Blokir konfigurasi akses publik di bucket Amazon S3 yang dibuat dan digunakan oleh CDK CLI.  
 *Nilai default*: `true` <a name="ref-cli-cmd-bootstrap-options-qualifier"></a>

 `--qualifier <STRING>`   
Nilai string sembilan digit yang unik untuk setiap tumpukan bootstrap. Nilai ini ditambahkan ke ID fisik sumber daya di tumpukan bootstrap.  
Dengan menyediakan qualifier, Anda menghindari bentrokan nama sumber daya saat menyediakan beberapa tumpukan bootstrap di lingkungan yang sama.  
Saat Anda mengubah qualifier, aplikasi CDK Anda harus meneruskan nilai yang diubah ke stack synthesizer. Untuk informasi selengkapnya, lihat [Menyesuaikan sintesis tumpukan CDK](configure-synth.md#bootstrapping-custom-synth).  
 *Nilai default*:`hnb659fds`. Nilai ini tidak memiliki signifikansi.<a name="ref-cli-cmd-bootstrap-options-show-template"></a>

 `--show-template <BOOLEAN>`   
Alih-alih bootstrap, cetak template bootstrap saat ini ke output standar (). `stdout` Anda kemudian dapat menyalin dan menyesuaikan template seperlunya.  
 *Nilai default*: `false` <a name="ref-cli-cmd-bootstrap-options-tags"></a>

 `--tags, -t <ARRAY>`   
Tag untuk ditambahkan ke tumpukan bootstrap dalam format`KEY=VALUE`.  
 *Nilai default*: `[]` <a name="ref-cli-cmd-bootstrap-options-template"></a>

 `--template <STRING>`   
Gunakan template dari file yang diberikan alih-alih yang bawaan.<a name="ref-cli-cmd-bootstrap-options-termination-protection"></a>

 `--termination-protection <BOOLEAN>`   
Alihkan perlindungan AWS CloudFormation terminasi pada tumpukan bootstrap.  
Kapan`true`, perlindungan terminasi diaktifkan. Ini mencegah tumpukan bootstrap terhapus secara tidak sengaja.  
Untuk mempelajari lebih lanjut tentang perlindungan penghentian, lihat [Melindungi tumpukan agar tidak dihapus](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-protect-stacks.html) di *Panduan AWS CloudFormation Pengguna*.  
 *Nilai default*: Tidak terdefinisi<a name="ref-cli-cmd-bootstrap-options-toolkit-stack-name"></a>

 `--toolkit-stack-name <STRING>`   
Nama tumpukan bootstrap untuk dibuat.  
Secara default, `cdk bootstrap` menyebarkan tumpukan bernama `CDKToolkit` ke dalam AWS lingkungan yang ditentukan. Gunakan opsi ini untuk memberikan nama yang berbeda untuk tumpukan bootstrap Anda.  
CDK CLI menggunakan nilai ini untuk memverifikasi versi stack bootstrap Anda.  
 *Nilai default*: `CDKToolkit`   
 *Wajib*: Ya<a name="ref-cli-cmd-bootstrap-options-trust"></a>

 `--trust <ARRAY>`   
 AWS Akun IDs yang harus dipercaya untuk melakukan penerapan ke lingkungan ini.  
Akun yang melakukan bootstrap akan selalu dipercaya.  
Opsi ini mengharuskan Anda juga menyediakan`--cloudformation-execution-policies`.  
Anda dapat memberikan opsi ini beberapa kali dalam satu perintah.  
Opsi ini hanya berlaku untuk bootstrap modern.  
Untuk menambahkan akun tepercaya ke tumpukan bootstrap yang ada, Anda harus menentukan semua akun yang akan dipercaya, termasuk yang mungkin telah Anda sediakan sebelumnya. Jika Anda hanya memberikan akun baru untuk dipercaya, akun tepercaya sebelumnya akan dihapus.  
Berikut ini adalah contoh yang mempercayai dua akun:  

```
$ cdk bootstrap aws://123456789012/us-west-2 --trust 234567890123 --trust 987654321098 --cloudformation-execution-policies arn:aws:iam::aws:policy/AdministratorAccess
 ⏳  Bootstrapping environment aws://123456789012/us-west-2...
Trusted accounts for deployment: 234567890123, 987654321098
Trusted accounts for lookup: (none)
Execution policies: arn:aws:iam::aws:policy/AdministratorAccess
CDKToolkit: creating CloudFormation changeset...
 ✅  Environment aws://123456789012/us-west-2 bootstrapped.
```
Template bootstrap modern secara efektif memberikan izin yang tersirat oleh `--cloudformation-execution-policies` ke AWS akun mana pun dalam daftar. `--trust` Secara default, ini memperluas izin untuk membaca dan menulis ke sumber daya apa pun di akun bootstrap. Pastikan untuk [mengonfigurasi tumpukan bootstrap](bootstrapping-customizing.md) dengan kebijakan dan akun tepercaya yang nyaman bagi Anda.
 *Nilai default*: `[]` <a name="ref-cli-cmd-bootstrap-options-trust-for-lookup"></a>

 `--trust-for-lookup <ARRAY>`   
 AWS Akun IDs yang harus dipercaya untuk mencari nilai di lingkungan ini.  
Gunakan opsi ini untuk memberikan izin akun untuk mensintesis tumpukan yang akan diterapkan ke lingkungan, tanpa benar-benar memberi mereka izin untuk menyebarkan tumpukan tersebut secara langsung.  
Anda dapat memberikan opsi ini beberapa kali dalam satu perintah.  
Opsi ini hanya berlaku untuk bootstrap modern.  
 *Nilai default*: `[]` 

## Contoh
<a name="ref-cli-cmd-bootstrap-examples"></a>

### Bootstrap AWS lingkungan yang ditentukan dalam profil prod
<a name="ref-cli-cmd-bootstrap-examples-1"></a>

```
$ cdk bootstrap --profile prod
```

### Terapkan tumpukan bootstrap ke lingkungan foo dan bar
<a name="ref-cli-cmd-bootstrap-examples-2"></a>

```
$ cdk bootstrap --app='node bin/main.js' foo bar
```

### Ekspor template bootstrap untuk menyesuaikannya
<a name="ref-cli-cmd-bootstrap-examples-3"></a>

Jika Anda memiliki persyaratan khusus yang tidak dipenuhi oleh template bootstrap, Anda dapat menyesuaikannya agar sesuai dengan kebutuhan Anda.

Anda dapat mengekspor template bootstrap, memodifikasinya, dan menerapkannya menggunakan AWS CloudFormation. Berikut ini adalah contoh mengekspor template yang ada:

```
$ cdk bootstrap --show-template > bootstrap-template.yaml
```

Anda juga dapat memberi tahu CDK CLI untuk menggunakan template khusus. Berikut ini adalah contohnya:

```
$ cdk bootstrap --template my-bootstrap-template.yaml
```

### Bootstrap dengan batas izin. Kemudian, hapus batas izin itu
<a name="ref-cli-cmd-bootstrap-examples-4"></a>

Untuk bootstrap dengan batas izin khusus, kami menjalankan yang berikut:

```
$ cdk bootstrap --custom-permissions-boundary my-permissions-boundary
```

Untuk menghapus batas izin, kami menjalankan yang berikut:

```
$ cdk bootstrap --no-previous-parameters
```

### Gunakan kualifikasi untuk membedakan sumber daya yang dibuat untuk lingkungan pengembangan
<a name="ref-cli-cmd-bootstrap-examples-5"></a>

```
$ cdk bootstrap --qualifier dev2024
```

# `cdk context`
<a name="ref-cli-cmd-context"></a>

Kelola nilai konteks cache untuk aplikasi AWS CDK Anda.

 *Konteks* mewakili konfigurasi dan informasi lingkungan yang dapat memengaruhi cara tumpukan Anda disintesis dan digunakan. Gunakan `cdk context` untuk melakukan hal berikut:
+ Lihat nilai konteks yang dikonfigurasi.
+ Tetapkan dan kelola nilai konteks.
+ Hapus nilai konteks.

## Penggunaan
<a name="ref-cli-cmd-context-usage"></a>

```
$ cdk context <options>
```

## Opsi
<a name="ref-cli-cmd-context-options"></a>

Untuk daftar opsi global yang berfungsi dengan semua perintah CDK CLI, [lihat](ref-cli-cmd.md#ref-cli-cmd-options) Opsi global.<a name="ref-cli-cmd-context-options-clear"></a>

 `--clear <BOOLEAN>`   
Hapus semua konteks.<a name="ref-cli-cmd-context-options-force"></a>

 `--force, -f <BOOLEAN>`   
Abaikan kesalahan kunci yang hilang.  
 *Nilai default*: `false` <a name="ref-cli-cmd-context-options-help"></a>

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

 `--reset, -e <STRING>`   
Kunci konteks, atau indeksnya, untuk mengatur ulang.

# `cdk deploy`
<a name="ref-cli-cmd-deploy"></a>

Terapkan satu atau lebih tumpukan AWS CDK ke lingkungan Anda. AWS 

Selama penyebaran, CDK CLI akan menampilkan indikator kemajuan, mirip dengan apa yang dapat diamati dari konsol. AWS CloudFormation 

Jika AWS lingkungan tidak di-bootstrap, hanya tumpukan tanpa aset dan dengan templat yang disintesis di bawah 51.200 byte yang akan berhasil diterapkan.

## Penggunaan
<a name="ref-cli-cmd-deploy-usage"></a>

```
$ cdk deploy <arguments> <options>
```

## Pendapat
<a name="ref-cli-cmd-deploy-args"></a><a name="ref-cli-cmd-deploy-args-stack-name"></a>

 **ID tumpukan CDK**   
ID build tumpukan CDK dari aplikasi Anda untuk diterapkan.  
 *Tipe*: String  
 *Wajib*: Tidak

## Opsi
<a name="ref-cli-cmd-deploy-options"></a>

Untuk daftar opsi global yang berfungsi dengan semua perintah CDK CLI, [lihat](ref-cli-cmd.md#ref-cli-cmd-options) Opsi global.<a name="ref-cli-cmd-deploy-options-all"></a>

 `--all <BOOLEAN>`   
Terapkan semua tumpukan di aplikasi CDK Anda.  
 *Nilai default*: `false` <a name="ref-cli-cmd-deploy-options-asset-parallelism"></a>

 `--asset-parallelism <BOOLEAN>`   
Tentukan apakah akan membangun dan mempublikasikan aset secara paralel.<a name="ref-cli-cmd-deploy-options-asset-prebuild"></a>

 `--asset-prebuild <BOOLEAN>`   
Tentukan apakah akan membangun semua aset sebelum menerapkan tumpukan pertama. Opsi ini berguna untuk kegagalan build Docker.  
 *Nilai default*: `true` <a name="ref-cli-cmd-deploy-options-build-exclude"></a>

 `--build-exclude, -E <ARRAY>`   
Jangan membangun kembali aset dengan ID yang diberikan.  
Opsi ini dapat ditentukan beberapa kali dalam satu perintah.  
 *Nilai default*: `[]` <a name="ref-cli-cmd-deploy-options-change-set-name"></a>

 `--change-set-name <STRING>`   
Nama set AWS CloudFormation perubahan yang akan dibuat.  
Opsi ini tidak kompatibel dengan`--method='direct'`.<a name="ref-cli-cmd-deploy-options-concurrency"></a>

 `--concurrency <NUMBER>`   
Terapkan beberapa tumpukan secara paralel sambil memperhitungkan dependensi antar-tumpukan. Gunakan opsi ini untuk mempercepat penerapan. Anda masih harus memperhitungkan AWS CloudFormation dan membatasi tingkat AWS akun lainnya.  
Berikan nomor untuk menentukan jumlah maksimum penerapan simultan (izin ketergantungan) untuk dilakukan.  
 *Nilai default*: `1` <a name="ref-cli-cmd-deploy-options-exclusively"></a>

 `--exclusively, -e <BOOLEAN>`   
Hanya terapkan tumpukan yang diminta dan jangan sertakan dependensi.<a name="ref-cli-cmd-deploy-options-force"></a>

 `--force, -f <BOOLEAN>`   
Saat Anda menerapkan untuk memperbarui tumpukan yang ada, CLI CDK akan membandingkan template dan tag tumpukan yang diterapkan ke tumpukan yang akan digunakan. Jika tidak ada perubahan yang terdeteksi, CDK CLI akan melewati penerapan.  
Untuk mengganti perilaku ini dan selalu menerapkan tumpukan, meskipun tidak ada perubahan yang terdeteksi, gunakan opsi ini.  
 *Nilai default*: `false` <a name="ref-cli-cmd-deploy-options-help"></a>

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

 `--hotswap <BOOLEAN>`   
Penerapan Hotswap untuk pengembangan yang lebih cepat. Opsi ini mencoba melakukan penyebaran hotswap yang lebih cepat jika memungkinkan. Misalnya, jika Anda memodifikasi kode fungsi Lambda di aplikasi CDK Anda, CLI CDK akan memperbarui sumber daya secara langsung melalui layanan APIs alih-alih melakukan penerapan. CloudFormation   
Jika CDK CLI mendeteksi perubahan yang tidak mendukung hotswapping, perubahan tersebut akan diabaikan dan pesan akan ditampilkan. Jika Anda lebih suka melakukan CloudFormation penerapan penuh sebagai mundur, gunakan sebagai `--hotswap-fallback` gantinya.  
CDK CLI menggunakan kredensil Anda AWS saat ini untuk melakukan panggilan API. Itu tidak mengambil peran dari tumpukan bootstrap Anda, bahkan jika flag `@aws-cdk/core:newStyleStackSynthesis` fitur disetel ke`true`. Peran tersebut tidak memiliki izin yang diperlukan untuk memperbarui AWS sumber daya secara langsung, tanpa menggunakan CloudFormation. Untuk alasan itu, pastikan kredensil Anda untuk AWS akun tumpukan yang sama dengan yang Anda lakukan penerapan hotswap dan bahwa mereka memiliki izin IAM yang diperlukan untuk memperbarui sumber daya.  
Hotswapping saat ini didukung untuk perubahan berikut:  
+ Aset kode (termasuk gambar Docker dan kode sebaris), perubahan tag, dan perubahan konfigurasi (hanya deskripsi dan variabel lingkungan yang didukung) dari fungsi Lambda.
+ Versi Lambda dan alias berubah.
+ Perubahan definisi mesin status AWS Step Functions.
+ Perubahan aset kontainer dari layanan Amazon ECS.
+ Perubahan aset situs web dari penerapan bucket Amazon S3.
+ Perubahan sumber dan lingkungan AWS CodeBuild proyek.
+ Template pemetaan VTL berubah untuk AWS AppSync resolver dan fungsi.
+ Perubahan skema untuk AWS AppSync APIs GraphQL.
Penggunaan fungsi CloudFormation intrinsik tertentu didukung sebagai bagian dari penyebaran hotswapped. Ini termasuk:  
+  `Ref` 
+  `Fn::GetAtt`— Hanya didukung sebagian. Lihat [implementasi ini](https://github.com/aws/aws-cdk/blob/main/packages/aws-cdk/lib/api/evaluate-cloudformation-template.ts#L477-L492) untuk sumber daya dan atribut yang didukung.
+  `Fn::ImportValue` 
+  `Fn::Join` 
+  `Fn::Select` 
+  `Fn::Split` 
+  `Fn::Sub` 
Opsi ini juga kompatibel dengan tumpukan bersarang.  
+ Opsi ini sengaja memperkenalkan drift di CloudFormation tumpukan untuk mempercepat penerapan. Untuk alasan ini, gunakan hanya untuk tujuan pengembangan. Jangan gunakan opsi ini untuk penerapan produksi Anda.
+ Opsi ini dianggap eksperimental dan mungkin memiliki perubahan yang melanggar di masa depan.
+ Default untuk parameter tertentu mungkin berbeda dengan parameter hotswap. Misalnya, persentase kesehatan minimum layanan Amazon ECS saat ini akan ditetapkan. `0` Tinjau sumbernya sesuai jika ini terjadi.
 *Nilai default*: `false` <a name="ref-cli-cmd-deploy-options-hotswap-fallback"></a>

 `--hotswap-fallback <BOOLEAN>`   
Opsi ini mirip dengan`--hotswap`. Perbedaannya adalah itu `--hotswap-fallback` akan mundur untuk melakukan CloudFormation penerapan penuh jika perubahan terdeteksi yang membutuhkannya.  
Untuk informasi selengkapnya tentang metrik ini, lihat `--hotswap`.  
 *Nilai default*: `false` <a name="ref-cli-cmd-deploy-options-ignore-no-stacks"></a>

 `--ignore-no-stacks <BOOLEAN>`   
Lakukan penerapan meskipun aplikasi CDK Anda tidak berisi tumpukan apa pun.  
Opsi ini berguna dalam skenario berikut: Anda mungkin memiliki aplikasi dengan beberapa lingkungan, seperti `dev` dan`prod`. Saat memulai pengembangan, aplikasi prod Anda mungkin tidak memiliki sumber daya apa pun, atau sumber daya dapat dikomentari. Ini akan menghasilkan kesalahan penerapan dengan pesan yang menyatakan bahwa aplikasi tidak memiliki tumpukan. Gunakan `--ignore-no-stacks` untuk melewati kesalahan ini.  
 *Nilai default*: `false` <a name="ref-cli-cmd-deploy-options-import-existing-resources"></a>

 `--import-existing-resources <BOOLEAN>`   
Impor AWS CloudFormation sumber daya yang ada dan tidak terkelola dari AWS akun Anda.  
Saat Anda menggunakan opsi ini, sumber daya dari AWS CloudFormation templat yang disintesis dengan nama kustom yang sama dengan sumber daya yang tidak dikelola yang ada di akun yang sama akan diimpor ke tumpukan Anda.  
Anda dapat menggunakan opsi ini untuk mengimpor sumber daya yang ada ke tumpukan baru atau yang sudah ada.  
Anda dapat mengimpor sumber daya yang ada dan menyebarkan sumber daya baru dalam `cdk deploy` perintah yang sama.  
Untuk mempelajari lebih lanjut tentang nama kustom, lihat [Jenis nama](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-name.html) di *Panduan AWS CloudFormation Pengguna*.  
Untuk mempelajari `ImportExistingResources` CloudFormation parameter selengkapnya, lihat [AWS CloudFormation menyederhanakan impor sumber daya dengan parameter baru](https://aws.amazon.com/about-aws/whats-new/2023/11/aws-cloudformation-import-parameter-changesets/). ChangeSets  
Untuk informasi selengkapnya tentang penggunaan opsi ini, lihat [Mengimpor sumber daya yang ada](https://github.com/aws/aws-cdk-cli/tree/main/packages/aws-cdk#import-existing-resources) di *aws-cdk-cli GitHub repositori*.<a name="ref-cli-cmd-deploy-options-logs"></a>

 `--logs <BOOLEAN>`   
Tampilkan CloudWatch log Amazon di output standar (`stdout`) untuk semua peristiwa dari semua sumber daya di tumpukan yang dipilih.  
Opsi ini hanya kompatibel dengan`--watch`.  
 *Nilai default*: `true` <a name="ref-cli-cmd-deploy-options-method"></a>

 `--method, -m <STRING>`   
Konfigurasikan metode untuk melakukan penyebaran.  
+  `change-set`— Metode default. CDK CLI membuat set perubahan CloudFormation dengan perubahan yang akan diterapkan, lalu melakukan penerapan.
+  `direct`— Jangan membuat set perubahan. Sebaliknya, terapkan perubahan segera. Ini biasanya lebih cepat daripada membuat set perubahan, tetapi Anda kehilangan detail kemajuan penerapan di output CLI.
+  `prepare-change-set`— Buat set perubahan tetapi tidak melakukan penerapan. Ini berguna jika Anda memiliki alat eksternal yang akan memeriksa set perubahan atau jika Anda memiliki proses persetujuan untuk set perubahan.
 *Nilai yang valid*:`change-set`,`direct`, `prepare-change-set`   
 *Nilai default*: `change-set` <a name="ref-cli-cmd-deploy-options-notification-arns"></a>

 `--notification-arns <ARRAY>`   
 ARNs Topik Amazon SNS yang CloudFormation akan memberi tahu untuk acara terkait tumpukan.<a name="ref-cli-cmd-deploy-options-outputs-file"></a>

 `--outputs-file, -O <STRING>`   
Jalur ke mana output tumpukan dari penerapan ditulis.  
Setelah penerapan, output tumpukan akan ditulis ke file output yang ditentukan dalam format JSON.  
Anda dapat mengonfigurasi opsi ini di `cdk.json` file proyek atau `~/.cdk.json` di mesin pengembangan lokal Anda:  

```
{
   "app": "npx ts-node bin/myproject.ts",
   // ...
   "outputsFile": "outputs.json"
}
```
Jika beberapa tumpukan digunakan, output ditulis ke file output yang sama, diatur oleh kunci yang mewakili nama tumpukan.<a name="ref-cli-cmd-deploy-options-parameters"></a>

 `--parameters <ARRAY>`   
Lewati parameter tambahan CloudFormation selama penerapan.  
Opsi ini menerima array dalam format berikut:`STACK:KEY=VALUE`.  
+  `STACK`— Nama tumpukan untuk mengaitkan parameter dengan.
+  `KEY`— Nama parameter dari tumpukan Anda.
+  `VALUE`— Nilai yang harus dilewati saat penerapan.
Jika nama tumpukan tidak disediakan, atau jika `*` disediakan sebagai nama tumpukan, parameter akan diterapkan ke semua tumpukan yang digunakan. Jika tumpukan tidak menggunakan parameter, penerapan akan gagal.  
Parameter tidak menyebar ke tumpukan bersarang. Untuk meneruskan parameter ke tumpukan bersarang, gunakan konstruksi. ` [NestedStack](https://docs.aws.amazon.com/cdk/api/v2/docs/aws-cdk-lib.NestedStack.html) `  
 *Nilai default*: `{}` <a name="ref-cli-cmd-deploy-options-previous-parameters"></a>

 `--previous-parameters <BOOLEAN>`   
Gunakan nilai sebelumnya untuk parameter yang ada.  
Ketika opsi ini diatur ke`false`, Anda harus menentukan semua parameter pada setiap penerapan.  
 *Nilai default*: `true` <a name="ref-cli-cmd-deploy-options-progress"></a>

 `--progress <STRING>`   
Konfigurasikan bagaimana CDK CLI menampilkan kemajuan penerapan.  
+  `bar`— Tampilkan peristiwa penyebaran tumpukan sebagai bilah kemajuan, dengan peristiwa untuk sumber daya yang saat ini sedang digunakan.
+  `events`— Berikan riwayat lengkap, termasuk semua CloudFormation acara.
Anda juga dapat mengonfigurasi opsi ini di `cdk.json` file proyek atau `~/.cdk.json` di mesin pengembangan lokal Anda:  

```
{
   "progress": "events"
}
```
 *Nilai valid:* `bar`, `events`   
 *Nilai default*: `bar` <a name="ref-cli-cmd-deploy-options-require-approval"></a>

 `--require-approval <STRING>`   
Tentukan perubahan sensitif keamanan apa yang memerlukan persetujuan manual.  
+  `any-change`— Persetujuan manual diperlukan untuk setiap perubahan pada tumpukan.
+  `broadening`Persetujuan manual diperlukan jika perubahan melibatkan perluasan izin atau aturan grup keamanan.
+  `never`- Persetujuan tidak diperlukan.
 *Nilai yang valid*:`any-change`,`broadening`, `never`   
 *Nilai default*: `broadening` <a name="ref-cli-cmd-deploy-options-rollback"></a>

 `--rollback` \$1 `--no-rollback`, `-R`   
Selama penerapan, jika sumber daya gagal dibuat atau diperbarui, penerapan akan kembali ke status stabil terbaru sebelum CLI CDK kembali. Semua perubahan yang dibuat sampai saat itu akan dibatalkan. Sumber daya yang dibuat akan dihapus dan pembaruan yang dibuat akan dibatalkan.  
Tentukan `--no-rollback` untuk mematikan perilaku ini. Jika sumber daya gagal dibuat atau diperbarui, CLI CDK akan meninggalkan perubahan yang dibuat hingga saat itu dan kembali. Ini akan membuat penerapan Anda dalam keadaan gagal dan dijeda. Dari sini, Anda dapat memperbarui kode Anda dan mencoba penerapan lagi. Ini mungkin membantu dalam lingkungan pengembangan di mana Anda melakukan iterasi dengan cepat.  
Jika penerapan dilakukan dengan `--no-rollback` gagal, dan Anda memutuskan bahwa Anda ingin mengembalikan penerapan, Anda dapat menggunakan perintah. `cdk rollback` Untuk informasi lebih lanjut, lihat [cdk rollback](ref-cli-cmd-rollback.md).  
Dengan`--no-rollback`, penerapan yang menyebabkan penggantian sumber daya akan selalu gagal. Anda hanya dapat menggunakan nilai opsi ini untuk penerapan yang memperbarui atau membuat sumber daya baru.
 *Nilai default*: `--rollback` <a name="ref-cli-cmd-deploy-options-toolkit-stack-name"></a>

 `--toolkit-stack-name <STRING>`   
Nama tumpukan CDK Toolkit yang ada.  
Secara default, `cdk bootstrap` menyebarkan tumpukan bernama `CDKToolkit` ke dalam AWS lingkungan yang ditentukan. Gunakan opsi ini untuk memberikan nama yang berbeda untuk tumpukan bootstrap Anda.  
CDK CLI menggunakan nilai ini untuk memverifikasi versi stack bootstrap Anda.<a name="ref-cli-cmd-deploy-options-watch"></a>

 `--watch <BOOLEAN>`   
Terus amati file proyek CDK, dan gunakan tumpukan yang ditentukan secara otomatis saat perubahan terdeteksi.  
Opsi ini menyiratkan secara `--hotswap` default.  
Opsi ini memiliki perintah CDK CLI yang setara. Untuk informasi lebih lanjut, lihat [cdk watch](ref-cli-cmd-watch.md).

## Contoh
<a name="ref-cli-cmd-deploy-examples"></a>

### Menyebarkan tumpukan bernama MyStackName
<a name="ref-cli-cmd-deploy-examples-1"></a>

```
$ cdk deploy MyStackName --app='node bin/main.js'
```

### Menerapkan beberapa tumpukan dalam aplikasi
<a name="ref-cli-cmd-deploy-examples-2"></a>

Gunakan `cdk list` untuk membuat daftar tumpukan Anda:

```
$ cdk list
CdkHelloWorldStack
CdkStack2
CdkStack3
```

Untuk menyebarkan semua tumpukan, gunakan opsi: `--all`

```
$ cdk deploy --all
```

Untuk memilih tumpukan mana yang akan diterapkan, berikan nama tumpukan sebagai argumen:

```
$ cdk deploy CdkHelloWorldStack CdkStack3
```

### Menyebarkan tumpukan pipa
<a name="ref-cli-cmd-deploy-examples-3"></a>

Gunakan `cdk list` untuk menampilkan nama tumpukan sebagai jalur, menunjukkan di mana mereka berada dalam hierarki pipeline:

```
$ cdk list
PipelineStack
PiplelineStack/Prod
PipelineStack/Prod/MyService
```

Gunakan `--all` opsi atau wildcard `*` untuk menyebarkan semua tumpukan. Jika Anda memiliki hierarki tumpukan seperti dijelaskan di atas, `--all` dan hanya `*` akan cocok tumpukan di tingkat atas. Untuk mencocokkan semua tumpukan dalam hierarki, gunakan. `**`

Anda dapat menggabungkan pola-pola ini. Berikut ini menyebarkan semua tumpukan di panggung: `Prod`

```
$ cdk deploy PipelineStack/Prod/**
```

### Lulus parameter saat penerapan
<a name="ref-cli-cmd-deploy-examples-4"></a>

Tentukan parameter di tumpukan CDK Anda. Berikut ini adalah contoh yang membuat parameter bernama `TopicNameParam` untuk topik Amazon SNS:

```
new sns.Topic(this, 'TopicParameter', {
    topicName: new cdk.CfnParameter(this, 'TopicNameParam').value.toString()
});
```

Untuk memberikan nilai parameter`parameterized`, jalankan yang berikut ini:

```
$ cdk deploy --parameters "MyStackName:TopicNameParam=parameterized"
```

Anda dapat mengganti nilai parameter dengan menggunakan `--force` opsi. Berikut ini adalah contoh penggantian nama topik dari penerapan sebelumnya:

```
$ cdk deploy --parameters "MyStackName:TopicNameParam=parameterName" --force
```

### Tulis output tumpukan ke file setelah penerapan
<a name="ref-cli-cmd-deploy-examples-5"></a>

Tentukan output dalam file tumpukan CDK Anda. Berikut ini adalah contoh yang membuat output untuk fungsi ARN:

```
const fn = new lambda.Function(this, "fn", {
  handler: "index.handler",
  code: lambda.Code.fromInline(`exports.handler = \${handler.toString()}`),
  runtime: lambda.Runtime.NODEJS_LATEST
});

new cdk.CfnOutput(this, 'FunctionArn', {
  value: fn.functionArn,
});
```

Menyebarkan tumpukan dan menulis output ke: `outputs.json`

```
$ cdk deploy --outputs-file outputs.json
```

Berikut ini adalah contoh `outputs.json` setelah penerapan:

```
{
  "MyStack": {
    "FunctionArn": "arn:aws:lambda:us-east-1:123456789012:function:MyStack-fn5FF616E3-G632ITHSP5HK"
  }
}
```

Dari contoh ini, kunci `FunctionArn` sesuai dengan ID logis dari `CfnOutput` instance.

Berikut ini adalah contoh `outputs.json` setelah penerapan ketika beberapa tumpukan diterapkan:

```
{
  "MyStack": {
    "FunctionArn": "arn:aws:lambda:us-east-1:123456789012:function:MyStack-fn5FF616E3-G632ITHSP5HK"
  },
  "AnotherStack": {
    "VPCId": "vpc-z0mg270fee16693f"
  }
}
```

### Memodifikasi metode penerapan
<a name="ref-cli-cmd-deploy-examples-6"></a>

Untuk menerapkan lebih cepat, tanpa menggunakan set perubahan, gunakan`--method='direct'`:

```
$ cdk deploy --method='direct'
```

Untuk membuat set perubahan tetapi tidak menerapkan, gunakan`--method='prepare-change-set'`. Secara default, set perubahan bernama `cdk-deploy-change-set` akan dibuat. Jika perubahan sebelumnya yang ditetapkan dengan nama ini ada, itu akan ditimpa. Jika tidak ada perubahan yang terdeteksi, set perubahan kosong masih dibuat.

Anda juga dapat memberi nama set perubahan Anda. Berikut ini adalah contohnya:

```
$ cdk deploy --method='prepare-change-set' --change-set-name='MyChangeSetName'
```

# `cdk destroy`
<a name="ref-cli-cmd-destroy"></a>

Hapus satu atau beberapa tumpukan AWS CDK dari lingkungan Anda AWS .

Saat Anda menghapus tumpukan, sumber daya di tumpukan akan dihancurkan, kecuali jika dikonfigurasi dengan a `DeletionPolicy``Retain`.

Selama penghapusan tumpukan, perintah ini akan menampilkan informasi kemajuan yang mirip `cdk deploy` dengan perilaku.

## Penggunaan
<a name="ref-cli-cmd-destroy-usage"></a>

```
$ cdk destroy <arguments> <options>
```

## Pendapat
<a name="ref-cli-cmd-destroy-args"></a><a name="ref-cli-cmd-destroy-args-stack-name"></a>

 **ID tumpukan CDK**   
ID build tumpukan CDK dari aplikasi Anda untuk dihapus.  
 *Tipe*: String  
 *Wajib*: Tidak

## Opsi
<a name="ref-cli-cmd-destroy-options"></a>

Untuk daftar opsi global yang berfungsi dengan semua perintah CDK CLI, [lihat](ref-cli-cmd.md#ref-cli-cmd-options) Opsi global.<a name="ref-cli-cmd-destroy-options-all"></a>

 `--all <BOOLEAN>`   
Hancurkan semua tumpukan yang tersedia.  
 *Nilai default*: `false` <a name="ref-cli-cmd-destroy-options-exclusively"></a>

 `--exclusively, -e <BOOLEAN>`   
Hanya hancurkan tumpukan yang diminta dan jangan sertakan dependensi.<a name="ref-cli-cmd-destroy-options-force"></a>

 `--force, -f <BOOLEAN>`   
Jangan meminta konfirmasi sebelum menghancurkan tumpukan.<a name="ref-cli-cmd-destroy-options-help"></a>

 `--help, -h <BOOLEAN>`   
Tampilkan informasi referensi perintah untuk `cdk destroy` perintah.

## Contoh
<a name="ref-cli-cmd-destroy-examples"></a>

### Hapus tumpukan bernama MyStackName
<a name="ref-cli-cmd-destroy-examples-1"></a>

```
$ cdk destroy --app='node bin/main.js' <MyStackName>
```

# `cdk diff`
<a name="ref-cli-cmd-diff"></a>

Lakukan diff untuk melihat perubahan infrastruktur di antara tumpukan AWS CDK.

Perintah ini biasanya digunakan untuk membandingkan perbedaan antara status tumpukan saat ini di aplikasi CDK lokal Anda dengan tumpukan yang diterapkan. Namun, Anda juga dapat membandingkan tumpukan yang diterapkan dengan AWS CloudFormation templat lokal apa pun.

## Penggunaan
<a name="ref-cli-cmd-diff-usage"></a>

```
$ cdk diff <arguments> <options>
```

## Pendapat
<a name="ref-cli-cmd-diff-args"></a><a name="ref-cli-cmd-diff-args-stack-name"></a>

 **ID tumpukan CDK**   
ID build tumpukan CDK dari aplikasi Anda untuk melakukan diff.  
 *Tipe*: String  
 *Wajib*: Tidak

## Opsi
<a name="ref-cli-cmd-diff-options"></a>

Untuk daftar opsi global yang berfungsi dengan semua perintah CDK CLI, [lihat](ref-cli-cmd.md#ref-cli-cmd-options) Opsi global.<a name="ref-cli-cmd-diff-options-change-set"></a>

 `--change-set <BOOLEAN>`   
Tentukan apakah akan membuat set perubahan untuk menganalisis penggantian sumber daya.  
Kapan`true`, CDK CLI akan membuat set perubahan untuk menampilkan perubahan AWS CloudFormation yang tepat yang akan dilakukan pada tumpukan Anda. Output ini mencakup apakah sumber daya akan diperbarui atau diganti. CDK CLI menggunakan peran penerapan alih-alih peran pencarian untuk melakukan tindakan ini.  
Kapan`false`, perbedaan yang lebih cepat, tetapi kurang akurat dilakukan dengan membandingkan templat. CloudFormation Setiap perubahan yang terdeteksi pada properti yang memerlukan penggantian sumber daya akan ditampilkan sebagai pengganti sumber daya, bahkan jika perubahan itu murni kosmetik, seperti mengganti referensi sumber daya dengan ARN hard-code.  
 *Nilai default*: `true` <a name="ref-cli-cmd-diff-options-context-lines"></a>

 `--context-lines <NUMBER>`   
Jumlah baris konteks yang akan disertakan dalam rendering diff JSON arbitrer.  
 *Nilai default*: `3` <a name="ref-cli-cmd-diff-options-exclusively"></a>

 `--exclusively, -e <BOOLEAN>`   
Hanya tumpukan yang diminta diff dan tidak menyertakan dependensi.<a name="ref-cli-cmd-diff-options-fail"></a>

 `--fail <BOOLEAN>`   
Gagal dan keluar dengan kode `1` jika perbedaan terdeteksi.<a name="ref-cli-cmd-diff-options-help"></a>

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

 `--processed <BOOLEAN>`   
Tentukan apakah akan membandingkan dengan template dengan CloudFormation transformasi yang sudah diproses.  
 *Nilai default*: `false` <a name="ref-cli-cmd-diff-options-quiet"></a>

 `--quiet, -q <BOOLEAN>`   
Jangan mencetak nama tumpukan CDK dan `cdk diff` pesan default `stdout` saat tidak ada perubahan yang terdeteksi.  
 *Nilai default*: `false` <a name="ref-cli-cmd-diff-options-security-only"></a>

 `--security-only <BOOLEAN>`   
Hanya perbedaan untuk perubahan keamanan yang diperluas.  
 *Nilai default*: `false` <a name="ref-cli-cmd-diff-options-strict"></a>

 `--strict <BOOLEAN>`   
Ubah `cdk diff` perilaku menjadi lebih tepat atau ketat. Jika benar, CDK CLI tidak akan memfilter sumber daya atau karakter non-ASCII ` AWS::CDK::Metadata` yang tidak dapat dibaca.  
 *Nilai default*: `false` <a name="ref-cli-cmd-diff-options-template"></a>

 `--template <STRING>`   
Jalur ke CloudFormation template untuk membandingkan tumpukan CDK dengan.

## Contoh
<a name="ref-cli-cmd-diff-examples"></a>

### Perbedaan terhadap tumpukan yang saat ini digunakan bernama MyStackName
<a name="ref-cli-cmd-diff-examples-1"></a>

CDK CLI menggunakan simbol-simbol berikut dalam output diff:
+  `[+]`— Mengidentifikasi kode atau sumber daya yang akan ditambahkan jika Anda menerapkan perubahan Anda.
+  `[-]`— Mengidentifikasi kode atau sumber daya yang akan dihapus jika Anda menerapkan perubahan Anda.
+  `[~]`— Mengidentifikasi sumber daya atau properti yang akan dimodifikasi jika Anda menerapkan perubahan Anda.

Berikut ini adalah contoh yang menunjukkan perbedaan perubahan lokal pada fungsi Lambda:

```
$ cdk diff MyStackName
start: Building <asset-hash>:<account:Region>
success: Built <asset-hash>:<account:Region>
start: Publishing <asset-hash>:<account:Region>
success: Published <asset-hash>:<account:Region>
Hold on while we create a read-only change set to get a diff with accurate replacement information (use --no-change-set to use a less accurate but faster template-only diff)
Stack MyStackName
Resources
[~] AWS::Lambda::Function HelloWorldFunction <resource-logical-ID>
 └─ [~] Code
     └─ [~] .ZipFile:
         ├─ [-]
        exports.handler = async function(event) {
          return {
            statusCode: 200,
            body: JSON.stringify('Hello World!'),
          };
        };

         └─ [+]
        exports.handler = async function(event) {
          return {
            statusCode: 200,
            body: JSON.stringify('Hello from CDK!'),
          };
        };



✨  Number of stacks with differences: 1
```

`[~]`Indikator untuk sumber daya yang akan dimodifikasi tidak selalu berarti penggantian sumber daya penuh:
+ Beberapa properti sumber daya, seperti`Code`, akan memperbarui sumber daya.
+ Beberapa properti sumber daya, seperti`FunctionName`, dapat menyebabkan penggantian sumber daya penuh.

### Diff terhadap template tertentu CloudFormation
<a name="ref-cli-cmd-diff-examples-2"></a>

```
$ cdk diff MyStackName --app='node bin/main.js' --template-path='./MyStackNameTemplate.yaml'
```

### Membedakan tumpukan lokal dengan tumpukan yang disebarkan. jangan cetak ke stdout jika tidak ada perubahan yang terdeteksi
<a name="ref-cli-cmd-diff-examples-3"></a>

```
$ cdk diff MyStackName --app='node bin/main.js' --quiet
```

# `cdk docs`
<a name="ref-cli-cmd-docs"></a>

Buka dokumentasi AWS CDK di browser Anda.

## Penggunaan
<a name="ref-cli-cmd-docs-usage"></a>

```
$ cdk docs <options>
```

## Opsi
<a name="ref-cli-cmd-docs-options"></a>

Untuk daftar opsi global yang berfungsi dengan semua perintah CDK CLI, [lihat](ref-cli-cmd.md#ref-cli-cmd-options) Opsi global.<a name="ref-cli-cmd-docs-options-browser"></a>

 `--browser, -b <STRING>`   
Perintah yang digunakan untuk membuka browser, menggunakan `%u` sebagai placeholder untuk jalur file yang akan dibuka.  
 *Nilai default*: `open %u` <a name="ref-cli-cmd-docs-options-help"></a>

 `--help, -h <BOOLEAN>`   
Tampilkan informasi referensi perintah untuk `cdk docs` perintah.

## Contoh
<a name="ref-cli-cmd-docs-examples"></a>

### Buka dokumentasi AWS CDK di Google Chrome
<a name="ref-cli-cmd-docs-examples-1"></a>

```
$ cdk docs --browser='chrome %u'
```

# `cdk doctor`
<a name="ref-cli-cmd-doctor"></a>

Periksa dan tampilkan informasi berguna tentang proyek AWS CDK lokal dan lingkungan pengembangan Anda.

Informasi ini dapat membantu mengatasi masalah CDK dan harus diberikan saat mengirimkan laporan bug.

## Penggunaan
<a name="ref-cli-cmd-doctor-usage"></a>

```
$ cdk doctor <options>
```

## Opsi
<a name="ref-cli-cmd-doctor-options"></a>

Untuk daftar opsi global yang berfungsi dengan semua perintah CDK CLI, [lihat](ref-cli-cmd.md#ref-cli-cmd-options) Opsi global.<a name="ref-cli-cmd-doctor-options-help"></a>

 `--help, -h <BOOLEAN>`   
Tampilkan informasi referensi perintah untuk `cdk doctor` perintah.

## Contoh
<a name="ref-cli-cmd-doctor-examples"></a>

### Contoh sederhana dari `cdk doctor` perintah
<a name="ref-cli-cmd-doctor-examples-1"></a>

```
$ cdk doctor
ℹ️ CDK Version: 1.0.0 (build e64993a)
ℹ️ AWS environment variables:
  - AWS_EC2_METADATA_DISABLED = 1
  - AWS_SDK_LOAD_CONFIG = 1
```

# `cdk drift`
<a name="ref-cli-cmd-drift"></a>

Mendeteksi penyimpangan konfigurasi untuk sumber daya yang Anda tentukan, kelola, dan terapkan menggunakan AWS Cloud Development Kit (AWS CDK). Drift terjadi ketika konfigurasi sebenarnya tumpukan berbeda dari konfigurasi yang diharapkan, yang terjadi ketika sumber daya dimodifikasi di luar. AWS CloudFormation

Perintah ini mengidentifikasi sumber daya yang telah dimodifikasi (misalnya, melalui AWS Konsol atau AWS CLI) dengan membandingkan statusnya saat ini dengan konfigurasi yang diharapkan. Modifikasi ini dapat menyebabkan perilaku tak terduga dalam infrastruktur Anda.

Selama deteksi drift, CDK CLI akan menampilkan indikator dan hasil kemajuan, menunjukkan:
+ Sumber daya yang telah melayang dari konfigurasi yang diharapkan.
+ Jumlah total sumber daya dengan drift.
+ Ringkasan yang menunjukkan apakah drift terdeteksi di tumpukan.

**penting**  
`cdk diff`Perintah `cdk drift` dan bekerja secara berbeda:  
 `cdk drift`memanggil CloudFormation operasi deteksi drift untuk membandingkan status sumber daya aktual di AWS (“realitas”) dengan konfigurasi yang diharapkan di CloudFormation. Tidak semua AWS sumber daya mendukung deteksi drift. Untuk daftar sumber daya yang didukung, lihat [Dukungan jenis sumber daya](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/resource-import-supported-resources.html) di *Panduan AWS CloudFormation Pengguna*.
 `cdk diff`membandingkan CloudFormation template yang disintesis dari kode CDK lokal Anda dengan template tumpukan yang diterapkan. CloudFormation 
Gunakan `cdk drift` saat Anda perlu memverifikasi apakah sumber daya telah dimodifikasi di luar CloudFormation (misalnya, melalui AWS Konsol atau AWS CLI). Gunakan `cdk diff` saat Anda ingin melihat pratinjau bagaimana perubahan kode lokal Anda akan memengaruhi infrastruktur Anda sebelum penerapan.

## Penggunaan
<a name="ref-cli-cmd-drift-usage"></a>

```
$ cdk drift <arguments> <options>
```

## Pendapat
<a name="ref-cli-cmd-drift-args"></a><a name="ref-cli-cmd-drift-args-stack-name"></a>

 **Nama tumpukan**   
Nama tumpukan yang ingin Anda periksa untuk drift. Tumpukan harus sebelumnya digunakan CloudFormation untuk melakukan deteksi drift.  
 *Tipe*: String  
 *Wajib*: Tidak  
Jika tidak ada tumpukan yang ditentukan, deteksi drift akan dilakukan pada semua tumpukan yang ditentukan dalam aplikasi CDK Anda.

## Opsi
<a name="ref-cli-cmd-drift-options"></a>

Untuk daftar opsi global yang berfungsi dengan semua perintah CDK CLI, [lihat](ref-cli-cmd.md#ref-cli-cmd-options) Opsi global.<a name="ref-cli-cmd-drift-options-fail"></a>

 `--fail <BOOLEAN>`   
Kembali dengan kode keluar 1 jika drift terdeteksi.  
 *Nilai default*: `false` <a name="ref-cli-cmd-drift-options-help"></a>

 `--help, -h <BOOLEAN>`   
Tampilkan informasi referensi perintah untuk `cdk drift` perintah.

## Contoh
<a name="ref-cli-cmd-drift-examples"></a>

### Periksa drift untuk tumpukan tertentu
<a name="ref-cli-cmd-drift-examples-stack"></a>

```
$ cdk drift MyStackName
```

Perintah akan menampilkan hasil yang mirip dengan:

```
Stack MyStackName
Modified Resources
[~] AWS::Lambda::Function MyFunction MyLambdaFunc1234ABCD
 └─ [~] /Description
     ├─ [-] My original hello world Lambda function
     └─ [+] My drifted hello world Lambda function

1 resource has drifted from their expected configuration

✨  Number of resources with drift: 1
```

### Periksa drift saat sumber daya telah dihapus
<a name="ref-cli-cmd-drift-examples-deleted"></a>

Contoh berikut menunjukkan seperti apa output ketika sumber daya telah dimodifikasi dan dihapus:

```
Stack MyStackName
Modified Resources
[~] AWS::Lambda::Function MyFunction MyLambdaFunc1234ABCD
 └─ [~] /Description
     ├─ [-] My original hello world Lambda function
     └─ [+] My drifted hello world Lambda function
Deleted Resources
[-] AWS::CloudWatch::Alarm MyAlarm MyCWAlarmABCD1234

2 resources have drifted from their expected configuration

✨  Number of resources with drift: 2
```

### Periksa drift dengan kode keluar
<a name="ref-cli-cmd-drift-examples-fail"></a>

Untuk meminta perintah mengembalikan kode keluar bukan nol jika drift terdeteksi:

```
$ cdk drift MyStackName --fail
```

Ini berguna dalam pipa CI/CD untuk secara otomatis mendeteksi dan merespons penyimpangan infrastruktur.

# `cdk flags`
<a name="ref-cli-cmd-flags"></a>

Lihat dan ubah konfigurasi flag fitur Anda untuk CDK CLI.

Bendera fitur mengontrol perilaku CDK CLI dan Anda dapat menggunakannya untuk mengaktifkan atau menonaktifkan fitur tertentu. Gunakan `cdk flags` perintah untuk melihat konfigurasi flag fitur Anda saat ini dan memodifikasinya sesuai kebutuhan.

**Awas**  
`cdk flags`Perintah ini sedang dalam pengembangan untuk AWS CDK. Fitur saat ini dari perintah ini dianggap siap produksi dan aman digunakan. Namun, ruang lingkup perintah ini dan fitur-fiturnya dapat berubah. Oleh karena itu, Anda harus ikut serta dengan memberikan `unstable=flags` opsi untuk menggunakan perintah ini.

## Penggunaan
<a name="ref-cli-cmd-flags-usage"></a>

```
$ cdk flags <arguments> <options>
```

## Pendapat
<a name="ref-cli-cmd-flags-args"></a><a name="ref-cli-cmd-flags-args-flagname"></a>

 **NAMA BENDERA**   
Nama bendera fitur tertentu yang ingin Anda lihat atau modifikasi.  
 *Tipe*: String  
 *Wajib*: Tidak

## Opsi
<a name="ref-cli-cmd-flags-options"></a>

Untuk daftar opsi global yang berfungsi dengan semua perintah CDK CLI, [lihat](ref-cli-cmd.md#ref-cli-cmd-options) Opsi global.<a name="ref-cli-cmd-flags-options-set"></a>

 `--set <BOOLEAN>`   
Ubah konfigurasi bendera fitur.<a name="ref-cli-cmd-flags-options-all"></a>

 `--all <BOOLEAN>`   
Ubah atau lihat semua bendera fitur.<a name="ref-cli-cmd-flags-options-recommended"></a>

 `--recommended <BOOLEAN>`   
Ubah bendera ke status yang direkomendasikan.<a name="ref-cli-cmd-flags-options-default"></a>

 `--default <BOOLEAN>`   
Ubah bendera ke status default.<a name="ref-cli-cmd-flags-options-unconfigured"></a>

 `--unconfigured <BOOLEAN>`   
Ubah bendera fitur yang tidak dikonfigurasi.<a name="ref-cli-cmd-flags-options-value"></a>

 `--value <STRING>`   
Nilai untuk mengatur konfigurasi flag fitur ke.  
 *requiresArg*: benar<a name="ref-cli-cmd-flags-options-safe"></a>

 `--safe <BOOLEAN>`   
Aktifkan semua flag fitur yang tidak memengaruhi aplikasi Anda.<a name="ref-cli-cmd-flags-options-interactive"></a>

 `--interactive, -i <BOOLEAN>`   
Opsi interaktif untuk perintah bendera.

## Contoh
<a name="ref-cli-cmd-flags-examples"></a>

### Lihat konfigurasi bendera fitur
<a name="ref-cli-cmd-flags-examples-1"></a>

Jalankan `cdk flags` untuk melihat laporan konfigurasi flag fitur Anda yang berbeda dari status yang kami rekomendasikan. Bendera yang tidak dikonfigurasi diberi label `<unset>` untuk menunjukkan bahwa bendera saat ini tidak memiliki nilai. Bendera ditampilkan dalam urutan sebagai berikut:
+ Bendera disetel ke nilai yang tidak sesuai dengan nilai yang kami rekomendasikan
+ Bendera yang belum Anda konfigurasikan

```
$ cdk flags --unstable=flags
Feature Flag                           Recommended                       User
* @aws-cdk/...                              true                         false
* @aws-cdk/...                              true                         false
* @aws-cdk/...                              true                         <unset>
```

Anda juga dapat menjalankan `cdk flags --all` untuk melihat laporan semua flag fitur dalam urutan berikut:
+ Bendera disetel ke nilai yang sesuai dengan nilai yang kami rekomendasikan
+ Bendera disetel ke nilai yang tidak sesuai dengan nilai yang kami rekomendasikan
+ Bendera yang belum Anda konfigurasikan

```
$ cdk flags --unstable=flags --all
Feature Flag                              Recommended                     User
@aws-cdk/...                                true                         true
* @aws-cdk/...                              true                         false
* @aws-cdk/...                              true                         false
* @aws-cdk/...                              true                         <unset>
```

### Ubah nilai bendera fitur
<a name="ref-cli-cmd-flags-examples-2"></a>

Untuk memodifikasi flag fitur Anda secara interaktif, jalankan `cdk flags --interactive` (atau`cdk flags -i`) untuk melihat daftar opsi menu.

Untuk mengubah setiap flag fitur ke nilai yang kami rekomendasikan, jalankan`cdk flags --set --recommended --all`. Perintah ini menyimpan konfigurasi flag fitur Anda up-to-date dengan konfigurasi flag fitur CDK terbaru. Ketahuilah bahwa menjalankan perintah ini berpotensi menimpa nilai yang dikonfigurasi yang ada.

```
$ cdk flags --unstable=flags --set --recommended --all
Feature Flag                              Recommended Value            User Value
* @aws-cdk/...                              true                         false
* @aws-cdk/...                              true                         false
* @aws-cdk/...                              true                         <unset>
  Synthesizing...
    Resources
    [~] AWS::S3::Bucket MyBucket
    └─ [~] Properties
        └─ [~] Encryption
                ...
    Number of stacks with differences: 2
  Do you want to accept these changes? (y/n) y
  Resynthesizing...
```

Jika Anda ingin mempertahankan status flag yang sudah dikonfigurasi, jalankan`cdk flags --set --recommended --unconfigured`. Opsi ini hanya mengubah flag fitur yang tidak dikonfigurasi ke nilai yang kami rekomendasikan.

```
$ cdk flags --unstable=flags --set --recommended --unconfigured
Feature Flag                              Recommended Value            User Value
* @aws-cdk/...                              true                         <unset>
* @aws-cdk/...                              true                         <unset>
  Synthesizing...
    Resources
    [~] AWS::S3::Bucket MyBucket
    └─ [~] Properties
        └─ [~] Encryption
            ├─ [-] None
            └─ [+] ServerSideEncryptionConfiguration:
                    - ...
            ...
    Number of stacks with differences: 2
  Do you want to accept these changes? (y/n) y
  Resynthesizing...
```

Jika Anda ingin memastikan bahwa flag fitur yang tidak dikonfigurasi tidak mengganggu aplikasi Anda, jalankan `cdk flags --set --default --unconfigured` perintah untuk mengubah flag yang tidak dikonfigurasi ke nilai defaultnya. Misalnya, jika tidak `@aws-cdk/aws-cloudfront:defaultSecurityPolicyTLSv1.2_2021` dikonfigurasi, pemberitahuan akan ditampilkan setelah dijalankan`cdk synth`. Namun, jika Anda menyetel flag ke status default (false), itu akan dikonfigurasi, dimatikan, dan tidak memengaruhi aplikasi Anda.

```
$ cdk flags --unstable=flags --set --default --unconfigured
Feature Flag                              Recommended Value            User Value
* @aws-cdk/...                              true                         <unset>
* @aws-cdk/...                              true                         <unset>
  Synthesizing...

  Do you want to accept these changes? (y/n) y
  Resynthesizing...
```

### Periksa bendera fitur tertentu
<a name="ref-cli-cmd-flags-examples-3"></a>

#### Lihat informasi selengkapnya tentang bendera
<a name="_view_more_information_about_a_flag"></a>

Selain menjalankan `cdk flags` dan `cdk flags --all` melihat konfigurasi flag fitur Anda, Anda juga dapat menggunakannya `cdk flags "FLAGNAME"` untuk memeriksa flag fitur tertentu dan mencari tahu apa yang dilakukan flag. Ini dapat membantu dalam kasus di mana Anda ingin memahami bendera tertentu dan dampaknya pada aplikasi Anda.

```
$ cdk flags --unstable=flags "@aws-cdk/aws-cloudfront:defaultSecurityPolicyTLSv1.2_2021"
    Description: Enable this feature flag to have cloudfront distributions use the security policy TLSv1.2_2021 by default.
    Recommended Value: true
    User Value: true
```

#### Filter bendera dengan substring
<a name="_filter_flags_by_substring"></a>

Anda juga dapat menjalankan `cdk flags substring` untuk melihat semua flag fitur yang cocok. Jika hanya ada satu tanda fitur yang cocok dengan substring itu, detail spesifik akan ditampilkan.

```
$ cdk flags --unstable=flags ebs
@aws-cdk/aws-ec2:ebsDefaultGp3Volume
    Description: When enabled, the default volume type of the EBS volume will be GP3
    Recommended Value: true
    User Value: true
```

Jika beberapa flag cocok dengan substring, semua flag yang cocok ditampilkan dalam tabel. Jika Anda memasukkan beberapa substring, semua flag yang cocok yang berisi salah satu substring dikembalikan.

```
$ cdk flags --unstable=flags s3 lambda
Feature Flag                              Recommended                     User
* @aws-cdk/s3...                            true                         false
* @aws-cdk/lambda...                        true                         false
* @aws-cdk/lambda...                        true                         <unset>
```

#### Ubah bendera tertentu
<a name="_modify_a_specific_flag"></a>

Jika Anda perlu mengubah nilai flag dan ingin memastikan Anda menyetelnya ke status yang benar dan didukung, jalankan`cdk flags --set "FLAGNAME" --value="state"`.

```
$ cdk flags --unstable=flags --set "@aws-cdk/aws-cloudfront:defaultSecurityPolicyTLSv1.2_2021" --value="true"
  Synthesizing...
    Resources
    [~] AWS::CloudFront::Distribution MyDistribution
    └─ [~] Properties
        └─ [~] DefaultSecurityPolicy
            ├─ [-] TLSv1.0
            └─ [+] TLSv1.2_2021
                    - ...
    Number of stacks with differences: 2
  Do you want to accept these changes? (y/n) y
  Resynthesizing...
```

# `cdk gc`
<a name="ref-cli-cmd-gc"></a>

Gunakan perintah AWS Cloud Development Kit (AWS CDK) command line interface (CLI`cdk gc`) untuk melakukan pengumpulan sampah pada aset yang tidak terpakai yang disimpan dalam sumber daya tumpukan bootstrap Anda. Gunakan perintah ini untuk melihat, mengelola, dan menghapus aset yang tidak lagi Anda perlukan.

Untuk aset Amazon Simple Storage Service (Amazon S3), CDK CLI akan memeriksa template yang AWS CloudFormation ada di lingkungan yang sama untuk melihat apakah mereka direferensikan. Jika tidak direferensikan, mereka akan dianggap tidak terpakai dan memenuhi syarat untuk tindakan pengumpulan sampah.

**Awas**  
`cdk gc`Perintah ini sedang dalam pengembangan untuk AWS CDK. Fitur saat ini dari perintah ini dianggap siap produksi dan aman digunakan. Namun, ruang lingkup perintah ini dan fitur-fiturnya dapat berubah. Oleh karena itu, Anda harus ikut serta dengan memberikan `unstable=gc` opsi untuk menggunakan perintah ini.

## Penggunaan
<a name="ref-cli-cmd-gc-usage"></a>

```
$ cdk gc <arguments> <options>
```

## Pendapat
<a name="ref-cli-cmd-gc-args"></a><a name="ref-cli-cmd-gc-args-env"></a>

 ** AWS lingkungan**   
 AWS Lingkungan target untuk melakukan tindakan pengumpulan sampah pada.  
Saat menyediakan lingkungan, gunakan format berikut:`aws://<account-id>/<region>`. Misalnya, `aws://<123456789012>/<us-east-1>`.  
Argumen ini dapat diberikan beberapa kali dalam satu perintah untuk melakukan tindakan pengumpulan sampah di beberapa lingkungan.  
Secara default, CDK CLI akan melakukan tindakan pengumpulan sampah di semua lingkungan yang Anda referensikan di aplikasi CDK atau berikan sebagai argumen. Jika Anda tidak menyediakan lingkungan, CDK CLI akan menentukan lingkungan dari sumber default. Sumber-sumber ini mencakup lingkungan yang Anda tentukan menggunakan `--profile` opsi, variabel lingkungan, atau sumber AWS CLI default.

## Opsi
<a name="ref-cli-cmd-gc-options"></a>

Untuk daftar opsi global yang berfungsi dengan semua perintah CDK CLI, [lihat](ref-cli-cmd.md#ref-cli-cmd-options) Opsi global.<a name="ref-cli-cmd-gc-options-action"></a>

 `--action <STRING>`   
Tindakan yang `cdk gc` dilakukan pada aset Anda selama pengumpulan sampah.  
+  `delete-tagged`— Menghapus aset yang telah ditandai dengan tanggal dalam rentang hari buffer yang Anda berikan, tetapi tidak menandai aset yang tidak digunakan yang baru diidentifikasi.
+  `full`— Lakukan semua tindakan pengumpulan sampah. Ini termasuk menghapus aset dalam rentang hari buffer yang Anda berikan dan menandai aset yang tidak digunakan yang baru diidentifikasi.
+  `print`— Menghasilkan jumlah aset yang tidak digunakan pada prompt perintah tetapi tidak membuat perubahan aktual dalam lingkungan Anda AWS .
+  `tag`— Menandai aset yang tidak digunakan yang baru diidentifikasi, tetapi tidak menghapus aset apa pun dalam rentang hari buffer yang Anda berikan.
 *Nilai yang diterima*:`delete-tagged`,`full`,`print`, `tag`   
 *Nilai default*: `full` <a name="ref-cli-cmd-gc-options-bootstrap-stack-name"></a>

 `--bootstrap-stack-name <STRING>`   
Nama tumpukan bootstrap CDK di AWS lingkungan Anda. Berikan opsi ini jika Anda menyesuaikan nama tumpukan bootstrap Anda. Jika Anda menggunakan nama `CDKToolkit` tumpukan default, Anda tidak perlu memberikan opsi ini.  
 *Nilai default*: `CDKToolkit` <a name="ref-cli-cmd-gc-options-confirm"></a>

 `--confirm <BOOLEAN>`   
Tentukan apakah CDK CLI akan meminta konfirmasi manual dari Anda sebelum menghapus aset apa pun.  
Tentukan `false` untuk menghapus aset secara otomatis tanpa meminta Anda untuk konfirmasi manual.  
 *Nilai default*: `true` <a name="ref-cli-cmd-gc-options-created-buffer-days"></a>

 `--created-buffer-days <NUMBER>`   
Jumlah hari aset harus ada sebelum memenuhi syarat untuk tindakan pengumpulan sampah.  
Saat Anda memberikan nomor, aset yang belum ada di luar jumlah hari yang Anda tentukan disaring dari tindakan pengumpulan sampah.  
 *Nilai default*: `1` <a name="ref-cli-cmd-gc-options-help"></a>

 `--help, -h <BOOLEAN>`   
Tampilkan informasi referensi perintah untuk `cdk gc` perintah.<a name="ref-cli-cmd-gc-options-rollback-buffer-days"></a>

 `--rollback-buffer-days <NUMBER>`   
Jumlah hari aset harus ditandai sebagai terisolasi sebelum memenuhi syarat untuk tindakan pengumpulan sampah.  
Saat Anda memberikan nomor, CDK CLI akan menandai aset yang tidak digunakan dengan tanggal saat ini alih-alih menghapusnya. CDK CLI juga akan memeriksa apakah ada aset yang telah ditandai selama menjalankan perintah sebelumnya. `cdk gc` Aset yang diberi tag sebelumnya yang termasuk dalam rentang hari buffer yang Anda berikan akan dihapus.  
 *Nilai default*: `0` <a name="ref-cli-cmd-gc-options-type"></a>

 `--type <STRING>`   
Jenis sumber daya bootstrap dalam tumpukan bootstrap Anda untuk melakukan tindakan pengumpulan sampah.  
+  `all`— Lakukan tindakan pengumpulan sampah pada semua sumber daya yang di-bootstrap.
+  `ecr`— Lakukan tindakan pengumpulan sampah pada aset di repositori Amazon Elastic Container Registry (Amazon ECR) Registry ECR) dari tumpukan bootstrap Anda.
+  `s3`— Lakukan tindakan pengumpulan sampah pada aset di bucket Amazon S3 dari tumpukan bootstrap Anda.
 *Nilai yang diterima*:`all`,`ecr`, `s3`   
 *Nilai default*: `all` <a name="ref-cli-cmd-gc-options-unstable"></a>

 `--unstable <STRING>`   
Izinkan penggunaan perintah CDK CLI yang masih dalam pengembangan.  
Opsi ini diperlukan untuk menggunakan perintah CDK CLI apa pun yang masih dalam pengembangan dan dapat berubah.  
Opsi ini dapat diberikan beberapa kali dalam satu perintah.  
Untuk menggunakan`cdk gc`, sediakan`--unstable=gc`.

## Contoh
<a name="ref-cli-cmd-gc-examples"></a>

### Contoh dasar
<a name="ref-cli-cmd-gc-examples-basic"></a>

Contoh berikut meminta Anda untuk konfirmasi manual untuk melakukan tindakan pengumpulan sampah default pada aset di bucket Amazon S3 dari tumpukan bootstrap Anda:

```
$ cdk gc --unstable=gc --type=s3

 ⏳  Garbage Collecting environment aws://<account-id>/<region>...
Found 99 assets to delete based off of the following criteria:
- assets have been isolated for > 0 days
- assets were created > 1 days ago

Delete this batch (yes/no/delete-all)?
```

Contoh berikut melakukan tindakan pengumpulan sampah pada berbagai aset di bucket Amazon S3 dari tumpukan bootstrap Anda. Rentang ini mencakup aset yang sebelumnya telah ditandai oleh `cdk gc` selama lebih dari 30 hari dan telah dibuat 10 hari atau lebih. Perintah ini akan meminta konfirmasi manual sebelum menghapus aset apa pun:

```
$ cdk gc --unstable=gc --type=s3 --rollback-buffer-days=30 --created-buffer-days=10
```

Contoh berikut melakukan tindakan menghapus aset yang diberi tag sebelumnya di bucket Amazon S3 dari tumpukan bootstrap Anda yang telah tidak digunakan selama lebih dari 30 hari:

```
$ cdk gc --unstable=gc --type=s3 --action=delete-tagged --rollback-buffer-days=30
```

# `cdk import`
<a name="ref-cli-cmd-import"></a>

Gunakan [impor AWS CloudFormation sumber daya](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/resource-import.html) 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](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/resource-import-supported-resources.html) 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 a`cdk import`, satu-satunya perubahan yang diizinkan dalam operasi impor adalah penambahan sumber daya baru yang diimpor.

1. 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 kunci AWS KMS, kebijakan siklus hidup, dan hal lain yang relevan tentang bucket. Jika tidak, operasi pembaruan berikutnya mungkin tidak melakukan apa yang Anda harapkan.

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

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

1. 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
<a name="ref-cli-cmd-import-usage"></a>

```
$ cdk import <arguments> <options>
```

## Pendapat
<a name="ref-cli-cmd-import-args"></a><a name="ref-cli-cmd-import-args-stack-name"></a>

 **ID tumpukan CDK**   
ID build tumpukan CDK dari aplikasi Anda untuk mengimpor resource ke. Argumen ini dapat diberikan beberapa kali dalam satu perintah.  
 *Tipe*: String  
 *Wajib*: Tidak

## Opsi
<a name="ref-cli-cmd-import-options"></a>

Untuk daftar opsi global yang berfungsi dengan semua perintah CDK CLI, [lihat](ref-cli-cmd.md#ref-cli-cmd-options) Opsi global.<a name="ref-cli-cmd-import-options-change-set-name"></a>

 `--change-set-name <STRING>`   
Nama set CloudFormation perubahan yang akan dibuat.<a name="ref-cli-cmd-import-options-execute"></a>

 `--execute <BOOLEAN>`   
Tentukan apakah akan mengeksekusi set perubahan.  
 *Nilai default*: `true` <a name="ref-cli-cmd-import-options-force"></a>

 `--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.<a name="ref-cli-cmd-import-options-help"></a>

 `--help, -h <BOOLEAN>`   
Tampilkan informasi referensi perintah untuk `cdk import` perintah.<a name="ref-cli-cmd-import-options-record-resource-mapping"></a>

 `--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.<a name="ref-cli-cmd-import-options-resource-mapping"></a>

 `--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.<a name="ref-cli-cmd-import-options-rollback"></a>

 `--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` <a name="ref-cli-cmd-import-options-toolkit-stack-name"></a>

 `--toolkit-stack-name <STRING>`   
Nama tumpukan CDK Toolkit untuk dibuat.  
Secara default, `cdk bootstrap` menyebarkan tumpukan bernama `CDKToolkit` ke dalam AWS lingkungan yang ditentukan. Gunakan opsi ini untuk memberikan nama yang berbeda untuk tumpukan bootstrap Anda.  
CDK CLI menggunakan nilai ini untuk memverifikasi versi stack bootstrap Anda.

# `cdk init`
<a name="ref-cli-cmd-init"></a>

Buat proyek AWS CDK baru dari template.

## Penggunaan
<a name="ref-cli-cmd-init-usage"></a>

```
$ cdk init <arguments> <options>
```

## Pendapat
<a name="ref-cli-cmd-init-args"></a><a name="ref-cli-cmd-init-args-template-type"></a>

 **Jenis template**   
Jenis template CDK untuk menginisialisasi proyek CDK baru dari.  
+  `app`— Template untuk aplikasi CDK.
+  `lib`— Template untuk Perpustakaan AWS Konstruksi.
+  `sample-app`— Contoh aplikasi CDK yang mencakup beberapa konstruksi.
 *Nilai yang valid*:`app`,`lib`, `sample-app` 

## Opsi
<a name="ref-cli-cmd-init-options"></a>

Untuk daftar opsi global yang berfungsi dengan semua perintah CDK CLI, [lihat](ref-cli-cmd.md#ref-cli-cmd-options) Opsi global.<a name="ref-cli-cmd-init-options-generate-only"></a>

 `--generate-only <BOOLEAN>`   
Tentukan opsi ini untuk menghasilkan file proyek tanpa memulai operasi tambahan seperti menyiapkan repositori git, menginstal dependensi, atau mengkompilasi proyek.  
 *Nilai default*: `false` <a name="ref-cli-cmd-init-options-help"></a>

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

 `--language, -l <STRING>`   
Bahasa yang akan digunakan untuk proyek baru. Opsi ini dapat dikonfigurasi dalam file `cdk.json` konfigurasi proyek atau `~/.cdk.json` di mesin pengembangan lokal Anda.  
 *Nilai yang valid*:`csharp`,`fsharp`,`go`,`java`,`javascript`,`python`, `typescript` <a name="ref-cli-cmd-init-options-list"></a>

 `--list <BOOLEAN>`   
Buat daftar jenis dan bahasa template yang tersedia.

## Contoh
<a name="ref-cli-cmd-init-examples"></a>

### Buat daftar jenis dan bahasa template yang tersedia
<a name="ref-cli-cmd-init-examples-1"></a>

```
$ cdk init --list
Available templates:
* app: Template for a CDK Application
   └─ cdk init app --language=[csharp|fsharp|go|java|javascript|python|typescript]
* lib: Template for a CDK Construct Library
   └─ cdk init lib --language=typescript
* sample-app: Example CDK Application with some constructs
   └─ cdk init sample-app --language=[csharp|fsharp|go|java|javascript|python|typescript]
```

### Buat aplikasi CDK baru TypeScript dari template perpustakaan
<a name="ref-cli-cmd-init-examples-2"></a>

```
$ cdk init lib --language=typescript
```

# `cdk list`
<a name="ref-cli-cmd-list"></a>

Buat daftar semua tumpukan AWS CDK dan dependensinya dari aplikasi CDK.

## Penggunaan
<a name="ref-cli-cmd-list-usage"></a>

```
$ cdk list <arguments> <options>
```

## Pendapat
<a name="ref-cli-cmd-list-args"></a><a name="ref-cli-cmd-list-args-stack-name"></a>

 **ID tumpukan CDK**   
ID build tumpukan CDK dari aplikasi Anda untuk menjalankan perintah ini terhadap.  
 *Tipe*: String  
 *Wajib*: Tidak

## Opsi
<a name="ref-cli-cmd-list-options"></a>

Untuk daftar opsi global yang berfungsi dengan semua perintah CDK CLI, [lihat](ref-cli-cmd.md#ref-cli-cmd-options) Opsi global.<a name="ref-cli-cmd-list-options-help"></a>

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

 `--long, -l <BOOLEAN>`   
Menampilkan informasi AWS lingkungan untuk setiap tumpukan.  
 *Nilai default*: `false` <a name="ref-cli-cmd-list-options-show-dependencies"></a>

 `--show-dependencies, -d <BOOLEAN>`   
Tampilkan informasi ketergantungan tumpukan untuk setiap tumpukan.  
 *Nilai default*: `false` 

## Contoh
<a name="ref-cli-cmd-list-examples"></a>

### Daftar semua tumpukan di aplikasi CDK “node bin/main.js”
<a name="ref-cli-cmd-list-examples-1"></a>

```
$ cdk list --app='node bin/main.js'
Foo
Bar
Baz
```

### Buat daftar semua tumpukan, termasuk detail AWS lingkungan untuk setiap tumpukan
<a name="ref-cli-cmd-list-examples-"></a>

```
$ cdk list --app='node bin/main.js' --long
-
    name: Foo
    environment:
        name: 000000000000/bermuda-triangle-1
        account: '000000000000'
        region: bermuda-triangle-1
-
    name: Bar
    environment:
        name: 111111111111/bermuda-triangle-2
        account: '111111111111'
        region: bermuda-triangle-2
-
    name: Baz
    environment:
        name: 333333333333/bermuda-triangle-3
        account: '333333333333'
        region: bermuda-triangle-3
```

# `cdk metadata`
<a name="ref-cli-cmd-metadata"></a>

Tampilkan metadata yang terkait dengan tumpukan CDK.

## Penggunaan
<a name="ref-cli-cmd-metadata-usage"></a>

```
$ cdk metadata <arguments> <options>
```

## Pendapat
<a name="ref-cli-cmd-metadata-args"></a><a name="ref-cli-cmd-metadata-args-stack-name"></a>

 **ID tumpukan CDK**   
ID konstruksi tumpukan CDK dari aplikasi Anda untuk menampilkan metadata.  
 *Tipe*: String  
 *Wajib*: Tidak

## Opsi
<a name="ref-cli-cmd-metadata-options"></a>

Untuk daftar opsi global yang berfungsi dengan semua perintah CDK CLI, [lihat](ref-cli-cmd.md#ref-cli-cmd-options) Opsi global.<a name="ref-cli-cmd-metadata-options-help"></a>

 `--help, -h <BOOLEAN>`   
Tampilkan informasi referensi perintah untuk `cdk metadata` perintah.

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

# `cdk notices`
<a name="ref-cli-cmd-notices"></a>

Tampilkan pemberitahuan untuk aplikasi CDK Anda.

Pemberitahuan dapat mencakup pesan penting mengenai kerentanan keamanan, regresi, dan penggunaan versi yang tidak didukung.

Perintah ini menampilkan pemberitahuan yang relevan, terlepas dari apakah mereka telah diakui atau tidak. Pemberitahuan yang relevan juga dapat muncul setelah setiap perintah secara default.

Anda dapat menekan pemberitahuan dengan cara berikut:
+ Melalui opsi perintah. Berikut ini adalah contohnya:

  ```
  $ cdk deploy --no-notices
  ```
+ Menekan semua pemberitahuan tanpa batas melalui konteks dalam file proyek: `cdk.json`

  ```
  {
    "notices": false,
    "context": {
      // ...
    }
  }
  ```
+ Akui setiap pemberitahuan dengan `cdk acknowledge` perintah.

## Penggunaan
<a name="ref-cli-cmd-notices-usage"></a>

```
$ cdk notices <options>
```

## Opsi
<a name="ref-cli-cmd-notices-options"></a>

Untuk daftar opsi global yang berfungsi dengan semua perintah CDK CLI, [lihat](ref-cli-cmd.md#ref-cli-cmd-options) Opsi global.<a name="ref-cli-cmd-notices-options-help"></a>

 `--help, -h <BOOLEAN>`   
Tampilkan informasi referensi perintah untuk `cdk notices` perintah.

## Contoh
<a name="ref-cli-cmd-notices-examples"></a>

### Contoh pemberitahuan default yang ditampilkan setelah menjalankan perintah cdk deploy
<a name="ref-cli-cmd-notices-examples-1"></a>

```
$ cdk deploy

... # Normal output of the command

NOTICES

16603   Toggling off auto_delete_objects for Bucket empties the bucket

        Overview: If a stack is deployed with an S3 bucket with
                  auto_delete_objects=True, and then re-deployed with
                  auto_delete_objects=False, all the objects in the bucket
                  will be deleted.

        Affected versions: <1.126.0.

        More information at: https://github.com/aws/aws-cdk/issues/16603


17061   Error when building EKS cluster with monocdk import

        Overview: When using monocdk/aws-eks to build a stack containing
                  an EKS cluster, error is thrown about missing
                  lambda-layer-node-proxy-agent/layer/package.json.

        Affected versions: >=1.126.0 <=1.130.0.

        More information at: https://github.com/aws/aws-cdk/issues/17061


If you don’t want to see an notice anymore, use "cdk acknowledge ID". For example, "cdk acknowledge 16603"
```

### Contoh sederhana menjalankan perintah pemberitahuan cdk
<a name="ref-cli-cmd-notices-examples-2"></a>

```
$ cdk notices

NOTICES

16603   Toggling off auto_delete_objects for Bucket empties the bucket

        Overview: if a stack is deployed with an S3 bucket with
                  auto_delete_objects=True, and then re-deployed with
                  auto_delete_objects=False, all the objects in the bucket
                  will be deleted.

        Affected versions: framework: <=2.15.0 >=2.10.0

        More information at: https://github.com/aws/aws-cdk/issues/16603


If you don’t want to see a notice anymore, use "cdk acknowledge <id>". For example, "cdk acknowledge 16603"
```

# `cdk refactor`
<a name="ref-cli-cmd-refactor"></a>

**penting**  
`cdk refactor`Perintah dalam rilis pratinjau dan dapat berubah.  
Anda harus memberikan `--unstable=refactor` opsi saat menggunakan perintah ini.

Pertahankan sumber daya yang digunakan saat memfaktorkan ulang kode di aplikasi AWS Cloud Development Kit (AWS CDK) Anda.

Ketika Anda mengganti nama konstruksi atau memindahkannya melintasi tumpukan dalam kode CDK Anda, biasanya CloudFormation akan memperlakukan ini sebagai sumber daya baru, menyebabkan penggantian yang dapat menyebabkan gangguan layanan atau kehilangan data. `cdk refactor`Perintah secara cerdas mendeteksi perubahan ini dan bekerja dengan CloudFormation API refactoring untuk mempertahankan sumber daya Anda sambil memperbarui logisnya. IDs

Dengan `cdk refactor`, Anda dapat:
+ Ganti nama konstruksi untuk kejelasan yang lebih baik dalam basis kode Anda tanpa menyebabkan penggantian sumber daya.
+ Pindahkan sumber daya antar tumpukan untuk meningkatkan organisasi dan pemisahan kekhawatiran.
+ Atur ulang hierarki konstruksi Anda (seperti mengelompokkan sumber daya AWS di bawah konstruksi L3 baru) sambil mempertahankan sumber daya cloud yang mendasarinya.
+ Upgrade atau beralih dengan aman di antara pustaka konstruksi, termasuk dependensi pihak ketiga, tanpa memicu penggantian sumber daya saat perubahan logis antar versi. IDs 

Perintah ini menganalisis perubahan Anda, menampilkan daftar sumber daya yang akan mengubah lokasi (tumpukan dan ID logis), dan menangani proses kompleks memperbarui sumber CloudFormation daya sambil mempertahankan identitas dan statusnya.

Saat dijalankan, perintah secara otomatis menghitung pemetaan dengan membandingkan kode Anda saat ini dengan status yang diterapkan. Ini memverifikasi bahwa aplikasi CDK Anda berisi kumpulan sumber daya yang persis sama dengan status yang diterapkan, hanya berbeda di lokasi mereka di pohon konstruksi. Jika perintah mendeteksi penambahan, penghapusan, atau modifikasi sumber daya apa pun, operasi refactoring akan ditolak dengan pesan kesalahan.

Setelah memetakan komputasi, perintah menunjukkan kepada Anda perubahan yang diusulkan dan, setelah konfirmasi pengguna, menerapkan refactoring. Jika ambiguitas terdeteksi (di mana beberapa pemetaan yang valid dimungkinkan), Anda dapat memberikan file penggantian dengan pemetaan eksplisit untuk menyelesaikan kasus ini.

Untuk pengantar, lihat [Mempertahankan sumber daya yang diterapkan saat memfaktorkan ulang kode CDK](refactor.md).

## Penggunaan
<a name="ref-cli-cmd-refactor-usage"></a>

```
$ cdk refactor <arguments> <options>
```

## Argumen
<a name="ref-cli-cmd-refactor-args"></a><a name="ref-cli-cmd-refactor-args-stack-id"></a>

 **ID tumpukan CDK**   
ID konstruksi tumpukan CDK dari aplikasi Anda menjadi refactor.  
Anda dapat menentukan beberapa tumpukan IDs untuk memfokuskan operasi refactoring pada tumpukan tersebut. Jika sumber daya dipindahkan antar tumpukan, dan salah satu tumpukan tersebut tidak disertakan secara eksplisit, perintah refactor akan secara otomatis menyertakan tumpukan tambahan dalam operasi.  
Jika Anda tidak menyediakan tumpukan apa pun IDs, semua tumpukan di aplikasi akan dipertimbangkan untuk refactoring.  
 *Tipe*: String  
 *Wajib*: Tidak

## Opsi
<a name="ref-cli-cmd-refactor-options"></a>

Untuk daftar opsi global yang berfungsi dengan semua perintah CDK CLI, [lihat](ref-cli-cmd.md#ref-cli-cmd-options) Opsi global.<a name="ref-cli-cmd-refactor-options-dry-run"></a>

 `--dry-run`   
Cetak pemetaan ke konsol tanpa menerapkannya.  
Opsi ini berguna untuk memvalidasi perubahan Anda sebelum benar-benar melakukan refactoring, terutama saat bekerja dengan aplikasi yang kompleks. Ini menunjukkan kepada Anda dengan tepat perubahan apa yang akan dilakukan tanpa memodifikasi sumber daya apa pun.<a name="ref-cli-cmd-refactor-options-force"></a>

 `--force`   
Lanjutkan dengan refactoring tanpa meminta pengguna untuk konfirmasi.  
Ini berguna dalam lingkungan interaktif ketika Anda yakin tentang perubahan. Dalam lingkungan non-interaktif seperti CI/CD pipeline, CDK CLI secara otomatis berjalan tanpa diminta, jadi opsi ini tidak diperlukan.<a name="ref-cli-cmd-refactor-options-help"></a>

 `--help, -h <BOOLEAN>`   
Tampilkan informasi referensi perintah untuk `cdk refactor` perintah.<a name="ref-cli-cmd-refactor-options-override-file"></a>

 `--override-file <FILE>`   
Berikan penggantian saat CDK CLI tidak dapat menentukan resolusi refactoring untuk sumber daya. File ini berisi pemetaan sumber daya dalam format JSON. Berikut ini adalah contohnya:  

```
{
    "environments": [
        {
            "account": "123456789012",
            "region": "us-east-2",
            "resources": {
                "StackA.OldName": "StackB.NewName",
                "StackC.Foo": "StackC.Bar"
            }
        }
    ]
}
```<a name="ref-cli-cmd-refactor-options-revert"></a>

 `--revert <FILE>`   
Kembalikan refactor sebelumnya. Anda harus menyediakan file override dengan pemetaan sumber daya.  
Ini tidak sepenuhnya membatalkan operasi refactor sebelumnya. Untuk mengembalikan refactor sepenuhnya, Anda perlu mengembalikan aplikasi ke status sebelumnya dan menjalankan proses refactor lagi.

# `cdk rollback`
<a name="ref-cli-cmd-rollback"></a>

Gunakan perintah AWS Cloud Development Kit (AWS CDK) Command Line Interface (CLI`cdk rollback`) untuk mengembalikan tumpukan yang gagal atau dijeda dari penerapan ke status stabil AWS CloudFormation terakhirnya.

**catatan**  
Untuk menggunakan perintah ini, Anda harus memiliki v23 dari template bootstrap yang disebarkan ke lingkungan Anda. Untuk informasi selengkapnya, lihat [Riwayat versi template Bootstrap](bootstrapping-env.md#bootstrap-template-history).

Saat Anda menerapkan penggunaan`cdk deploy`, CDK CLI akan mengembalikan penerapan yang gagal secara default. Jika Anda menentukan `--no-rollback` dengan`cdk deploy`, Anda kemudian dapat menggunakan `cdk rollback` perintah untuk secara manual mengembalikan penerapan yang gagal. Ini akan memulai rollback ke status stabil terakhir dari tumpukan Anda.

## Penggunaan
<a name="ref-cli-cmd-rollback-usage"></a>

```
$ cdk rollback <arguments> <options>
```

## Pendapat
<a name="ref-cli-cmd-rollback-args"></a><a name="ref-cli-cmd-rollback-args-stack-name"></a>

 **ID tumpukan CDK**   
ID build tumpukan CDK dari aplikasi Anda ke rollback.  
 *Tipe*: String  
 *Wajib*: Tidak

## Opsi
<a name="ref-cli-cmd-rollback-options"></a>

Untuk daftar opsi global yang berfungsi dengan semua perintah CDK CLI, [lihat](ref-cli-cmd.md#ref-cli-cmd-options) Opsi global.<a name="ref-cli-cmd-rollback-options-all"></a>

 `--all <BOOLEAN>`   
Kembalikan semua tumpukan di aplikasi CDK Anda.  
 *Nilai default*: `false` <a name="ref-cli-cmd-rollback-options-force"></a>

 `--force, -f <BOOLEAN>`   
Ketika Anda menggunakan`cdk rollback`, beberapa sumber daya mungkin gagal untuk rollback. Berikan opsi ini untuk memaksa rollback semua sumber daya. Ini adalah perilaku yang sama dengan menyediakan `--orphan` opsi untuk setiap sumber daya di tumpukan Anda.  
 *Nilai default*: `false` <a name="ref-cli-cmd-rollback-options-help"></a>

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

 `--orphan <LogicalId>`   
Ketika Anda menggunakan`cdk rollback`, beberapa sumber daya mungkin gagal untuk rollback. Ketika ini terjadi, Anda dapat mencoba untuk memaksa rollback sumber daya dengan menggunakan opsi ini dan memberikan ID logis dari sumber daya yang gagal untuk rollback.  
Opsi ini dapat diberikan beberapa kali dalam satu perintah Berikut ini adalah contoh:  

```
$ cdk rollback MyStack --orphan MyLambdaFunction --orphan MyLambdaFunction2
```
Untuk memaksa rollback semua sumber daya, gunakan `--force` opsi sebagai gantinya.<a name="ref-cli-cmd-rollback-options-toolkit-stack-name"></a>

 `--toolkit-stack-name <STRING>`   
Nama tumpukan CDK Toolkit yang ada tempat lingkungan di-bootstrap.  
Secara default, `cdk bootstrap` menyebarkan tumpukan bernama `CDKToolkit` ke dalam AWS lingkungan yang ditentukan. Gunakan opsi ini untuk memberikan nama yang berbeda untuk tumpukan bootstrap Anda.  
CDK CLI menggunakan nilai ini untuk memverifikasi versi stack bootstrap Anda.<a name="ref-cli-cmd-rollback-options-validate-bootstrap-version"></a>

 `--validate-bootstrap-version <BOOLEAN>`   
Tentukan apakah akan memvalidasi versi stack bootstrap. Menyediakan `--validate-bootstrap-version=false` atau `--no-validate-bootsrap-version` mematikan perilaku ini.  
 *Nilai default*: `true` 

# `cdk synthesize`
<a name="ref-cli-cmd-synth"></a>

Sintesis aplikasi CDK untuk menghasilkan rakitan cloud, termasuk AWS CloudFormation template untuk setiap tumpukan.

Rakitan cloud adalah file yang menyertakan semua yang diperlukan untuk menerapkan aplikasi Anda ke lingkungan Anda. AWS Misalnya, ini menyertakan CloudFormation template untuk setiap tumpukan di aplikasi Anda, dan salinan aset file atau gambar Docker yang Anda referensikan di aplikasi Anda.

Jika aplikasi Anda berisi satu tumpukan atau jika satu tumpukan disediakan sebagai argumen, CloudFormation template juga akan ditampilkan dalam output standar (`stdout`) dalam format YAMAL.

Jika aplikasi Anda berisi beberapa tumpukan, `cdk synth` akan mensintesis perakitan cloud ke. `cdk.out`

## Penggunaan
<a name="ref-cli-cmd-synth-usage"></a>

```
cdk synthesize <arguments> <options>
```

## Argumen
<a name="ref-cli-cmd-synth-args"></a><a name="ref-cli-cmd-synth-args-stack-name"></a>

 **ID tumpukan CDK**   
ID konstruksi tumpukan CDK dari aplikasi Anda untuk disintesis.  
 *Tipe*: String  
 *Wajib*: Tidak

## Opsi
<a name="ref-cli-cmd-synth-options"></a>

Untuk daftar opsi global yang berfungsi dengan semua perintah CDK CLI, [lihat](ref-cli-cmd.md#ref-cli-cmd-options) Opsi global.<a name="ref-cli-cmd-synth-options-exclusively"></a>

 `--exclusively, -e <BOOLEAN>`   
Hanya mensintesis tumpukan yang diminta, jangan sertakan dependensi.<a name="ref-cli-cmd-synth-options-help"></a>

 `--help, -h <BOOLEAN>`   
Tampilkan informasi referensi perintah untuk `cdk synthesize` perintah.<a name="ref-cli-cmd-synth-options-quiet"></a>

 `--quiet, -q <BOOLEAN>`   
Jangan keluarkan CloudFormation template ke`stdout`.  
Opsi ini dapat dikonfigurasi dalam `cdk.json` file proyek CDK. Berikut ini adalah contohnya:  

```
{
   "quiet": true
}
```
 *Nilai default*: `false` <a name="ref-cli-cmd-synth-options-validation"></a>

 `--validation <BOOLEAN>`   
Validasi CloudFormation template yang dihasilkan setelah sintesis dengan melakukan pemeriksaan tambahan.  
Anda juga dapat mengonfigurasi opsi ini melalui `validateOnSynth` atribut atau variabel `CDK_VALIDATION` lingkungan.  
 *Nilai default*: `true` 

## Contoh
<a name="ref-cli-cmd-synth-examples"></a>

### Sintesis rakitan cloud untuk tumpukan CDK dengan ID logis MyStackName dan keluarkan CloudFormation template ke stdout
<a name="ref-cli-cmd-synth-examples-1"></a>

```
$ cdk synth MyStackName
```

### Sintesis rakitan cloud untuk semua tumpukan di aplikasi CDK dan simpan ke cdk.out
<a name="ref-cli-cmd-synth-examples-2"></a>

```
$ cdk synth
```

### Sintesis rakitan cloud untuk MyStackName, tetapi jangan sertakan dependensi
<a name="ref-cli-cmd-synth-examples-3"></a>

```
$ cdk synth MyStackName --exclusively
```

### Sintesis rakitan cloud untuk MyStackName, tetapi jangan keluarkan CloudFormation template ke stdout
<a name="ref-cli-cmd-synth-examples-4"></a>

```
$ cdk synth MyStackName --quiet
```

# `cdk watch`
<a name="ref-cli-cmd-watch"></a>

Terus menonton proyek AWS CDK lokal untuk perubahan untuk melakukan penerapan dan hotswap.

Perintah ini mirip dengan`cdk deploy`, kecuali bahwa ia dapat melakukan penerapan terus menerus dan hotswaps melalui satu perintah.

Perintah ini adalah jalan pintas untuk`cdk deploy --watch`.

Untuk mengakhiri `cdk watch` sesi, hentikan proses dengan menekan`Ctrl+C`.

File yang diamati ditentukan oleh `"watch"` pengaturan dalam `cdk.json` file Anda. Ini memiliki dua sub-kunci, `"include"` dan`"exclude"`, yang menerima string tunggal atau array string. Setiap entri ditafsirkan sebagai jalur relatif terhadap lokasi `cdk.json` file. Keduanya `*` `**` dan diterima.

Jika Anda membuat proyek menggunakan `cdk init` perintah, perilaku default berikut dikonfigurasi untuk `cdk watch` dalam `cdk.json` file proyek Anda:
+  `"include"`diatur ke`"**/*"`, yang mencakup semua file dan direktori di root proyek.
+  `"exclude"`bersifat opsional, kecuali untuk file dan folder yang sudah diabaikan secara default. Ini terdiri dari file dan direktori yang dimulai dengan`.`, direktori output CDK, dan direktori. `node_modules`

Pengaturan minimal untuk mengkonfigurasi `watch` adalah`"watch": {}`.

Jika kode CDK atau kode aplikasi Anda memerlukan langkah pembuatan sebelum penerapan, `cdk watch` berfungsi dengan `"build"` kunci dalam file. `cdk.json`

**penting**  
Perintah ini dimaksudkan untuk penyebaran cepat selama fase pengembangan Aplikasi CDK dan tidak direkomendasikan untuk penerapan produksi.

Keterbatasan yang sama `cdk deploy --hotswap` berlaku untuk`cdk watch`. Untuk informasi selengkapnya, lihat ` cdk deploy --hotswap `.

## Penggunaan
<a name="ref-cli-cmd-watch-usage"></a>

```
$ cdk watch <arguments> <options>
```

## Pendapat
<a name="ref-cli-cmd-watch-args"></a><a name="ref-cli-cmd-watch-args-stack-name"></a>

 **ID tumpukan CDK**   
ID build tumpukan CDK dari aplikasi Anda untuk ditonton.  
 *Tipe*: String  
 *Wajib*: Tidak

## Opsi
<a name="ref-cli-cmd-watch-options"></a>

Untuk daftar opsi global yang berfungsi dengan semua perintah CDK CLI, [lihat](ref-cli-cmd.md#ref-cli-cmd-options) Opsi global.<a name="ref-cli-cmd-watch-options-build-exclude"></a>

 `--build-exclude, -E <ARRAY>`   
Jangan membangun kembali aset dengan ID yang diberikan.  
Opsi ini dapat ditentukan beberapa kali dalam satu perintah.  
 *Nilai default*: `[]` <a name="ref-cli-cmd-watch-options-change-set-name"></a>

 `--change-set-name <STRING>`   
Nama CloudFormation perubahan diatur untuk membuat.<a name="ref-cli-cmd-watch-options-concurrency"></a>

 `--concurrency <NUMBER>`   
Terapkan dan hotswap beberapa tumpukan secara paralel sambil memperhitungkan dependensi antar-tumpukan. Gunakan opsi ini untuk mempercepat penerapan. Anda masih harus memperhitungkan CloudFormation dan membatasi tingkat AWS akun lainnya.  
Berikan nomor untuk menentukan jumlah maksimum penerapan simultan (izin ketergantungan) untuk dilakukan.  
 *Nilai default*: `1` <a name="ref-cli-cmd-watch-options-exclusively"></a>

 `--exclusively, -e <BOOLEAN>`   
Hanya terapkan tumpukan yang diminta dan jangan sertakan dependensi.<a name="ref-cli-cmd-watch-options-force"></a>

 `--force, -f <BOOLEAN>`   
Selalu gunakan tumpukan, bahkan jika template identik.  
 *Nilai default*: `false` <a name="ref-cli-cmd-watch-options-help"></a>

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

 `--hotswap <BOOLEAN>`   
Secara default, `cdk watch` gunakan penerapan hotswap bila memungkinkan untuk memperbarui sumber daya Anda. CDK CLI akan mencoba melakukan penyebaran hotswap dan tidak akan kembali ke penerapan penuh jika tidak berhasil. CloudFormation Setiap perubahan yang terdeteksi yang tidak dapat diperbarui melalui hotswap diabaikan.  
 *Nilai default*: `true` <a name="ref-cli-cmd-watch-options-hotswap-fallback"></a>

 `--hotswap-fallback <BOOLEAN>`   
Secara default, `cdk watch` upaya untuk melakukan penerapan hotswap dan mengabaikan perubahan yang memerlukan penerapan. CloudFormation Berikan `--hotswap-fallback` untuk mundur dan melakukan penerapan penuh jika CloudFormation penerapan hotswap tidak berhasil.<a name="ref-cli-cmd-watch-options-logs"></a>

 `--logs <BOOLEAN>`   
Secara default, `cdk watch` memantau semua grup CloudWatch log dalam aplikasi Anda dan mengalirkan peristiwa log secara lokal ke. `stdout`  
 *Nilai default*: `true` <a name="ref-cli-cmd-watch-options-progress"></a>

 `--progress <STRING>`   
Konfigurasikan bagaimana CDK CLI menampilkan kemajuan penerapan.  
+  `bar`— Tampilkan peristiwa penyebaran tumpukan sebagai bilah kemajuan, dengan peristiwa untuk sumber daya yang saat ini sedang digunakan.
+  `events`— Berikan riwayat lengkap, termasuk semua CloudFormation acara.
Anda juga dapat mengonfigurasi opsi ini di `cdk.json` file proyek atau `~/.cdk.json` di mesin pengembangan lokal Anda:  

```
{
   "progress": "events"
}
```
 *Nilai valid:* `bar`, `events`   
 *Nilai default*: `bar` <a name="ref-cli-cmd-watch-options-rollback"></a>

 `--rollback <BOOLEAN>`   
Selama penerapan, jika sumber daya gagal dibuat atau diperbarui, penerapan akan kembali ke status stabil terbaru sebelum CLI CDK kembali. Semua perubahan yang dibuat sampai saat itu akan dibatalkan. Sumber daya yang dibuat akan dihapus dan pembaruan yang dibuat akan dibatalkan.  
Gunakan `--no-rollback` atau `-R` untuk menonaktifkan perilaku ini. Jika sumber daya gagal dibuat atau diperbarui, CLI CDK akan meninggalkan perubahan yang dibuat hingga saat itu dan kembali. Ini mungkin membantu dalam lingkungan pengembangan di mana Anda melakukan iterasi dengan cepat.  
Kapan`false`, penerapan yang menyebabkan penggantian sumber daya akan selalu gagal. Anda hanya dapat menggunakan nilai ini untuk penerapan yang memperbarui atau membuat sumber daya baru.
 *Nilai default*: `true` <a name="ref-cli-cmd-watch-options-toolkit-stack-name"></a>

 `--toolkit-stack-name <STRING>`   
Nama tumpukan CDK Toolkit yang ada.  
Secara default, `cdk bootstrap` menyebarkan tumpukan bernama `CDKToolkit` ke dalam AWS lingkungan yang ditentukan. Gunakan opsi ini untuk memberikan nama yang berbeda untuk tumpukan bootstrap Anda.  
CDK CLI menggunakan nilai ini untuk memverifikasi versi stack bootstrap Anda.

## Contoh
<a name="ref-cli-cmd-watch-examples"></a>

### Tonton tumpukan CDK dengan ID logis DevelopmentStack untuk perubahan
<a name="ref-cli-cmd-watch-examples-1"></a>

```
$ cdk watch DevelopmentStack
Detected change to 'lambda-code/index.js' (type: change). Triggering 'cdk deploy'
DevelopmentStack: deploying...

 ✅  DevelopmentStack
```

### Konfigurasikan file cdk.json untuk apa yang harus disertakan dan dikecualikan agar tidak diawasi untuk perubahan
<a name="ref-cli-cmd-watch-examples-2"></a>

```
{
   "app": "mvn -e -q compile exec:java",
   "watch": {
    "include": "src/main/**",
    "exclude": "target/*"
   }
}
```

### Bangun proyek CDK menggunakan Java sebelum penerapan dengan mengonfigurasi file cdk.json
<a name="ref-cli-cmd-watch-examples-3"></a>

```
{
  "app": "mvn -e -q exec:java",
  "build": "mvn package",
  "watch": {
    "include": "src/main/**",
    "exclude": "target/*"
  }
}
```