Güncelleme ve bakım

Güncellemeden önce

Ayarlar → Güncellemeler sekmesi sürüm kontrolü ve kurulumun desteklediği güncelleme işlevlerini sunar. Docker Compose ile resmî betikten kurulan sistemler için ayrıca güncelleme betikleri bulunur.

Kurulum klasörünü, .env dosyasını ve kalıcı verileri yedekleyin. Uygulama veritabanı yedeği ile registry image verisinin yedeği farklı kapsamlar taşır. Bakım aralığını açık terminal ve sorgu oturumlarını dikkate alarak seçin.

Linux Compose kurulumu

Varsayılan /opt/battani kurulumu için kaydedilen betiği çalıştırın. Farklı dizin kullandıysanız mevcut kurulum dizininizi belirtin.

• Betik yeni imajı indirir ve varsayılan olarak backups klasörüne PostgreSQL yedeği alır.
• Sürüm bilgisini değiştirir, servisleri yeniden oluşturur ve sağlık kontrolü yapar.
• Yeni sürüm açılmazsa önceki uygulama sürümüne dönmeyi dener; veritabanı geçişleri için gerektiğinde alınan yedek ayrıca kullanılmalıdır.

sudo sh /opt/battani/update.sh

Güncelleme sonrası kontrol

Kapalı ağ ortamlarında imajların önceden taşınması gerekir. Güncelleme betiği tüm haricî veritabanlarını, cluster iş yüklerini veya registry verisini otomatik yedeklemez.

1. Uygulama sağlık kontrolünün başarılı olduğunu ve sürüm bilgisini doğrulayın.
2. Oturum açarak lisans durumunu ve aktif cluster erişimini kontrol edin.
3. Kullandığınız veri servisi bağlantılarında bağlantı testi yapın.
4. Sorun varsa uygulama loglarını ve güncelleme sonucunu inceleyin; veri geçişi etkisini değerlendirerek geri dönüş yapın.

Sürüm ve güncelleme durumu kartları

Güncellemeler sekmesi mevcut tag, bulunan en yeni tag ve güncelleme durumunu gösterir. Hata mesajı varsa güncel görünümünü değerlendirmeden önce mesajı okuyun; registry erişilememesi yeni sürüm olmadığı anlamına gelmez.

• Gösterilen image repository hangi kaynağın kontrol edildiğini belirtir.
• Sürüm denetimi ile güncellemeyi uygulama ayrı işlemlerdir.
• İşlem talebi kabul edildikten sonra gerçek çalışan sürümü ayrıca doğrulayın.

Otomatik kontrol aralığı ve ön sürümler

Formda kontrol aralığı 5–1440 dakika arasında seçilir. Otomatik kontrol, otomatik uygulama ve ön sürümleri dahil etme seçenekleri ayrı ayrı kaydedilir.

• autoCheck sürüm sorgulamayı, autoApply uygun güncellemeyi uygulama davranışını etkiler.
• Ön sürüm seçeneği sürüm adaylarını değerlendirmeye katar; kararlı sürümle aynı beklentiye sahip olmayabilir.
• Kaydetme işlemi ayarları günceller; hemen yeni sürüme geçildiğini göstermez.

Elle sürüm kontrolü

Kontrol Et düğmesi yapılandırılmış OCI imaj kaynağındaki etiketleri sorgular ve mevcut sürümle karşılaştırır. Uygulamayı bu aşamada yeniden başlatmaz.

1. Mevcut sürüm ve imaj kaynağını kontrol edin.
2. Elle kontrolü çalıştırın ve bitmesini bekleyin.
3. Bulunan tag veya hata mesajını okuyun.
4. Güncelleme varsa bakım ve geri dönüş hazırlığından sonra uygulama yolunu seçin.

Kurulum türüne göre uygulama yolu

Battani’nin çalışma ortamına göre Kubernetes rollout, desteklenen yerinde güncelleme veya yapılandırılmış webhook yolu kullanılabilir. Arayüzde bir güncelleme düğmesi bulunması, her Docker/özel kurulumda aynı yolun hazır olduğu anlamına gelmez.

