Ini adalah Panduan Pengembang AWS CDK v2. CDK v1 yang lebih lama memasuki pemeliharaan pada 1 Juni 2022 dan mengakhiri dukungan pada 1 Juni 2023.

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# `cdk 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...
```