Memelihara Amazon DocumentDB - Amazon DocumentDB

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

Memelihara Amazon DocumentDB

Secara berkala, Amazon DocumentDB melakukan pemeliharaan pada sumber daya Amazon DocumentDB. Pemeliharaan paling sering melibatkan pembaruan ke mesin basis data (pemeliharaan klaster) atau sistem operasi (OS) yang mendasari instans (pemeliharaan instans). Pembaruan mesin database adalah tambalan yang diperlukan dan mencakup perbaikan keamanan, perbaikan bug, dan penyempurnaan pada mesin database. Meskipun sebagian besar tambalan sistem operasi bersifat opsional, jika Anda tidak menerapkannya untuk sementara waktu, tambalan mungkin diperlukan dan diterapkan secara otomatis untuk menjaga postur keamanan Anda. Jadi, kami menyarankan Anda menerapkan pembaruan sistem operasi ke instans Amazon DocumentDB Anda segera setelah tersedia.

Patch mesin database mengharuskan Anda membuat cluster Amazon DocumentDB offline untuk waktu yang singkat. Setelah tersedia, tambalan ini secara otomatis dijadwalkan untuk diterapkan selama jendela pemeliharaan terjadwal yang akan datang dari cluster Amazon DocumentDB Anda.

Pemeliharaan klaster dan instans memiliki jendela pemeliharaan masing-masing. Modifikasi cluster dan instance yang telah Anda pilih untuk tidak segera diterapkan, juga diterapkan selama jendela pemeliharaan. Secara default, saat Anda membuat klaster, Amazon DocumentDB menetapkan jendela pemeliharaan untuk klaster dan setiap instans tunggal. Anda dapat memilih jendela pemeliharaan saat membuat klaster atau instans. Anda juga dapat mengubah jendela pemeliharaan kapan saja agar sesuai dengan jadwal atau praktik bisnis Anda. Umumnya disarankan untuk memilih jendela pemeliharaan yang meminimalkan dampak pemeliharaan pada aplikasi Anda (misalnya, pada malam hari atau akhir pekan).

Pemberitahuan untuk patch mesin Amazon DocumentDB

Anda akan menerima pemberitahuan pemeliharaan untuk patch mesin database yang diperlukan melalui acara kesehatan di AWS Health Dashboard (AHD) di AWS konsol dan melalui email. Ketika patch pemeliharaan mesin Amazon DocumentDB tersedia di wilayah AWS tertentu, semua akun pengguna Amazon DocumentDB yang terkena dampak di wilayah tersebut akan menerima pemberitahuan AHD dan email untuk setiap versi Amazon DocumentDB yang terpengaruh oleh tambalan tersebut. Anda dapat melihat pemberitahuan ini di bawah bagian Perubahan terjadwal AHD di AWS konsol. Pemberitahuan akan memiliki detail tentang waktu ketersediaan patch, jadwal penerapan otomatis, daftar cluster yang terkena dampak, dan catatan rilis. Pemberitahuan ini juga akan dikirimkan melalui e-mail ke alamat email pengguna root AWS akun.

Konsol Amazon DocumentDB menampilkan tab Perubahan terjadwal untuk peningkatan patch mesin.

Setelah Anda menerima pemberitahuan ini, Anda dapat memilih untuk menerapkan sendiri patch mesin ini ke cluster Amazon DocumentDB Anda sebelum tanggal penerapan otomatis yang dijadwalkan. Atau Anda dapat menunggu patch mesin diterapkan secara otomatis selama jendela pemeliharaan yang akan datang (opsi default).

catatan

Status untuk notifikasi di AHD akan diatur ke 'Sedang Berlangsung' hingga patch mesin Amazon DocumentDB baru dengan versi patch mesin baru dirilis.

Setelah patch mesin diterapkan ke cluster Amazon DocumentDB Anda, versi patch mesin cluster akan diperbarui untuk mencerminkan versi dalam notifikasi. Anda dapat menjalankan db.runCommand({getEngineVersion: 1}) perintah untuk memverifikasi pembaruan ini.

