Bir yazılım güncellemesi cihazları bozuyorsa, bunlardan az sayıda etkilenmeli. Dalgalar halinde dağıtım paketi önce küçük bir gruba gönderir, nasıl gittiğini kontrol eder, bekler ve ancak ondan sonra daha büyük gruplara geçer. Bir dalga izin verdiğinizden daha kötü giderse kendiliğinden durur. Bu sayfa bunun nasıl kurulacağını ve izleneceğini açıklar. Paketler ve atamalarla ilgili temel bilgiler Yazılım güncellemeleri (OTA) sayfasındadır.
Dalgaları ne zaman kullanabilirsiniz
Dalgalar, Bir profildeki her cihaz veya Bazı cihazlar (bir cihaz listesi) atamasına uygulanır. Bir cihaz ataması hemen gönderilir. Yazılım atama yetkisine (yöneticiler) ihtiyacınız vardır.
Dağıtım kurma
- Firmware üzerinden paketi açın ve Ata seçeneğini seçin (ya da bir profilin Firmware sekmesini kullanın).
- Bir profildeki her cihaz veya Bazı cihazlar seçeneğini seçin ve hedefleri belirleyin.
- Send in waves seçeneğini açın (“Çevrimiçi cihazlardan oluşan küçük bir ilk dalga, ardından daha büyük dalgalar. Bir dalga izin verdiğinizden daha kötü giderse dağıtım kendiliğinden durur.”).
- Use the usual plan seçeneğini açık bırakın ya da dalgaları aşağıda anlatıldığı gibi düzenleyin.
- Check seçeneğini seçin. What happens cihaz sayılarını ve her dalganın boyutuyla birlikte “In waves: …” bilgisini gösterir.
- Assign seçeneğini seçin ve onaylayın.
Olağan plan
| Dalga | Boyut | Geçtikten sonra bekleme |
|---|---|---|
| 1 | Cihazların %1’i, en az 1 ve en fazla 10 (kanarya) | 30 dakika |
| 2 | 10 % | 30 dakika |
| 3 | 50 % | 15 dakika |
| 4 | kalan hepsi | — |
Olağan planın her dalgası, tamamlanan cihazlarının en az %90’ının güncellenmesini gerektirir, %5’in üzerinde başarısızlıkta duraklar ve en geç 240 dakika sonra kapanır.
Kendi dalgalarınız
Waves bölümünde, “Boyutlar güncellenecek cihazlar üzerinden sayılır. Son dalga kalan tüm cihazları alır.” Her dalga için:
| Alan | Anlamı | Aralık |
|---|---|---|
| Boyut olarak | Cihaz sayısı veya Cihazların payı (%) | 0’dan büyük bir boyut; en fazla %100 bir pay |
| Geçtikten sonra bekleme (dakika) | Bir sonraki dalga başlamadan önceki bekleme süresi | 0 ila 10.080 (7 gün) |
| En az güncellenen (%) | Dalganın tamamlanan cihazları üzerindeki başarı eşiği | 0 ila 100 |
| En fazla başarısız (%) | Başarısızlık eşiği | 0 ila 100 |
| En fazla başarısız (cihaz) | İsteğe bağlı mutlak üst sınır. “Yalnızca payı saymak için boş bırakın.” | — |
| Sonra kapat (dakika) | Dalganın ne kadar açık kalacağı. “O zamana kadar hâlâ çevrimdışı ya da bekleyen cihazlar sonraki dalgaya aktarılır ve başarısızlık sayılmaz.” | 5 ila 43.200 |
Add a wave ve Remove wave n listeyi değiştirir; The rest son dalgayı işaretler. Bir dağıtımda en fazla 20 dalga olabilir.
Cihazlar dalgalara nasıl yerleştirilir
- Cihazların sırası bir dağıtım için sabittir; böylece tekrar baktığınızda bir cihaz dalgalar arasında atlamaz.
- Çevrimiçi cihazlar önce gider; böylece kanarya dalgası size hızlıca sonuç verir.
- Sonraki bir dalganın cihazı, dalgası başlayana kadar hiçbir şey almaz (
fw_*öznitelikleri yoktur). Kendi sayfasında Waits for wave n görünür.
Dağıtım çalışırken
Paket sayfasında Rollout in waves görünür: her dalga, State (Not started, Updating, Passed, waiting, Passed, Paused, Not sent), Devices ve Progress (“updated / planned güncellendi, failed başarısız”) ile birlikte şu anki eşik (“Now: … failed (… %), … % of the finished updated.”) gösterilir. “This wave closes … at the latest” ve “The next wave starts …” zamanları gösterir.
Dağıtımın durumu Running, Paused, Completed veya Aborted olabilir.
Otomatik duraklatma
Dağıtım, bir dalga şu durumlarda kendiliğinden duraklar:
| Neden | Gösterilen |
|---|---|
| izin verilenden fazla başarısızlık var | çok fazla cihaz başarısız oldu |
| daha az güncellenmiş cihazla kapanır | çok az cihaz güncellendi |
| hiçbir cihaz tamamlanmadan kapanır | hiçbir cihaz zamanında tamamlanmadı |
“Güncellemeye zaten başlamış cihazlar güncellemeyi tamamlar; biri dağıtımı sürdürene kadar başka hiçbir cihaz güncellemeyi almaz.” Yöneticileriniz uygulama içi bir bildirim alır (“package: the rollout is paused”).
Pause, Resume, Abort
| İşlem | Etkisi |
|---|---|
| Pause | “Siz sürdürene kadar başka hiçbir cihaz güncellemeyi almaz. Güncellemeye zaten başlamış cihazlar güncellemeyi tamamlar; bir güncelleme yarıda güvenli şekilde durdurulamaz.” |
| Resume | “Dağıtım n. dalgayla devam eder.” Otomatik duraklamadan sonra: “Devam etmek, o ana kadar olanları kabul eder: yalnızca yeni başarısızlıklar eşiğe sayılır ve sonunda durdurulan bir dalga geçmiş sayılır.” |
| Abort | “Atamasi kaldırılır. Kurulumu başlamamış cihazlar bu güncellemeyi almaz; başka bir atamayla kapsanan cihazlar o atamaya geçer. Bu işlem geri alınamaz.” |
Dağıtım ayrıca paket iptal edildiğinde, atama kaldırıldığında veya yerine daha yeni bir atama geçtiğinde sona erer.
Bildirimler, denetim ve webhook’lar
| Olay | Webhook | Uygulama içi bildirim |
|---|---|---|
| Bir dalga geçti | ota.rollout.wave_completed | “n. dalganın yeterli cihazı güncellendi. Bir sonraki dalga bekleme süresinden sonra başlar.” |
| Duraklatıldı | ota.rollout.paused | evet |
| Devam ettirildi | ota.rollout.resumed | — |
| Tamamlandı | ota.rollout.completed | “Tüm n dalga geçti. Çevrimdışı olan cihazlar geri geldiklerinde güncellenir.” |
| İptal edildi | ota.rollout.aborted | — |
Her duraklatma, devam ettirme ve iptal, kimin yaptığıyla birlikte denetim günlüğüne yazılır.
İpuçları
- Dağıtımdan önce, Bir cihaz atamalarıyla, fiziksel olarak ulaşabildiğiniz birkaç cihazda paketi test edin.
- Bekleme süresini, sorunların ortaya çıkması için yeterince uzun tutun: sürekli yeniden başlayan bir cihazın başarısız olması zaman alır.
- Ölçümlü bağlantıdaki cihazlar güncellemek yerine beklemede (Waiting) kalabilir; bunlar sonraki dalgaya aktarılır ve dalga kapandığında başarısızlık sayılmaz.