Cihazı güncelleyin
İmzalı bir sürümü çevrimiçi kanaldan ya da çevrimdışı bir paketten kurun, güncelleme sürerken ne olduğunu bilin ve sağlıklı açılmazsa geri alın.
- Sürüm: 0.4
- Rol: admin_user
- Tür: görev
Her CID222 sürümü imzalıdır, cihazda hiçbir şey değişmeden önce doğrulanır ve yeni sürüm sağlıklı açılmazsa kendiliğinden geri alınır. Cihazın interneti varsa sürüm kanalından, yoksa yanınızda taşıdığınız bir paketten sürüm kurarsınız.
Neye ihtiyacım var?
- Lisans
- Any
- Rol
admin_user
Ön koşullar
- Cihaz ilk açılış kurulum sihirbazını tamamladı.
- Panele admin_user rolüne sahip bir kiracıyla oturum açabiliyorsunuz.
- Disk payı: yüklenen bir paket için kabaca paket boyutunun üç katı, çevrimiçi kurulum için 15 GB boş alan. Güncelleyici bu olmadan başlamayı reddeder.
- Çevrimiçi yol için: cihaz sürüm kanalına HTTPS üzerinden erişebiliyor ve kanal sunucusu çevrimiçi kurulumlar için izinli.
- Çevrimdışı yol için: hedef sürümün imzalı .cidupd paketi, tarayıcısı cihaza erişebilen bir makinede.
- Bir bakım penceresi. Panel de değiştirilen konteynerlerden biridir ve veritabanı geçişleri çalışırken yazma işlemleri engellenebilir.
Cihaz hiçbir zaman kendi başına güncelleme denetlemez. Denetim yalnızca siz istediğinizde olur ve işi cihazın ana makinesindeki ayrıcalıklı bir güncelleyici yapar — panel isteği sıraya alır ve güncelleyicinin bildirdiklerini geri akıtır.
Başlamadan önce
Şu sırayla dört şey. İlk ikisi dakikalar alır, atlanan ikisi ise son ikisidir.
- Bir anlık görüntü ya da yedek alın. Güncelleyicinin güncelleme öncesi veritabanı yedekleri bir güncelleme emniyet ağıdır, felaket kurtarma değil: cihazın kendi diskinde dururlar ve yalnızca veritabanını kapsarlar. Ana makine dizinlerini, özel anahtarları ve ortam dosyasını da geri getiren tek kopya, kapatılmış cihazın hipervizör anlık görüntüsüdür. Bkz. Yedekleme ve geri yükleme.
- Diski denetleyin. Güncelleyici, yüklenen bir paket için paket boyutunun kabaca üç katı, bir çevrimiçi kurulum içinse 15 GB boş alan olmadan başlamayı reddeder. Sonradan yer açmak ikinci bir bakım penceresi demektir.
- Pencereyi ayırtın. Veritabanı geçişleri yeni imajlar başlamadan önce çalışır; dolayısıyla hâlâ hizmet veren eski sürüm onların kilitlerine takılır ve pano, değiştirme sırasında yenilenen kapsayıcılardan biridir. Sayfanın süre tahmini, veritabanınızın boyutundan ve gerçekten bekleyen geçişlerden türetilir — geçen seferkini varsaymak yerine onu okuyun.
- Lisans durumunu denetleyin. Süresi dolmuş bir lisans güncellemeyi engellemez — Ayarlar → Sistem Güncellemeleri tasarım gereği her lisans durumunda çalışmayı sürdürür — ama bir katman değişikliğiyle bir güncellemeyi ayrı ayrı düşünmek daha kolaydır. Birini bitirip diğerine geçin.
Bir güncelleme neye dokunur
| Değişen | Dokunulmayan |
|---|---|
| Özet değerine sabitlenmiş kapsayıcı imajları | Lisans ve kurulum bağlaması |
| Sürümün geçişleri üzerinden veritabanı şeması | Verileriniz: kiracılar, kimlik bilgileri, filtreler, oturumlar, tespitler, olay günlükleri |
| Değiştirilen, çalışan kapsayıcılar | Cihazın sunduğu sertifika ve özel anahtarları |
| Cihazın sürüm damgası | Cihazın adresi, ana makine adları ve DNS kayıtları |
| Sürüm yenilerini taşıdığında ana makinenin systemd birimleri | Sihirbazın ve lisansın yazdığı kalıcı dizinler |
Bir güncelleme, paketinizin neye hak verdiğini hiçbir zaman değiştirmez. Yetenekler sürümü değil, lisans dosyasını izler.
Hangi sürümde olduğunuzu denetleyin
Güncelleme sayfasını açın
Ayarlar → Sistem Güncellemeleri seçin.
Installed version (kurulu sürüm) kartı çalışan sürümü ve varsa önceki sürümü ile geri almanın
kullanılabilir olup olmadığını bildirir. Channel (kanal) kartı sürüm kanalını adlandırır ya
da hiçbirinin yapılandırılmadığını belirtir. 0.0.0 sürümü, cihazın yayımlanmamış olduğu değil,
kendi sürüm damgasını okuyamadığı anlamına gelir.
/assets/screenshots/system-updates@0.4.pngBir sürüm kurun
Çevrimiçi kaynağı seçin
Ayarlar → Sistem Güncellemeleri sayfasında Online sekmesini açın.
Update channel (güncelleme kanalı) alanı cihazın yapılandırmasından önceden doldurulur. use a custom URL (özel bir URL kullan) ile Custom manifest URL (özel bildirim URL'si) alanlarını yalnızca bu cihaz, yapılandırıldığından başka bir sunucudan indirmek zorundaysa kullanın.
Kurulumu başlatın
Check & install (denetle ve kur) seçin.
Cihaz kanal bildirimini alır, imzasını doğrular ve sürüm kurulu olandan yeniyse kuruluma başlar. İlerleme sayfada akar. Bir güncellemenin var olduğu zaten biliniyorsa sayfa bunun yerine o sürüm için doğrudan Install (kur) sunar.
Güncelleme sürerken ne olur
Güncelleyici sabit bir sırayla çalışır ve başarısız olan ilk adımda durur:
- Bildirimin ya da paketin imzasını doğrular. İmzasız veya değiştirilmiş bir sürüm reddedilir.
- Sürüm imajlarını, özetleriyle sabitleyerek hazırlar.
- Veritabanının iki yedeğini alır — mantıksal bir döküm ve veri dizininin fiziksel bir anlık
görüntüsü —
/var/lib/cid/backupsaltına. Son 14 döküm saklanır. - Veritabanı geçişlerini önce tek kullanımlık bir kopyaya, prova olarak uygular.
- Geçişleri gerçekten uygular, yeni konteynerleri devreye alır ve sağlık denetiminden geçirir.
- Yeni sürüm sağlıklı açılmazsa önceki sürüme geri döner ve veritabanını 3. adımda aldığı anlık görüntüden geri yükler.
Sayfa, veritabanının boyutundan ve gerçekten bekleyen geçiş sayısından türetilen bir süre tahmini gösterir. Geçişler yeni imajlar başlamadan önce çalışır; bu nedenle hâlâ hizmet veren eski sürüm onların kilitlerine takılır: tahmin yazma işlemlerinin engellenebileceğini söylüyorsa engellenir. Panelin kendisi de devreye alma sırasında değiştirilir, bu yüzden sayfa kendiliğinden kopar ve yeniden bağlanır. Cihazın adresi değişmez.
Warning
Bir sürüm, adını verdiği asgari sürümden eski bir sürümün üstüne kurulmayı reddeder ve güncelleyici sürüm düşürmeyi reddeder. Daha eski bir sürüme dönmek için eski paketi kurmak yerine aşağıdaki geri alma yolunu kullanın.
Geri alın
Geri alma desteklenir ve güncelleyicinin başarısız bir sağlık denetiminde kendiliğinden yaptığı işlemin aynısıdır. Cihazı önceki sürüme döndürür ve o sürüm uygulanmadan önce alınan veritabanı anlık görüntüsünü geri yükler.
Geri almanın kullanılabilir olduğunu doğrulayın
Ayarlar → Sistem Güncellemeleri sayfasında Installed version kartını okuyun.
Kart önceki sürümü adlandırır ve geri almanın kullanılabilir olduğunu belirtir. Belirtmiyorsa, bu cihazın dönebileceği bir önceki sürüm yoktur ve geri alma denetimi devre dışıdır.
Geri alın
Adı verilen sürüm için Roll back to (şu sürüme geri dön) seçin ve onaylayın.
Güncelleyici önce geçerli veritabanının anlık görüntüsünü alır, sonra imajları geri çevirir ve önceki veritabanını geri yükler. Güncelleme uygulandıktan sonra yazılan veriler geri taşınmaz.
Danger
Geri alma, veritabanını güncellemeden önceki hâline döndürür. O andan sonra kaydedilen her şey — oturumlar, tespitler, olay günlüğü kayıtları, yapılandırma değişiklikleri — kaybolur. Geri almayı bozuk bir güncellemeden kurtulmak için kullanın, bir yapılandırma hatasını geri almak için değil.
Geri almanın ne olmadığı — keşfetmek yerine ona göre planlayabilmeniz için:
- İlk güncellemede kullanılamaz. Hiç güncellenmemiş bir cihazın döneceği bir önceki sürüm yoktur ve denetim devre dışıdır. Anlık görüntünün en çok önem taşıdığı güncelleme budur.
- Tam olarak bir sürüm geri gider. Cihazı gelişigüzel eski bir sürüme değil, üzerinde olduğu sürüme döndürür.
- Eski bir sürümü kurma yolu değildir. Güncelleyici sürüm düşürmeyi reddeder ve bir sürüm, adlandırdığı asgari sürümden eski bir sürümün üzerine kurulmayı reddeder.
- Ana makine tarafındaki onarımı geri almaz. Bir sürümün ana makinede kurduğu ya da onardığı bir şey varsa, kapsayıcıları geri döndürmek onu da geri döndürmeyebilir.
Paketinde isteğe bağlı servisler bulunan bir cihazı güncellemek
Bir cihaz, başlatmadığı servislerin — satır içi vekil ya da dizin ilişkilendirme ajanı gibi, bir profilin kapıladığı servislerin — imajlarını da taşır. Güncelleyici bu imajları sürümün parçası sayar; bunun pencereden önce bilinmeye değer iki sonucu vardır:
- Profille kapılanan eksik bir imaj güncellemeyi reddettirir; mesaj, geçerli sürümün imajlarının eksik olduğunu ve bu nedenle geri almanın olanaksız olacağını söyler. Güncelleyici sürümler arasında değişmemiş imajları yeniden çekmez; dolayısıyla bir imaja hiç sahip olmamış bir cihaz bu yolla ona hiç kavuşmaz. Yeniden denemek yerine mesajı CID222 muhatabınıza bildirin.
- Bir profili güncellemeden sonra ilk kez açmak, o imajın manifestoda bulunmasını gerektirir. Eski bir ISO'dan kurulmuş bir cihaz yer tutucu imaj başvuruları taşır; ilk güncelleme bunları manifestonun kendi başvurularıyla değiştirir — bu nedenle profili güncellemeden önce değil sonra etkinleştirin.
Daha fazla servis çalıştıran bir cihazın güncellemesi, daha azını çalıştıranınkinden uzun ve ağırdır: hazırlanacak daha çok imaj, sağlık denetiminden geçecek daha çok kapsayıcı. Pencereyi yalnızca ağ geçidi çalıştıran bir makineye göre değil, bu cihazın gerçekte çalıştırdıklarına göre boyutlandırın.
Doğrulama
- Ayarlar → Sistem Güncellemeleri sayfası Installed version altında yeni sürümü gösterir ve Last update (son güncelleme) çalışmayı eski ve yeni sürümlerle birlikte başarılı olarak bildirir.
- Oturum açın ve bir ürün sayfası açın. Sayfa, cihazın kullanılamadığını bildirmek yerine yüklenir.
- Ayarlar → Lisans hâlâ katmanınızı ve bitiş tarihinizi gösterir. Bir güncelleme lisanslı paketi hiçbir zaman değiştirmez.
- Host repair (ana makine onarımı) kartının gösterildiği yerde, listelediği her geçiş bekliyor veya başarısız değil, uygulanmış olarak okunur.
Başarısız olursa
Sistem Güncellemeleri sayfası 0.0.0 gösteriyor ya da güncelleme düğmeleri 500 döndürüyor
Şunları görebilirsiniz: **Sistem Güncellemeleri** sayfası sürümü 0.0.0 olarak gösteriyor · current version 0.0.0 (kurulu sürüm 0.0.0 görünüyor) · güncelleme denetimi 500 döndürüyor · install update → 500 (güncellemeyi kurma eylemi 500 döndürüyor)
Başlamadan önce
Denetimler
- 1
Cihazın bildirdiği ürün sürümünü okuyun
tanılama · appliance.version = "0.0.0"
- 2
Bir güncelleme kanalının yapılandırıldığını doğrulayın
tanılama · appliance.channel
- 3
Sürüm kanalının son denemede yanıt verdiğini doğrulayın
tanılama · appliance.update.channelReachable = true
- 4
Bir güncelleme ya da ana makine onarımı isteğinin ana makine güncelleyicisini beklerken takılı kalıp kalmadığını denetleyin
tanılama · appliance.update.pendingIntent
- 5
Sayfanın sürümün yanında gösterdiği ana makine onarım durumunu okuyun
GET /admin/system-update/host-repair
Nedenler ve düzeltmeler
| Ne zaman ulaşılır | Neden | Açıklama, düzeltme ve doğrulama |
|---|---|---|
| denetim 1 başarısız olduğunda | version-file-missing (uyarı) | Cihaz, kurulu sürümünü imaj derlemesinin yazdığı bir dosyadan okur. Bu dosya yoksa ya da okunamıyorsa sürüm 0.0.0'a geri düşer ve kanal manifestiyle yapılan her karşılaştırma bir sürüm düşürme gibi görünür — sayfanın aynı anda hem 0.0.0 göstermesi hem de güncelleme sunmayı reddetmesi bu yüzdendir. Düzeltme: Ayarlar → Sistem Güncellemeleri üzerinden ana makine onarımını çalıştırın; bu, cihazın sürüm dosyasını yeniden yazar. Ardından sayfayı yenileyin. Ana makine onarımı kullanılamıyorsa sürüm, kurulum programının sonlandırma adımı yeniden çalıştırılarak da geri getirilebilir; bkz. Güncellemeler. Doğrulama: tanılama · appliance.version = "0.0.0" Bu geçerli değilse: Destek paketini ekleyin. Ana makine onarımından sonra da süren bir 0.0.0, imajın sürüm damgası olmadan derlendiği anlamına gelir. |
| denetim 2 başarısız olduğunda | manifest-url-unset (uyarı) | Yapılandırılmış bir sürüm kanalı yoktur, dolayısıyla güncelleme denetiminin getireceği bir manifest de yoktur. API çağrıyı, eksik manifest URL'sinin adını veren bir 400 ile reddeder; sayfa bunu bir yapılandırma uyarısı olarak değil, başarısız bir düğme olarak gösterir. Düzeltme: Güncelleme kanalını Ayarlar → Sistem Güncellemeleri altında ayarlayın. Ağdan yalıtılmış bir cihazda bir URL göstermek yerine çevrimdışı kanalı seçin ve güncelleme paketini yükleyin. Doğrulama: tanılama · appliance.channel |
| denetim 3 başarısız olduğunda | channel-unreachable (uyarı) | Kanal yapılandırılmıştır ama manifest getirilemedi — ad çözümleme yok, dışarı çıkış yok ya da zorunlu olduğu hâlde yapılandırılmamış bir dış vekil var. Getirme hatası, güncelleme uç noktasından 500 olarak görünür. Düzeltme: Kanal ana makinesine dışarıya erişimi düzeltin, ya da cihazı çevrimdışı güncellemeye geçirin. Tanılama anlık görüntüsündeki DNS ve dışarı çıkış yoklamalarını ayrı ayrı okuyun: çözümlemenin başarılı olması HTTPS getirmesinin de başarılı olduğu anlamına gelmez ve yalnızca vekil üzerinden çıkan bir ağ, vekilin açıkça yapılandırılmasını ister. Doğrulama: tanılama · appliance.update.channelReachable = true |
| denetim 4 başarısız olduğunda | updater-daemon-not-running (kritik) | Kuyruğa bir istek alınmış ama onu çalıştıran hiçbir şey yok. Ağ geçidi yalnızca isteği kaydeder; işi ana makinedeki ayrıcalıklı güncelleyici arka plan süreci yapar. Bu süreç çalışmadığında istekler birikir ve sonraki her eylem takılmış ya da başarısız olmuş gibi görünür. Düzeltme: Cihazın ana makinesinde güncelleyici arka plan sürecini başlatın ve kuyruktaki isteğin kuyruk durumundan çıktığını doğrulayın. Çıkana kadar yeni istek eklemeyin; biriken kuyruk arızayı okumayı zorlaştırır. Doğrulama: tanılama · appliance.update.pendingIntent Bu geçerli değilse: Destek paketine ek olarak ana makinedeki güncelleyici arka plan sürecinin kendi günlüğünü ekleyin. |
| denetim 5 başarısız olduğunda | host-agent-absent (uyarı) | Ana makine onarımı uç noktası yanıt veremiyor, çünkü ana makine ajanı envanterini hiç yazmamış. Sayfanın o zaman sürümün yanında gösterecek ana makine tarafı verisi olmaz ve bu birleşim bozuk bir sayfa gibi okunur. Düzeltme: Cihazda ana makine ajanının envanter işini çalıştırın ve sayfayı yenileyin. Cihaz olmayan bir dağıtımda bu beklenen durumdur: orada hiç ana makine ajanı yoktur ve güncelleme sayfası desteklenen yükseltme yolu değildir. Doğrulama: GET /admin/system-update/host-repair |
- Kanala erişilemiyor → Güncelleme kanalına cihazdan erişilemiyor
- Paket yüklenmiyor ya da reddediliyor → Bir güncelleme paketi yüklenmiyor ya da kurulmuyor. Yalnızca gerçek, üretici tarafından imzalanmış sürümler kurulur; aynı dosyayı yeniden denemek yerine paketi yeniden edinin.
- Güncelleyici sürümü reddediyor ya da yarıda duruyor → Güncelleyici sürümü reddediyor
- Cihaz hangi sürümü çalıştırdığını söyleyemiyor → Cihaz hangi sürümü çalıştırdığını söyleyemiyor
- Güncelleme bitti ve bir sayfa, var olması gereken bir sütunda başarısız oluyor → Bekleyen geçişler var
- Güncelleyici yer yokluğundan başlamayı reddediyor → Bir dosya sistemi neredeyse dolu
- Kurulum çalıştı ve bir hata bildirdi → önceki sürüm zaten yeniden çalışıyordur. Sayfanın gösterdiği mesajı not edin ve onunla birlikte CID222 muhatabınıza başvurun.
Sonraki adımlar
- Yedekleme ve geri yükleme — güncelleyicinin kendi yedeklerinin neyi kapsayıp neyi kapsamadığı.
- Lisanslama ve etkinleştirme — yetenekler sürümü değil, lisansı izler.
- Sıkılaştırma denetim listesi — büyük bir yükseltmeden sonra operatör ayarlarını yeniden gözden geçirin.
Son güncelleme