AWS Health juga terintegrasi dengan Amazon EventBridge yang menggunakan peristiwa untuk membangun aplikasi berbasis peristiwa yang dapat diskalakan dan terintegrasi dengan lebih dari 20 target, termasuk, AWS Lambda Amazon Simple Queue Service (), dan lainnya. SQS Anda dapat menggunakan kode AWS_DOCDB_DB_PATCH_UPGRADE_MAINTENANCE_SCHEDULED acara untuk mengatur Amazon EventBridge sebelum tambalan mesin tersedia. Anda dapat mengatur EventBridge untuk menanggapi peristiwa dan melakukan tindakan otomatis seperti menangkap informasi peristiwa, memulai acara tambahan, mengirim pemberitahuan melalui saluran tambahan seperti pemberitahuan push ke, dan mengambil tindakan korektif atau tindakan lainnya AWS Console Mobile Application, ketika patch mesin Amazon DocumentDB tersedia di wilayah Anda.

Dalam skenario langka Amazon DocumentDB membatalkan patch mesin, Anda akan menerima pemberitahuan serta email AHD yang memberi tahu Anda tentang pembatalan. Dengan demikian, Anda dapat menggunakan kode AWS_DOCDB_DB_PATCH_UPGRADE_MAINTENANCE_CANCELLED acara untuk mengatur Amazon EventBridge untuk menanggapi acara ini. Lihat Panduan EventBridge Pengguna Amazon untuk mempelajari lebih lanjut tentang menggunakan EventBridge aturan Amazon.

Melihat tindakan pemeliharaan Amazon DocumentDB yang tertunda

Anda dapat melihat apakah pembaruan pemeliharaan tersedia untuk klaster Anda dengan menggunakan AWS Management Console atau file AWS CLI.

Jika pembaruan tersedia, Anda dapat melakukan salah satu hal berikut:

  • Tunda tindakan pemeliharaan yang saat ini dijadwalkan untuk jendela pemeliharaan berikutnya (hanya untuk patch OS).

  • Terapkan tindakan pemeliharaan segera.

  • Jadwalkan tindakan pemeliharaan untuk dimulai selama periode pemeliharaan berikutnya.

catatan

Jika Anda tidak mengambil tindakan, tindakan pemeliharaan yang diperlukan seperti tambalan engine akan diterapkan secara otomatis di jendela pemeliharaan terjadwal yang akan datang.

Jendela pemeliharaan menentukan kapan operasi yang tertunda dimulai, tetapi tidak membatasi total waktu pelaksanaan operasi ini.

Using the AWS Management Console
  1. Masuk ke AWS Management Console, dan buka konsol Amazon DocumentDB di /docdb. https://console.aws.amazon.com

  2. Pada panel navigasi, silakan pilih Klaster.

  3. Jika pembaruan tersedia, ini ditunjukkan dengan kata Tersedia, Diperlukan, atau Jendela Berikutnya di kolom Pemeliharaan untuk cluster di konsol Amazon DocumentDB, seperti yang ditunjukkan di sini:

    Konsol Amazon DocumentDB menampilkan kolom Pemeliharaan untuk klaster.
  4. Untuk mengambil tindakan, pilih cluster untuk menampilkan detailnya, lalu pilih Maintenance & backup. Item Pemeliharaan Tertunda muncul.

    Konsol Amazon DocumentDB menampilkan jendela Pemeliharaan cluster.
Using the AWS CLI

Gunakan AWS CLI operasi berikut untuk menentukan tindakan pemeliharaan apa yang tertunda. Output di sini menunjukkan tidak ada tindakan pemeliharaan yang tertunda.

aws docdb describe-pending-maintenance-actions

Output dari operasi ini terlihat seperti berikut (JSONformat).

{ "PendingMaintenanceActions": [] }

Pembaruan mesin Amazon DocumentDB

Dengan Amazon DocumentDB, Anda dapat memilih kapan menerapkan operasi pemeliharaan. Anda dapat memutuskan kapan Amazon DocumentDB menerapkan pembaruan menggunakan atau. AWS Management Console AWS CLI

Gunakan prosedur dalam topik ini untuk segera meningkatkan atau menjadwalkan peningkatan untuk klaster Anda.

Using the AWS Management Console

Anda dapat menggunakan konsol untuk mengelola pembaruan untuk cluster Amazon DocumentDB Anda.

