Güncellemeler

BorCube'un yeni sürümleri panelinde görünür. Siten tek komutla kurulduysa yeni sürümü panelden tek tıkla kurarsın. Kurmadan önce yedek alınır; yeni sürüm açılmazsa site kendiliğinden eski sürüme döner.

Yeni sürümleri görmek#

Yönetim paneli → Ayarlar → Güncellemeler sayfasını aç (Güvenlik ve erişim başlığının altında). Bu sayfayı Yönetici rolü ve "BorCube'u güncelleme ve Connect eklentisini indirme" yetkisi olan roller görür.

Sayfanın üstünde üç bilgi var:

• Kurulu sürüm: sitende çalışan sürüm.
• Son denetim: lisans sunucusuna en son ne zaman soruldu.
• Güncelleme hakkı: hangi sürümleri kurabileceğin (aşağıda anlatılıyor).

Site yeni sürümleri kendisi denetler: en fazla 6 saatte bir ve sürüm değiştikten hemen sonra. Beklemek istemezsen Şimdi denetle düğmesine bas. Yeni bir sürüm varsa sürüm notlarıyla birlikte listelenir ve panelin Bekleyen işler listesinde "BorCube … kurulmaya hazır" satırı çıkar. Güncellemeleri görmek için lisansın etkin olmalıdır.

Panelden güncellemek#

1. Yeni sürüm kartındaki … sürümüne güncelle düğmesine bas ve onayla. Site 1–2 dakika kapanır.
2. Panel paketi indirir ve imzasını denetler.
3. Sunucudaki borcube-update servisi işi devralır. Bu servis root yetkisiyle çalışır, paketin imzasını kendi anahtar kopyasıyla yeniden denetler ve yalnız kurulu sürümden yeni bir sürümü kabul eder.
4. Önce yedek alınır, sonra yeni sürüm kurulur ve site yeniden başlatılır.
5. Sayfa kendiliğinden yenilenir.

İlerlemeyi aynı sayfada izlersin: Sırada, Kuruluyor, Site yeniden başlatılıyor ve sonunda Kuruldu ya da Kurulamadı. Ayrıntılar Kurulum çıktısı bölümünde görünür.

Güncelleme yalnız BorCube'u yeniler; sunucudaki Ubuntu paketlerinin tamamını güncellemez. Paket, çalışan sürümün yanına açıldığı için diskte yeterli boş yer gerekir. Yer yoksa güncelleme başlamaz ve "Diskte yer yok: en az … MB boş alan gerekli." uyarısı çıkar.

İmza denetimi#

Her BorCube sürümü BorCube'un imza anahtarıyla imzalanır. Panel, imzası uymayan bir sürümü listeye bile almaz. İndirilen paketin boyutu ve özeti (SHA-256) imzalı bilgilerle karşılaştırılır. Root servisi de imzayı ayrıca denetler. Bir şey uymazsa güncelleme yapılmaz ve şu mesajlardan biri çıkar:

• "Paketin imzası doğrulanamadı; güncelleme yapılmadı."
• "Paket imzalı bilgilerle uyuşmuyor; güncelleme yapılmadı."

Yedek ve otomatik geri dönüş#

Her güncellemeden önce veritabanının ve veri klasörünün yedeği /var/backups/borcube klasörüne alınır.

Yeni sürüm yaklaşık iki dakika içinde açılmazsa site önceki sürüme döner ve açılmayan sürüm silinir. Panelde Kurulamadı ve "Site önceki sürümle çalışmaya devam ediyor." yazar. Sunucuda son üç sürümün klasörü /opt/borcube/releases altında tutulur.

Veritabanı güncellemesi yarıda kaldıysa veritabanını güncellemeden önce alınan yedekten geri yükle. Gereken komut Kurulum çıktısı bölümünde yazar; adımlar Veritabanını geri yüklemek bölümünde.

Komutla güncellemek#

Kurulum komutu güncelleme için de kullanılır:

1. Hesabım → İndirmeler sayfasında Sunucuna kur kartını bul.
2. Alan adını yaz ve Kurulum komutunu oluştur düğmesine bas.
3. Kopyala ile komutu kopyala ve sunucuda çalıştır.

BorCube kurulu bir sunucuda bu komut kartta yazan sürüme günceller. Önce yedek alır; yeni sürüm açılmazsa eski sürüme döner. Komuttaki indirme bağlantısı 10 dakika geçerlidir; süresi geçerse yeni komut oluştur. Aynı anda yalnız bir kurulum ya da güncelleme çalışır.

Komutla güncellemen gereken durumlar:

• Panel Bekliyor diyorsa: sunucudaki güncelleme servisi isteği almamıştır. İsteği iptal et düğmesine bas, komutu bir kez çalıştır (güncelleme servisini de kurar), sonra panelden yeniden dene.
• Tek komutla kurduğun eski bir site için panel "panelden güncellenemiyor" diyorsa: o kurulumda güncelleme servisi henüz yoktur. Komutu bir kez çalıştır; bundan sonraki sürümler panelden de kurulur.

Docker ve elle kurulum#

Panelden tek tıkla güncelleme yalnız tek komutla yapılan kurulumlarda çalışır. Diğer kurulumlarda yeni sürümü Hesabım → İndirmeler sayfasından indirirsin.

• Docker: yeni sürümü yeni bir klasöre aç, eski klasördeki .env dosyasını oraya kopyala ve aynı Caddy profiliyle docker compose up -d --build çalıştır (Caddy'yi BorCube ile kurduysan docker compose --profile https up -d --build). Veriler Docker birimlerinde kalır; veritabanı ilk açılışta kendiliğinden güncellenir.
• Elle kurulum: önce veritabanının ve borcube-data klasörünün yedeğini al. Yeni arşivi eski klasörün yanına aç, servisi yeni klasördeki start.sh dosyasına çevir ve yeniden başlat. Bir hata olursa yedeği geri yükleyip eski klasöre dön.

Ayrıntılar: Docker ve elle kurulum.

Güncelleme hakkı#

Hangi sürümleri kurabileceğin lisansına bağlıdır:

Ömür boyu lisansın güncelleme süresi bittikten sonra çıkan sürüm Yenileme gerekli olarak görünür. Siten kurulu sürümle çalışmaya devam eder. Yeni sürümler için borcube.com'dan güncelleme yenilemesi al: Süre uzatma ve paket değiştirme.

Connect eklentisi#

Aynı sayfanın altında BorCube Connect eklentisinin son sürümü görünür. Eklentiyi indir düğmesiyle indirirsin. Kurulumu için: Connect kurulumu.