Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Membuat bendera fitur multi-varian
Gunakan prosedur di bagian ini untuk membuat varian bendera fitur.
**Sebelum Anda mulai**
Perhatikan informasi penting berikut.
+ Anda dapat membuat varian bendera fitur yang ada dengan mengeditnya. Anda tidak dapat membuat varian tanda fitur baru *saat membuat profil konfigurasi baru*. Anda harus menyelesaikan alur kerja membuat profil konfigurasi baru terlebih dahulu. Setelah Anda membuat profil konfigurasi, Anda dapat menambahkan varian ke bendera apa pun dalam profil konfigurasi. Untuk informasi tentang cara membuat profil konfigurasi baru, lihat[Membuat profil konfigurasi bendera fitur di AWS AppConfig](appconfig-creating-configuration-and-profile-feature-flags.md).
+ Untuk mengambil data varian tanda fitur untuk platform komputasi Amazon EC2, Amazon ECS, dan Amazon EKS, Anda harus AWS AppConfig menggunakan Agen versi 2.0.4416 atau yang lebih baru.
+ Untuk alasan kinerja, AWS CLI dan panggilan SDK untuk AWS AppConfig tidak mengambil data varian. Untuk informasi lebih lanjut tentang AWS AppConfig Agen, lihat[Cara menggunakan AWS AppConfig Agen untuk mengambil data konfigurasi](appconfig-agent-how-to-use.md).
+ Saat Anda membuat varian bendera fitur, Anda menentukan aturan untuk itu. Aturan adalah ekspresi yang mengambil konteks permintaan sebagai input dan menghasilkan hasil boolean sebagai output. Sebelum Anda membuat varian, tinjau operan dan operator yang didukung untuk menandai aturan varian. Anda dapat membuat aturan sebelum membuat varian. Untuk informasi selengkapnya, lihat [Memahami aturan bendera fitur multi-varian](appconfig-creating-multi-variant-feature-flags-rules.md).
**Topics**
+ [Membuat bendera fitur multi-varian (konsol)](#appconfig-creating-multi-variant-feature-flags-procedures-console)
+ [Membuat bendera fitur multi-varian (baris perintah)](#appconfig-creating-multi-variant-feature-flags-procedures-commandline)
## Membuat bendera fitur multi-varian (konsol)
Prosedur berikut menjelaskan cara membuat flag fitur multi-varian untuk profil konfigurasi yang ada dengan menggunakan AWS AppConfig konsol. Anda juga dapat mengedit bendera fitur yang ada untuk membuat varian.
**Untuk membuat bendera fitur multi-varian**
1. Buka AWS Systems Manager konsol di [https://console.aws.amazon.com/systems-manager/appconfig/](https://console.aws.amazon.com/systems-manager/appconfig/).
1. Di panel navigasi, pilih **Aplikasi**, lalu pilih aplikasi.
1. Pada tab **Profil konfigurasi dan bendera fitur**, pilih profil konfigurasi bendera fitur yang ada.
1. Di bagian **Bendera**, pilih **Tambahkan bendera baru**.
1. Di bagian **Definisi bendera fitur**, untuk **nama Bendera**, masukkan nama.
1. Untuk **tombol Bendera** masukkan pengenal bendera untuk membedakan bendera dalam profil konfigurasi yang sama. Bendera dalam profil konfigurasi yang sama tidak dapat memiliki kunci yang sama. Setelah bendera dibuat, Anda dapat mengedit nama bendera, tetapi bukan tombol bendera.
1. (Opsional) Di bidang **Deskripsi**, masukkan informasi tentang bendera ini.
1. Di bagian **Varian**, pilih **Multi-variantbendera**.
1. (Opsional) Di bagian **atribut bendera fitur**, pilih **Tentukan atribut**. Atribut memungkinkan Anda untuk memberikan nilai tambahan dalam flag Anda. Untuk informasi selengkapnya tentang atribut dan kendala, lihat. [Memahami atribut bendera fitur](appconfig-creating-configuration-and-profile-feature-flags.md#appconfig-creating-configuration-profile-feature-flag-attributes)
1. Untuk **Key**, tentukan tombol bendera dan pilih jenisnya dari daftar **Type**. Untuk informasi tentang opsi yang didukung untuk bidang **Nilai** dan Batasan, lihat bagian **yang** direferensikan sebelumnya tentang atribut.
1. Pilih **Nilai yang diperlukan** untuk menentukan apakah nilai atribut diperlukan.
1. Pilih **Tentukan atribut** untuk menambahkan atribut tambahan.
1. Pilih **Terapkan** untuk menyimpan perubahan atribut.
1. Di bagian **Varian bendera fitur**, pilih **Buat varian**.
1. Untuk **nama Variant**, masukkan nama.
1. Gunakan sakelar **nilai Diaktifkan** untuk mengaktifkan varian.
1. Di kotak teks **Aturan**, masukkan aturan.
1. Gunakan opsi **Buat varian>** **Buat varian di atas** atau **Buat varian di bawah** ini untuk membuat varian tambahan untuk bendera ini.
1. Di bagian **varian Default**, gunakan sakelar **Nilai diaktifkan** untuk mengaktifkan varian default. Secara opsional, berikan nilai untuk atribut yang ditentukan pada langkah 10.
1. Pilih **Terapkan**.
1. Verifikasi detail bendera dan variannya dan pilih **Buat bendera**.
Untuk informasi tentang penerapan flag fitur baru Anda dengan varian, lihat[Menyebarkan flag fitur dan data konfigurasi di AWS AppConfig](deploying-feature-flags.md).
## Membuat bendera fitur multi-varian (baris perintah)
Prosedur berikut menjelaskan cara menggunakan AWS Command Line Interface (di Linux atau Windows) atau Alat untuk Windows PowerShell untuk membuat bendera fitur multi-varian untuk profil konfigurasi yang ada. Anda juga dapat mengedit bendera fitur yang ada untuk membuat varian.
**Sebelum Anda mulai**
Selesaikan tugas-tugas berikut sebelum Anda membuat flag fitur multi-varian dengan menggunakan. AWS CLI
+ Buat profil konfigurasi bendera fitur. Untuk informasi selengkapnya, lihat [Membuat profil konfigurasi bendera fitur di AWS AppConfig](appconfig-creating-configuration-and-profile-feature-flags.md).
+ Perbarui ke versi terbaru dari AWS CLI. Untuk informasi selengkapnya, lihat [Menginstal atau memperbarui ke versi terbaru](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html) dari *Panduan AWS Command Line Interface Pengguna*. AWS CLI
**Untuk membuat bendera fitur multi-varian**
1. Buat file konfigurasi di mesin lokal Anda yang menentukan detail bendera multi-varian yang ingin Anda buat. Simpan file dengan ekstensi `.json` file. File harus mematuhi skema [https://docs.aws.amazon.com/appconfig/latest/userguide/appconfig-type-reference-feature-flags.html](https://docs.aws.amazon.com/appconfig/latest/userguide/appconfig-type-reference-feature-flags.html)JSON. Isi skema file konfigurasi Anda akan mirip dengan yang berikut ini.
```
{
"flags": {
"{{FLAG_NAME}}": {
"attributes": {
"{{ATTRIBUTE_NAME}}": {
"constraints": {
"type": "{{CONSTRAINT_TYPE}}"
}
}
},
"description": "{{FLAG_DESCRIPTION}}",
"name": "{{VARIANT_NAME}}"
}
},
"values": {
"{{VARIANT_VALUE_NAME}}": {
"_variants": [
{
"attributeValues": {
"{{ATTRIBUTE_NAME}}": {{BOOLEAN}}
},
"enabled": {{BOOLEAN}},
"name": "{{VARIANT_NAME}}",
"rule": "{{VARIANT_RULE}}"
},
{
"attributeValues": {
"{{ATTRIBUTE_NAME}}": {{BOOLEAN}}
},
"enabled": {{BOOLEAN}},
"name": "{{VARIANT_NAME}}",
"rule": "{{VARIANT_RULE}}"
},
{
"attributeValues": {
"{{ATTRIBUTE_NAME}}": {{BOOLEAN}}
},
"enabled": {{BOOLEAN}},
"name": "{{VARIANT_NAME}}",
"rule": "{{VARIANT_RULE}}"
},
{
"attributeValues": {
"{{ATTRIBUTE_NAME}}": {{BOOLEAN}}
},
"enabled": {{BOOLEAN}},
"name": "{{VARIANT_NAME}}",
"rule": "{{VARIANT_RULE}}"
}
]
}
},
"version": "{{VERSION_NUMBER}}"
}
```
Berikut adalah contoh dengan tiga varian dan varian default.
```
{
"flags": {
"ui_refresh": {
"attributes": {
"dark_mode_support": {
"constraints": {
"type": "boolean"
}
}
},
"description": "A release flag used to release a new UI",
"name": "UI Refresh"
}
},
"values": {
"ui_refresh": {
"_variants": [
{
"attributeValues": {
"dark_mode_support": true
},
"enabled": true,
"name": "QA",
"rule": "(ends_with $email \"qa-testers.mycompany.com\")"
},
{
"attributeValues": {
"dark_mode_support": true
},
"enabled": true,
"name": "Beta Testers",
"rule": "(exists key::\"opted_in_to_beta\")"
},
{
"attributeValues": {
"dark_mode_support": false
},
"enabled": true,
"name": "Sample Population",
"rule": "(split pct::10 by::$email)"
},
{
"attributeValues": {
"dark_mode_support": false
},
"enabled": false,
"name": "Default Variant"
}
]
}
},
"version": "1"
}
```
1. Gunakan `CreateHostedConfigurationVersion` API untuk menyimpan data konfigurasi flag fitur Anda AWS AppConfig.
------
#### [ Linux ]
```
aws appconfig create-hosted-configuration-version \
--application-id {{APPLICATION_ID}} \
--configuration-profile-id {{CONFIGURATION_PROFILE_ID}} \
--content-type "application/json" \
--content {{file://path/to/feature_flag_configuration_data.json \}}
--cli-binary-format raw-in-base64-out \
outfile
```
------
#### [ Windows ]
```
aws appconfig create-hosted-configuration-version ^
--application-id {{APPLICATION_ID}} ^
--configuration-profile-id {{CONFIGURATION_PROFILE_ID}} ^
--content-type "application/json" ^
--content {{file://path/to/feature_flag_configuration_data.json}} ^
--cli-binary-format raw-in-base64-out ^
outfile
```
------
#### [ PowerShell ]
```
New-APPCHostedConfigurationVersion `
-ApplicationId {{APPLICATION_ID}} `
-ConfigurationProfileId {{CONFIGURATION_PROFILE_ID}} `
-ContentType "application/json" `
-Content {{file://path/to/feature_flag_configuration_data.json}} `
-Raw
```
------
`service_returned_content_file`Berisi data konfigurasi Anda yang mencakup beberapa AWS AppConfig metadata yang dihasilkan.
**catatan**
Saat Anda membuat versi konfigurasi yang dihosting, AWS AppConfig verifikasi bahwa data Anda sesuai dengan skema [https://docs.aws.amazon.com/appconfig/latest/userguide/appconfig-type-reference-feature-flags.html](https://docs.aws.amazon.com/appconfig/latest/userguide/appconfig-type-reference-feature-flags.html)JSON. AWS AppConfig Selain itu memvalidasi bahwa setiap atribut flag fitur dalam data Anda memenuhi batasan yang Anda tetapkan untuk atribut tersebut.