Skip to main content
CID222 Docs

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.

  1. 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.
  2. 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.
  3. 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.
  4. 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şenDokunulmayan
Ö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ılarCihazı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 birimleriSihirbazı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.

Bir 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:

  1. Bildirimin ya da paketin imzasını doğrular. İmzasız veya değiştirilmiş bir sürüm reddedilir.
  2. Sürüm imajlarını, özetleriyle sabitleyerek hazırlar.
  3. 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/backups altına. Son 14 döküm saklanır.
  4. Veritabanı geçişlerini önce tek kullanımlık bir kopyaya, prova olarak uygular.
  5. Geçişleri gerçekten uygular, yeni konteynerleri devreye alır ve sağlık denetiminden geçirir.
  6. 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

  1. 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.
  2. Oturum açın ve bir ürün sayfası açın. Sayfa, cihazın kullanılamadığını bildirmek yerine yüklenir.
  3. Ayarlar → Lisans hâlâ katmanınızı ve bitiş tarihinizi gösterir. Bir güncelleme lisanslı paketi hiçbir zaman değiştirmez.
  4. 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

Çalışma kitabıupdates

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. 1

    Cihazın bildirdiği ürün sürümünü okuyun

    tanılama · appliance.version = "0.0.0"

  2. 2

    Bir güncelleme kanalının yapılandırıldığını doğrulayın

    tanılama · appliance.channel

  3. 3

    Sürüm kanalının son denemede yanıt verdiğini doğrulayın

    tanılama · appliance.update.channelReachable = true

  4. 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. 5

    Sayfanın sürümün yanında gösterdiği ana makine onarım durumunu okuyun

    GET /admin/system-update/host-repair

Sonraki adımlar

Son güncelleme

Bu sayfada