Meningkatkan versi mesin broker Amazon MQ

Amazon MQ secara teratur menyediakan versi mesin broker baru untuk semua jenis mesin broker yang didukung. Versi mesin baru termasuk patch keamanan, perbaikan bug, dan peningkatan mesin broker lainnya.

Amazon MQ mengatur nomor versi sesuai dengan spesifikasi versi semantik sebagai. X.Y.Z Dalam implementasi Amazon MQ, X menunjukkan versi utama, Y mewakili versi minor, dan Z menunjukkan nomor versi patch. Ada dua jenis peningkatan:

• Upgrade versi utama - Terjadi ketika nomor versi mesin utama berubah. Misalnya, memutakhirkan dari versi 1 .0 ke versi 2 .0 dianggap sebagai peningkatan versi utama.

• Peningkatan versi minor - Terjadi ketika hanya nomor versi mesin minor atau patch yang berubah. Misalnya, memutakhirkan dari versi 1. 5 ke versi 1. 6 dianggap sebagai upgrade versi minor.

Untuk informasi selengkapnya tentang manajemen versi utama dan minor untuk setiap jenis mesin broker tertentu, lihat topik berikut.

• Mengelola versi mesin Amazon MQ for ActiveMQ

• Mengelola Amazon MQ untuk versi mesin RabbitMQ

Anda dapat meningkatkan broker Anda secara manual kapan saja ke versi mayor, minor, atau patch berikutnya yang didukung. Saat Anda mengaktifkan upgrade versi minor otomatis, Amazon MQ akan meningkatkan broker Anda ke versi patch terbaru yang didukung selama jendela pemeliharaan. Jika Anda tidak mengaktifkan upgrade versi minor otomatis, Amazon MQ akan meningkatkan broker Anda ke versi minor berikutnya ketika versi minor saat ini mencapai akhir dukungan.

Peningkatan versi manual dan otomatis terjadi selama jendela pemeliharaan terjadwal atau setelah Anda melakukan boot ulang broker.

Topik berikut menjelaskan cara meningkatkan versi mesin broker secara manual, dan mengaktifkan peningkatan versi minor otomatis.

Meningkatkan versi mesin secara manual

Untuk memutakhirkan versi mesin broker secara manual ke versi mayor atau minor baru, Anda dapat menggunakan AWS Management Console, AWS CLI API, atau Amazon MQ.

AWS Management Console

Untuk meng-upgrade versi mesin broker dengan menggunakan AWS Management Console

1. Masuk ke konsol Amazon MQ.

2. Pada panel navigasi kiri, pilih Broker, lalu pilih broker dalam daftar yang ingin Anda tingkatkan.

3. Pada halaman detail broker, pilih Edit.

4. Di bawah Spesifikasi, untuk Versi mesin broker, pilih nomor versi baru dari daftar dropdown.

5. Gulir ke bagian bawah halaman, lalu pilih Jadwalkan perubahan.

6. Di halaman Jadwalkan modifikasi broker, untuk Kapan menerapkan perubahan, pilih salah satu opsi berikut.

   • Pilih Setelah boot ulang berikutnya, jika Anda ingin Amazon MQ untuk menyelesaikan peningkatan versi selama jendela pemeliharaan terjadwal berikutnya.

   • Pilih Segera, jika Anda ingin segera melakukan boot ulang broker dan meningkatkan versi mesin.

     penting

     Broker Anda akan menjadi offline saat sedang di-boot ulang.

7. Pilih Terapkan untuk menyelesaikan penerapan perubahan.

AWS CLI

Untuk meng-upgrade versi mesin broker dengan menggunakan AWS CLI

1. Gunakan perintah CLI update-broker dan tentukan parameter berikut, seperti yang ditampilkan dalam contoh.

   • --broker-id – ID unik yang dihasilkan Amazon MQ untuk broker. Anda dapat mengurai ID dari ARN broker. Misalnya, dengan ARN berikut, arn:aws:mq:us-east-2:123456789012:broker:MyBroker:b-1234a5b6-78cd-901e-2fgh-3i45j6k178l9, ID broker akan menjadi b-1234a5b6-78cd-901e-2fgh-3i45j6k178l9.

   • --engine-version – Nomor versi mesin untuk meningkatkan mesin broker.

   aws mq update-broker --broker-id broker-id --engine-version version-number

2. (Opsional) Gunakan perintah CLI reboot-broker untuk melakukan boot ulang broker jika Anda ingin segera meningkatkan versi mesin.

   aws mq reboot-broker --broker-id broker-id

   Jika Anda tidak ingin melakukan boot ulang broker dan segera menerapkan perubahan, Amazon MQ akan meningkatkan broker selama jendela pemeliharaan terjadwal berikutnya.

   penting

   Broker Anda akan menjadi offline saat sedang di-boot ulang.

API Amazon MQ

Untuk meningkatkan versi mesin broker menggunakan API Amazon MQ

