

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

# Tutorial: Buat pipeline yang digunakan AWS AppConfig sebagai penyedia penyebaran
<a name="tutorials-AppConfig"></a>

Dalam tutorial ini, Anda mengonfigurasi pipeline yang terus-menerus mengirimkan file konfigurasi menggunakan AWS AppConfig sebagai penyedia tindakan penerapan di tahap penerapan Anda.

**penting**  
Sebagai bagian dari pembuatan pipa, ember artefak S3 yang disediakan oleh pelanggan akan digunakan CodePipeline untuk artefak. (Ini berbeda dari bucket yang digunakan untuk aksi sumber S3.) Jika bucket artefak S3 berada di akun yang berbeda dari akun untuk pipeline Anda, pastikan bucket artefak S3 dimiliki oleh Akun AWS yang aman dan dapat diandalkan.

**Topics**
+ [Prasyarat](#tutorials-AppConfig-prereq)
+ [Langkah 1: Buat AWS AppConfig sumber daya Anda](#tutorials-AppConfig-application)
+ [Langkah 2: Unggah file ke bucket sumber S3 Anda](#tutorials-AppConfig-bucket)
+ [Langkah 3: Buat pipeline Anda](#tutorials-AppConfig-pipeline)
+ [Langkah 4: Buat perubahan pada file sumber apa pun dan verifikasi penyebaran](#tutorials-AppConfig-verify)

## Prasyarat
<a name="tutorials-AppConfig-prereq"></a>

Sebelum Anda mulai, Anda harus menyelesaikan yang berikut:
+ Contoh ini menggunakan sumber S3 untuk pipeline Anda. Buat atau gunakan bucket Amazon S3 dengan versi diaktifkan. Ikuti instruksi [Langkah 1: Buat bucket sumber S3 untuk aplikasi Anda](tutorials-simple-s3.md#s3-create-s3-bucket) untuk membuat ember S3.

## Langkah 1: Buat AWS AppConfig sumber daya Anda
<a name="tutorials-AppConfig-application"></a>

Di bagian ini, Anda membuat sumber daya berikut:
+ *Aplikasi* dalam AWS AppConfig adalah unit kode logis yang menyediakan kemampuan untuk pelanggan Anda.
+ *Environment* in AWS AppConfig adalah kelompok AppConfig target penyebaran logis, seperti aplikasi dalam lingkungan beta atau produksi.
+ *Profil konfigurasi* adalah kumpulan pengaturan yang memengaruhi perilaku aplikasi Anda. Profil konfigurasi memungkinkan AWS AppConfig untuk mengakses konfigurasi Anda di lokasi yang disimpan.
+ (Opsional) *Strategi penerapan* dalam AWS AppConfig mendefinisikan perilaku penerapan konfigurasi, seperti berapa persentase klien yang harus menerima konfigurasi baru yang diterapkan pada waktu tertentu selama penerapan.

**Untuk membuat aplikasi, lingkungan, profil konfigurasi, dan strategi penyebaran**

1. Masuk ke Konsol Manajemen AWS.

1. Gunakan langkah-langkah dalam topik berikut untuk membuat sumber daya Anda AWS AppConfig.
   + [Buat aplikasi](https://docs.aws.amazon.com/systems-manager/latest/userguide/appconfig-creating-application.html).
   + [Buat lingkungan](https://docs.aws.amazon.com/systems-manager/latest/userguide/appconfig-creating-environment.html).
   + [Buat profil AWS CodePipeline konfigurasi](https://docs.aws.amazon.com/systems-manager/latest/userguide/appconfig-creating-configuration-and-profile.html).
   + (Opsional) [Pilih strategi penerapan yang telah ditentukan sebelumnya atau buat sendiri](https://docs.aws.amazon.com/systems-manager/latest/userguide/appconfig-creating-deployment-strategy.html).

## Langkah 2: Unggah file ke bucket sumber S3 Anda
<a name="tutorials-AppConfig-bucket"></a>

Di bagian ini, buat file atau file konfigurasi Anda. Kemudian zip dan dorong file sumber Anda ke bucket yang digunakan pipeline untuk tahap sumber Anda.

**Untuk membuat file konfigurasi**

1. Buat `configuration.json` file untuk setiap konfigurasi di setiap Wilayah. Sertakan konten berikut:

   ```
   Hello World!
   ```

1. Gunakan langkah-langkah berikut untuk zip dan mengunggah file konfigurasi Anda.

**Untuk zip dan mengunggah file sumber**

1. Buat file.zip dengan file Anda dan beri nama file.zip. `configuration-files.zip` Sebagai contoh, file.zip Anda dapat menggunakan struktur berikut:

   ```
   .
   └── appconfig-configurations
       └── MyConfigurations
           ├── us-east-1
           │   └── configuration.json
           └── us-west-2
               └── configuration.json
   ```

1. Di konsol Amazon S3 untuk bucket Anda, pilih **Unggah**, dan ikuti petunjuk untuk mengunggah file.zip Anda.

## Langkah 3: Buat pipeline Anda
<a name="tutorials-AppConfig-pipeline"></a>

Dalam bagian ini, Anda membuat alur dengan tindakan berikut:
+ Tahap sumber dengan aksi Amazon S3 di mana artefak sumber adalah file untuk konfigurasi Anda.
+ Tahap penyebaran dengan tindakan AppConfig penerapan.

**Untuk membuat alur dengan wizard**

1. Masuk ke Konsol Manajemen AWS dan buka CodePipeline konsol di [http://console.aws.amazon. com/codesuite/codepipeline/home](https://console.aws.amazon.com/codesuite/codepipeline/home).

1. Pada halaman **Selamat Datang**, halaman **Memulai**, atau halaman **Pipelines**, pilih **Buat pipeline**.

1. Pada **Langkah 1: Pilih halaman opsi pembuatan**, di bawah **Opsi pembuatan**, pilih opsi **Build custom pipeline**. Pilih **Berikutnya**.

1. Pada **Langkah 2: Pilih pengaturan pipeline**, dalam **nama Pipeline**, masukkan**MyAppConfigPipeline**.

1. CodePipeline menyediakan pipa tipe V1 dan V2, yang berbeda dalam karakteristik dan harga. Jenis V2 adalah satu-satunya jenis yang dapat Anda pilih di konsol. Untuk informasi selengkapnya, lihat [jenis pipa](https://docs.aws.amazon.com/codepipeline/latest/userguide/pipeline-types-planning.html?icmpid=docs_acp_help_panel). Untuk informasi tentang harga CodePipeline, lihat [Harga](https://aws.amazon.com/codepipeline/pricing/).

1. Dalam **peran Layanan**, pilih **Peran layanan baru** CodePipeline untuk memungkinkan membuat peran layanan di IAM.

1. **Biarkan pengaturan di bawah **Pengaturan lanjutan** pada defaultnya, lalu pilih Berikutnya.**

1. Pada **Langkah 3: Tambahkan tahap sumber**, di **penyedia Sumber**, pilih **Amazon S3**. Di **Bucket**, pilih nama bucket sumber S3 Anda. 

   Di **tombol objek S3**, masukkan nama file.zip Anda:. `configuration-files.zip`

   Pilih **Berikutnya**.

1. Pada **Langkah 4: Tambahkan tahap build**, pilih **Lewati tahap build**, lalu terima pesan peringatan dengan memilih **Lewati** lagi. 

   Pilih **Berikutnya**.

1. Pada **Langkah 5: Tambahkan tahap pengujian**, pilih **Lewati tahap pengujian**, lalu terima pesan peringatan dengan memilih **Lewati** lagi. 

   Pilih **Berikutnya**.

1. Pada **Langkah 6: Tambahkan tahap penerapan**:

   1. Di **Penyedia Deploy**, pilih **AWS AppConfig**. 

   1. Di **Aplikasi**, pilih nama aplikasi yang Anda buat AWS AppConfig. Bidang menunjukkan ID untuk aplikasi Anda.

   1. Di **Lingkungan**, pilih nama lingkungan yang Anda buat AWS AppConfig. Bidang menunjukkan ID untuk lingkungan Anda.

   1. Di **Profil konfigurasi**, pilih nama profil konfigurasi yang Anda buat AWS AppConfig. Bidang menunjukkan ID untuk profil konfigurasi Anda.

   1. Dalam **strategi Deployment**, pilih nama strategi penyebaran Anda. Ini bisa berupa strategi penerapan yang Anda buat AppConfig atau yang telah Anda pilih dari strategi penerapan yang telah ditentukan sebelumnya. AppConfig Bidang menunjukkan ID untuk strategi penerapan Anda.

   1. Di **jalur konfigurasi artefak input**, masukkan jalur file. Pastikan jalur konfigurasi artefak masukan Anda cocok dengan struktur direktori dalam file bucket S3. zip Anda. Untuk contoh ini, masukkan path file berikut:`appconfig-configurations/MyConfigurations/us-west-2/configuration.json`. 

   1. Pilih **Berikutnya**.

1. Pada **Langkah 7: Tinjau**, tinjau informasi, lalu pilih **Buat pipeline**.

## Langkah 4: Buat perubahan pada file sumber apa pun dan verifikasi penyebaran
<a name="tutorials-AppConfig-verify"></a>

Buat perubahan pada file sumber Anda dan unggah perubahan ke bucket Anda. Ini memicu pipeline Anda untuk berjalan. Verifikasi bahwa konfigurasi Anda tersedia dengan melihat versinya.