Untuk mengelola pembaruan untuk klaster
  1. Masuk ke AWS Management Console, dan buka konsol Amazon DocumentDB di /docdb. https://console.aws.amazon.com

  2. Pada panel navigasi, silakan pilih Klaster.

  3. Dalam daftar klaster, pilih tombol di samping nama klaster yang ingin Anda terapkan operasi pemeliharaannya.

  4. Pada menu Tindakan, pilih salah satu dari berikut ini:

    • Perbarui sekarang untuk segera melakukan tugas pemeliharaan yang tertunda.

    • Perbarui di jendela berikutnya untuk melakukan tugas pemeliharaan yang tertunda selama jendela pemeliharaan klaster berikutnya.

    Atau, Anda dapat mengklik Terapkan sekarang atau Terapkan di jendela pemeliharaan berikutnya di bagian Pemeliharaan Tertunda pada tab Pemeliharaan & pencadangan cluster (lihat Menggunakan bagian sebelumnya AWS Management Console).

    catatan

    Jika tidak ada tugas pemeliharaan yang tertunda, semua opsi sebelumnya tidak aktif.

Using the AWS CLI

Untuk menerapkan pembaruan yang tertunda ke cluster, gunakan apply-pending-maintenance-action AWS CLI operasi.

Parameter
  • --resource-identifierARN—Nama Sumber Daya Amazon DocumentDB Amazon () dari sumber daya yang berlaku untuk tindakan pemeliharaan tertunda.

  • --apply-action—Tindakan pemeliharaan yang tertunda untuk diterapkan ke sumber daya ini.

    Nilai yang valid: system-update dan db-upgrade.

  • --opt-in-type—Nilai yang menentukan jenis permintaan keikutsertaan, atau membatalkan permintaan keikutsertaan. Permintaan keikutsertaan tipe immediate tidak dapat diurungkan.

    Nilai valid:

    • immediate—Terapkan tindakan pemeliharaan segera.

    • next-maintenance—Terapkan tindakan pemeliharaan selama jendela pemeliharaan berikutnya untuk sumber daya.

    • undo-opt-in—Membatalkan permintaan keikutsertaan next-maintenance yang ada.

Untuk Linux, macOS, atau Unix:

aws docdb apply-pending-maintenance-action \ --resource-identifier arn:aws:rds:us-east-1:123456789012:db:docdb \ --apply-action system-update \ --opt-in-type immediate

Untuk Windows:

aws docdb apply-pending-maintenance-action ^ --resource-identifier arn:aws:rds:us-east-1:123456789012:db:docdb ^ --apply-action system-update ^ --opt-in-type immediate

Untuk mengembalikan daftar sumber daya yang memiliki setidaknya satu pembaruan yang tertunda, gunakan describe-pending-maintenance-actions AWS CLI operasi.

Untuk Linux, macOS, atau Unix:

aws docdb describe-pending-maintenance-actions \ --resource-identifier arn:aws:rds:us-east-1:001234567890:db:docdb

Untuk Windows:

aws docdb describe-pending-maintenance-actions ^ --resource-identifier arn:aws:rds:us-east-1:001234567890:db:docdb

Output dari operasi ini terlihat seperti berikut (JSONformat).

{ "PendingMaintenanceActions": [ { "ResourceIdentifier": "arn:aws:rds:us-east-1:001234567890:cluster:sample-cluster", "PendingMaintenanceActionDetails": [ { "Action": "system-update", "CurrentApplyDate": "2019-01-11T03:01:00Z", "Description": "db-version-upgrade", "ForcedApplyDate": "2019-01-18T03:01:00Z", "AutoAppliedAfterDate": "2019-01-11T03:01:00Z" } ] } ] }

Anda juga dapat mengembalikan daftar sumber daya untuk cluster dengan menentukan --filters parameter describe-pending-maintenance-actions AWS CLI operasi. Format untuk operasi --filters adalah Name=filter-name,Values=resource-id,....

db-cluster-idadalah nilai yang dapat diterima untuk Name parameter filter. Nilai ini menerima daftar pengidentifikasi cluster atau. ARNs Daftar yang dikembalikan hanya mencakup tindakan pemeliharaan tertunda untuk kluster yang diidentifikasi oleh pengidentifikasi ini atau. ARNs

