Meningkatkan versi mesin broker Amazon MQ - Amazon MQ
Meningkatkan versi mesin secara manualOtomatis meningkatkan versi mesin minor

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

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 yang berubah. Misalnya, memutakhirkan dari versi 1. 5 ke versi 1. 6 dianggap sebagai upgrade versi minor.

Anda dapat meningkatkan broker Anda secara manual kapan saja ke versi mayor atau minor yang didukung berikutnya. Saat Anda mengaktifkan peningkatan versi minor otomatis, Amazon MQ akan meningkatkan broker Anda ke versi patch terbaru yang didukung. Untuk semua broker yang menggunakan engine versi 3.13 ke atas, Amazon MQ mengelola peningkatan ke versi patch terbaru yang didukung selama jendela pemeliharaan. Amazon MQ 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 meningkatkan versi mesin broker secara manual ke versi mayor atau minor baru, Anda dapat menggunakan AWS Management Console, AWS CLI API MQ, atau Amazon.

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.

Untuk meng-upgrade versi mesin broker dengan menggunakan AWS CLI

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

    • --broker-id – ID unik yang dihasilkan Amazon MQ untuk broker. Anda dapat mengurai ID dari broker ARN Anda. Misalnya, mengingat hal berikutARN,arn:aws:mq:us-east-2:123456789012:broker:MyBroker:b-1234a5b6-78cd-901e-2fgh-3i45j6k178l9, ID broker akan menjadib-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 CLI perintah reboot-broker untuk me-reboot broker Anda jika, Anda ingin segera memutakhirkan 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.

Untuk meningkatkan versi mesin broker dengan menggunakan Amazon MQ API

  1. Gunakan UpdateBrokerAPIoperasi. 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 RebootBrokerAPIoperasi 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, AWS CLI, atau Amazon API MQ.

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.

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

  • --broker-id – ID unik yang dihasilkan Amazon MQ untuk broker. Anda dapat mengurai ID dari broker ARN Anda. Misalnya, mengingat hal berikutARN,arn:aws:mq:us-east-2:123456789012:broker:MyBroker:b-1234a5b6-78cd-901e-2fgh-3i45j6k178l9, ID broker akan menjadib-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.

Untuk mengaktifkan upgrade versi minor otomatis melalui Amazon API MQ, gunakan UpdateBrokerAPIoperasi. 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.