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
Bu yazıda
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:
- Şifreli yedek alınır. Yedek alınamazsa hiçbir şey değişmez.
- Worker durdurulur; çalışan adımın bitmesi en çok 120 saniye beklenir.
- Yeni sürüm derlenir, başlatılır ve sağlık kontrolü yapılır.
- 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 |
|---|---|
stable | Yalnızca yayımlanmış sürümler |
beta | Ön sürümler de |
edge | Bir 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:00Yü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.keydosyası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.
.enviçindeBACKUP_COPY_TObir 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.encOnaylı ç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_HOLDdö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-holdAz ö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.