Contoh berikut mengembalikan tindakan pemeliharaan tertunda untuk klaster sample-cluster1 dan sample-cluster2.

Untuk Linux, macOS, atau Unix:

aws docdb describe-pending-maintenance-actions \ --filters Name=db-cluster-id,Values=sample-cluster1,sample-cluster2

Untuk Windows:

aws docdb describe-pending-maintenance-actions ^ --filters Name=db-cluster-id,Values=sample-cluster1,sample-cluster2

Terapkan tanggal

Setiap tindakan pemeliharaan memiliki tanggal penerapan masing-masing yang dapat Anda temukan saat menjelaskan tindakan pemeliharaan yang tertunda. Saat Anda membaca output tindakan pemeliharaan yang tertunda dari AWS CLI, tiga tanggal dicantumkan. Nilai tanggal ini adalah null saat pemeliharaan bersifat opsional. Nilai terisi setelah tindakan pemeliharaan yang sesuai dijadwalkan atau diterapkan.

  • CurrentApplyDate—Tanggal tindakan pemeliharaan akan diterapkan baik segera atau selama jendela pemeliharaan berikutnya.

  • ForcedApplyDate—Tanggal saat pemeliharaan akan diterapkan secara otomatis, terlepas dari jangka waktu pemeliharaan Anda.

  • AutoAppliedAfterDate—Tanggal setelah pemeliharaan akan diterapkan selama jendela pemeliharaan klaster.

Pembaruan yang diprakarsai pengguna

Sebagai pengguna Amazon DocumentDB, Anda dapat memulai pembaruan untuk klaster atau instans Anda. Misalnya, Anda dapat mengubah kelas instans menjadi kelas dengan memori lebih banyak atau lebih sedikit, atau Anda dapat mengubah grup parameter klaster. Amazon DocumentDB melihat perubahan ini secara berbeda dari pembaruan yang dimulai Amazon DocumentDB. Untuk informasi selengkapnya tentang memodifikasi klaster atau instans, lihat berikut ini:

Untuk melihat daftar modifikasi yang dimulai oleh pengguna yang tertunda, jalankan perintah berikut.

Untuk melihat perubahan yang dimulai pengguna yang tertunda untuk instans Anda

Untuk Linux, macOS, atau Unix:

aws docdb describe-db-instances \ --query 'DBInstances[*].[DBClusterIdentifier,DBInstanceIdentifier,PendingModifiedValues]'

Untuk Windows:

aws docdb describe-db-instances ^ --query 'DBInstances[*].[DBClusterIdentifier,DBInstanceIdentifier,PendingModifiedValues]'

Output dari operasi ini terlihat seperti berikut (JSONformat).

Dalam hal ini, sample-cluster-instance memiliki perubahan yang tertunda ke kelas instans db.r5.xlarge, sedangkan sample-cluster-instance-2 tidak memiliki perubahan yang tertunda.

[ [ "sample-cluster", "sample-cluster-instance", { "DBInstanceClass": "db.r5.xlarge" } ], [ "sample-cluster", "sample-cluster-instance-2", {} ] ]

Mengelola jendela pemeliharaan Amazon DocumentDB Anda

Setiap instans dan klaster memiliki jendela pemeliharaan mingguan selama perubahan yang tertunda diterapkan. Jendela pemeliharaan adalah kesempatan untuk mengendalikan kapan modifikasi dan patch perangkat lunak terjadi, jika diminta atau diperlukan. Jika peristiwa pemeliharaan dijadwalkan untuk minggu tertentu, itu dilakukan selama periode pemeliharaan 30 menit yang Anda identifikasi. Sebagian besar peristiwa pemeliharaan juga selesai selama jendela pemeliharaan 30 menit, meskipun peristiwa pemeliharaan yang lebih besar mungkin memerlukan waktu lebih dari 30 menit untuk diselesaikan.

Jendela pemeliharaan 30 menit dipilih secara acak dari blok waktu 8 jam per Wilayah. Jika Anda tidak menentukan jendela pemeliharaan pilihan saat membuat instans atau klaster, Amazon DocumentDB menugaskan jendela pemeliharaan 30 menit pada hari yang dipilih secara acak dalam seminggu.

Tabel berikut mencantumkan blok waktu untuk setiap Wilayah dari mana jendela pemeliharaan default ditugaskan.