• Kubernetes’te çalışan Pod’un sahibi Deployment ve hedef container belirlenir.
• Kubernetes dışındaki kurulumda ilgili güncelleme yapılandırmasının mevcut olması gerekir.
• Resmî Compose kurulumu için kurulum dizinine yönelik update.sh/update.ps1 ayrı ve açık bakım yoludur.

Kubernetes üzerinde rollout gereksinimleri

Kubernetes güncellemesi Battani’nin kendi çalışan uygulama Deployment’ını hedefler. Servis hesabının gerekli okuma ve güncelleme izinleri olmalıdır; cluster seçicisindeki herhangi bir iş yükünü rastgele güncellemez.

• Mevcut Pod → ReplicaSet → Deployment ilişkisinin bulunabilmesi gerekir.
• Yeni imajın cluster node’larından indirilebildiğini kontrol edin.
• Talep sonrası rollout durumunu, hazır Pod’ları ve uygulamaya yeniden erişimi doğrulayın.

Linux güncelleme seçenekleri

update.sh --version ile hedef sürüm, --dir ile kurulum dizini, --force ile aynı sürümde yeniden başlatma ve --yes ile onay davranışı alır. --no-backup veritabanı yedeğini kapatır; varsayılan yedek alma davranışını korumak çoğu bakım akışında daha uygundur.

• Kurucu yerine güncelleme betiğini kullanın.
• Mevcut .env ve Compose dosyalarının bulunduğu dizini hedefleyin.
• Özel bir dizin kullanıyorsanız aşağıdaki örnekte yolu değiştirin.

sudo sh /opt/battani/update.sh --dir /opt/battani

Windows güncelleme seçenekleri

PowerShell güncelleyicisi -Version, -Dir, -NoBackup, -Force ve -Yes parametrelerini destekler. Varsayılan dizin kullanıcı profilindeki Battani klasörüdür. Docker Desktop çalışır ve doğru container modunda olmalıdır.

• İlk kurulum betiğini tekrar çalıştırmak yerine update.ps1 kullanın.
• Özel kurulum yolunda -Dir değerini açıkça belirtin.
• Betik sonucundan sonra çalışan uygulamanın sürümünü yeniden kontrol edin.

irm https://battani.dev/update.ps1 | iex

Otomatik PostgreSQL yedeğinin kapsamı

Güncelleme betiği varsayılan olarak yeni sürüme geçmeden PostgreSQL yedeğini backups klasörüne alır. Bu yedek uygulama veritabanı içindir; registry volume’ünün, haricî SQL veritabanlarının veya Kubernetes workload verilerinin tam yedeği değildir.

• .env ve kalıcı şifreleme anahtarlarını güvenli biçimde ayrıca saklayın.
• Yedek çıktısının gerçekten oluştuğunu ve okunabilir olduğunu kontrol edin.
• Disk alanını yeni imaj ve yedek için birlikte planlayın.

Sağlık kontrolü ve başarısız güncelleme

Compose güncelleyici yeni sürüm açılmadığında önceki uygulama sürümüne dönmeyi dener. Yeni sürüm veritabanı geçişi yaptıysa eski imaja dönmek tek başına veritabanını eski şemaya döndürmez.

1. Hata mesajını ve uygulama loglarını inceleyin.
2. Servislerin çalışan tag ve sağlık durumunu kontrol edin.
3. Veritabanı geçişi etkisi varsa alınmış yedeğe göre geri dönüş planını uygulayın.
4. Tekrar denemeden önce hatanın nedenini giderin.

Kapalı ağ bakımı ve son kontrol

Kapalı ağda gerekli imajlar önceden taşınmalıdır. BATTANI_SKIP_PULL=1 önceden yüklenmiş imajı kullanmaya yardım eder; sürüm keşfi ve betik indirme gibi diğer ağ bağımlılıklarını kendiliğinden kaldırmaz.

1. Hedef sürümü, betiği ve gerekli imajları ağ dışında hazırlayın.
2. Kurulumun desteklediği güncelleme yolunu çalıştırın.
3. Sürüm, lisans, cluster erişimi ve veri bağlantı testlerini kontrol edin.
4. Terminal/log, registry ve kritik kullanıcı girişini kullandığınız kapsamda doğrulayın.