Bagikan melalui


Tingkatkan ke versi baru

Pelajari cara meningkatkan penyebaran Operasi Azure IoT ke versi yang lebih baru.

Prasyarat

  • Sebuah akun Azure dengan langganan aktif. Jika Anda tidak memiliki akun, Anda dapat membuat akun gratis.
  • Azure CLI versi 2.53.0 atau yang lebih tinggi. Gunakan az --version untuk memeriksa versi Anda dan az upgrade untuk memperbarui jika perlu. Untuk informasi selengkapnya, lihat Mulai menggunakan Azure CLI.

Memahami dukungan peningkatan

Versi rilis Operasi Azure IoT dapat berupa pratinjau atau tersedia secara umum (GA), Anda dapat menemukan versi terbaru dalam dokumen versi Operasi Azure IoT . Versi ekstensi CLI Operasi Azure IoT terkait dengan versi Operasi Azure IoT, jadi Anda perlu memastikan bahwa Anda memiliki versi ekstensi CLI yang benar yang diinstal untuk melakukan peningkatan.

Operasi Azure IoT mendukung skenario peningkatan berikut:

  • Anda dapat meningkatkan instans Azure IoT Operations yang ada ke patch apa pun dari versi minor yang sama, atau ke versi minor berikutnya.
  • Anda tidak dapat menurunkan tingkat antar versi. Untuk berpindah ke versi yang lebih lama, hapus instalan Azure IoT Operations dan instal ulang versi yang diinginkan.
  • Anda tidak dapat meningkatkan dari versi pratinjau apa pun ke versi GA. Anda perlu menghapus instalan Operasi Azure IoT dan menginstal ulang versi baru.
  • Anda tidak dapat meningkatkan dari versi GA apa pun ke versi pratinjau. Untuk informasi selengkapnya tentang cara menginstal versi pratinjau, lihat Meningkatkan ke versi pratinjau.

Nota

Operasi Azure IoT tidak mendukung peningkatan langsung. Harap tunggu beberapa waktu henti selama proses peningkatan.

Pemutakhiran

Operasi Azure IoT mendukung peningkatan instans ke versi GA baru saat dirilis. Jika instans Azure IoT Operations Anda memenuhi syarat untuk peningkatan, Anda dapat menggunakan portal Microsoft Azure atau Azure CLI untuk melakukan peningkatan.

Jika versi terbaru Operasi Azure IoT dalam pratinjau, lihat Meningkatkan ke versi pratinjau.

Jika penyebaran Operasi Azure IoT Anda memenuhi syarat untuk peningkatan, portal Microsoft Azure menampilkan opsi Peningkatan . Jika Anda tidak melihat opsi untuk meningkatkan, maka pengaturan Anda ada di versi terbaru.

  1. Di portal Microsoft Azure, navigasikan ke instans Azure IoT Operations Anda.

  2. Pilih Tingkatkan pada halaman Gambaran Umum instans Anda.

    Cuplikan layar yang memperlihatkan tombol peningkatan diaktifkan di portal Microsoft Azure.

  3. Anda perlu menggunakan versi terbaru ekstensi Azure IoT Operations CLI untuk mendapatkan versi terbaru Operasi Azure IoT. Jika Anda tidak memperbarui ekstensi sebagai bagian dari prasyarat, lakukan sekarang.

    az extension add --upgrade --name azure-iot-ops
    

    Atau, jika Anda ingin meningkatkan penyebaran ke versi yang lebih baru tetapi bukan yang terbaru, atur versi ekstensi CLI ke versi yang terkait dengan versi Operasi Azure IoT yang Anda inginkan dalam versi Operasi IoT.

    az extension add --upgrade --name azure-iot-ops --version <VERSION_NUMBER>
    
  4. Portal menyajikan perintah Azure CLI guna meningkatkan instans Anda, yang sudah diisi dengan langganan, kelompok sumber daya, dan detail instans Anda. Pilih ikon salin di samping perintah CLI.

  5. Jalankan perintah yang disalin az iot ops upgrade .

  6. Setelah perintah peningkatan berhasil diselesaikan, refresh instans Anda untuk melihat perubahan.

