Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Menerapkan flag fitur dan data konfigurasi di AWS AppConfig
Setelah Anda [membuat artefak yang diperlukan](https://docs.aws.amazon.com/appconfig/latest/userguide/creating-feature-flags-and-configuration-data.html) untuk bekerja dengan flag fitur dan data konfigurasi bentuk bebas, Anda dapat membuat penerapan baru. Saat Anda membuat penyebaran baru, Anda menentukan informasi berikut:
+ ID aplikasi
+ ID profil konfigurasi
+ Versi konfigurasi
+ ID lingkungan tempat Anda ingin menyebarkan data konfigurasi
+ ID strategi penerapan yang menentukan seberapa cepat Anda ingin perubahan diterapkan
+ ID kunci AWS Key Management Service (AWS KMS) untuk mengenkripsi data menggunakan kunci yang dikelola pelanggan.
Saat Anda memanggil tindakan [StartDeployment](https://docs.aws.amazon.com/appconfig/2019-10-09/APIReference/API_StartDeployment.html)API, AWS AppConfig lakukan tugas-tugas berikut:
1. Mengambil data konfigurasi dari penyimpanan data yang mendasarinya dengan menggunakan URI lokasi di profil konfigurasi.
1. Memverifikasi data konfigurasi secara sintaksis dan semantik benar dengan menggunakan validator yang Anda tentukan saat membuat profil konfigurasi.
1. Cache salinan data sehingga siap untuk diambil oleh aplikasi Anda. Salinan cache ini disebut data yang *digunakan*.
Anda dapat mengurangi situasi di mana penerapan data konfigurasi menyebabkan kesalahan dalam aplikasi Anda dengan menggunakan kombinasi strategi AWS AppConfig penerapan dan rollback otomatis berdasarkan alarm Amazon. CloudWatch Strategi penerapan memungkinkan Anda untuk secara perlahan merilis perubahan ke semua target atau segmen tertentu selama beberapa menit atau jam—baik berbasis sesi atau sepanjang dimensi target Anda sendiri dengan memanfaatkan penerapan berbasis entitas. Setelah Anda mengonfigurasi CloudWatch, jika satu atau beberapa alarm masuk ke status alarm selama penerapan, AWS AppConfig secara otomatis memutar kembali data konfigurasi Anda ke versi sebelumnya. Untuk informasi selengkapnya tentang strategi penerapan, lihat[Bekerja dengan strategi penyebaran](appconfig-creating-deployment-strategy.md). Untuk informasi selengkapnya tentang rollback otomatis, lihat. [Memantau penyebaran untuk rollback otomatis](monitoring-deployments.md)
**catatan**
AWS AppConfig Agen (versi 2.0.136060 atau yang lebih baru) mendukung penerapan flag fitur atau data konfigurasi bentuk bebas ke segmen tertentu atau pengguna individu selama peluncuran bertahap. Penerapan bertahap berbasis entitas memastikan bahwa setelah pengguna atau segmen menerima versi konfigurasi, mereka terus menerima versi yang sama selama periode penerapan, terlepas dari sumber daya komputasi mana yang melayani permintaan mereka. Untuk informasi selengkapnya, lihat [Menggunakan AWS AppConfig Agen untuk penerapan bertahap berbasis pengguna atau entitas](appconfig-agent-how-to-use.md#appconfig-entity-based-gradual-deployments).
**Topics**
+ [Bekerja dengan strategi penyebaran](appconfig-creating-deployment-strategy.md)
+ [Men-deploy konfigurasi](appconfig-deploying.md)
+ [Menerapkan AWS AppConfig konfigurasi menggunakan CodePipeline](appconfig-integration-codepipeline.md)
+ [Mengembalikan konfigurasi](appconfig-deploying-reverting.md)
# Bekerja dengan strategi penyebaran
Strategi penerapan memungkinkan Anda untuk secara perlahan melepaskan perubahan ke semua target atau segmen tertentu selama beberapa menit atau jam—baik berdasarkan sesi atau sepanjang dimensi target Anda sendiri dengan memanfaatkan penerapan berbasis entitas.
**catatan**
AWS AppConfig Agen (versi 2.0.136060 atau yang lebih baru) mendukung penerapan flag fitur atau data konfigurasi bentuk bebas ke segmen tertentu atau pengguna individu selama peluncuran bertahap. Penerapan bertahap berbasis entitas memastikan bahwa setelah pengguna atau segmen menerima versi konfigurasi, mereka terus menerima versi yang sama selama periode penerapan, terlepas dari sumber daya komputasi mana yang melayani permintaan mereka. Untuk informasi selengkapnya, lihat [Menggunakan AWS AppConfig Agen untuk penerapan bertahap berbasis pengguna atau entitas](appconfig-agent-how-to-use.md#appconfig-entity-based-gradual-deployments).
Strategi AWS AppConfig penyebaran mendefinisikan aspek-aspek penting berikut dari penerapan konfigurasi.
****
| Pengaturan | Deskripsi |
| --- | --- |
| Waktu berlalu | Kemajuan penerapan |
| --- | --- |
| Tipe deployment | *Jenis penerapan mendefinisikan bagaimana konfigurasi diterapkan atau diluncurkan.* AWS AppConfig mendukung jenis penyebaran **Linear** dan **Eksponensial**. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/appconfig/latest/userguide/appconfig-creating-deployment-strategy.html) |
| Persentase langkah (faktor pertumbuhan) | Pengaturan ini menentukan persentase penelepon yang akan ditargetkan selama setiap langkah penerapan. Dalam SDK dan [Referensi AWS AppConfig API](https://docs.aws.amazon.com/appconfig/2019-10-09/APIReference/API_CreateDeploymentStrategy.html), `step percentage` disebut`growth factor`. |
| Waktu deployment | Pengaturan ini menentukan jumlah waktu selama AWS AppConfig penyebaran ke host. Ini bukan nilai batas waktu. Ini adalah jendela waktu di mana penyebaran diproses dalam interval. |
| Waktu menanam | Pengaturan ini menentukan jumlah AWS AppConfig monitor waktu untuk CloudWatch alarm Amazon setelah konfigurasi dikerahkan ke 100% targetnya, sebelum mempertimbangkan penerapan selesai. Jika alarm dipicu selama waktu ini AWS AppConfig , putar kembali penerapan. Anda harus mengonfigurasi izin AWS AppConfig untuk memutar kembali berdasarkan CloudWatch alarm. Untuk informasi selengkapnya, lihat [Konfigurasikan izin untuk rollback otomatis](setting-up-appconfig.md#getting-started-with-appconfig-cloudwatch-alarms-permissions). |
| 0 jam | 0% |
| 2 jam | 20% |
| 4 jam | 40% |
| 6 jam | 60% |
| 8 jam | 80% |
| 10 jam | 100% |
Anda dapat memilih strategi yang telah ditentukan yang disertakan dengan AWS AppConfig atau membuat sendiri.
**catatan**
AWS AppConfig Agen (versi 2.0.136060 atau yang lebih baru) mendukung penerapan flag fitur atau data konfigurasi bentuk bebas ke segmen tertentu atau pengguna individu selama peluncuran bertahap. Penerapan bertahap berbasis entitas memastikan bahwa setelah pengguna atau segmen menerima versi konfigurasi, mereka terus menerima versi yang sama selama periode penerapan, terlepas dari sumber daya komputasi mana yang melayani permintaan mereka. Untuk informasi selengkapnya, lihat [Menggunakan AWS AppConfig Agen untuk penerapan bertahap berbasis pengguna atau entitas](appconfig-agent-how-to-use.md#appconfig-entity-based-gradual-deployments).
**Topics**
+ [Menggunakan strategi penyebaran yang telah ditentukan](appconfig-creating-deployment-strategy-predefined.md)
+ [Buat strategi deployment](appconfig-creating-deployment-strategy-create.md)
# Menggunakan strategi penyebaran yang telah ditentukan
AWS AppConfig menyertakan strategi penerapan yang telah ditentukan untuk membantu Anda menerapkan konfigurasi dengan cepat. Alih-alih membuat strategi Anda sendiri, Anda dapat memilih salah satu dari berikut ini saat Anda menerapkan konfigurasi.
****
| Strategi deployment | Deskripsi |
| --- | --- |
| AppConfig.Linear20 6 PercentEvery Menit | **AWS direkomendasikan**: Strategi ini menerapkan konfigurasi hingga 20% dari semua target setiap enam menit selama 30 menit penerapan. Sistem memonitor CloudWatch alarm Amazon selama 30 menit. Jika tidak ada alarm yang diterima saat ini, penyebaran selesai. Jika alarm dipicu selama waktu ini AWS AppConfig , putar kembali penerapan.Kami merekomendasikan penggunaan strategi ini untuk penerapan produksi karena selaras dengan praktik AWS terbaik dan mencakup penekanan tambahan pada keselamatan penerapan karena durasinya yang lama dan waktu pemanggangan. |
| AppConfig.Canary10Percent20Menit | **AWS direkomendasikan**: Strategi ini memproses penyebaran secara eksponensial menggunakan faktor pertumbuhan 10% selama 20 menit. Sistem memonitor CloudWatch alarm selama 10 menit. Jika tidak ada alarm yang diterima saat ini, penyebaran selesai. Jika alarm dipicu selama waktu ini AWS AppConfig , putar kembali penerapan.Sebaiknya gunakan strategi ini untuk penerapan produksi karena strategi ini sejalan dengan praktik AWS terbaik untuk penerapan konfigurasi. |
| AppConfig.AllAtOnce | **Cepat**: Strategi ini segera menyebarkan konfigurasi ke semua target. Sistem memonitor CloudWatch alarm selama 10 menit. Jika tidak ada alarm yang diterima saat ini, penyebaran selesai. Jika alarm dipicu selama waktu ini AWS AppConfig , putar kembali penerapan. |
| AppConfig.Linear50 30 Detik PercentEvery | **Pengujian/demonstrasi**: Strategi ini menyebarkan konfigurasi ke setengah dari semua target setiap 30 detik untuk penerapan satu menit. Sistem memonitor CloudWatch alarm Amazon selama 1 menit. Jika tidak ada alarm yang diterima saat ini, penyebaran selesai. Jika alarm dipicu selama waktu ini AWS AppConfig , putar kembali penerapan.Sebaiknya gunakan strategi ini hanya untuk tujuan pengujian atau demonstrasi karena memiliki durasi dan waktu pemanggangan yang singkat. |
# Buat strategi deployment
Jika Anda tidak ingin menggunakan salah satu strategi penerapan yang telah ditentukan sebelumnya, Anda dapat membuatnya sendiri. Anda dapat membuat maksimal 20 strategi penyebaran. Saat menerapkan konfigurasi, Anda dapat memilih strategi penerapan yang paling sesuai untuk aplikasi dan lingkungan.
## Membuat strategi AWS AppConfig penerapan (konsol)
Gunakan prosedur berikut untuk membuat strategi AWS AppConfig penyebaran dengan menggunakan AWS Systems Manager konsol.
**Untuk membuat strategi penyebaran**
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 **Strategi penyebaran, lalu pilih Buat strategi** **penerapan**.
1. Untuk **Nama**, masukkan nama untuk strategi penyebaran.
1. Untuk **Deskripsi**, masukkan informasi tentang strategi penyebaran.
1. Untuk **jenis Deployment**, pilih tipe.
1. Untuk **persentase Langkah**, pilih persentase penelepon yang akan ditargetkan selama setiap langkah penerapan.
1. Untuk **waktu Deployment**, masukkan total durasi penerapan dalam hitungan menit atau jam.
1. Untuk **waktu Bake**, masukkan total waktu, dalam menit atau jam, untuk memantau CloudWatch alarm Amazon sebelum melanjutkan ke langkah penerapan berikutnya atau sebelum mempertimbangkan penerapan selesai.
1. Di bagian **Tag**, masukkan kunci dan nilai opsional. Anda dapat menentukan maksimum 50 tag untuk sumber daya.
1. Pilih **Buat strategi penerapan**.
**penting**
Jika Anda membuat profil konfigurasi untuk AWS CodePipeline, maka Anda harus membuat pipeline CodePipeline yang menentukan AWS AppConfig sebagai penyedia *penerapan*. Anda tidak perlu tampil[Men-deploy konfigurasi](appconfig-deploying.md). Namun, Anda harus mengonfigurasi klien untuk menerima pembaruan konfigurasi aplikasi seperti yang dijelaskan dalam[Mengambil data konfigurasi tanpa Agen AWS AppConfig](about-data-plane.md). *Untuk informasi tentang membuat pipeline yang ditetapkan AWS AppConfig sebagai penyedia penerapan, lihat [Tutorial: Membuat Pipeline yang Digunakan AWS AppConfig sebagai Penyedia Deployment di Panduan](https://docs.aws.amazon.com/codepipeline/latest/userguide/tutorials-AppConfig.html) Pengguna.AWS CodePipeline *
Lanjut ke [Men-deploy konfigurasi](appconfig-deploying.md).
## Membuat strategi AWS AppConfig penyebaran (baris perintah)
Prosedur berikut menjelaskan cara menggunakan AWS CLI (di Linux atau Windows) atau Alat AWS untuk PowerShell untuk membuat strategi AWS AppConfig penyebaran.
**Untuk membuat strategi penyebaran langkah demi langkah**
1. Buka AWS CLI.
1. Jalankan perintah berikut untuk membuat strategi penyebaran.
------
#### [ Linux ]
```
aws appconfig create-deployment-strategy \
--name A_name_for_the_deployment_strategy \
--description A_description_of_the_deployment_strategy \
--deployment-duration-in-minutes Total_amount_of_time_for_a_deployment_to_last \
--final-bake-time-in-minutes Amount_of_time_AWS AppConfig_monitors_for_alarms_before_considering_the_deployment_to_be_complete \
--growth-factor The_percentage_of_targets_to_receive_a_deployed_configuration_during_each_interval \
--growth-type The_linear_or_exponential_algorithm_used_to_define_how_percentage_grows_over_time \
--replicate-to To_save_the_deployment_strategy_to_a_Systems_Manager_(SSM)_document \
--tags User_defined_key_value_pair_metadata_of_the_deployment_strategy
```
------
#### [ Windows ]
```
aws appconfig create-deployment-strategy ^
--name A_name_for_the_deployment_strategy ^
--description A_description_of_the_deployment_strategy ^
--deployment-duration-in-minutes Total_amount_of_time_for_a_deployment_to_last ^
--final-bake-time-in-minutes Amount_of_time_AWS AppConfig_monitors_for_alarms_before_considering_the_deployment_to_be_complete ^
--growth-factor The_percentage_of_targets_to_receive_a_deployed_configuration_during_each_interval ^
--growth-type The_linear_or_exponential_algorithm_used_to_define_how_percentage_grows_over_time ^
--name A_name_for_the_deployment_strategy ^
--replicate-to To_save_the_deployment_strategy_to_a_Systems_Manager_(SSM)_document ^
--tags User_defined_key_value_pair_metadata_of_the_deployment_strategy
```
------
#### [ PowerShell ]
```
New-APPCDeploymentStrategy `
--Name A_name_for_the_deployment_strategy `
--Description A_description_of_the_deployment_strategy `
--DeploymentDurationInMinutes Total_amount_of_time_for_a_deployment_to_last `
--FinalBakeTimeInMinutes Amount_of_time_AWS AppConfig_monitors_for_alarms_before_considering_the_deployment_to_be_complete `
--GrowthFactor The_percentage_of_targets_to_receive_a_deployed_configuration_during_each_interval `
--GrowthType The_linear_or_exponential_algorithm_used_to_define_how_percentage_grows_over_time `
--ReplicateTo To_save_the_deployment_strategy_to_a_Systems_Manager_(SSM)_document `
--Tag Hashtable_type_User_defined_key_value_pair_metadata_of_the_deployment_strategy
```
------
Sistem mengembalikan informasi seperti berikut ini.
------
#### [ Linux ]
```
{
"Id": "Id of the deployment strategy",
"Name": "Name of the deployment strategy",
"Description": "Description of the deployment strategy",
"DeploymentDurationInMinutes": "Total amount of time the deployment lasted",
"GrowthType": "The linear or exponential algorithm used to define how percentage grew over time",
"GrowthFactor": "The percentage of targets that received a deployed configuration during each interval",
"FinalBakeTimeInMinutes": "The amount of time AWS AppConfig monitored for alarms before considering the deployment to be complete",
"ReplicateTo": "The Systems Manager (SSM) document where the deployment strategy is saved"
}
```
------
#### [ Windows ]
```
{
"Id": "Id of the deployment strategy",
"Name": "Name of the deployment strategy",
"Description": "Description of the deployment strategy",
"DeploymentDurationInMinutes": "Total amount of time the deployment lasted",
"GrowthType": "The linear or exponential algorithm used to define how percentage grew over time",
"GrowthFactor": "The percentage of targets that received a deployed configuration during each interval",
"FinalBakeTimeInMinutes": "The amount of time AWS AppConfig monitored for alarms before considering the deployment to be complete",
"ReplicateTo": "The Systems Manager (SSM) document where the deployment strategy is saved"
}
```
------
#### [ PowerShell ]
```
ContentLength : Runtime of the command
DeploymentDurationInMinutes : Total amount of time the deployment lasted
Description : Description of the deployment strategy
FinalBakeTimeInMinutes : The amount of time AWS AppConfig monitored for alarms before considering the deployment to be complete
GrowthFactor : The percentage of targets that received a deployed configuration during each interval
GrowthType : The linear or exponential algorithm used to define how percentage grew over time
HttpStatusCode : HTTP Status of the runtime
Id : The deployment strategy ID
Name : Name of the deployment strategy
ReplicateTo : The Systems Manager (SSM) document where the deployment strategy is saved
ResponseMetadata : Runtime Metadata
```
------
# Men-deploy konfigurasi
Setelah Anda [membuat artefak yang diperlukan](https://docs.aws.amazon.com/appconfig/latest/userguide/creating-feature-flags-and-configuration-data.html) untuk bekerja dengan flag fitur dan data konfigurasi bentuk bebas, Anda dapat membuat penerapan baru dengan menggunakan Konsol Manajemen AWS, the AWS CLI, atau SDK. Memulai penerapan dalam AWS AppConfig panggilan operasi [StartDeployment](https://docs.aws.amazon.com/appconfig/2019-10-09/APIReference/API_StartDeployment.html)API. Panggilan ini mencakup AWS AppConfig aplikasi, lingkungan, profil konfigurasi, dan (opsional) versi data konfigurasi yang akan digunakan. IDs Panggilan juga mencakup ID dari strategi deployment yang digunakan, yang menentukan cara data konfigurasi di-deploy.
Jika Anda menerapkan rahasia yang disimpan dalam AWS Secrets Manager, objek Amazon Simple Storage Service (Amazon S3) Simple Storage Service (Amazon S3) yang dienkripsi dengan kunci yang dikelola pelanggan, atau parameter string aman yang disimpan di AWS Systems Manager Parameter Store yang dienkripsi dengan kunci yang dikelola pelanggan, Anda harus menentukan nilai untuk parameter tersebut. `KmsKeyIdentifier` Jika konfigurasi Anda tidak dienkripsi atau dienkripsi dengan Kunci yang dikelola AWS, menentukan nilai untuk parameter tidak diperlukan. `KmsKeyIdentifier`
**catatan**
Nilai yang Anda tentukan `KmsKeyIdentifier` harus berupa kunci yang dikelola pelanggan. Ini tidak harus menjadi kunci yang sama yang Anda gunakan untuk mengenkripsi konfigurasi Anda.
Saat Anda memulai penerapan dengan a`KmsKeyIdentifier`, kebijakan izin yang dilampirkan pada prinsipal AWS Identity and Access Management (IAM) Anda harus mengizinkan operasi. `kms:GenerateDataKey`
AWS AppConfig memantau distribusi ke semua host dan melaporkan status. Jika distribusi gagal, maka AWS AppConfig putar kembali konfigurasi.
**catatan**
Anda hanya dapat menerapkan satu konfigurasi pada satu waktu ke lingkungan. Namun, Anda dapat menerapkan satu konfigurasi masing-masing ke lingkungan yang berbeda secara bersamaan.
## Menerapkan konfigurasi (konsol)
Gunakan prosedur berikut untuk menerapkan AWS AppConfig konfigurasi menggunakan AWS Systems Manager konsol.
**Untuk menerapkan konfigurasi dengan menggunakan konsol**
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 yang Anda buat. [Membuat namespace untuk aplikasi Anda di AWS AppConfig](appconfig-creating-namespace.md)
1. Pada tab **Lingkungan**, isi tombol radio untuk lingkungan, lalu pilih **Lihat detail**.
1. Pilih **Mulai penerapan**.
1. Untuk **Konfigurasi**, pilih konfigurasi dari daftar.
1. Bergantung pada sumber konfigurasi Anda, gunakan daftar versi untuk memilih versi yang ingin Anda gunakan.
1. Untuk **strategi Deployment**, pilih strategi dari daftar.
1. (Opsional) Untuk **deskripsi Deployment**, masukkan deskripsi.
1. Untuk **opsi enkripsi tambahan**, pilih AWS Key Management Service kunci dari daftar.
1. (Opsional) Di bagian **Tag**, pilih **Tambahkan tag baru** dan masukkan kunci dan nilai opsional. Anda dapat menentukan maksimum 50 tag untuk sumber daya.
1. Pilih **Mulai penerapan**.
## Menyebarkan konfigurasi (baris perintah)
Prosedur berikut menjelaskan cara menggunakan AWS CLI (di Linux atau Windows) atau Alat AWS untuk PowerShell untuk menyebarkan AWS AppConfig konfigurasi.
**Untuk menerapkan konfigurasi langkah demi langkah**
1. Buka AWS CLI.
1. Jalankan perintah berikut untuk menyebarkan konfigurasi.
------
#### [ Linux ]
```
aws appconfig start-deployment \
--application-id The_application_ID \
--environment-id The_environment_ID \
--deployment-strategy-id The_deployment_strategy_ID \
--configuration-profile-id The_configuration_profile_ID \
--configuration-version The_configuration_version_to_deploy \
--description A_description_of_the_deployment \
--tags User_defined_key_value_pair_metadata_of_the_deployment
```
------
#### [ Windows ]
```
aws appconfig start-deployment ^
--application-id The_application_ID ^
--environment-id The_environment_ID ^
--deployment-strategy-id The_deployment_strategy_ID ^
--configuration-profile-id The_configuration_profile_ID ^
--configuration-version The_configuration_version_to_deploy ^
--description A_description_of_the_deployment ^
--tags User_defined_key_value_pair_metadata_of_the_deployment
```
------
#### [ PowerShell ]
```
Start-APPCDeployment `
-ApplicationId The_application_ID `
-ConfigurationProfileId The_configuration_profile_ID `
-ConfigurationVersion The_configuration_version_to_deploy `
-DeploymentStrategyId The_deployment_strategy_ID `
-Description A_description_of_the_deployment `
-EnvironmentId The_environment_ID `
-Tag Hashtable_type_user_defined_key_value_pair_metadata_of_the_deployment
```
------
Sistem mengembalikan informasi seperti berikut ini.
------
#### [ Linux ]
```
{
"ApplicationId": "The ID of the application that was deployed",
"EnvironmentId" : "The ID of the environment",
"DeploymentStrategyId": "The ID of the deployment strategy that was deployed",
"ConfigurationProfileId": "The ID of the configuration profile that was deployed",
"DeploymentNumber": The sequence number of the deployment,
"ConfigurationName": "The name of the configuration",
"ConfigurationLocationUri": "Information about the source location of the configuration",
"ConfigurationVersion": "The configuration version that was deployed",
"Description": "The description of the deployment",
"DeploymentDurationInMinutes": Total amount of time the deployment lasted,
"GrowthType": "The linear or exponential algorithm used to define how percentage grew over time",
"GrowthFactor": The percentage of targets to receive a deployed configuration during each interval,
"FinalBakeTimeInMinutes": Time AWS AppConfig monitored for alarms before considering the deployment to be complete,
"State": "The state of the deployment",
"EventLog": [
{
"Description": "A description of the deployment event",
"EventType": "The type of deployment event",
"OccurredAt": The date and time the event occurred,
"TriggeredBy": "The entity that triggered the deployment event"
}
],
"PercentageComplete": The percentage of targets for which the deployment is available,
"StartedAt": The time the deployment started,
"CompletedAt": The time the deployment completed
}
```
------
#### [ Windows ]
```
{
"ApplicationId": "The ID of the application that was deployed",
"EnvironmentId" : "The ID of the environment",
"DeploymentStrategyId": "The ID of the deployment strategy that was deployed",
"ConfigurationProfileId": "The ID of the configuration profile that was deployed",
"DeploymentNumber": The sequence number of the deployment,
"ConfigurationName": "The name of the configuration",
"ConfigurationLocationUri": "Information about the source location of the configuration",
"ConfigurationVersion": "The configuration version that was deployed",
"Description": "The description of the deployment",
"DeploymentDurationInMinutes": Total amount of time the deployment lasted,
"GrowthType": "The linear or exponential algorithm used to define how percentage grew over time",
"GrowthFactor": The percentage of targets to receive a deployed configuration during each interval,
"FinalBakeTimeInMinutes": Time AWS AppConfig monitored for alarms before considering the deployment to be complete,
"State": "The state of the deployment",
"EventLog": [
{
"Description": "A description of the deployment event",
"EventType": "The type of deployment event",
"OccurredAt": The date and time the event occurred,
"TriggeredBy": "The entity that triggered the deployment event"
}
],
"PercentageComplete": The percentage of targets for which the deployment is available,
"StartedAt": The time the deployment started,
"CompletedAt": The time the deployment completed
}
```
------
#### [ PowerShell ]
```
ApplicationId : The ID of the application that was deployed
CompletedAt : The time the deployment completed
ConfigurationLocationUri : Information about the source location of the configuration
ConfigurationName : The name of the configuration
ConfigurationProfileId : The ID of the configuration profile that was deployed
ConfigurationVersion : The configuration version that was deployed
ContentLength : Runtime of the deployment
DeploymentDurationInMinutes : Total amount of time the deployment lasted
DeploymentNumber : The sequence number of the deployment
DeploymentStrategyId : The ID of the deployment strategy that was deployed
Description : The description of the deployment
EnvironmentId : The ID of the environment that was deployed
EventLog : {Description : A description of the deployment event, EventType : The type of deployment event, OccurredAt : The date and time the event occurred,
TriggeredBy : The entity that triggered the deployment event}
FinalBakeTimeInMinutes : Time AWS AppConfig monitored for alarms before considering the deployment to be complete
GrowthFactor : The percentage of targets to receive a deployed configuration during each interval
GrowthType : The linear or exponential algorithm used to define how percentage grew over time
HttpStatusCode : HTTP Status of the runtime
PercentageComplete : The percentage of targets for which the deployment is available
ResponseMetadata : Runtime Metadata
StartedAt : The time the deployment started
State : The state of the deployment
```
------
# Menerapkan AWS AppConfig konfigurasi menggunakan CodePipeline
AWS AppConfig adalah tindakan penerapan terintegrasi untuk AWS CodePipeline (CodePipeline). CodePipeline adalah layanan pengiriman berkelanjutan yang dikelola sepenuhnya yang membantu Anda mengotomatiskan saluran pipa rilis Anda untuk pembaruan aplikasi dan infrastruktur yang cepat dan andal. CodePipeline mengotomatiskan fase build, test, dan deploy dari proses rilis Anda setiap kali ada perubahan kode, berdasarkan model rilis yang Anda tentukan. Untuk informasi selengkapnya, lihat [Apa itu AWS CodePipeline?](https://docs.aws.amazon.com/codepipeline/latest/userguide/welcome.html)
Integrasi AWS AppConfig dengan CodePipeline menawarkan manfaat berikut:
+ Pelanggan yang menggunakan CodePipeline untuk mengelola orkestrasi sekarang memiliki cara yang ringan untuk menerapkan perubahan konfigurasi ke aplikasi mereka tanpa harus menyebarkan seluruh basis kode mereka.
+ Pelanggan yang ingin menggunakan AWS AppConfig untuk mengelola penerapan konfigurasi tetapi terbatas karena AWS AppConfig tidak mendukung kode atau penyimpanan konfigurasi mereka saat ini, sekarang memiliki opsi tambahan. CodePipeline mendukung AWS CodeCommit, GitHub, dan BitBucket (untuk beberapa nama).
**catatan**
AWS AppConfig integrasi dengan CodePipeline hanya didukung di Wilayah AWS tempat CodePipeline yang [tersedia](https://aws.amazon.com/about-aws/global-infrastructure/regional-product-services/).
## Bagaimana integrasi bekerja
Anda mulai dengan mengatur dan mengonfigurasi. CodePipeline Ini termasuk menambahkan konfigurasi Anda ke penyimpanan kode CodePipeline yang didukung. Selanjutnya, Anda mengatur AWS AppConfig lingkungan Anda dengan melakukan tugas-tugas berikut:
+ [Buat namespace dan profil konfigurasi](https://docs.aws.amazon.com/appconfig/latest/userguide/creating-feature-flags-and-configuration-data.html)
+ [Pilih strategi penerapan yang telah ditentukan sebelumnya atau buat sendiri](https://docs.aws.amazon.com/appconfig/latest/userguide/appconfig-creating-deployment-strategy.html)
Setelah menyelesaikan tugas ini, Anda membuat pipeline CodePipeline yang menentukan AWS AppConfig sebagai penyedia *penerapan*. Anda kemudian dapat membuat perubahan pada konfigurasi Anda dan mengunggahnya ke toko CodePipeline kode Anda. Mengunggah konfigurasi baru secara otomatis memulai penerapan baru di. CodePipeline Setelah penerapan selesai, Anda dapat memverifikasi perubahan Anda. *Untuk informasi tentang membuat pipeline yang ditetapkan AWS AppConfig sebagai penyedia penerapan, lihat [Tutorial: Membuat Pipeline yang Digunakan AWS AppConfig sebagai Penyedia Deployment di Panduan](https://docs.aws.amazon.com/codepipeline/latest/userguide/tutorials-AppConfig.html) Pengguna.AWS CodePipeline *
# Mengembalikan konfigurasi
Selama penerapan, Anda dapat mengurangi situasi di mana data konfigurasi yang salah atau salah menyebabkan kesalahan dalam aplikasi Anda dengan menggunakan rollback otomatis (jika alarm dipicu selama penerapan) atau dengan mengembalikan data konfigurasi ke versi sebelumnya (jika penerapan berhasil diselesaikan).
Untuk rollback otomatis, Anda dapat menggunakan kombinasi strategi AWS AppConfig [penyebaran dan alarm](https://docs.aws.amazon.com/appconfig/latest/userguide/appconfig-creating-deployment-strategy.html) Amazon. CloudWatch Setelah dikonfigurasi, jika satu atau beberapa CloudWatch alarm masuk ke `ALARM` status selama penerapan, AWS AppConfig secara otomatis memutar kembali data konfigurasi Anda ke versi sebelumnya, sehingga mencegah pemadaman aplikasi atau kesalahan. Untuk memulai, lihat [Konfigurasikan izin untuk rollback otomatis](setting-up-appconfig.md#getting-started-with-appconfig-cloudwatch-alarms-permissions).
**catatan**
Anda juga dapat memutar kembali konfigurasi dengan memanggil operasi [StopDeployment](https://docs.aws.amazon.com/appconfig/2019-10-09/APIReference/API_StopDeployment.html)API saat penerapan masih berlangsung.
Untuk penerapan yang berhasil diselesaikan, AWS AppConfig juga mendukung pengembalian data konfigurasi ke versi sebelumnya dengan menggunakan `AllowRevert` parameter dengan operasi API. [StopDeployment](https://docs.aws.amazon.com/appconfig/2019-10-09/APIReference/API_StopDeployment.html) Untuk beberapa pelanggan, kembali ke konfigurasi sebelumnya setelah penerapan yang berhasil menjamin data akan sama seperti sebelum penerapan. Mengembalikan juga mengabaikan monitor alarm, yang dapat mencegah kemajuan maju selama keadaan darurat aplikasi.
**penting**
Jika Anda memanggil `StopDeployment` dengan `AllowRevert` parameter diaktifkan, AWS AppConfig akan mengembalikan penerapan hanya jika penerapan berhasil dalam 72 jam terakhir. Setelah 72 jam, penyebaran tidak dapat lagi dikembalikan. Anda harus membuat penerapan baru.
Berikut adalah rincian `StopDeployment` fungsionalitas berdasarkan situasi yang berbeda.
1. Jika `StopDeployment` dipanggil pada penerapan yang sedang berlangsung, status penerapan yang dihasilkan akan menjadi. `ROLLED_BACK`
1. Jika `StopDeployment` (with`AllowRevert`) dipanggil pada penerapan yang sedang berlangsung, status penerapan yang dihasilkan akan menjadi. `ROLLED_BACK`
1. Jika `StopDeployment` dipanggil pada penerapan yang selesai, a `BadRequestException` akan dilemparkan.
1. Jika `StopDeployment` (with`AllowRevert`) dipanggil pada penerapan yang selesai, status penerapan yang dihasilkan akan menjadi. `REVERTED`
1. Jika `StopDeployment` (with`AllowRevert`) dipanggil pada penerapan selesai setelah 72 jam, a `BadRequestException` akan dilemparkan.
Anda dapat menggunakan AWS CLI untuk memanggil [StopDeployment](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/appconfig/stop-deployment.html)operasi dengan `AllowRevert` parameter. Berikut adalah contoh AWS CLI perintah yang menyertakan `AllowRevert` parameter.
```
aws appconfig stop-deployment \
--application-id 339ohji \
--environment-id 54j1r29 \
--deployment-number 2 \
--allow-revert
```