Güncelleme Akışı
1. Genel Bakış
WHost iki bağımsız güncelleme kanalı taşır:
- WHost yazılım güncellemeleri (satıcı güncelleme servisi → imzalı tarball → atomik yerinde uygulama).
/system/update/*API uçlarının arkasındaki ajan güncelleme servisi ve ajanın günlük güncelleme zamanlayıcısı yürütür. - OS paket güncellemeleri (Debian ailesinde apt-get, RHEL ailesinde dnf). Operatörün tetiklediği yükseltmeler için aynı router'ın
/system/packages/*bloğu, bekleyen listeyi günlük tazeleyip güvenlik sayılarını yüzeye çıkaran zamanlayıcı. Güvenlik güncellemeleri ve PHP yamaları ayrıca işletim sisteminin kendi aracıyla, kendi zamanlayıcısında kendiliğinden kurulur (§6, Kendiliğinden kurulanlar).
İki kanal da root yetkisiyle çalışır, sistem yollarına yazar ve kalıcı bir geçmiş kaydı tutar. İkisi de yönetici kimliğinin arkasındadır (oturum çerezi ya da imzalı anahtar). WHost kanalı agent kodunu değiştirmeden önce yedekler ve hata durumunda geri alır; OS kanalı işi paket yöneticisine bırakır.
2. WHost Yazılım Güncelleme Pipeline'ı
sequenceDiagram
participant Operator
participant API as POST /system/update/install
participant US as update_service.run_install
participant WL as WLicense (check-update / download)
participant FS as dosya sistemi
participant Systemd
Operator->>API: kurulum isteği (GET /system/update/check sonrası)
API->>API: ret: süren kurulum (UPDATE_IN_PROGRESS), süren yedek işi (BACKUP_IN_PROGRESS), henüz kontrol yok (UPDATE_CHECK_REQUIRED), daha yeni sürüm yok (UPDATE_ALREADY_LATEST), bozuk sürüm adı (UPDATE_INVALID_VERSION), daha eski sürüm (UPDATE_DOWNGRADE_REJECTED)
API->>US: asyncio görevi; audit satırı update_install_started
US->>US: indirme URL'sinin host'u lisans sunucularına karşı doğrulanır
US->>FS: backup (%5) — backup_before_update açıksa yalnız agent kodunun tar'ı (/opt/whost/agent/whost_agent, yapılandırma yok) /var/whost/backups/update_<zaman>/ altına (zamanlayıcı bu klasörlerin en yeni üçünü tutar, §5); başarısız yedek loglanır ve koşum sürer
US->>WL: check-update yeniden — yanıt veren node'dan taze indirme token'ı; teklif artık kurulumun başlatıldığı sürüm değilse koşum biter
US->>WL: download (%15) — token'ı üreten node'dan (403 INVALID_TOKEN yanıtlayan, erişilemeyen ve sunucu hatası veren node atlanır; başka her ret koşumu vendor'ın koduyla bitirir), X-WLicense-SHA256 başlığı
US->>US: verifying (%35) — SHA-256 = kontrol yanıtı = başlık
US->>WL: <paket>.asc alınır — aynı node; yalnız 404 "imza yok" demektir, başka her ret koşumu bitirir
US->>US: verifying (%40) — RSA-PSS-SHA256 ayrık imza (gömülü yayın açık anahtarı; eksik ya da geçersiz .asc kurulumu durdurur)
US->>FS: verifying (%45) — boş alan: paketten okunan açılmış boyut bir kez açma için, bir kez daha agent ve panel ağaçlarının yanındaki hazırlık kopyaları için, artı 256 MB, ilgili her dosya sisteminde; alan yetmiyorsa koşum hiçbir şeye dokunmadan biter
US->>FS: extracting (%50) — safe_extract (traversal yok, symlink kaçışı yok, giriş ve boyut sınırı); paketin taşıdığı agent sürümü sunulan sürüm olmalıdır, değilse koşum hiçbir şey değiştirilmeden burada biter
US->>FS: migrating (%60) — paket taşıyorsa migrations/{from}_to_{to}.py (WHost paketleri taşımaz: bir sürümün sunucuda yaptığı değişiklikler ilk açılışında koşar)
US->>FS: migrating (%65) — Python bağımlılıkları: paketin requirements.lock'u (her dağıtım özetleriyle sabitlenmiş; kilit taşımayan paket için requirements.txt) kurulu dağıtımlarla karşılaştırılır (ağ yok); yalnız eksik varsa ortam venv.new'a kopyalanır ve pip kopyanın içinde özet denetimiyle koşar
US->>FS: applying (%70) — üretildiyse venv.new → rename (öncekisi venv.old olarak kalır); agent ağacı whost_agent.new → rename, öncekisi .old olarak kalır; servis birimi + daemon-reload; kurulu requirements.txt ve requirements.lock değişir (öncekisi .old olarak kalır)
US->>FS: applying (%80) — panel.new → rename (paket ne taşırsa taşısın dizin 755, dosya 644: web sunucusu paneli yetkisiz kullanıcıyla okur), öncekisi panel.old olarak kalır; config.json yeniden yazılır
US->>US: health_check (%85) — kurulu ağacın her düz .py modülü bellekte derlenir (bytecode dosyası yazılmaz); bütünlük manifesti değişir (.lock.old / .lock.new)
alt dosyalar değiştirildikten sonra bir adım başarısız
US->>FS: rolling_back — bu koşumun değiştirdiği her şey geri konur (Python ortamı, agent ağacı, servis birimi, requirements dosyası, panel ağacı, manifest), hazırlık kopyaları silinir; geri konan sürüm bu sürecin çalıştırdığı sürümdür, bu yüzden hiçbir şey yeniden başlatılmaz
US->>US: geçmiş kaydı status=rolled_back ve hata; audit satırı update_failed
end
US->>FS: completed (%100) — geçmiş kaydı status=completed restart'tan ÖNCE yazılır; audit satırı update_installed
US->>Systemd: restarting (%100) — kurulum sonrası denetim /var/lib/whost/update-recovery/ altına yazılır (sürüm kaydının kopyasıyla) ve 20 s uyuyan geçici bir servis olarak hemen başlatılır; sonra systemd-run --on-active=3s systemctl restart whost-agent; ilerleme akışı bu aşamada kapanır (açık akış eski süreci nazik kapanış boyunca ayakta tutar; birim bunu 10 s, durdurmayı 30 s ile sınırlar) ve periyodik bellek denetimi yeni süreç açılana dek ertelenir
Note over US,Systemd: restart zamanlayıcısı bu süreç yanıt verdikten sonra ateşlenir; denetim kendi birimi olarak onu aşar
Kurulum sonrası denetim. Bir paket kod denetiminden geçtiği hâlde açılamayabilir (başka bir Python için derlenmiş modül, açılışta düşen bir import). Denetim, restart kuyruğa alınmadan önce başlatılan kendi geçici servisinde çalışır; 20 s uyur, sonra agent'ın sağlık ucunu 5 s arayla en çok 18 kez sorar (yaklaşık 90 s). İlk yanıt denetimi bitirir. (Zamanlayıcı değil servistir: agent'ın kurduğu geçici bir zamanlayıcının, agent birimi restart döngüsündeyken tetiklenme anını sürekli ertelediği ve hiç tetiklenmediği ölçüldü.) Yeni sürüm hiç yanıt vermezse denetim birimi durdurur, güncellemenin değiştirdiklerini geri koyar (whost_agent.old, panel.old, integrity.lock.old, whost-agent.service.old, güncelleme Python paketi kurduysa venv.old, listeyi değiştirdiyse requirements.txt.old — reddedilen agent ağacı, panel ağacı, manifest ve ortam .failed olarak tutulur), kalıcı sürüm kaydını restart'tan önce alınan kopyadan geri yükler, geçmiş satırını rolled_back yapar, birimi yeniden başlatır ve yaptıklarını — geri konan sürümün 10 s sonra yanıt verip vermediğiyle birlikte — agent loguna yazar (whost.update_watch). Rollback ile biten bir koşum restart'a hiç ulaşmaz; onun için denetim kuyruğa alınmaz.
Kanallar ve beta programı. stable isteyen sunucuya yalnız kararlı sürümler sunulur; beta isteyen sunucuya betalar ve kararlı sürümler. Bir beta (X.Y.Z-beta.N) yalnız beta kanalında yayımlanır ve hiçbir zaman zorunlu değildir; bu yüzden security otomatik güncelleme politikası hiçbir betayı kendiliğinden kurmaz (§5). Beta kanalı yalnız beta programına kabul edilmiş lisanslara yanıt verir; kabulü WISECP verir. Kabul edilmemiş bir lisansa kararlı kanaldan yanıt verilir ve kontrol bunu söyler: beta_denied true olur (channel alanı bu sunucunun istediği kanalı adlandırmayı sürdürür) ve sürüm kartı kararlı yanıtla birlikte program notunu ("kararlı kanal kullanıldı") gösterir. Bir betadan kurulan sunucu beta kanalıyla başlar (§8). Bir sürüm önce yalnız listelenen sunuculara açılabilir; listede olmayan sunucuya sürüm genişletilene kadar sunulmaz.
Hangi sürüm sunulur. Satıcının yanıtı iki sürüm adlandırır: bu sunucuya sunulan paket — güncelleme yolunun sıradaki adımı — ve o yolun son sürümü (kararlı sürümler arasında sunulan adımdan daha ileride; ulaşılabilir sürüm yoksa sunucunun kendi sürümü). Sürüm kartı, kurulum, Geçmiş satırı ve geri alma kapısı sunulan paketi kullanır; çıkarmadan sonra paketin içindeki agent ağacının __version__ değeri bu sürüm olmalıdır (paket bütünüyle imzalıdır, yani yeni süreç bu sürümle başlar) ve başka sürüm taşıyan bir paket koşumu hiçbir şey değiştirilmeden bitirir. Kararlı sürümler arasında sunucuya her seferinde bir sürüm sunulur; bir hattın betaları arasında en yenisi.
Bir sürümün Python bağımlılıkları. Paket agent'ın requirements.lock dosyasını — agent'ın ihtiyaç duyduğu, dolaylı gelenler dahil her dağıtım, dizinin o sürüm için sunduğu her dosyanın SHA-256'sıyla tam sürüme sabitlenmiş — ve ondan çözüldüğü gevşek requirements.txt'yi taşır (scripts/release/lock_requirements.py). Hiçbir şey değiştirilmeden önce koşum kilidi (kilit taşımayan paket için gevşek listeyi) agent'ın sanal ortamında (/opt/whost/venv) kurulu dağıtımlarla karşılaştırır: listedeki her satırın adı ve sürümü, ayrıca o dağıtımların (extras dahil) getirdiği paketlerin varlığı. Bu denetim için hiçbir şey indirilmez; yeni bağımlılık getirmeyen bir sürüm, İnternet erişimi olmayan bir sunucuyu eskisi gibi günceller. Eksik varsa ortam /opt/whost/venv.new'a kopyalanır, pip install --require-hashes -r kopyanın yorumlayıcısıyla koşar (en çok 15 dakika; bu adım paket dizinine erişim ister ve kilitteki özetten farklı sunulan dosya reddedilir), pip'in yazdığı konsol betikleri yeniden /opt/whost/venv'i gösterecek şekilde düzeltilir ve uygulama adımı kopyayı yerine alır. Çalışan sürecin içe aktardığı ortama hiçbir zaman kurulum yapılmaz: pip hatası ya da dolu disk (ortamın bir kopyası + 256 MB sığmalıdır) koşumu gerekçesiyle (pip'in son satırları ya da gereken alan) failed bitirir ve kopya silinir; bu adım sırasında durdurulan agent geride bir venv.new bırakır, sonraki koşum onu siler. Başka hiçbir şeye dokunulmamıştır. Sanal ortamdan çalışmayan bir agent, sistem yorumlayıcısının paketlerini değiştirmek yerine böyle bir sürümü eksik paket listesiyle reddeder. İki listenin kurulu kopyası (/opt/whost/agent/requirements.lock, requirements.txt) sürümü izler; ortamı elle onarmak için /opt/whost/venv/bin/python -m pip install --require-hashes -r /opt/whost/agent/requirements.lock yeterlidir. İnternet erişimi olmayan sunucular: listedeki paketler güncellemeden önce ortama kurulur; denetim o zaman eksik bulmaz ve pip koşmaz. Manifest şeması 1.2'den itibaren ortamdaki cryptography, cffi ve certifi dosyaları imzalı bütünlük manifestinin parçasıdır: açılış denetimi, preflight ve 120 saniyelik öz-denetim değişmiş ya da eksik bir dosyaya değişmiş bir ajan dosyası gibi davranır; /opt/whost/venv'e elle kurulan ya da düzenlenen bir paket ajanı durdurur (ajan günlüğünde INTEGRITY_FAILURE: venv hash mismatch: … ya da venv file missing: …) ve onarım yine kilitten yeniden kurulumdur (wheel'in kendi baytları geri gelir). Güncelleme bu dağıtımları manifestin üretildiği kilitten kurduğu için kendi başına bu denetime takılmaz.
Bir koşum nereye kaydedilir. Koşumun adımları agent loguna (/var/log/whost/agent.log) whost.update_service (güncelleme öncesi yedek, manifest, servis birimi, kuyruğa alınan denetim ve restart, reddin gerekçesi) ve whost.router.updates (panelden ya da API'den başlatılan koşumun nasıl bittiği; otomatik kurulumda whost.auto_update_scheduler) adlarıyla yazılır; kurulum sonrası denetim whost.update_watch adıyla yazar. Sonuç ayrıca geçmiş satırında (/admin/updates → Geçmiş; geri almanın gerekçesiyle) ve denetim kaydı satırlarında (update_install_started, ardından update_installed ya da update_failed; otomatik kurulum yalnız sonuç satırını yazar) tutulur. Uygulama adımından restart gerçekleşene — ya da bir geri alma önceki sürümü yerine koyana — kadar agent'ın periyodik öz denetimleri ertelenir, çünkü diskteki dosyalar sürecin yüklediği dosyalar değildir; o pencereye düşen denetim koşmak yerine memory and manifest checks deferred (whost.main) satırını yazar.
Yedekler ve güncelleme hiç çakışmaz. Bir koşum agent'ın yeniden başlatılmasıyla biter ve yeniden başlatma, sürecin o an yaptığı yedek işini keser — kopyalayan ya da yükleyen bir yedeği, yarısı yazılmış bir geri yüklemeyi, saklama adımına gelmemiş bir zamanlanmış yedeği. Bu yüzden böyle bir iş sürerken kurulum 409 BACKUP_IN_PROGRESS ile reddedilir; ileti her işi ve başladığı saati adlandırır (panel hata bildiriminde gösterir), kurulum iş bittikten sonra yeniden başlatılır. Rotanın yanıtıyla koşumun ilk adımı arasındaki anda başlayan yedek işi koşumu aynı iletiyle failed olarak bitirir; hiçbir şey değişmemiştir. Tersi yönde, koşumun ilk adımından süreci yenisiyle değiştiren yeniden başlatmaya kadar panelden ya da API'den başlatılan yedek veya geri yükleme 409 UPDATE_IN_PROGRESS ile reddedilir; vakti gelen zamanlanmış yedek bekler ve güncellemeden sonraki ilk zamanlayıcı turunda koşar. Süren yedek işi bulan otomatik kurulum başarısızlık bildirimi gönderilmeden ertelenir ve bir sonraki günlük denetim yerine 30 dakika sonra yeniden denenir. Başka bir yolla durdurulan süreç (operatörün yeniden başlatması, needrestart, çökme) yedek işini yine kesebilir; sonraki açılış sahipsiz çalışma ağaçlarını arka planda siler — hizmet önce yanıt verir — ve durdurulan sürecin bitiremediği uzak hedef kopyası yedeğin satırında kopyalanmış gibi değil, başarısız olarak işaretlenir ("The remote copy did not finish: the agent stopped during the upload.").
Koşum sırasında durdurulan agent. systemctl restart whost-agent — operatörün yazdığı ya da needrestart gibi bir paket yöneticisi yardımcısının verdiği — koşum kurulu ağaçları takas ederken gelebilir. Koşumun adımları kendi görevinde yaşar; bu yüzden çağıranın ortadan kalkması (zamanlayıcının durdurulması, olay döngüsünün kapanması) adımları kesmez ve agent'ın kapanışı, uygulama adımına ulaşmış bir koşumu 25 sn'ye kadar — birimin 30 sn'lik durma zaman aşımının altında — bekler; shutdown requested while an update is being applied (whost.update_service) satırını yazar ve restart o kadar uzun sürer. Uygulama adımına ulaşmamış bir koşum diskte hiçbir şeyi değiştirmemiştir ve iptal edilir. Bekleme, kod takası ile manifest takası arasında doğrudan öldürülen bir süreci (SIGKILL, güç kaybı) kapsayamaz: sonraki açılışın bütünlük denetimi o çifti reddeder, kurulum sonrası denetim henüz kuyruğa alınmamıştır ve önceki sürüm whost_agent.old'dan (varsa panel.old, whost-agent.service.old, venv.old ve requirements.txt.old ile birlikte) elle yerine konur.
Neden ertelenmiş restart? Agent'ın içinden verilen bir systemctl restart whost-agent birimin durmasını bekler; oysa çalışan birim çağrıyı yapan sürecin ta kendisidir — systemd onu çağrının ortasında durdurur ve koşum kendi adımlarını hiç bitiremez. Çözüm: 3 s sonra, bu süreç yanıtını verdikten sonra ateşlenecek geçici bir systemd-run birimi zamanlamak ve restart döngüsünü systemd'ye bırakmak.
Neden geçmiş restart'tan önce yazılır? Aynı kök neden: kaydı yazan süreç restart'ın yerine koyduğu süreçtir ve yeni süreç koşumdan bellekte hiçbir şey taşımaz; başarı kaydını önce yazmak, restart ne yaparsa yapsın eksiksiz bir geçmiş bırakır.
İşaretçi dosyası yok. Yeni süreç koşumun geride bıraktığı hiçbir şeyi okumaz: kurulumun kaydı geçmiş satırıdır ve update_marker.json yoktur. Restart'ı izleyen tek şey, kendi birimi olarak çalışan kurulum sonrası denetimdir.
Bir sürümün ilk açılışında sunucu sertleştirmesi. Kurucu kurduğu sunucuyu sertleştirir — yönlendirmeyi, tünelleri ve gateway portlarını hosting hesaplarından alan 60-whost-hardening.conf sshd drop-in'i (Match Group whost-accounts bloğu; root ve yönetici oturumları kendilerininkini korur), Postfix istemci başına sınırlar (smtpd_client_message_rate_limit = 100, smtpd_client_connection_rate_limit = 30, anvil_rate_time_unit = 60s), postfix-sasl jail'i, nginx_apache sunucuda Apache'nin Listen 127.0.0.1:8080 satırı, CGI modülleri ve mod_fcgid yüklenmemiş Apache (hesabın .htaccess'i Options ve işleyici ayarlayabilir; PHP her hesabın kendi PHP-FPM havuzuna gider) ve frontend hata ayıklama işaretçisi günlükleri için /etc/logrotate.d/whost kuralı (frontend-*.log, günlük, yedi kopya, kopyala-sıfırla; agent.log ve audit.jsonl kendi döndürücülerinde kalır). Bu adımlardan önce yapılmış bir kurulum onları ajanın kendisinden alır: her açılışta (security.host_hardening_reconcile, varsayılan açık) her adım sunucuyla karşılaştırılır ve yalnız eksik olduğu yerde uygulanır — zaten eşleşen dosyaya dokunulmaz ve hiçbir servis yeniden yüklenmez; bir değişiklik dosyanın yanında damgalı bir yedek bırakır (<ad>.whost-bak-<damga>; logrotate kuralının ve Apache modül dosyalarının kopyaları /var/lib/whost/host_hardening-backups/ altına gider, çünkü logrotate ve Apache kendi dizinlerindeki dosyaları okur), önceki Postfix değerleri kaydedilir ve kayıt /var/lib/whost/host_hardening.json dosyasında durur; servisin kendi testinin (sshd -t, postfix check, fail2ban-client -t, apachectl configtest, logrotate -d) reddettiği değişiklik anında geri alınır ve günlüğe yazılır. logrotate adımı /var/log/whost dizinini zaten adlandıran başka bir kurala ve elle yazılmış bir /etc/logrotate.d/whost dosyasına (frontend-*.log içermeyen) yol verir; ikisi de atlandı diye bildirilir; dağıtılan kuralın eski bir kopyasını taşıyan dosya güncel olana getirilir. Ajan günlüğü açılış başına bir satır taşır (host hardening unchanged: …, host hardening reconciled at start: … ya da host hardening step refused: …, whost.host_hardening altında). Aynı adımlar yeniden başlatma olmadan komut satırından koşar — /opt/whost/venv/bin/python3 -m whost_agent.services.host_hardening_service status|apply|rollback [--dry-run] — ve rollback kaydedilen önceki durumu geri koyar (drop-in geri yüklenir ya da kaldırılır, Postfix değerleri, jail drop-in'i, Apache dinleyicisi, logrotate kuralı), her biri yeniden yüklemeden önce aynı yapılandırma testiyle; kaydedilen bütün adımları birlikte geri alır, tek birini değil. Servis biriminin kendisi bu adımlardan biri değildir: sürümün taşıdığı birim güncelleme koşumunca kurulur (yukarıda); status yalnız kurulu birimin ağaçtaki kopyayla eşleşip eşleşmediğini bildirir.
Çalışma zamanı ortamı kaydı. İmzalı manifestin kapsamadığı — servis birimi ve drop-in'leri, birimin Environment= satırları, yorumlayıcı, yorumlayıcının site dizinlerindeki başlangıç dosyaları (.pth dosyaları, sitecustomize.py, usercustomize.py — yorumlayıcının ajanın hiçbir modülünden önce koşturduğu kod), sanal ortamdaki dağıtımlar (manifestin şema 1.2'den itibaren kendisinin kapsadığı üçü dışında) ve iki gereksinim listesi — her açılışta parmak izine alınır ve önceki açılışın kaydıyla (/var/lib/whost/runtime_env.json) karşılaştırılır: ilk açılış runtime environment baseline recorded (N items; manifest M files), değişmemiş sunucu runtime environment unchanged (…), bir fark ise her öğeyi adlandıran tek bir runtime environment DRIFT (k of N items; …): <öğe> changed/added/removed (…) uyarısı yazar (değişen birim, eklenen drop-in, adıyla eklenen ya da kaldırılan paketler). Bu bilgidir, yaptırım değil: ajan her durumda açılır ve yeni durum temel alınır, böylece bir değişiklik bir kez bildirilir — birimi değiştiren ya da paket kuran bir güncellemeden sonra tam olarak bir DRIFT satırı beklenir. /opt/whost/venv/bin/python3 -m whost_agent.core.runtime_env [--no-record] [--json] aynı karşılaştırmayı istendiğinde basar.
Bir sürümün ilk açılışında nginx snippet'leri. Panelin location snippet'ini (/etc/nginx/snippets/whost-panel-locations.conf) ve webmail snippet'ini (/etc/nginx/snippets/roundcube.conf) installer yazar; ajan bunları başka zaman yalnız hostname, duyurulan IP ya da Force SSL kaydedildiğinde (panel) veya Roundcube panelden kurulduğunda (webmail) yeniden yazar. Yalnız güncellenen bir kurulumun kurulduğu günkü location kümesinde kalmaması için her açılış iki dosyayı — ve phpMyAdmin snippet'ini (/etc/nginx/snippets/phpmyadmin.conf) — çalışan sürümün şablonlarıyla karşılaştırır (webmail ve phpMyAdmin dosyalarını paneli nginx sunduğu her kipte: nginx, nginx + Apache ve nginx'in arkasında çalışan OpenLiteSpeed ile LiteSpeed Enterprise kipleri) ve farklı olanı şablona getirir: dosya yazılır, nginx -t karar verir, nginx yeniden yüklenir; nginx'in reddettiği kopyada (ya da nginx çalıştırılamıyorsa) önceki dosya geri konur. Panel yenilemesi server block'a (sites-available/whost-panel.conf; host adlarını ve sertifika yollarını taşır) dokunmaz, rate-limit bölge dosyasını yalnız yoksa yazar; webmail yenilemesi mevcut dosyanın adlandırdığı docroot'u ve PHP-FPM soketini korur, bunları okuyamadığı dosyayı olduğu gibi bırakır. Temiz kurulum şablonları zaten taşıdığından açılışları hiçbir şey değiştirmez. Değişiklik agent log'una Panel nginx snippet brought to the current template (whost.system_router), Nginx Roundcube snippet written (whost.webmail_service) ve Nginx phpMyAdmin snippet written (whost.phpmyadmin_service) olarak, reddedilen kopya … failed nginx -t — reverted olarak düşer. Webmail location'ı PHP olarak yalnız Roundcube'un index.php'sini ve panelin oturum açma betiğini çalıştırır; Roundcube'un kütüphane, eylem ve çeviri ağaçlarını, eklentilerin sınıf ve kaynak dosyalarını, şemayı, betikleri, yapılandırmayı, çalışma klasörlerini, belge ve paket dosyalarını reddeder. phpMyAdmin location'ı yalnız phpMyAdmin'in giriş noktalarını çalıştırır; örnek, kütüphane, şablon, şema, çeviri ve bağımlılık ağaçlarını, yapılandırmayı ve sürümün belge ve paket dosyalarını reddeder, yerel belgenin bir sayfasını (/phpmyadmin/doc/html/<sayfa>.html) docs.phpmyadmin.net'teki aynı sayfaya yönlendirir.
Bir sürümün ilk açılışında Roundcube. Installer pinlediği Roundcube sürümünü (1.6.21) /usr/share/roundcube altına açar ve var olan ağaca dokunmaz. Ajan, açılıştan üç dakika sonra — arka planda, panel beklemez — daha eski bir ağacı Roundcube'un kendi bin/installto.sh'ının yaptığı gibi o sürüme getirir. Sürüm arşivi indirilir (önce WHost yansısı, sonra GitHub) ve yalnız SHA-256'sı pinlenen değerse kullanılır. Kurulumun bir kopyası yanında hazırlanır (/usr/share/.whost-roundcube-next): sürümün program/ ve vendor/ ağaçları eskilerin yerini alır, bin/, SQL/, plugins/ ve skins/ eskilerin üstüne serilir, kök dosyaları (.htaccess dahil) eskilerinin yerine geçer; config/config.inc.php, panelin oturum açma betiği ve eklentisi, elle eklenmiş bir eklenti ve public_html/ kalır. Ardından sürümün bin/updatedb.sh'ı bu kopyadan koşar ve yeni kodu kurulumun yapılandırması ve eklentileriyle de açmış olur; yalnız başarılı olursa kopya iki yeniden adlandırmayla canlı ağacın yerini alır, önceki ağaç bir sonraki yükseltmeye kadar /usr/share/.whost-roundcube-prev olarak kalır. Düşen indirme ajan çalıştıkça saatte bir yeniden denenir. Pinlenen değer olmayan bir özet, başarısız şema güncellemesi ya da başka bir hata kurulumu olduğu gibi bırakır (yeniden adlandırmalardan sonraki bir hata önceki ağacı geri koyar); iki yeniden adlandırma arasında kurulumu eksik bulan açılış önce önceki ağacı geri koyar. Bir sistem paketinin sahip olduğu ağaç, yapılandırması bağlantı olan (dağıtım düzeni) ya da vendor/'ı Composer'la kurulmuş ağaç olduğu gibi bırakılır. Agent log'u Roundcube upgraded from <eski> to <yeni> (<kaynak>); the previous tree is kept at … (whost.roundcube_upgrade) satırını ya da neden yapılmadığını yazar. İki indirme adresine de ulaşamayan bir sunucuda log satırındaki arşivi başka yerden indirip sunucuya kopyalayın ve /opt/whost/venv/bin/python3 -m whost_agent.services.roundcube_upgrade upgrade --archive <dosya> komutunu çalıştırın (… roundcube_upgrade status kurulu ve pinlenen sürümü gösterir). Önceki bir WHost sürümüne dönmek Roundcube'u geri götürmez; önceki ağaç elle geri konur — mv /usr/share/roundcube /usr/share/.whost-roundcube-new && mv /usr/share/.whost-roundcube-prev /usr/share/roundcube — ve daha yeni Roundcube'u pinleyen bir sürüm bir sonraki açılışında onu yeniden yükseltir.
3. Aşama İlerlemesi
Panel canlı ilerleme için bir Server-Sent Events akışına abone olur (GET /api/v1/system/update/status/stream; tarayıcının EventSource'u başlık gönderemediği için bundle-fingerprint başlığından muaf, oturum çerezi ya da imzalı anahtarla kapılı). Pipeline'ın yayımladığı aşamalar ve ilerleme yüzdeleri:
| Aşama | % | Not |
|---|---|---|
idle |
0 | Süren kurulum yok (akış tek olay verir ve kapanır) |
backup |
5 | agent kodunun tar'ı (backup_before_update kapalıysa atlanır) |
downloading |
15 | vendor'dan taze token istenir (token beş dakika ve yalnız onu üreten node'da geçerlidir), sonra paket o node'dan alınır |
verifying |
35 → 45 | kontrol yanıtı ve başlığa karşı SHA-256, sonra .asc yayın imzası, sonra boş alan denetimi |
extracting |
50 | safe_extract üye yürüyüşü, ardından paketin taşıdığı sürüm |
migrating |
60 → 65 | paket taşıyorsa migrations/{from}_to_{to}.py (WHost paketleri taşımaz), ardından Python bağımlılık denetimi (yalnız eksik paket varsa ortamın kopyasında pip koşumu — dakikalar sürebilir) |
applying |
70 → 80 | üretildiyse ortam değişimi, atomik agent değişimi + servis birimi + requirements dosyası, sonra panel değişimi |
health_check |
85 | kurulu ağacın her düz .py modülü bellekte derlenir, bütünlük manifesti değişimi |
completed |
100 | geçmiş yazıldı, ertelenmiş restart bekliyor |
restarting |
100 | kurulum sonrası denetim başlatıldı, systemd-run restart'ı kuyruğa alındı; akış bu aşamada kapanır |
rolling_back → rolled_back |
0 | dosyalar değiştirildikten sonra bir adım başarısız oldu; koşumun değiştirdiği geri konur |
failed |
0 | koşum hiçbir şeyi değiştirmeden bitti (ya da geri alması tamamlanamadı) |
Her olay durum anlık görüntüsüdür (stage, progress, message, error, sürümler), 2 s'de bir. Akış completed, failed, rolled_back, idle ve restarting'de kapanır; eski süreç yeniden başlarken tarayıcı akışın düştüğünü görür ve yeni süreç yeni current_version ile ilk olayını verene dek akışı 3 s'de bir yeniden açar, sonra sayfayı yeniler. O yanıt 60 s içinde gelmezse sayfa beklemeyi bırakır ve agent'ın geri gelmediğini söyler (güncelleme yine de tamamlanmış olabilir: sayfayı yenileyip sürümü kontrol edin).
4. Geri Alma (Rollback)
sequenceDiagram
participant US as update_service
participant Live as /opt/whost/agent + /var/www/whost/panel + /etc/whost/integrity.lock + whost-agent.service
Note over US: bir uygulama adımı, kod denetimi ya da manifest değişimi başarısız oldu
US->>US: stage = "rolling_back"
US->>Live: venv.old yeniden venv olarak adlandırılır (yalnız bu koşum ortamı değiştirdiyse); requirements.txt ve requirements.lock .old kopyalarından geri yüklenir
US->>Live: whost_agent.old mevcut agent ağacının üstüne geri adlandırılır, whost_agent.new silinir
US->>Live: bütünlük manifesti .lock.old'dan geri yüklenir (yalnız bu koşum değiştirdiyse)
US->>Live: servis birimi .old kopyasından geri yüklenir (yalnız bu koşum değiştirdiyse)
US->>Live: panel.old panel ağacının üstüne geri adlandırılır, panel.new silinir
US->>US: geçmiş kaydı status=rolled_back ve error_message; audit satırı update_failed
Geri konan sürüm çalışan sürecin açıldığı sürümdür; bu yüzden rollback hiçbir şeyi yeniden başlatmaz: operatör hata kartını agent'ın gerekçesiyle görürken servis yanıt vermeyi sürdürür.
Atomik rename kalıbı sayesinde başarısız bir kurulum ya .new hazırlık dizinini yerinde bırakmıştır (etkisiz, rollback siler) ya da rename'i tamamlamıştır (rollback geri çevirir). Yarım uygulanmış agent ağacı yoktur ve panel agent'ı izler: geri alınan kurulum yine önceki paneli sunar.
Rollback, başarısız koşumun kendi değiştirdiğini geri alır, başka hiçbir şeyi değil. Her uygulama adımı önce daha eski bir güncellemeden kalan .old kopyasını siler; bu yüzden rollback sırasında bulunan bir .old ağacı ya da integrity.lock.old yalnız kurulum başladığında çalışan sürüme ait olabilir — reddedilen ikinci bir güncelleme, çalışan sürümün altına daha eski bir sürümün manifestini, panelini ya da kodunu asla geri koymaz. Uygulama adımlarından önce reddedilen paket (sağlama, imza, açma) hiçbir şeyi değiştirmez; rollback ve restart tetiklenmez.
Kod denetiminden geçtiği hâlde açılamayan bir paket (örneğin başka bir Python için derlenmiş modül) yukarıda anlatılan kurulum sonrası denetimle geri alınır; .old ağaçları bir sonraki kuruluma kadar yerinde durur ve geri alma, reddedilen ağaçları tanı için .failed olarak yanlarında bırakır. Denetimin kendisi önceki sürümü geri getiremezse log satırları bunu söyler ve kurtarma bu kopyalardan elle yapılır. venv.old ağaçlarla aynı kurala uyar: her koşum, kendisi ortam üretsin ya da üretmesin, daha eski bir güncellemeden kalan kopyayı siler; böylece bir geri almanın ya da kurulum sonrası denetimin bulduğu ortam her zaman çalışan sürümün başlatıldığı ortamdır.
Geri alma /etc/whost/agent.conf dosyasına ve /var/lib/whost/ altındaki verilere dokunmaz. Bunun görünür iz bıraktığı tek durum şudur: whitelabel logolarını dosya olarak tutan bir sürüm, agent.conf içinde hâlâ satır içi duran logoları ilk açılışında /var/lib/whost/branding/ altına taşır (configuration.tr.md › whitelabel). Bu sürümün ardından dosyalardan önceki bir sürüme geçilirse — böyle bir açılıştan sonra kurulum sonrası denetimin önceki sürümü geri koyması ya da elle sürüm düşürme — panel, /var/lib/whost/branding-legacy-<zaman>.yaml dosyasında saklanan özgün değerler agent.conf'un whitelabel bloğuna geri kopyalanıp agent yeniden başlatılana kadar özel logo göstermez.
5. Otomatik Güncelleme Zamanlayıcısı
Zamanlayıcı, ajanla birlikte başlayıp duran bir arka plan görevidir:
GET /api/v1/system/update/status'u — son kontrolün saklanan sonucunu — okur; bu yüzden bir yönetici sayfasının yüklenmesi satıcıyı hiç sorgulamaz, yalnız zamanlayıcı ve güncellemeler sayfasının kendi kontrolü sorgular/var/whost/backups/update_<zaman>/) en yeni üçü dışındakileri sil, (1) check_for_updates() — canlı satıcı sorgusu, (2) OS paket önbelleğini tazele (os_packages_check_enabled açıkken), (3) aşağıdaki bildirimleri gönder (güncelleme mevcut bildirimi yalnız notify_available açıkken), (4) auto_update açıksa ve sürüm farkı auto_update_type ile eşleşiyorsa otomatik kur — yedek, geri yükleme ya da zamanlanmış yedek sürerken ertelenir ve 30 dk sonra yeniden denenirsecurity (yalnız satıcının zorunlu işaretlediği ve yalnız allow_vendor_critical_override ile; bu izin olmadan bu mod yalnız bildirir), patch (aynı X.Y: bir patch adımı), minor (aynı X: bir minor ya da patch adımı), all (yeni bir major dahil her adım). Bir beta (X.Y.Z-beta.N) kendi X.Y.Z'sine göre ölçülür: aynı numaranın sonraki betası ve kararlı sürümü patch adımıdır; başka bir ek taşıyan sürüm kendiliğinden hiç kurulmaz. Varsayılan (security) hiçbir betayı kendiliğinden kurmaz, çünkü beta sürümü zorunlu olamaz — yönetici bildirim alır ve panelden kurarallow_vendor_critical_override — açıkken satıcının "zorunlu" işaretlediği güncellemeler auto_update_type'tan bağımsız otomatik kurulur/var/whost/update_notify_state.json içinde kalıcı — aynı üst sürüm restart'lar boyunca iki kez bildirilmez; damga bir otomatik kurulumdan sonra temizlenir. notify_available kapalıyken hiçbir şey gönderilmez ve damga olduğu yerde kalır; anahtar yeniden açılınca hâlâ sunulan sürüm bir sonraki kontrolde bildirilirZamanlayıcı bilinçli olarak tembeldir: her korumalı endpoint her istekte zaten lisans denetiminden geçtiği için 24 saatte tek kontrol yeter. Üst kaynağı dakikada bir yoklamaya gerek yoktur.
6. OS Paket Kanalı
Sistem düzeyi güncellemeler için ayrı, daha basit bir pipeline:
sequenceDiagram
participant Operator
participant API as POST /system/packages/upgrade
participant Apt as apt-get / dnf
participant Status as GET /system/packages/upgrade/status
Operator->>API: {security_only, package_names?}
API->>API: paket adlarını doğrula (model regex'i; bekleyen listede olmayan ad → 422)
API->>API: tek yükseltme yuvasını al (bellek içi; süren iş 200 ile canlı durumunu döner)
API->>API: denetimli koşu run.lock'u tutuyor (/proc/locks'tan okunur) → 409 OS_UPGRADE_IN_PROGRESS; PHP sürüm işi → 409 PHP_PACKAGE_JOB_IN_PROGRESS; web sunucusu eklentisi işi → 409 PLUGIN_TASK_IN_PROGRESS
API->>Apt: arka plan görevi (argv listesi, shell yok), panel-work.lock paylaşımlı tutulur
API-->>Operator: 200 {stage: "running", ...} (hemen döner, polling)
loop bitene kadar
Operator->>Status: GET status
Status-->>Operator: {stage, progress, message, upgraded, output_tail}
end
Apt->>Apt: geçmişi yaz /var/whost/os_packages_history.json (son 100 deneme), bekleyen önbelleği tazele
Doğrulama: paket adları ^[a-z0-9][a-z0-9.+\-]*$ (apt'nin kendi ad biçimi) ve bekleyen listeye karşı kontrol edilir. Uyumsuzluk apt'ye ulaşmadan 422 döner. Shell yoktur — agent apt'yi argv listesiyle çağırır.
Yalnız güvenlik modu: security_only=true iki ailede de bekleyen listenin güvenlik güncellemesi saydığı paketleri adlarıyla kurar. Debian ve Ubuntu'da bir paket, apt-get --just-print upgrade'in onun için yazdığı kaynaklardan biri bir güvenlik cebiyse (-security; -updates'e de yayımlanan sürüm ikisini birden yazar) ya da güncellemeleri güvenlik güncellemeleriyle birlikte giden bir depoysa — Ondřej Surý'nin PHP PPA'sı, Debian'daki Sury deposu, deadsnakes PPA'sı (Ubuntu 22.04'te ajanın Python'u) — güvenlik güncellemesidir; simülasyon kaynağı Release etiketiyle yazar, ajan etiketi apt-cache policy üzerinden deponun origin'ine eşler. RHEL ailesinde dnf updateinfo list security'nin adını verdiği bir paket ya da bülten taşımayan Remi PHP derlemelerinden biridir (php<NN>-php-*, php<NN>-runtime). Bekleyen güvenlik güncellemesi yoksa iş hata olarak değil, "No security updates available." iletisiyle completed olarak biter.
Kendiliğinden kurulanlar (denetimli koşu): os_packages_auto_security açıkken WHost'un kendi koşusu güncellemeleri her gece, gece yeniden başlatma penceresinden bir saat önce (varsayılan 04:30 ile 03:30), ajan çalışsa da çalışmasa da kurar. Sistemin kendi araçlarıyla çalışan bir bash betiğidir (/usr/local/sbin/whost-os-update, whost-os-update.timer başlatır); bir güncellemenin bozduğu şey ajan ya da ajanın Python'u olsa da çalışır. Yedek işi /var/lib/whost/backup-work.lock'u tutarken en çok üç saat bekler; gece yeniden başlatma, koşu sürerken penceresini atlar. İşletim sisteminin kendi kurulum koşusu (unattended-upgrades, dnf-automatic, Remi PHP yama zamanlayıcısı) kapalıdır: Debian ve Ubuntu'da APT::Periodic::Unattended-Upgrade "0", RHEL ailesinde iki zamanlayıcı durdurulur.
- Plan.
os_packages_auto_modekoşunun neyi alacağını belirler:security(varsayılan — bekleyen listenin yukarıda güvenlik güncellemesi saydığı paketler) ya daall(bekleyen her güncelleme). İki kipte de veritabanı (mariadb*,mysql-*,galera*,libmariadb*) yalnız kendi serisinin güvenlik düzeltmelerini alır — öteki veritabanı güncellemeleri, önce bütün veritabanlarının dökümünü alan panel veritabanı güncellemesine, sıradaki seriye geçiş de panelin seri yükseltmesine (aşağıda) bırakılır — ve çekirdek yalnız güvenlik düzeltmelerini alır; bunları gece yeniden başlatma devreye sokar ve hiçbir zaman geri alınmazlar (önceki çekirdek kurulu kalır). Yeni gelecek (yükseltme olmayan) bir paket elle koşuyu bekler. - Kurulu sürümü sakla. Hiçbir şey kurulmadan önce her paketin kurulu sürümünün dosyası
/var/lib/whost/os-update/archive/<paket>/altında saklanır: o arşivden, paket önbelleğinden, depolardan (apt-get download/dnf download) ya da kurulu dosyalardan yeniden paketlenerek (dpkg-repack/rpmrebuild, ajan kurar). Kurulu sürümü saklanamayan paket koşu tarafından kurulmaz: nedeniyle birlikte elle koşu için listelenir. Ubuntu'da daha yenisi yayımlanınca bir sürüm depolardan kalkar (güvenlik cebinde de değilse) ve EPEL yalnız en yeni sürümü tutar; arşiv bu yüzden önemlidir: her koşudan sonra yeni kurulan sürümün ve ondan öncekinin dosyasını tutar. - Grup grup. Paketler gruplar hâlinde gider — web sunucusu ve WAF modülü, PHP, posta, FTP/DNS, veritabanı, ajanın Python'u, diğer, çekirdek — her biri tam sürümleriyle. İşlemi saklanan dosyası olmayan bir paketi de yükseltecek, bir paketi kaldıracak ya da (çekirdek grubu dışında) yeni bir paket getirecek grup elle koşuya bırakılır. Her gruptan sonra hâlâ değişmiş dosyalarla çalışan WHost servisleri yeniden başlatılır ve aşağıdaki sağlık denetimi ilk gruptan önce alınan denetime karşı koşar.
- Geri al ve beklet. Önce geçen bir denetim bir gruptan sonra başarısız olursa grubun paketleri saklanan dosyalara döner, denetim yeniden koşar ve bozan sürüm daha yenisi yayımlanana kadar bekletilir (
/etc/apt/preferences.d/90whost-os-update-locksiçinde önceliği -1 olan bir apt pin'i; RHEL ailesinde bir versionlock dışlaması); daha yeni bir sürüm çıkınca sonraki koşu bekletmeyi kaldırır. Her koşu/var/lib/whost/os-update/runs/<id>.jsondosyasına yazılır (paket başına: kaynak, hedef, sonuç, neden; grup başına: sonuç ve başarısız olan denetimler). - Birim durumu korunur. Bir paketin betikleri sunucunun kapalı tuttuğu bir servisi, soketi ya da zamanlayıcıyı açabilir ya da etkinleştirebilir (openlitespeed'inkiler sunucusunu başlatır ve açılışta etkinleştirir; bir sonraki yeniden başlatmada web portlarını nginx'ten alırdı) ya da sunucunun açık tuttuğu birini devre dışı bırakabilir. İlk paket işleminden önce koşu her servisin, soketin ve zamanlayıcının etkinlik (
enabled,disabled,masked) ve çalışma durumunu alır; her paket işleminden sonra — bir grubun kurulumu, geri alması, bir geri alma (undo), veritabanı güncellemesi — ve ardından gelen denetimden önce farklılaşan birim geri konur: etkinliği eski hâline, çalışmayan bir birim durdurulur (etkin olup çökmüş ve şimdi çalışan birim çalışır bırakılır). İşlemle gelen birim geldiği gibi bırakılır, işlemin durdurduğu birim yeniden başlatılmaz (WHost'un servisleri sağlık denetiminde); ikisi de listelenir. Şablonlar ve örnekleri, WHost'un kendi birimleri (whost-*) ve bir paketin kendi getirdiği maske dışarıda kalır. Koşu kaydı bu birimleri listeler (units: birim, hangi işlemden sonra bulunduğu, koşudan önceki, işlemden sonraki ve koşunun geri koyduğu durumu, sonuçrestored,restore_failed,stoppedya danew; koşu klasörü durumlarıunits-<işlem>.tsvolarak tutar); Güncellemeler › Geçmiş koşunun ayrıntısında gösterir, koşunun bildirimi adlandırır. Geri konamayan birim koşuyu kritik bildirimlefailedbitirir.
Sağlık denetimi: /usr/local/sbin/whost-os-check (bash, sistemin kendi araçları) kurulu her web sunucusunun yapılandırmasını, izlenen ve etkin servisleri, WHost'un kendi gizli kanarya sitesini (whost-canary.invalid, yalnız sunucunun kendisine yanıt verir, /var/www/whost-canary altında) — statik bir sayfa, WAF'ın kipine göre yanıtladığı bir istek ve kurulu her sürüm için o sürümün paylaşılan havuzundan geçen bir PHP sayfası; barındırılan bir sitenin isteğinin izlediği yoldan (nginx'ten doğrudan PHP-FPM'e ya da Apache önünde nginx) — paneli ve ajanı, SMTP / IMAP / FTP karşılamalarını, PowerDNS'e bir DNS sorusunu ve bir veritabanı sorgusunu (kurucunun /root/.my.cnf'iyle) denetler. Neyi denetleyeceğini ajan /etc/whost/os-update/check.conf'a yazar. Yalnız önce geçen denetim değerlendirilir; başarısız olan, servisler otururken yeniden denenir. Her açılıştan üç dakika sonra da son temiz denetime karşı koşar (whost-os-check.timer). Bulgu kritik bir bildirimdir (aşağıda); ajan çalışmazken bulunan, ajan açılınca bildirilir.
Panelden: POST /system/update/os-security/runs/{run_id}/undo bir koşunun paketlerini arşivden geri koyar (çekirdek dışında) ve kaldırılan sürümleri bekletir; DELETE /system/update/os-security/locks/{name} bir bekletmeyi kaldırır; POST /system/update/os-security/database bütün veritabanlarının dökümünü alır (son üçü /var/lib/whost/os-update/db-backups/ altında tutulur) ve ardından kurulu serinin veritabanı güncellemelerini kurar. GET /system/update/os-security kipi, süren bir koşunun başlangıcını (running_since: klasörü var, sonucu henüz yok ve kilidi tutuluyor), son koşuları, elle koşuya bırakılan güncellemeleri, bekletilen sürümleri ve son denetimi yanıtlar. Her eylem kendi birimini başlatır ve hemen yanıt verir; panel bir koşu sürerken durumu yeniden okur.
MariaDB seri yükseltmesi (panelden, hiçbir zaman gece değil): GET /system/update/os-security/database/series desteği süren sıradaki uzun destekli seriye geçişi planlar — ajan uzun destekli serilerin ve destek bitiş tarihlerinin tablosunu taşır, desteği biten seri atlanır (10.5 doğrudan 10.11'e gider). Plan kaynağı söyler: seriyi taşıyorsa dağıtımın depoları (RHEL ailesinde mariadb:10.11 gibi bir AppStream modül akışı), değilse MariaDB'nin o seri için deposu (deb.mariadb.org/<seri>/<dağıtım>, /etc/apt/sources.list.d/whost-mariadb.sources içinde, anahtar /etc/apt/keyrings/whost-mariadb.gpg; ya da rpm.mariadb.org/<seri>/rhel/<ana sürüm>/<mimari>, /etc/yum.repos.d/whost-mariadb.repo içinde; yalnız MariaDB'nin yayımladığı parmak izini taşıyan imza anahtarı alınır). Ayrıca veri klasörünü, boş diskin veri klasörünün kopyası + döküm + 1,5 GB payın gerektirdiğine karşı durumunu, salt okunur sürenin tahminini, örneklenen siteleri (veritabanı olan, askıda olmayan hesapların ana sayfası; daha fazlası varsa rastgele 25'i) ve başlatmayı neyin engellediğini söyler. POST /system/update/os-security/database/series ({"target": "<seri>"}) /etc/whost/os-update/db-series.conf'u yazar ve whost-os-update db-series'i kendi biriminde (whost-os-update-db-series-<zaman>) gece koşusunun kilidiyle başlatır — gece koşusu ve gece yeniden başlatması onu bekler:
- Sakla ve indir. Kurulu her veritabanı paketinin dosyası saklanır (yukarıdaki 2. adımdaki gibi; saklanamayan sürüm koşuyu hiçbir şey değişmeden durdurur), kaynak hazırlanır ve yeni seri indirilir; veritabanı grubu dışından paket kaldıracak bir işlem reddedilir.
- Salt okunur pencere.
read_onlyaçılır ve/var/lib/whost/os-update/db-series/windowyazılır.read_onlyroot dışındaki her hesabı durdurur; bu yüzden işaret dosyası durdukça ve koşu kilidini tuttukça ajan kendi root yazmalarını (havuzluMySQLClient)409 DATABASE_UPGRADE_IN_PROGRESSile reddeder, okumalar sürer. Durum ölçülür — her tablo ve görünüm açılıyor mu, sağlık denetimi, Postfix, Dovecot, PowerDNS, Pure-FTPd'nin veritabanı sorguları ve panelin TCP root girişi, örneklenen siteler — bütün veritabanlarının dökümü alınır (db-backups/db-series-<koşu>.sql.gz, 7 gün tutulur), MariaDB durur, veri klasörü ve yapılandırmasıdb-series/<koşu>/altına kopyalanır. - Yeni seri. MariaDB yapılandırma klasöründeki
99-whost-db-window.cnfsunucuyu yeniden başlatmalar boyunca salt okunur tutar. Yeni seri kurulur (Debian ve Ubuntu'da birpolicy-rc.dpaket betiklerinin onu açmasını engeller), birim durumu yukarıdaki 5. adımdaki gibi korunur (kurulumdan hemen önce, MariaDB kopya için durdurulmuşken alınır; RHEL ailesinde yeni adla kurulan MariaDB paketi dağıtımın paketiyle paylaştığı birimin etkinliğini kaldırır, koşu sunucu açılmadan önce onu yeniden etkinleştirir), açılır,mariadb-upgradeile yükseltilir, yeniden başlatılır ve yeniden ölçülür: önce açılıp şimdi açılmayan tablo, yeniden başlatmadan sonra sunucunun günlüğünde yeni bir[ERROR]satırı ya da önce geçip şimdi kalan bir denetim, sorgu veya site başarısızlıktır (kalan sorgu 60 saniye boyunca, site iki kez daha sorulur; havuzlu istemciler yeniden başlatmadan sonra yeniden bağlanır). - Aç ya da geri koy. Temizse pencere kapanır (
read_only = 0), kopya silinir ve MariaDB'nin deposu seriye sabit kalır — Release etiketiMariaDB(Debian, Ubuntu) ya da depo kimliğiwhost-mariadb(RHEL ailesi) gece koşusu için güvenlik kaynağı sayılır; gece koşusu serinin yamalarını denetimli kurar. Kalırsa önce veri klasörü ve yapılandırma kopyadan geri konur (Debian ve Ubuntu'da eski serinin paket betikleri daha yeni bir serinin bayrağını taşıyan veri klasörünü kenara taşır), sonra eski paketler saklanan dosyalarından (yalnız yeni seride olan paket kaldırılır; birim durumu yeniden korunur), sonra yapılandırma bir kez daha; yükseltme için eklenen kaynak ya da modül akışı geri alınır, eski seri salt okunur açılır, aynı şekilde denetlenir ve yazmaya açılır. Temiz geri gelmeyen geri koymafailedbiter; döküm kalır, eski seri geri konamadıysa ya da açılmadıysa kopya da.
Seri yükseltmesi başarıdan sonra geri alınamaz — POST /system/update/os-security/runs/{run_id}/undo seri koşusunu ve ondan önceki her koşuyu reddeder, çünkü geri dönmek o zamandan beri yazılanı kaybettirirdi. Yarıda kesilen koşuyu (yeniden başlatma, birimin durdurulması) ajan failed olarak yazar ve kritik bildirim gönderir; kopyası ve dökümü kalır, pencere dosyası durdukça sunucu salt okunur açılır. GET /system/update/os-security database alanını taşır: kurulu seri ve sürüm, sıradaki seri ve destek bitişi, süren bir seri yükseltmesinin koşusu ve aşaması.
Eşzamanlılık: aynı anda tek yükseltme işi; biri sürerken ikinci POST yenisini başlatmak yerine canlı durumu döner. Uç adres başına saatte iki başlatma kabul eder (üçüncüsü 429 alır). İş sürerken GET /system/packages/updates dpkg kilidi altında apt çalıştırmak yerine önbellekteki listeyi verir. İş ile denetimli koşu paketleri hiçbir zaman yan yana değiştirmez — işin koşunun adımları arasında değiştirdiği bir paketi koşunun denetimi ve geri alması görmezdi. Bir koşu /var/lib/whost/os-update/run.lock'u tutarken (gece koşusu, geri alma, veritabanı güncellemesi, seri yükseltmesi) POST 409 OS_UPGRADE_IN_PROGRESS ile reddedilir; ajan kilidi çekirdeğin kilit tablosundan okur, hiç almaz. İş çalıştığı sürece /var/lib/whost/os-update/panel-work.lock'u paylaşımlı tutar ve onu aldıktan sonra koşu kilidini yeniden okur: arada başlamış bir koşu işi hiçbir şey kurmadan failed bitirir. Koşu önce kendi kilidini, ardından panel-work.lock'u özel alır; böylece süren bir işi planlamadan önce bekler (en çok bir saat — test için saniye cinsinden WHOST_OS_UPDATE_PANEL_WAIT; bekleme koşu kaydında waited_for_panel, beklemesi dolan koşu failed yazılır, hiçbir şey kurulmaz, çıkış kodu 1). Her taraf ötekine bakmadan önce kendi kilidini aldığı için biri ötekini her zaman görür. Panelden başlatılan öteki paket işleri için de aynısı geçerlidir — PHP sürüm kurma ya da kaldırma (services/php_version_jobs.py) ve bir web sunucusu eklentisinin etkinleştirilmesi, devre dışı bırakılması ya da güncellenmesi (services/plugin_service.py: adımları apt / dnf, lsup.sh ya da LSWS install.sh çalıştıran ve lshttpd'yi değiştiren OpenLiteSpeed / LiteSpeed Enterprise). Her tür yuvasını services/panel_package_work.py üzerinden alır; o, koşu kilidi tutulurken ya da üç işten biri sürerken reddeder ve hata kodu süren işi adlandırır (OS_UPGRADE_IN_PROGRESS, PHP_PACKAGE_JOB_IN_PROGRESS, PLUGIN_TASK_IN_PROGRESS); ajan talepleri sırayla aldığı için birlikte istenen iki iş ikisi birden geçemez. PHP işi ve eklenti işi, yükseltme işinin yaptığı gibi çalıştıkları sürece panel-work.lock'u paylaşımlı tutar: koşu onları bekler (günlüğünde "waiting for the package work started from the panel"), arada başlamış bir koşu ise onları hiçbir şey değiştirmeden bitirir (arka plan eklenti etkinleştirmesinin görevi failed biter). Bu işlerden biri sürerken seri yükseltmesi engelleri arasında running gösterir. Çalışma zamanı eklentileri (Python / Node.js barındırma) yalnız ayar değiştirir, bekletilmez. Olduğu gibi kalanlar: denetimli koşunun kendi araçları (dpkg-repack / versionlock eklentisiyle rpmrebuild, unattended-upgrades / dnf-automatic) — yalnız eksiklerse, ajan açılışında ya da ayar kaydında kurulur — ve hiçbir paketi değiştirmeyen paket dizini yenileme ile tarama (koşunun apt-get update'i apt'nin kilitlerini on dakikaya kadar bekler).
Liste okumanın maliyeti: GET /system/packages/updates her çağrıda apt-get update ve bir deneme yükseltmesi çalıştırır (doksan bekleyen paketli bir sunucuda yaklaşık on saniye); panel bunu Sistem Güncellemeleri sayfası (/admin/updates) açıldığında — hangi sekme açık olursa olsun; OS Paketleri sekmesinin etiketi sayıyı taşır — ve en çok beş dakikada bir okur; topbar rozeti önbellekteki /system/packages/summary'yi okur.
7. Bildirim Yüzeyi
| Olay | Alıcı | Kanal | Tekilleştirme |
|---|---|---|---|
Güncelleme mevcut (zamanlayıcı kontrolü; yalnız notify_available açıkken) |
admin | bildirim ayarlarına göre panel bildirimi + e-posta (bu olayın olay matrisinde kendi satırı var) | last_notified_version |
| Bekleyen OS güvenlik güncellemeleri (zamanlayıcı tazelemesi; yalnız sayı arttığında) | admin | bildirim ayarlarına göre panel bildirimi + e-posta (update kategorisi) |
last_os_security_count |
Otomatik kurulum tamamlandı (yalnız notify_installed açıkken) |
admin | bildirim ayarlarına göre panel bildirimi + e-posta (update kategorisi) |
ardından damga temizlenir |
| Otomatik kurulum başarısız (iki bildirim anahtarından bağımsız) | admin | panel bildirimi + e-posta (kritik: panel ya da e-posta kanalı açıksa gönderilir) | — |
OS güncellemeleri kuruldu ve denetlendi (os_update_installed) |
admin | bildirim ayarlarına göre panel bildirimi + e-posta (update kategorisi) |
koşu başına bir |
Bir OS güncellemesi başarısız denetimden sonra geri kondu (os_update_rolled_back; paketleri ve başarısız denetimleri adlandırır) |
admin | panel bildirimi + e-posta (kritik) | koşu başına bir |
Denetimli koşu temiz bitmedi (os_update_failed) |
admin | panel bildirimi + e-posta (kritik) | koşu başına bir |
Panelden geri alınan koşu (os_update_undone) |
admin | panel bildirimi + e-posta (bilgi) | geri alma başına bir |
Sağlık denetimi önce geçen bir denetimi başarısız buldu (os_check_problem; açılıştan ya da paket koşusundan sonra) |
admin | panel bildirimi + e-posta (kritik) | denetim sonucu başına bir |
MariaDB sıradaki seriye yükseltildi ve denetlendi (os_db_series_upgraded; salt okunur süre ve döküm) |
admin | bildirim ayarlarına göre panel bildirimi + e-posta (update kategorisi, bilgi) |
koşu başına bir |
Bir MariaDB seri yükseltmesi başarısız denetimden sonra geri kondu (os_db_series_rolled_back; kalan denetimleri ve siteleri adlandırır) |
admin | panel bildirimi + e-posta (kritik) | koşu başına bir |
Bir MariaDB seri yükseltmesi başlamadı (os_db_series_refused; nedeni, hiçbir şey değişmedi) |
admin | panel bildirimi + e-posta (update kategorisi, uyarı) |
koşu başına bir |
Bir MariaDB seri yükseltmesi temiz bitmedi (os_db_series_failed; temiz geri gelmeyen geri koyma ya da yarıda kesilen koşu) |
admin | panel bildirimi + e-posta (kritik) | koşu başına bir |
Otomatik kurulumdan sonra yeniden başlatma gerekli (os_reboot_required; yalnız gece yeniden başlatma os_auto_reboot açık değilken) |
admin | panel bildirimi + e-posta (update kategorisi, uyarı) |
açılış başına bir kez |
Gece yeniden başlatma planlandı (os_reboot_scheduled; işletim sistemi yeniden başlatma istiyor ve os_auto_reboot açık) |
admin | panel bildirimi + e-posta (update kategorisi, bilgi) |
açılış ve paket kümesi başına bir kez |
Gece yeniden başlatma ertelendi (os_reboot_skipped; yedek, güncelleme ya da hesap taşıma sürüyordu) |
admin | panel bildirimi + e-posta (update kategorisi, bilgi) |
atlanan pencere başına bir |
Bu güncellemeler için gece yeniden başlatma durdu (os_reboot_blocked; kendileri için yeniden başlatma yapılmış aynı paketler hâlâ istiyor) |
admin | panel bildirimi + e-posta (update kategorisi, uyarı) |
paket ve sürüm kümesi başına bir kez |
Gece yeniden başlatma başlatılamadı (os_reboot_failed) |
admin | panel bildirimi + e-posta (kritik) | pencere başına bir |
Sunucu yeniden başlatıldı (os_reboot_done) / sorunlarla döndü (os_reboot_problem: önceden çalışan bir servis çalışmıyor — kritik; güncellemeninkinden başka çekirdek — uyarı) |
admin | panel bildirimi + e-posta (update kategorisi) |
yeniden başlatma başına bir, açılıştan sonraki denetimin ardından |
Denetimli koşunun bildirimleri (os_update_*, os_db_series_*) bir paket işleminin değiştirdiği birimlerle biter (denetimli koşunun 5. adımı): eski hâline döndürülen, döndürülemeyen (koşu failed), durdurulup yeniden başlatılmayan ya da yeni gelen — her biri birim (önceki durum -> işlemden sonra -> şimdi) biçiminde, durum etkinlik/çalışma.
Panelden başlatılan bir kurulum başlarken bir audit satırı (update_install_started) ve sonucu için bir satır (update_installed, ya da gerekçesi ve önceki sürümün geri konup konmadığıyla update_failed) artı geçmiş kaydı yazar; bildirim göndermez — onu başlatan operatör akışı zaten izlemektedir. Kurulum ucu adres başına saatte altı başlatma kabul eder; reddedilen başlatma 429 ile ve retry_after alanında o pencerede kalan saniyeyle yanıtlanır.
8. Ayarlar
/etc/whost/update_settings.json (root, 0600) agent'ın okuduğu tek kaynaktır; agent.conf'ta update: bloğu yoktur:
{
"channel": "stable",
"auto_update": true,
"auto_update_type": "security",
"backup_before_update": true,
"notify_available": true,
"notify_installed": true,
"os_packages_check_enabled": true,
"os_packages_notify_security": true,
"allow_vendor_critical_override": true,
"os_packages_auto_security": true,
"os_packages_auto_mode": "security"
}
Kurucu dosyayı yeni bir sunucuda bir kez, kanalla ve os_packages_auto_security: true ile yazar: -beta.N bir sürümden kurulan sunucu beta, kararlı bir sürümden kurulan stable kanalında başlar. Diğer alanlar yukarıdaki varsayılanda kalır; var olan dosyaya dokunulmaz — kurucuyu yeniden çalıştırmak yöneticinin seçimini sıfırlamaz. Dosya yoksa yukarıdaki varsayılanlar geçerlidir, os_packages_auto_security null olur (hiç kaydedilmemiş: anahtar kaydedilene kadar işletim sisteminin varsayılanı kalır).
Operatör değişiklikleri panelden yapılır (/admin/updates → Ayarlar sekmesi); sayfa değişen alanı PUT /api/v1/system/update/settings ile yazar. Hiçbir şeyi değiştirmeyen bir kayıt ne dosyayı ne bir audit satırını yazar; gerçek bir değişikliğin audit satırı yalnız değişen alanları adlandırır. Var olan ama ayrıştırılamayan bir dosya loglanır ve onarılana kadar auto_update: false ile varsayılanlar olarak okunur; panelden yapılan bir kayıt bu durumu dosyaya yazar, bu yüzden otomatik güncellemeler yönetici yeniden açana kadar kapalı kalır. Varsayılanlar dostçadır: yeni kurulmuş bir sunucu satıcının kritik işaretlediği güvenlik yamalarını kendiliğinden uygular (her yamanın açık onay gerektirdiği uyum ortamları için yapılandırılabilir); hiçbir beta işaretlenmez, bu yüzden bu varsayılanlar hiçbir betayı kendiliğinden kurmaz (§5).
9. API Uçları ve Dosyalar
| Konu | Uç ya da dosya | Not |
|---|---|---|
| WHost yazılım güncellemeleri | /system/update/* |
kontrol, sürüm notları, kurulum, durum ve ilerleme akışı, geçmiş, ayarlar; os-security (kendiliğinden kurulan OS güvenlik güncellemeleri) |
| Kendiliğinden kurulan OS güvenlik güncellemeleri | /var/lib/whost/os_auto_security.json, /var/lib/whost/backup-work.lock |
son koşu / kurulum ve uygulama hatası; güncelleme birimlerinin beklediği kilit |
| Denetimli koşu ve sağlık denetimi | /usr/local/sbin/whost-os-update, /usr/local/sbin/whost-os-check, /etc/whost/os-update/{update,check}.conf, /var/lib/whost/os-update/ (runs/, checks/, archive/, db-backups/, run.lock, panel-work.lock), /var/www/whost-canary, /etc/nginx/conf.d/whost-canary.conf, Apache zz-whost-canary.conf |
ajan yazar ve yerinde tutar; panelin gösterdiği koşular ve denetimlerdir; bir koşunun klasörü (runs/<id>.d/) birim durumlarını (units-before.tsv, units-<işlem>.tsv), değiştirdiği birimleri (units.tsv) ve systemctl'in yanıtını (units.log) tutar; koşu run.lock'u tutar, panel-work.lock'u panelden başlatılan OS paket yükseltmesi paylaşımlı, koşu özel tutar (Eşzamanlılık, §6) |
| MariaDB seri yükseltmesi | /etc/whost/os-update/db-series.conf, /var/lib/whost/os-update/db-series/ (window, stage, <koşu>/ veri klasörünün ve yapılandırmanın kopyası), MariaDB yapılandırma klasöründe 99-whost-db-window.cnf, MariaDB'nin deposu (whost-mariadb.sources + whost-mariadb.gpg ya da whost-mariadb.repo + RPM-GPG-KEY-whost-mariadb) |
plan her başlatmada yazılır; pencere dosyaları yalnız bir koşu yeni seriyi denetlerken vardır; depo başarıdan sonra kalır |
| OS paket güncellemeleri | /system/packages/* |
özet, bekleyen güncellemeler, yükseltme, yükseltme durumu, yükseltme geçmişi |
| Geçmiş | /var/whost/update_history.json (WHost) ve /var/whost/os_packages_history.json (OS) |
atomik yazılan JSON dizileri |
| Ayarlar | /etc/whost/update_settings.json |
tek kaynak |
Kurulum ucu ve OS paket yükseltme ucu etkin bir lisans (ya da hâlâ ek süre penceresindeki bir lisans) ister; aksi hâlde 403 ile LICENSE_NOT_ACTIVATED (hiç etkinleştirilmemiş) ya da LICENSE_SUSPENDED (diğer her durum) döner. Bir güncellemeyi yeniden denemeden önce lisansı kurtarın.
Yukarıda bulamadığınız her şey için destek ekibimiz her zaman yanınızda.