

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

# Menggunakan solusi Blue/Green Neptunus untuk melakukan pembaruan biru-hijau
<a name="neptune-BG-deployments"></a>

Peningkatan mesin Amazon Neptunus dapat memerlukan waktu henti aplikasi karena database tidak tersedia saat pembaruan sedang diinstal dan diverifikasi. Ini benar apakah mereka dimulai secara manual atau otomatis.

Neptunus menyediakan solusi penerapan Blue/Green yang dapat Anda jalankan menggunakan tumpukan dan CloudFormation sangat mengurangi waktu henti tersebut. Ini menciptakan lingkungan pementasan hijau yang disinkronkan dengan lingkungan produksi biru Anda. Anda kemudian dapat memperbarui lingkungan pementasan tersebut untuk melakukan peningkatan versi mesin kecil atau utama, perubahan model data grafik, atau pembaruan sistem operasi, dan menguji hasilnya. Akhirnya, Anda dapat mengubahnya dengan cepat untuk menjadi lingkungan produksi Anda, dengan waktu henti yang sangat sedikit.

Solusi Blue/Green Neptunus melewati dua fase, seperti yang diilustrasikan dalam diagram ini:

![\[Diagram alir tingkat tinggi dari strategi penyebaran biru-hijau\]](http://docs.aws.amazon.com/id_id/neptune/latest/userguide/images/BG-flow.png)


**Fase 1 membuat cluster DB Hijau yang identik dengan cluster produksi Anda**

Solusinya membuat cluster DB dengan pengenal blue/green penerapan unik dan dengan topologi cluster yang sama dengan cluster produksi Anda. Artinya, ia memiliki jumlah dan ukuran instans DB yang sama, grup parameter yang sama dan semua konfigurasi yang sama dengan cluster DB produksi (biru) kecuali bahwa itu telah ditingkatkan ke versi mesin target yang Anda tentukan, yang harus lebih tinggi dari versi mesin (biru) Anda saat ini. Anda dapat menentukan versi mesin minor dan utama untuk target. Jika perlu, solusi akan melakukan upgrade menengah yang diperlukan untuk mencapai versi mesin target yang ditentukan. Cluster baru ini menjadi lingkungan pementasan hijau.

**Tahap 2 mengatur sinkronisasi data berkelanjutan**

Setelah lingkungan hijau sepenuhnya disiapkan, solusinya mengatur replikasi berkelanjutan antara cluster sumber (biru) dan cluster target (hijau) menggunakan aliran Neptunus. Ketika perbedaan replikasi di antara mereka mencapai nol, lingkungan pementasan siap untuk pengujian. Pada saat itu Anda harus menjeda penulisan ke cluster biru untuk menghindari kelambatan replikasi lebih lanjut.

Versi mesin target Anda mungkin memiliki fitur atau dependensi baru yang memengaruhi aplikasi Anda. Periksa halaman rilis mesin target dan halaman rilis mesin intervensi di bawah [Rilis mesin](engine-releases.md) untuk melihat apa yang telah berubah sejak versi mesin Anda saat ini. Yang terbaik adalah menjalankan pengujian integrasi atau memverifikasi aplikasi Anda secara manual di klaster hijau sebelum mempromosikannya ke lingkungan produksi.

Setelah Anda menguji dan memenuhi syarat perubahan di cluster hijau, cukup alihkan titik akhir database dalam aplikasi Anda dari biru ke cluster hijau.

Setelah peralihan, Blue/Green solusi Neptunus tidak menghapus lingkungan produksi biru lama. Anda masih akan memiliki akses ke sana untuk validasi dan pengujian tambahan jika diperlukan. Biaya penagihan standar berlaku untuk instance-nya sampai Anda menghapusnya. Blue/Green Solusinya juga menggunakan AWS layanan lain, biaya yang ditagih dengan harga normal. Detail tentang menghapus solusi ketika Anda selesai dengan itu tercakup di [bagian pembersihan](neptune-BG-cleanup.md).

## Prasyarat untuk menjalankan tumpukan Neptunus Blue/Green
<a name="neptune-BG-prereqs"></a>

Sebelum meluncurkan tumpukan Blue/Green Neptunus:
+ Pastikan untuk [mengaktifkan aliran Neptunus](streams-using.md) di cluster produksi (biru) Anda.
+ Semua instance di cluster biru Anda harus dalam keadaan **tersedia**. Anda dapat memeriksa status instance di konsol [Neptunus](https://console.aws.amazon.com/neptune) atau dengan menggunakan API. [describe-db-instances](https://docs.aws.amazon.com/cli/latest/reference/neptune/describe-db-instances.html)
+ Semua instance juga harus sinkron dengan [grup parameter cluster DB](parameter-groups.md).
+ Solusi Blue/Green Neptunus memerlukan titik akhir DynamoDB VPC di VPC tempat cluster biru Anda berada. Lihat [Menggunakan titik akhir Amazon VPC untuk mengakses](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/network-isolation.html#vpc-endpoints-dynamodb) DynamoDB.
+ Pilih pada waktunya untuk menjalankan solusi ketika beban kerja tulis pada cluster DB produksi biru Anda akan seringan mungkin. Hindari, misalnya, menjalankan solusi ketika beban massal akan terjadi, atau ketika kemungkinan ada sejumlah besar operasi tulis karena alasan lain.

# Menggunakan CloudFormation template untuk menjalankan solusi Neptunus Blue/Green
<a name="neptune-BG-console-cfn"></a>

Anda dapat menggunakan AWS CloudFormation untuk menyebarkan solusi Neptunus Blue/Green . CloudFormationTemplate membuat instans Amazon EC2 di VPC yang sama dengan database Neptunus sumber biru Anda, menginstal solusi di sana, dan menjalankannya. Anda dapat memantau kemajuannya dalam CloudWatch log, seperti yang dijelaskan dalam [Memantau kemajuan](neptune-BG-monitoring.md).

Anda dapat menggunakan tautan ini untuk meninjau template solusi, atau pilih tombol **Launch Stack** untuk meluncurkannya di CloudFormation konsol:


|  |  |  | 
| --- |--- |--- |
| [Lihat](https://aws-neptune-customer-samples-us-east-1.s3.amazonaws.com/neptune-bg/bg.yaml) | [Lihat di Desainer](https://console.aws.amazon.com/cloudformation/designer/home?templateURL=https://aws-neptune-customer-samples-us-east-1.s3.amazonaws.com/neptune-bg/bg.yaml) | [https://console.aws.amazon.com/cloudformation/home?region=us-east-1#/stacks/new?stackName=NeptuneBG&templateURL=https://aws-neptune-customer-samples-us-east-1.s3.amazonaws.com/neptune-bg/bg.yaml](https://console.aws.amazon.com/cloudformation/home?region=us-east-1#/stacks/new?stackName=NeptuneBG&templateURL=https://aws-neptune-customer-samples-us-east-1.s3.amazonaws.com/neptune-bg/bg.yaml)  | 

Di konsol, pilih AWS wilayah tempat Anda ingin menjalankan solusi dari dropdown di kanan atas jendela.

Atur parameter tumpukan sebagai berikut:
+ **`DeploymentID`**— Pengidentifikasi yang unik untuk setiap penyebaran Neptunus Blue/Green .

  Ini digunakan sebagai pengidentifikasi cluster DB hijau, dan sebagai awalan untuk penamaan sumber daya baru yang dibuat selama penerapan.
+ **`NeptuneSourceClusterId`**— Pengidentifikasi cluster DB biru yang ingin Anda tingkatkan.
+ **`NeptuneTargetClusterVersion:`**— Versi [mesin Neptunus](engine-releases.md) yang ingin Anda tingkatkan ke cluster DB biru.

  Ini harus lebih tinggi dari versi mesin cluster DB biru saat ini.
+ **`DeploymentMode`**— Menunjukkan apakah ini adalah penerapan baru atau upaya untuk melanjutkan penerapan sebelumnya. Saat Anda menggunakan `DeploymentID` sama dengan penerapan sebelumnya, setel `DeploymentMode` ke`resume`.

  Nilai yang valid adalah: `new` (default), dan`resume`.
+ **`GraphQueryType`**— Jenis data grafik untuk database Anda.

  Nilai yang valid adalah: `propertygraph` (default), dan`rdf`.
+ **`SubnetId`**— ID subnet dari VPC yang sama tempat cluster DB biru Anda berada. (lihat [Menghubungkan ke Cluster DB Neptunus dari instans Amazon EC2 di VPC](get-started-connect-ec2-same-vpc.md) yang sama).

  Berikan ID subnet publik jika Anda ingin SSH ke instans melalui [EC2](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/Connect-using-EC2-Instance-Connect.html) Connect.
+ **`InstanceSecurityGroup`**— Grup keamanan untuk instans Amazon EC2 Anda.

  Grup keamanan harus memiliki akses ke cluster DB biru Anda, dan Anda harus dapat SSH ke instance. Lihat [Buat grup keamanan menggunakan konsol VPC](get-started-vpc.md#security-vpc-security-group).

Tunggu sampai tumpukan selesai. Segera setelah selesai, solusinya dimulai. Anda kemudian dapat memantau proses penyebaran menggunakan CloudWatch log seperti yang dijelaskan di bagian berikutnya.

# Memantau kemajuan penyebaran Neptunus Blue/Green
<a name="neptune-BG-monitoring"></a>

[Anda dapat memantau kemajuan solusi Blue/Green Neptunus dengan pergi ke CloudWatch konsol dan melihat log di `/aws/neptune/(Neptune Blue/Green deployment ID)` CloudWatch grup log.](https://console.aws.amazon.com/cloudwatch/) Anda dapat menemukan tautan ke CloudWatch log di output CloudFormation tumpukan solusi:

![\[Tangkapan layar dari output tumpukan Biru/Hijau CloudFormation\]](http://docs.aws.amazon.com/id_id/neptune/latest/userguide/images/BG-stack-output.png)


Jika Anda menyediakan subnet publik sebagai parameter tumpukan, Anda juga dapat SSH ke instans Amazon EC2 yang dibuat sebagai bagian dari tumpukan dan merujuk ke log in. `/var/log/cloud-init-output.log`

Log menunjukkan tindakan yang diambil oleh solusi Blue/Green Neptunus, seperti yang ditunjukkan pada tangkapan layar ini:

![\[Tangkapan layar dari layar log Blue/Green Neptunus\]](http://docs.aws.amazon.com/id_id/neptune/latest/userguide/images/BG-log-screenshot.png)


Pesan log menunjukkan status sinkronisasi antara cluster biru dan hijau:

![\[Tangkapan layar pesan log solusi Blue/Green Neptunus\]](http://docs.aws.amazon.com/id_id/neptune/latest/userguide/images/BG-log-messages.png)


Proses sinkronisasi memeriksa lag replikasi dengan menghitung perbedaan antara aliran terbaru `eventID` pada cluster biru dan pos pemeriksaan replikasi yang ada di tabel pos pemeriksaan DynamoDB yang dibuat oleh tumpukan replikasi. Neptune-to-Neptune Dengan menggunakan pesan-pesan ini, Anda dapat memantau perbedaan replikasi saat ini.

# Memotong dari cluster biru produksi ke cluster hijau yang diperbarui
<a name="neptune-BG-cutover"></a>

Sebelum mempromosikan cluster hijau ke produksi, pastikan bahwa perbedaan komit antara cluster biru dan hijau adalah nol dan kemudian nonaktifkan semua lalu lintas tulis ke cluster biru. Melanjutkan menulis ke cluster biru sambil mengalihkan titik akhir basis data ke cluster hijau dapat mengakibatkan kerusakan data yang disebabkan oleh penulisan data sebagian ke kedua cluster. Anda mungkin belum perlu menonaktifkan lalu lintas baca.

Jika Anda telah mengaktifkan autentikasi IAM pada klaster sumber (biru), pastikan untuk memperbarui kebijakan IAM yang digunakan dalam aplikasi Anda untuk menunjuk ke klaster hijau (untuk contoh kebijakan semacam itu, lihat kebijakan [akses tidak terbatas](iam-data-access-examples.md#iam-auth-data-policy-example-general) ini).

Setelah menonaktifkan lalu lintas tulis, tunggu replikasi selesai dan kemudian aktifkan lalu lintas tulis di cluster hijau (tetapi tidak pada cluster biru). Beralih lalu lintas baca dari biru ke cluster hijau juga.

# Pembersihan setelah solusi Blue/Green Neptunus selesai
<a name="neptune-BG-cleanup"></a>

Setelah Anda mempromosikan klaster pementasan (hijau) ke produksi, bersihkan sumber daya yang dibuat oleh solusi Neptunus Blue/Green :
+ Hapus instans Amazon EC2 yang dibuat untuk menjalankan solusi.
+ Hapus CloudFormation template untuk replikasi [berbasis aliran Neptunus](streams-consumer-setup.md) yang membuat cluster hijau tetap sinkron dengan cluster biru. Yang utama memiliki nama tumpukan yang Anda berikan sebelumnya, dan satu terdiri dari ID penerapan diikuti oleh “-replikasi”: yaitu,. `(DeploymentID)-replication`

Menghapus CloudFormation template tidak menghapus cluster itu sendiri. Setelah Anda memverifikasi bahwa cluster hijau berfungsi seperti yang diharapkan, Anda dapat mengambil snapshot secara opsional sebelum menghapus cluster biru secara manual.

# Praktik terbaik solusi Blue/Green Neptunus
<a name="neptune-BG-best-practices"></a>
+ Sebelum mengalihkan cluster hijau Anda ke produksi, ada baiknya memverifikasi secara menyeluruh bahwa itu berfungsi dengan baik. Periksa konsistensi data dan konfigurasi database. Ada kemungkinan bahwa beberapa versi mesin baru memerlukan peningkatan klien juga. Periksa catatan rilis mesin sebelum Anda meningkatkan. Perlu menguji semua ini dalam pengembangan, pengujian, dan lingkungan pra-produksi sebelum memulai blue/green peningkatan produksi.
+ Yang terbaik adalah melakukan peralihan dari server biru ke hijau selama jendela pemeliharaan Anda.
+ Untuk memastikan bahwa semuanya berfungsi dengan baik setelah memutakhirkan dan menyinkronkan, ada baiknya menyimpan cluster asli Anda selama beberapa periode waktu sebelum menghapusnya. Itu bisa terbukti berguna jika masalah yang tidak terduga muncul.
+ Hindari operasi penulisan berat seperti beban massal saat menjalankan solusi Blue/Green Neptunus, karena dapat menyebabkan kelambatan replikasi yang menyebabkan waktu henti yang signifikan. Idealnya, waktu antara mematikan penulisan ke cluster biru Anda dan menyalakannya untuk cluster hijau Anda hanya beberapa saat.

# Memecahkan masalah solusi Neptunus Blue/Green
<a name="neptune-BG-troubleshooting"></a>

 Informasi berikut menyoroti masalah yang dapat muncul selama proses penerapan Blue/Green solusi, seperti konflik dengan cluster yang ada, kebutuhan untuk mengaktifkan aliran Neptunus, operasi pemuatan massal yang sedang berlangsung, dan persyaratan kompatibilitas versi. Dengan mengatasi masalah potensial ini, Anda dapat memastikan penerapan solusi Neptunus yang lancar dan sukses. Blue/Green 

**Kesalahan yang ditimbulkan oleh solusi Neptunus Blue/Green**
+ **`Cluster with id = (blue_green_deployment_id) already exists`**— Ada cluster yang ada dengan pengenal*(blue\$1green\$1deployment\$1id)*.

  Berikan ID penerapan baru atau atur mode penerapan ke `resume` jika cluster dibuat dalam proses Neptunus sebelumnya. Blue/Green 
+ **`Streams should be enabled on the source Cluster for Blue Green Deployment`**— Aktifkan aliran [Neptunus](streams-using-enabling.md) pada cluster biru (sumber).
+ **`No Bulkload should be in progress on source cluster: (cluster_id)`**— Solusi Blue/Green Neptunus berakhir jika mengidentifikasi beban curah yang sedang berlangsung.

  Ini untuk memastikan bahwa proses sinkronisasi dapat menangkap penulisan yang sedang dibuat. Hindari atau batalkan pekerjaan pemuatan massal yang sedang berlangsung sebelum memulai solusi Blue/Green Neptunus.
+ **`Blue Green deployment requires instances to be in sync with db cluster parameter group`**— Setiap perubahan pada grup parameter cluster harus disinkronkan di seluruh cluster DB. Lihat [Grup parameter Amazon Neptunus](parameter-groups.md).
+ **`Invalid target engine version for Blue Green Deployment`**— Versi mesin target harus terdaftar sebagai aktif[Rilis mesin untuk Amazon Neptunus](engine-releases.md), dan harus lebih tinggi dari pelepasan mesin saat ini dari cluster sumber (biru).