1. Gunakan Operasi API UpdateBroker. Tentukan broker-id sebagai parameter jalur. Contoh berikut mengasumsikan broker di wilayah us-west-2. Untuk informasi selengkapnya tentang titik akhir Amazon MQ yang tersedia, lihat titik akhir dan kuota Amazon MQ. di Referensi Umum AWS

   PUT /v1/brokers/broker-id HTTP/1.1
   Host: mq.us-west-2.amazonaws.com
   Date: Mon, 7 June 2021 12:00:00 GMT
   x-amz-date: Mon, 7 June 2021 12:00:00 GMT
   Authorization: authorization-string

   Gunakan engineVersion dalam muatan permintaan untuk menentukan nomor versi peningkatan broker.

   {
       "engineVersion": "engine-version-number"
   }

2. (Opsional) Gunakan operasi RebootBrokerAPI untuk me-reboot broker Anda, jika Anda ingin segera memutakhirkan versi mesin. broker-idditentukan sebagai parameter jalur.

   POST /v1/brokers/broker-id/reboot-broker HTTP/1.1
   Host: mq.us-west-2.amazonaws.com
   Date: Mon, 7 June 2021 12:00:00 GMT
   x-amz-date: Mon, 7 June 2021 12:00:00 GMT
   Authorization: authorization-string

   Jika Anda tidak ingin melakukan boot ulang broker dan segera menerapkan perubahan, Amazon MQ akan meningkatkan broker selama jendela pemeliharaan terjadwal berikutnya.

   penting

   Broker Anda akan menjadi offline saat sedang di-boot ulang.

Otomatis meningkatkan versi mesin minor

Anda dapat mengontrol apakah peningkatan versi minor otomatis diaktifkan untuk broker ketika Anda pertama kali membuat broker, atau dengan mengubah preferensi broker. Untuk mengaktifkan upgrade versi auto minor untuk broker yang ada, Anda dapat menggunakan AWS Management Console, API AWS CLI, atau Amazon MQ.

AWS Management Console

Untuk mengaktifkan upgrade versi minor otomatis dengan menggunakan AWS Management Console

1. Masuk ke konsol Amazon MQ.

2. Pada panel navigasi kiri, pilih Broker, lalu pilih broker dalam daftar yang ingin Anda tingkatkan.

3. Pada halaman detail broker, pilih Edit.

4. Di bawah Pemeliharaan, pilih Aktifkan peningkatan versi minor otomatis.

   catatan

   Jika opsi sudah dipilih, Anda tidak perlu melakukan perubahan apa pun.

5. Pilih Simpan di bagian bawah halaman.

AWS CLI

Untuk mengaktifkan upgrade versi minor otomatis melalui AWS CLI, gunakan perintah CLI update-broker dan tentukan parameter berikut.

• --broker-id – ID unik yang dihasilkan Amazon MQ untuk broker. Anda dapat mengurai ID dari ARN broker. Misalnya, dengan ARN berikut, arn:aws:mq:us-east-2:123456789012:broker:MyBroker:b-1234a5b6-78cd-901e-2fgh-3i45j6k178l9, ID broker akan menjadi b-1234a5b6-78cd-901e-2fgh-3i45j6k178l9.

• --auto-minor-version-upgrade – Mengaktifkan opsi peningkatan versi minor otomatis.

aws mq update-broker --broker-id broker-id --auto-minor-version-upgrade

Jika Anda ingin menonaktifkan peningkatan versi minor otomatis untuk broker, gunakan parameter --no-auto-minor-version-upgrade.

API Amazon MQ

Untuk mengaktifkan upgrade versi minor otomatis melalui Amazon MQ API, gunakan operasi API UpdateBroker. Tentukan broker-id sebagai parameter jalur. Contoh berikut mengasumsikan broker di wilayah us-west-2. Untuk informasi selengkapnya tentang titik akhir Amazon MQ yang tersedia, lihat titik akhir dan kuota Amazon MQ. di Referensi Umum AWS

PUT /v1/brokers/broker-id HTTP/1.1
Host: mq.us-west-2.amazonaws.com
Date: Mon, 7 June 2021 12:00:00 GMT
x-amz-date: Mon, 7 June 2021 12:00:00 GMT
Authorization: authorization-string

Gunakan properti autoMinorVersionUpgrade di muatan permintaan untuk mengaktifkan peningkatan versi minor otomatis.

{
    "autoMinorVersionUpgrade": "true"
}

Jika Anda ingin menonaktifkan peningkatan versi minor otomatis untuk broker, atur "autoMinorVersionUpgrade": "false" dalam muatan permintaan.

Versi mesin akhir kalender dukungan

Akhir kalender dukungan versi Amazon MQ memberi tahu Anda kapan versi mesin broker akan mencapai akhir dukungan. Ketika versi mesin mencapai akhir dukungan, Amazon MQ memperbarui semua broker pada versi ini ke versi berikutnya yang tersedia secara otomatis. Amazon MQ menyediakan setidaknya pemberitahuan 90 hari sebelum versi mesin mencapai akhir dukungan.

Untuk melihat kalender dukungan versi, lihat Amazon MQ Mengelola versi mesin Amazon MQ for ActiveMQ untuk ActiveMQ dan Amazon MQ untuk Mengelola Amazon MQ untuk versi mesin RabbitMQ RabbitMQ.