Nama Wilayah Wilayah UTCBlok Waktu
AS Timur (Ohio) us-east-2 03:00-11:00
US East (Northern Virginia) us-east-1 03:00-11:00
AS Barat (Oregon) us-west-2 06:00-14:00
Afrika (Cape Town) af-south-1 03:00 — 11:00
Asia Pasifik (Hong Kong) ap-east-1 06:00-14:00
Asia Pasifik (Hyderabad) ap-south-2 06:30 — 14:30
Asia Pasifik (Mumbai) ap-south-1 06:00-14:00
Asia Pasifik (Seoul) ap-northeast-2 13:00-21:00
Asia Pasifik (Singapura) ap-southeast-1 14:00-22:00
Asia Pasifik (Sydney) ap-southeast-2 12:00-20:00
Asia Pasifik (Tokyo) ap-northeast-1 13:00-21:00
Kanada (Pusat) ca-central-1 03:00-11:00
Tiongkok (Beijing) cn-north-1 06:00-14:00
Tiongkok (Ningxia) cn-northwest-1 06:00-14:00
Eropa (Frankfurt) eu-central-1 21:00-05:00
Eropa (Irlandia) eu-west-1 22:00-06:00
Eropa (London) eu-west-2 22:00-06:00
Eropa (Milan) eu-south-1 02:00-10:00
Eropa (Paris) eu-west-3 23:59-07:29
Eropa (Spanyol) eu-south-2 02:00 — 10:00
Timur Tengah (UAE) me-central-1 05:00 — 13:00
Amerika Selatan (Sao Paulo) sa-east-1 00:00-08:00
AWS GovCloud (AS-Timur) us-gov-east-1 17:00-01:00
AWS GovCloud (AS-Barat) us-gov-west-1 06:00-14:00

Mengubah jendela pemeliharaan Amazon DocumentDB Anda

Waktu pemeliharaan harus jatuh pada saat penggunaan terendah dan dengan demikian mungkin perlu diubah dari waktu ke waktu. Klaster atau instans Anda tidak tersedia selama waktu ini hanya jika perubahan sistem (seperti operasi penyimpanan skala atau perubahan kelas instans) sedang diterapkan dan memerlukan penghentian. Dan kemudian itu tidak tersedia hanya untuk jumlah waktu minimum yang diperlukan untuk membuat perubahan yang diperlukan.

Untuk pembaruan ke mesin basis data, Amazon DocumentDB menggunakan jendela pemeliharaan pilihan klaster dan bukan jendela pemeliharaan untuk instans individual.

Mengubah waktu pemeliharaan

Pembaruan sistem operasi Amazon DocumentDB

Instans di cluster Amazon DocumentDB terkadang memerlukan pembaruan sistem operasi. Amazon DocumentDB meningkatkan sistem operasi ke versi yang lebih baru untuk meningkatkan kinerja database dan postur keamanan pelanggan secara keseluruhan. Pembaruan sistem operasi tidak mengubah versi mesin cluster atau kelas instans dari instans Amazon DocumentDB.

Sebaiknya Anda memperbarui instance pembaca di klaster terlebih dahulu, lalu instance penulis untuk memaksimalkan ketersediaan klaster Anda. Kami tidak menyarankan untuk memperbarui instance pembaca dan penulis secara bersamaan, karena Anda mungkin mengalami downtime yang lebih lama jika terjadi failover.

Sebagian besar pembaruan sistem operasi untuk Amazon DocumentDB bersifat opsional dan tidak memiliki tanggal yang ditetapkan untuk menerapkannya. Namun, jika Anda tidak menerapkan pembaruan ini untuk sementara waktu, pembaruan tersebut pada akhirnya mungkin diperlukan dan diterapkan secara otomatis selama jendela pemeliharaan instans Anda. Ini untuk membantu menjaga postur keamanan database Anda. Untuk menghindari waktu henti yang tidak terduga, sebaiknya Anda menerapkan pembaruan sistem operasi ke instans Amazon DocumentDB Anda segera setelah tersedia dan mengatur jendela pemeliharaan instans Anda pada saat yang sesuai dengan kebutuhan bisnis Anda.

