

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

# Bekerja dengan distribusi pementasan dan kebijakan penyebaran berkelanjutan
<a name="working-with-staging-distribution-continuous-deployment-policy"></a>

Anda dapat membuat, memperbarui, dan memodifikasi distribusi pementasan dan kebijakan penerapan berkelanjutan di CloudFront konsol, dengan AWS Command Line Interface (AWS CLI), atau dengan API. CloudFront 

## Membuat distribusi pementasan dengan kebijakan penerapan berkelanjutan
<a name="create-staging-distribution-continuous-deployment-policy"></a>

Prosedur berikut menunjukkan cara membuat distribusi pementasan dengan kebijakan penerapan berkelanjutan.

------
#### [ Console ]

Anda dapat membuat distribusi pementasan dengan kebijakan penerapan berkelanjutan dengan menggunakan. Konsol Manajemen AWS

**Untuk membuat distribusi pementasan dan kebijakan penerapan berkelanjutan (konsol)**

1. Masuk ke Konsol Manajemen AWS dan buka CloudFront konsol di[https://console.aws.amazon.com/cloudfront/v4/home](https://console.aws.amazon.com/cloudfront/v4/home).

1. Di panel navigasi, pilih **Distribusi**.

1. Pilih distribusi yang ingin Anda gunakan sebagai *distribusi utama*. Distribusi utama adalah distribusi yang saat ini melayani lalu lintas produksi, yang darinya Anda akan membuat distribusi pementasan.

1. Di bagian **Continuous deployment**, pilih **Create staging distribution**. Ini membuka wizard **distribusi pementasan Buat**.

1. Di wizard **Create staging distribution**, lakukan hal berikut:

   1. (Opsional) Ketik deskripsi untuk distribusi pementasan.

   1. Pilih **Berikutnya**.

   1. Ubah konfigurasi distribusi pementasan. Untuk informasi selengkapnya tentang pengaturan yang dapat Anda perbarui, lihat[Perbarui distribusi primer dan pementasan](understanding-continuous-deployment.md#updating-staging-and-primary-distributions).

      **Setelah Anda selesai memodifikasi konfigurasi distribusi pementasan, pilih Berikutnya.**

   1. Gunakan konsol untuk menentukan **konfigurasi Lalu Lintas**. Ini menentukan bagaimana CloudFront rute lalu lintas ke distribusi pementasan. (CloudFront menyimpan konfigurasi lalu lintas dalam *kebijakan penerapan berkelanjutan*.)

      Untuk informasi selengkapnya tentang opsi dalam **konfigurasi Lalu Lintas**, lihat[Permintaan rute ke distribusi pementasan](understanding-continuous-deployment.md#understanding-continuous-deployment-routing).

      Setelah Anda selesai dengan **konfigurasi Lalu Lintas**, pilih **Berikutnya**.

   1. Tinjau konfigurasi untuk distribusi pementasan, termasuk konfigurasi lalu lintas, lalu pilih **Buat distribusi pementasan**.

Saat Anda menyelesaikan wizard **distribusi pementasan Buat** di CloudFront konsol, CloudFront lakukan hal berikut:
+ Membuat distribusi pementasan dengan pengaturan yang Anda tentukan (pada langkah 5c)
+ Membuat kebijakan penerapan berkelanjutan dengan konfigurasi lalu lintas yang Anda tentukan (pada langkah 5d)
+ Melampirkan kebijakan penerapan berkelanjutan ke distribusi utama tempat Anda membuat distribusi pementasan

Ketika konfigurasi distribusi utama, dengan kebijakan penerapan berkelanjutan terlampir, disebarkan ke lokasi tepi, CloudFront mulai mengirimkan bagian lalu lintas yang ditentukan ke distribusi pementasan berdasarkan konfigurasi lalu lintas.

------
#### [ CLI ]

Untuk membuat distribusi pementasan dan kebijakan penyebaran berkelanjutan dengan AWS CLI, gunakan prosedur berikut.

**Untuk membuat distribusi pementasan (CLI)**

1. Gunakan **grep** perintah **aws cloudfront get-distribution** dan bersama-sama untuk mendapatkan `ETag` nilai distribusi yang ingin Anda gunakan sebagai *distribusi utama*. Distribusi utama adalah salah satu yang saat ini melayani lalu lintas produksi, dari mana Anda akan membuat distribusi pementasan.

   Perintah berikut menunjukkan sebuah contoh. Dalam contoh berikut, ganti {{primary\_distribution\_ID}} dengan ID distribusi primer. 

   ```
   aws cloudfront get-distribution --id {{primary_distribution_ID}} | grep 'ETag'
   ```

   Salin `ETag` nilainya karena Anda membutuhkannya untuk langkah berikut.

1. Gunakan **aws cloudfront copy-distribution** perintah untuk membuat distribusi pementasan. Contoh perintah berikut menggunakan karakter escape (\\) dan jeda baris untuk keterbacaan, tetapi Anda harus menghilangkan ini dari perintah. Dalam contoh perintah berikut:
   + Ganti {{primary\_distribution\_ID}} dengan ID distribusi primer.
   + Ganti {{primary\_distribution\_ETag}} dengan `ETag` nilai distribusi primer (yang Anda dapatkan di langkah sebelumnya).
   + (Opsional) Ganti {{CLI\_example}} dengan ID referensi penelepon yang diinginkan.

   ```
   aws cloudfront copy-distribution --primary-distribution-id {{primary_distribution_ID}} \
                                    --if-match {{primary_distribution_ETag}} \
                                    --staging \
                                    --caller-reference '{{CLI_example}}'
   ```

   Output perintah menunjukkan informasi tentang distribusi pementasan dan konfigurasinya. Salin nama CloudFront domain distribusi pementasan karena Anda membutuhkannya untuk langkah berikut.

**Untuk membuat kebijakan penerapan berkelanjutan (CLI dengan file input)**

1. Gunakan perintah berikut untuk membuat file bernama `continuous-deployment-policy.yaml` yang berisi semua parameter input untuk **create-continuous-deployment-policy** perintah. Perintah berikut menggunakan karakter escape (\\) dan jeda baris untuk keterbacaan, tetapi Anda harus menghilangkan ini dari perintah.

   ```
   aws cloudfront create-continuous-deployment-policy --generate-cli-skeleton yaml-input \
                                                      > continuous-deployment-policy.yaml
   ```

1. Buka file dengan nama `continuous-deployment-policy.yaml` yang baru Anda buat. Edit file untuk menentukan pengaturan kebijakan penerapan berkelanjutan yang Anda inginkan, lalu simpan file tersebut. Saat Anda mengedit file:
   + Di `StagingDistributionDnsNames` bagian:
     + Ubah nilai `Quantity` ke`1`.
     + Untuk`Items`, tempel nama CloudFront domain dari distribusi pementasan (yang Anda simpan dari langkah sebelumnya).
   + Di `TrafficConfig` bagian:
     + Pilih`Type`, salah satu `SingleWeight` atau`SingleHeader`.
     + Hapus pengaturan untuk jenis lainnya. Misalnya, jika Anda menginginkan konfigurasi lalu lintas berbasis berat, atur `Type` ke lalu hapus `SingleWeight` pengaturannya`SingleHeaderConfig`.
     + Untuk menggunakan konfigurasi lalu lintas berbasis berat, tetapkan nilai `Weight` ke angka desimal antara `.01` (satu persen) dan `.15` (lima belas persen).

     Untuk informasi selengkapnya tentang opsi di`TrafficConfig`, lihat [Permintaan rute ke distribusi pementasan](understanding-continuous-deployment.md#understanding-continuous-deployment-routing) dan[Sesi lengket untuk konfigurasi berbasis berat](understanding-continuous-deployment.md#understanding-continuous-deployment-sessions).

1. Gunakan perintah berikut untuk membuat kebijakan penerapan berkelanjutan menggunakan parameter input dari `continuous-deployment-policy.yaml` file.

   ```
   aws cloudfront create-continuous-deployment-policy --cli-input-yaml file://continuous-deployment-policy.yaml
   ```

   Salin `Id` nilai dalam output perintah. Ini adalah ID kebijakan penerapan berkelanjutan, dan Anda memerlukannya dalam langkah berikut.

**Untuk melampirkan kebijakan penerapan berkelanjutan ke distribusi utama (CLI dengan file input)**

1. Gunakan perintah berikut untuk menyimpan konfigurasi distribusi utama ke file bernama`primary-distribution.yaml`. Ganti {{primary\_distribution\_ID}} dengan ID distribusi utama.

   ```
   aws cloudfront get-distribution-config --id {{primary_distribution_ID}} --output yaml > primary-distribution.yaml
   ```

1. Buka file dengan nama `primary-distribution.yaml` yang baru saja Anda buat. Edit file akan membuat perubahan berikut:
   + Rekatkan ID kebijakan penerapan berkelanjutan (yang Anda salin dari langkah sebelumnya) ke dalam bidang. `ContinuousDeploymentPolicyId`
   + Ubah nama `ETag` bidang menjadi`IfMatch`, tetapi jangan ubah nilai bidang.

   Simpan file setelah selesai.

1. Gunakan perintah berikut untuk memperbarui distribusi utama agar menggunakan kebijakan penerapan berkelanjutan. Ganti {{primary\_distribution\_ID}} dengan ID distribusi utama.

   ```
   aws cloudfront update-distribution --id {{primary_distribution_ID}} --cli-input-yaml file://primary-distribution.yaml
   ```

Ketika konfigurasi distribusi utama, dengan kebijakan penerapan berkelanjutan terlampir, disebarkan ke lokasi tepi, CloudFront mulai mengirimkan bagian lalu lintas yang ditentukan ke distribusi pementasan berdasarkan konfigurasi lalu lintas.

------
#### [ API ]

Untuk membuat distribusi pementasan dan kebijakan penerapan berkelanjutan dengan CloudFront API, gunakan operasi API berikut:
+ [CopyDistribution](https://docs.aws.amazon.com/cloudfront/latest/APIReference/API_CopyDistribution.html)
+ [CreateContinuousDeploymentPolicy](https://docs.aws.amazon.com/cloudfront/latest/APIReference/API_CreateContinuousDeploymentPolicy.html)

Untuk informasi selengkapnya tentang bidang yang Anda tentukan dalam panggilan API ini, lihat berikut ini:
+ [Permintaan rute ke distribusi pementasan](understanding-continuous-deployment.md#understanding-continuous-deployment-routing)
+ [Sesi lengket untuk konfigurasi berbasis berat](understanding-continuous-deployment.md#understanding-continuous-deployment-sessions)
+ Dokumentasi referensi API untuk AWS SDK Anda atau klien API lainnya

Setelah Anda membuat distribusi pementasan dan kebijakan penerapan berkelanjutan, gunakan [UpdateDistribution](https://docs.aws.amazon.com/cloudfront/latest/APIReference/API_UpdateDistribution.html)(pada distribusi utama) untuk melampirkan kebijakan penerapan berkelanjutan ke distribusi utama.

------

## Perbarui distribusi pementasan
<a name="update-staging-distribution"></a>

Prosedur berikut menunjukkan cara memperbarui distribusi pementasan dengan kebijakan penerapan berkelanjutan.

------
#### [ Console ]

Anda dapat memperbarui konfigurasi tertentu untuk distribusi primer dan pementasan. Untuk informasi selengkapnya, lihat [Perbarui distribusi primer dan pementasan](understanding-continuous-deployment.md#updating-staging-and-primary-distributions).

**Untuk memperbarui distribusi pementasan (konsol)**

1. Buka CloudFront konsol di[https://console.aws.amazon.com/cloudfront/v4/home](https://console.aws.amazon.com/cloudfront/v4/home).

1. Di panel navigasi, pilih **Distribusi**.

1. Pilih distribusi utama. Ini adalah distribusi yang saat ini melayani lalu lintas produksi, yang darinya Anda membuat distribusi pementasan.

1. Pilih **Lihat distribusi pementasan**.

1. Gunakan konsol untuk memodifikasi konfigurasi distribusi pementasan. Untuk informasi selengkapnya tentang pengaturan yang dapat Anda perbarui, lihat[Perbarui distribusi primer dan pementasan](understanding-continuous-deployment.md#updating-staging-and-primary-distributions).

Segera setelah konfigurasi distribusi pementasan diterapkan ke lokasi tepi, itu berlaku untuk lalu lintas masuk yang diarahkan ke distribusi pementasan.

------
#### [ CLI ]

**Untuk memperbarui distribusi pementasan (CLI dengan file input)**

1. Gunakan perintah berikut untuk menyimpan konfigurasi distribusi pementasan ke file bernama`staging-distribution.yaml`. Ganti {{staging\_distribution\_ID}} dengan ID distribusi pementasan.

   ```
   aws cloudfront get-distribution-config --id {{staging_distribution_ID}} --output yaml > staging-distribution.yaml
   ```

1. Buka file dengan nama `staging-distribution.yaml` yang baru saja Anda buat. Edit file akan membuat perubahan berikut:
   + Ubah konfigurasi distribusi pementasan. Untuk informasi selengkapnya tentang pengaturan yang dapat Anda perbarui, lihat[Perbarui distribusi primer dan pementasan](understanding-continuous-deployment.md#updating-staging-and-primary-distributions).
   + Ubah nama `ETag` bidang menjadi`IfMatch`, tetapi jangan ubah nilai bidang.

   Simpan file setelah selesai.

1. Gunakan perintah berikut untuk memperbarui konfigurasi distribusi pementasan. Ganti {{staging\_distribution\_ID}} dengan ID distribusi pementasan.

   ```
   aws cloudfront update-distribution --id {{staging_distribution_ID}} --cli-input-yaml file://staging-distribution.yaml
   ```

Segera setelah konfigurasi distribusi pementasan diterapkan ke lokasi tepi, itu berlaku untuk lalu lintas masuk yang diarahkan ke distribusi pementasan.

------
#### [ API ]

Untuk memperbarui konfigurasi distribusi pementasan, gunakan [UpdateDistribution](https://docs.aws.amazon.com/cloudfront/latest/APIReference/API_UpdateDistribution.html)(pada distribusi pementasan) untuk memodifikasi konfigurasi distribusi pementasan. Untuk informasi selengkapnya tentang pengaturan yang dapat Anda perbarui, lihat[Perbarui distribusi primer dan pementasan](understanding-continuous-deployment.md#updating-staging-and-primary-distributions).

------

## Memperbarui kebijakan penerapan berkelanjutan
<a name="update-continuous-deployment-policy"></a>

Prosedur berikut menunjukkan cara memperbarui kebijakan penerapan berkelanjutan.

------
#### [ Console ]

Anda dapat memperbarui konfigurasi lalu lintas distribusi dengan memperbarui kebijakan penerapan berkelanjutan.

**Untuk memperbarui kebijakan penerapan berkelanjutan (konsol)**

1. Buka CloudFront konsol di[https://console.aws.amazon.com/cloudfront/v4/home](https://console.aws.amazon.com/cloudfront/v4/home).

1. Di panel navigasi, pilih **Distribusi**.

1. Pilih distribusi utama. Ini adalah distribusi yang saat ini melayani lalu lintas produksi, yang darinya Anda membuat distribusi pementasan.

1. Di bagian **Penerapan berkelanjutan**, pilih **Edit kebijakan**.

1. Ubah konfigurasi lalu lintas dalam kebijakan penerapan berkelanjutan. Setelah selesai, pilih **Simpan perubahan**.

Ketika konfigurasi distribusi utama dengan kebijakan penerapan berkelanjutan yang diperbarui diterapkan ke lokasi tepi, CloudFront mulai mengirimkan lalu lintas ke distribusi pementasan berdasarkan konfigurasi lalu lintas yang diperbarui.

------
#### [ CLI ]

**Untuk memperbarui kebijakan penerapan berkelanjutan (CLI dengan file input)**

1. Gunakan perintah berikut untuk menyimpan konfigurasi kebijakan penerapan berkelanjutan ke file bernama`continuous-deployment-policy.yaml`. Ganti {{continuous\_deployment\_policy\_ID}} dengan ID kebijakan penerapan berkelanjutan. Perintah berikut menggunakan karakter escape (\\) dan jeda baris untuk keterbacaan, tetapi Anda harus menghilangkan ini dari perintah.

   ```
   aws cloudfront get-continuous-deployment-policy-config --id {{continuous_deployment_policy_ID}} \
                                                          --output yaml > continuous-deployment-policy.yaml
   ```

1. Buka file dengan nama `continuous-deployment-policy.yaml` yang baru saja Anda buat. Edit file akan membuat perubahan berikut:
   + Ubah konfigurasi kebijakan penerapan berkelanjutan sesuai keinginan. Misalnya, Anda dapat mengubah dari menggunakan konfigurasi lalu lintas berbasis header ke berbasis berat, atau Anda dapat mengubah persentase lalu lintas (bobot) untuk konfigurasi berbasis berat. Untuk informasi selengkapnya, lihat [Permintaan rute ke distribusi pementasan](understanding-continuous-deployment.md#understanding-continuous-deployment-routing) dan [Sesi lengket untuk konfigurasi berbasis berat](understanding-continuous-deployment.md#understanding-continuous-deployment-sessions).
   + Ubah nama `ETag` bidang menjadi`IfMatch`, tetapi jangan ubah nilai bidang.

   Simpan file setelah selesai.

1. Gunakan perintah berikut untuk memperbarui kebijakan penerapan berkelanjutan. Ganti {{continuous\_deployment\_policy\_ID}} dengan ID kebijakan penerapan berkelanjutan. Perintah berikut menggunakan karakter escape (\\) dan jeda baris untuk keterbacaan, tetapi Anda harus menghilangkan ini dari perintah.

   ```
   aws cloudfront update-continuous-deployment-policy --id {{continuous_deployment_policy_ID}} \
                                                      --cli-input-yaml file://continuous-deployment-policy.yaml
   ```

Ketika konfigurasi distribusi utama dengan kebijakan penerapan berkelanjutan yang diperbarui diterapkan ke lokasi tepi, CloudFront mulai mengirimkan lalu lintas ke distribusi pementasan berdasarkan konfigurasi lalu lintas yang diperbarui.

------
#### [ API ]

Untuk memperbarui kebijakan penerapan berkelanjutan, gunakan [UpdateContinuousDeploymentPolicy](https://docs.aws.amazon.com/cloudfront/latest/APIReference/API_UpdateContinuousDeploymentPolicy.html).

------

## Promosikan konfigurasi distribusi pementasan
<a name="promote-staging-distribution-configuration"></a>

Prosedur berikut menunjukkan cara mempromosikan konfigurasi distribusi pementasan.

------
#### [ Console ]

Saat Anda *mempromosikan* distribusi pementasan, CloudFront salin konfigurasi dari distribusi pementasan ke distribusi utama. CloudFront juga menonaktifkan kebijakan penyebaran berkelanjutan dan merutekan semua lalu lintas ke distribusi utama.

Setelah Anda mempromosikan konfigurasi, Anda dapat menggunakan kembali distribusi pementasan yang sama saat berikutnya Anda ingin menguji perubahan konfigurasi.

**Untuk mempromosikan konfigurasi distribusi pementasan (konsol)**

1. Buka CloudFront konsol di[https://console.aws.amazon.com/cloudfront/v4/home](https://console.aws.amazon.com/cloudfront/v4/home).

1. Di panel navigasi, pilih **Distribusi**.

1. Pilih distribusi utama. Ini adalah distribusi yang saat ini melayani lalu lintas produksi, yang darinya Anda membuat distribusi pementasan.

1. Di bagian **Penerapan berkelanjutan**, pilih **Promosikan**.

1. Ketik **confirm** dan kemudian pilih **Promosikan**.

------
#### [ CLI ]

Saat Anda *mempromosikan* distribusi pementasan, CloudFront salin konfigurasi dari distribusi pementasan ke distribusi utama. CloudFront juga menonaktifkan kebijakan penyebaran berkelanjutan dan merutekan semua lalu lintas ke distribusi utama.

Setelah Anda mempromosikan konfigurasi, Anda dapat menggunakan kembali distribusi pementasan yang sama saat berikutnya Anda ingin menguji perubahan konfigurasi.

**Untuk mempromosikan konfigurasi distribusi pementasan (CLI)**
+ Gunakan **aws cloudfront update-distribution-with-staging-config** perintah untuk mempromosikan konfigurasi distribusi pementasan ke distribusi utama. Contoh perintah berikut menggunakan karakter escape (\\) dan jeda baris untuk keterbacaan, tetapi Anda harus menghilangkan ini dari perintah. Dalam contoh perintah berikut:
  + Ganti {{primary\_distribution\_ID}} dengan ID distribusi primer.
  + Ganti {{staging\_distribution\_ID}} dengan ID distribusi pementasan.
  + Ganti {{primary\_distribution\_ETag}} dan {{staging\_distribution\_ETag}} dengan `ETag` nilai-nilai distribusi primer dan pementasan. Pastikan nilai distribusi primer adalah yang pertama, seperti yang ditunjukkan pada contoh.

  ```
  aws cloudfront update-distribution-with-staging-config --id {{primary_distribution_ID}} \
                                                         --staging-distribution-id {{staging_distribution_ID}} \
                                                         --if-match '{{primary_distribution_ETag}},{{staging_distribution_ETag}}'
  ```

------
#### [ API ]

Untuk mempromosikan konfigurasi distribusi pementasan ke distribusi utama, gunakan [UpdateDistributionWithStagingConfig](https://docs.aws.amazon.com/cloudfront/latest/APIReference/API_UpdateDistributionWithStagingConfig.html).

------