Nilai Versi yang ditampilkan pada halaman gambaran umum instans Anda mencerminkan versi instans Operasi Azure IoT. Namun, Anda mungkin diminta untuk meningkatkan jika ekstensi Arc yang diperlukan memiliki peningkatan yang tersedia. Anda dapat mengetahui bahwa peningkatan berhasil jika opsi Peningkatan menghilang dari halaman gambaran umum instans, meskipun tidak terlihat seperti sesuatu yang berubah. Anda dapat memeriksa versi ekstensi Arc untuk penyebaran Operasi Azure IoT Anda di halaman Ekstensi kluster berkemampuan Arc Anda di portal Microsoft Azure.

Tingkatkan ke versi pratinjau

Terkadang versi terbaru Azure IoT Operations sedang dalam pratinjau. Periksa versi Operasi Azure IoT untuk melihat versi terbaru. Selama rilis pratinjau, peningkatan versi diblokir, dan Anda perlu menghapus instalan Operasi Azure IoT dan menginstal ulang versi pratinjau.

Anda hanya dapat menginstal versi pratinjau menggunakan Azure CLI.

  1. Jika Anda memiliki instans Azure IoT Operations yang sudah ada, Anda perlu Menghapus instalan Operasi Azure IoT untuk melakukan penyebaran baru.

  2. Tambahkan versi terbaru ekstensi Azure IoT Operations CLI dengan --allow-preview bendera .

    az extension add --upgrade --name azure-iot-ops --allow-preview
    

Jika Anda ingin meningkatkan ke versi tertentu dari Operasi Azure IoT yang bukan yang terbaru, Anda dapat menjalankan az iot ops get-versions atau merujuk ke versi Operasi IoT untuk menemukan versi ekstensi CLI yang terkait dengan versi Operasi Azure IoT yang Anda inginkan. Dapatkan nomor versi dan jalankan perintah berikut untuk meningkatkan ke versi tersebut:

az extension add --upgrade --name azure-iot-ops --version <VERSION_NUMBER>

Pertimbangan peningkatan broker MQTT

Untuk memastikan tidak ada kehilangan data dan ketersediaan tinggi selama peningkatan penyebaran, broker MQTT menerapkan pembaruan bergulir di seluruh pod broker MQTT. Pod manajer kesehatan mengkoordinasi proses peningkatan bertahap untuk pod broker MQTT guna memastikan bahwa:

  • Koneksi klien aktif tetap tidak terganggu.
  • Setiap pesan dalam penerbangan dipertahankan.
  • Data yang disimpan pada disk dimigrasikan dengan benar antar versi.

Jika kegagalan terjadi selama proses peningkatan, pod manajer kesehatan secara otomatis memulai ulang proses peningkatan sambil memastikan tidak ada kehilangan data atau konektivitas.

Pembaruan bergulir hanya dapat terjadi jika broker MQTT disebarkan dengan dua replika backend atau lebih. Peningkatan broker MQTT tidak didukung untuk penyebaran replika tunggal. Saat Anda menyebarkan Operasi Azure IoT, Anda menentukan jumlah replika backend yang akan dibuat dalam perintah az iot ops create dengan --broker-backend-rf parameter .

Versi yang didukung

Microsoft mendukung tiga versi Azure IoT Operations yang tersedia secara umum kapan saja: versi terbaru, dan dua versi minor sebelumnya. Selain itu, versi pratinjau tersedia untuk menguji fitur baru.

Saat ini, dukungan Azure tersedia untuk versi berikut:

Versi Tipe Patch saat ini
rilis (YYMM)
Arus
Versi CLI
Catatan rilis
1.2.x GA 1.2.112 (2510) 2.0.1 Catatan rilis
1.1.x GA 1.1.59 (2506) 1.7.0 Catatan rilis
1.0.x GA 1.0.34 (2503) 1.3.0 Catatan rilis

Untuk mempelajari tentang peningkatan antar versi, lihat Meningkatkan ke versi baru.

Penting

Versi minor sebelumnya tidak menerima patch keamanan. Tingkatkan ke versi terbaru untuk mendapatkan pembaruan dan fitur keamanan terbaru.

Peringatan

Jangan gunakan versi pratinjau di lingkungan produksi.

Untuk memverifikasi versi Anda saat ini, buka halaman gambaran umum untuk instans Operasi Azure IoT Anda di portal Microsoft Azure atau gunakan perintah tampilkan instans Operasi Azure IoT CLI az iot ops .