İçeriğe geç
Lightning VM

Yazılar

Güncelleme, yedek ve geri yükleme: bekleme ne işe yarar

Panelin kendini nasıl güncellediği, yedeğin içinde ne olduğu, anahtarın neden sunucu dışında durması gerektiği ve geri yüklemeden sonra panelin neden beklemede açıldığı.

Yaklaşık 3 dakikalık okuma

Panel kendini nasıl günceller

Güncellemeyi Yönetim → Sistem → Güncellemeler'den ya da komut satırından başlatırsınız:

sudo sh scripts/install.sh update

İkisi de aynı akışı çalıştırır:

  1. Şifreli yedek alınır. Yedek alınamazsa hiçbir şey değişmez.
  2. Worker durdurulur; çalışan adımın bitmesi en çok 120 saniye beklenir.
  3. Yeni sürüm derlenir, başlatılır ve sağlık kontrolü yapılır.
  4. Yeni sürüm hazır olmazsa önceki sürüm otomatik olarak geri gelir.

Veritabanı otomatik geri alınmaz. Gerekirse çalıştırılacak geri yükleme komutu, yedeğin adıyla birlikte güncelleme kaydında yazar.

Panelin sunucuda doğrudan komut çalıştırma yetkisi yoktur ve Docker soketi panele verilmez. API bir istek dosyası bırakır; kurulumun eklediği bir systemd birimi dosyayı görür ve kurulum betiğini çalıştırır. Betik isteği yeniden doğrular ve yalnızca sabit bir listedeki işlemleri kabul eder: sürüm denetimi, güncelleme, yedek, otomatik güncelleme ayarı, alan adı, sunucu ayarları, izleme, terminal ve işletim sistemi güncellemeleri. Listede olmayan her istek reddedilir.

Kanallar

Kanalİzlediği
stableYalnızca yayımlanmış sürümler
betaÖn sürümler de
edgeBir daldaki her değişiklik; test sunucuları içindir

Otomatik güncellemeyi bir bakım penceresiyle açabilirsiniz:

sh scripts/install.sh auto-update on --channel stable --window 03:00-05:00

Yükseltmeden önce upgrade-notes.md sayfasını okuyun. Sürümler arasında değişen davranışları, mevcut veriye etkisini ve kimlerin etkileneceğini gösteren sorguları içerir.

Yedeğin içinde ne var

PostgreSQL'in tamamı, .env, ana anahtar ve VMware servis belirteci, Caddy'nin sertifikaları ve ACME hesabı, yüklediyseniz kendi sertifikanız ve Alertmanager ayarı. Redis yedeklenmez; orada yalnızca kuyruk kopyaları, tek kullanımlık biletler ve hız sınırı sayaçları vardır.

Yedek müşteri VM'lerini içermez. Belge ayrıca şunu hatırlatır: VMware anlık görüntüsü de bağımsız bir yedek değildir, aynı veri deposunda durur ve depo kaybolursa o da kaybolur.

Anahtar

Arşiv secrets/backup.key ile şifrelenir ve aynı anahtarla imzalanır. Anahtar ilk kurulumda oluşturulur, yedeğin içinde yoktur ve başka bir yerden yeniden üretilemez.

Yapmanız gereken iki şey var:

  • backup.key dosyasını sunucu dışında güvenli bir yere, örneğin bir parola kasasına kopyalayın. Yedeklerle aynı yere koyarsanız şifrelemenin koruması kalmaz.
  • Yedeklerin sunucu dışı kopyasını ayarlayın. Varsayılan kurulumda yedekler yalnızca panel sunucusunun diskindedir. .env içinde BACKUP_COPY_TO bir rsync hedefi alır; imza dosyası da birlikte kopyalanır.

İmzanın bir sınırı vardır: değiştirilmiş ya da başka adla konmuş bir yedeği yakalar, ama değiştirilmemiş eski bir yedeğin kendi adıyla geri konmasını ya da yedeklerin silinmesini engellemez. Yedekleri güvendiğiniz bir depoda tutun ve yeniden adlandırmayın.

Geri yükleme

Komutu önce onaysız çalıştırın; yalnızca denetler ve neyin değişeceğini söyler:

sudo sh scripts/install.sh restore backups/DOSYA.tar.enc

Onaylı çalıştırma (--yes-replace-data) önce veritabanının yanıt verdiğini ve dökümün okunabildiğini denetler, sonra mevcut verinin bir güvenlik yedeğini alır, servisleri durdurur ve veritabanını tamamen yedektekiyle değiştirir. Arşiv, denetlenmeden önce yalnızca root'un açabildiği bir klasöre kopyalanır; geçici klasörde arşiv boyutunda yer olmalıdır.

Bekleme ne işe yarar

Geri yüklenen veritabanı hipervizörlerden, ödeme sağlayıcılarından ve anlattığı kişilerden eskidir. Yedekte açık duran bir işlem, ödenmemiş bir sipariş ya da zamanlanmış bir silme, o günden sonra ödenmiş ve kurulmuş bir sunucuyu bozabilir. Panel eski kayıtlara göre kendiliğinden hareket ederse müşterinin çalışan sunucusunu silebilir.

Bu yüzden geri yükleme iki şey yapar. Herkesin oturumunu kapatır, çünkü yedekten sonra çıkış yapmış biri yeniden girmiş olmamalıdır. Ve paneli beklemeye alır. Bekleme sürerken:

  • worker hiçbir işlemi başlatmaz;
  • güç ve anlık görüntü zamanlamaları ile zamanlanmış silmeler çalışmaz;
  • tahsilat çalışmaz;
  • tutarlılık denetimi yalnızca bulgu yazar, sunucu kayıtlarına dokunmaz;
  • işlem başlatan API rotaları 409 RESTORE_HOLD döner.

Giriş, sayfaları görüntüleme ve ayarlar çalışır. system.update izni olan personele bildirim gider ve personel her sayfanın üstünde bir şerit görür.

Serbest bırakmadan önce yedekten sonra neyin değiştiğine bakın: oluşturulan ya da silinen sunucular, yapılan ödemeler, silinen API anahtarları, yasaklar ve rol değişiklikleri. Sonra Yönetim → Sistem'deki şeritten ya da şu komutla serbest bırakın:

docker compose exec api node dist/cli.js release-restore-hold

Az önce alınmış bir yedeği geri yüklüyorsanız, örneğin başarısız bir güncellemeden hemen sonra, --no-hold bekletmeyi atlar.

Denenmemiş olanlar

Bekleme bildiriminin mantığı bir entegrasyon testiyle sınanır, ancak gerçek bir geri yüklemeden sonra e-postanın ulaştığı denenmedi. Uçtan uca testte bekleme durumu sayfaya dışarıdan verilir. Kurulum betiğinin yedek ve güncelleme yolları güvenlik incelemesinde satır satır yeniden okunmadı. Bir geri yüklemeyi gerçekten ihtiyacınız olmadan önce, boş bir sunucuda bir kez deneyin.

Kaynak: docs/operations.md, docs/updates.md.