Untuk diberi tahu ketika pembaruan opsional baru tersedia, Anda dapat berlangganan RDS - EVENT -0230 dalam kategori acara penambalan keamanan. Untuk informasi tentang berlangganan acara Amazon DocumentDB, lihat Berlangganan Langganan Acara Amazon DocumentDB.

Anda harus mengharapkan bahwa ketika pemeliharaan dilakukan pada klaster atau instans Anda, jika instans adalah instans primer, itu akan gagal. Untuk meningkatkan ketersediaan, sebaiknya gunakan lebih dari satu instans untuk klaster Amazon DocumentDB Anda. Untuk informasi selengkapnya, lihat Failover Amazon DocumentDB.

catatan

Untuk fitur manajemen tertentu, Amazon DocumentDB menggunakan teknologi operasional yang dibagikan dengan Amazon Relational Database Service (Amazon). RDS

penting

Instans Amazon DocumentDB Anda akan offline selama peningkatan sistem operasi. Anda dapat meminimalkan waktu henti klaster dengan memiliki klaster multi-instance. Jika Anda tidak memiliki klaster multi-instance maka Anda dapat memilih untuk membuatnya sementara dengan menambahkan instance sekunder untuk melakukan pemeliharaan ini, lalu menghapus instance pembaca tambahan setelah pemeliharaan selesai (biaya reguler untuk instance sekunder akan berlaku).

catatan

Tetap mengikuti semua pembaruan opsional dan wajib mungkin diperlukan untuk memenuhi berbagai kewajiban kepatuhan. Kami menyarankan Anda menerapkan semua pembaruan yang disediakan oleh Amazon DocumentDB secara rutin selama jendela pemeliharaan Anda.

Anda dapat menggunakan AWS Management Console atau AWS CLI untuk menentukan apakah pembaruan tersedia.

Using the AWS Management Console

Untuk menentukan apakah pembaruan tersedia menggunakan AWS Management Console:

  1. Masuk ke AWS Management Console, dan buka konsol Amazon DocumentDB di /docdb. https://console.aws.amazon.com

  2. Di panel navigasi, pilih Clusters, lalu pilih instance.

  3. Pilih Pemeliharaan.

  4. Di bagian Pending Maintenance, temukan pembaruan sistem operasi.

Konsol Amazon DocumentDB menampilkan kolom Pemeliharaan untuk klaster.

Anda dapat memilih pembaruan sistem operasi dan klik Terapkan sekarang atau Terapkan di jendela pemeliharaan berikutnya di bagian Pemeliharaan Tertunda. Jika nilai pemeliharaan adalah jendela berikutnya, tunda item pemeliharaan dengan memilih Defer upgrade. Anda tidak dapat menunda tindakan pemeliharaan jika sudah dimulai.

Atau, Anda dapat memilih instance dari daftar cluster dengan mengklik Cluster di panel navigasi dan pilih Terapkan sekarang atau Terapkan di jendela maintentnace berikutnya dari menu Tindakan.

Using the AWS CLI

Untuk menentukan apakah pembaruan tersedia menggunakan AWS CLI, panggil describe-pending-maintenance-actions perintah:

aws docdb describe-pending-maintenance-actions
{ "ResourceIdentifier": "arn:aws:docdb:us-east-1:123456789012:db:mydb2", "PendingMaintenanceActionDetails": [ { "Action": "system-update", "Description": "New Operating System update is available" } ] }

Pembaruan sistem operasi khusus untuk versi mesin Amazon DocumentDB dan kelas instance. Oleh karena itu, instans Amazon DocumentDB menerima atau memerlukan pembaruan pada waktu yang berbeda. Ketika pembaruan sistem operasi tersedia untuk instans Anda berdasarkan versi mesin dan kelas instans, pembaruan muncul di konsol. Itu juga dapat dilihat dengan menjalankan AWS CLI describe-pending-maintenance-actions perintah atau dengan memanggil DescribePendingMaintenanceActions API operasi.

Jika Anda tidak menjalankan rilis patch cluster terbaru dari mesin Amazon DocumentDB Anda, Anda mungkin tidak melihat pembaruan sistem operasi terdaftar sebagai pemeliharaan yang tersedia. Untuk melihat dan mengelola pembaruan sistem operasi, Anda harus terlebih dahulu meningkatkan ke versi patch mesin terbaru.