Ürün kılavuzu

Platform Güncellemeleri & Yaşam Döngüsü Yönetimi

Moftgate sunucu platform güncellemelerini yönetme kılavuzu: bulut tabanlı otomatik dağıtım, hava boşluklu (airgap) çevrimdışı paket yükleme, çok aşamalı migrasyon hattı, gerçek zamanlı terminal telemetrisi ve otomatik sıfır kayıplı geri alma (rollback) mekanizmaları.

Genel Bakış & Platform Mimarisi#

Moftgate DLP & UEM, hem bulut bağlantılı hem de tamamen kapalı (air-gapped) şirket içi altyapılar için tasarlanmış kurumsal düzeyde dayanıklı bir platform yaşam döngüsü motoru sunar. Platform güncelleme alt sistemi; atomik migrasyonları, kriptografik bütünlük doğrulamasını, otomatik ön kontrol snapshot yedeklerini ve sıfır kayıplı anlık geri alma mekanizmalarını garanti eder.

Sıfır Kesinti Felsefesi

Sunucu güncellemeleri atomik konteyner ve iş parçacığı yenilemeleriyle gerçekleştirilir. İstemci uç nokta ajanları izlemeye, DLP ihlallerini engellemeye ve telemetriyi yerel SQLite veritabanlarında arabelleğe almaya kesintisiz devam eder; tek bir log dahi kaybolmaz.

Sistem Sağlığı & Ön Kontrol Tanılamaları#

Herhangi bir platform güncellemesi uygulanmadan önce, orkestratör olası riskleri ortadan kaldırmak amacıyla tüm altyapı bağımlılıklarının operasyonel sağlığını değerlendirir:

Yığın Bileşeni	Teknoloji	Ön Kontrol Rolü
Platform Çekirdek Motoru	Laravel 13 & Octane / Rust Zenith Gateway	Aktif sunucu sürümünü, çalışma ortamı modunu (production/staging) ve çalışma zamanı kararlılığını gösterir.
PostgreSQL Veritabanı	PostgreSQL 15+ ilişkisel veri saklama katmanı	Aktif PDO bağlantı durumunu, şema bütünlüğünü ve migrasyon kilit hazırlığını doğrular.
Redis Bellek-İçi Motoru	Yüksek hızlı önbellek ve kuyruk mesaj dağıtıcısı	Redis ping gecikmesini, iş kuyruğu çalışanlarının sağlığını ve gerçek zamanlı soket durumunu doğrular.
Konteyner Motoru	Docker / Containerd çalışma zamanı arayüzü	Arka plan konteyner durumunu, izolasyon sınırlarını ve yardımcı mikroservis çalışma sürekliliğini denetler.
Depolama Alt Sistemi	Boş disk alanı ve snapshot ayrımı	Güncelleme öncesi snapshot yedekleri, paket açma ve geri alma işlemleri için yeterli disk alanını garanti eder.

Bulut Tabanlı Otomatik Güncellemeler (Tek Tıkla Kurulum)#

İnternet erişimi bulunan dağıtımlarda, yöneticiler Moftgate Cloud Registry üzerinden resmi güncellemeleri, kriptografik imzaları ve detaylı değişiklik günlüklerini anında sorgulayabilir:

1
Genel Ayarlar > Platform Update Bölümüne Gidin
Ana navigasyon menüsünden Ayarlar sayfasına gidin ve Sistem grubu altındaki Platform Update sekmesini seçin.
2
Güncellemeleri Denetleyin
"Güncellemeleri Denetle" butonuna tıklayarak kriptografik lisans anahtarınız ve donanım Machine ID bilginiz ile Moftgate Cloud Registry sorgusu gerçekleştirin.
3
Sürüm Notlarını ve Değişiklikleri İnceleyin
Gelen yeni sürüm numarasını, yayın tarihini, paket boyutunu, güvenlik yamalarını ve değişiklik günlüğünü modal üzerinden detaylıca inceleyin.
4
Tek Tıkla Kurulumu Başlatın
"Platform Güncellemesini Kur" butonuna tıklayın. Açılan güvenlik onay penceresinde otomatik snapshot ve migrasyon adımlarını onaylayarak süreci başlatın.

Çevrimdışı & Airgap Paket Dağıtımı (.mpkg / .tar.gz)#

Askeri, finansal veya yüksek güvenlikli kapalı devre ağlarda, güncellemeler tüm veritabanı migrasyonlarını, ön yüz derlemelerini ve servis ikililerini içeren şifrelenmiş ve imzalı `.mpkg` veya `.tar.gz` arşiv paketleri olarak sağlanır:

1
Doğrulanmış Güncelleme Paketini Temin Edin
Moftgate Customer Hub veya yetkili dağıtım portalından imzalı çevrimdışı güncelleme paketini (.mpkg, .tar.gz veya .tgz) indirin.
2
Paketi Sürükleyip Bırakın veya Seçin
Platform Update sayfasındaki Çevrimdışı Paket Yükleme alanına paket dosyasını sürükleyip bırakın veya dosya seçici ile yükleyin.
3
Kriptografik SHA-256 ve Manifest Doğrulaması
Sunucu dosyanın SHA-256 özetini hesaplar, arşivi açarak manifest.json dosyasındaki hedef sürüm uyumluluğunu ve bileşenlerini doğrular.
4
Hazırlama (Staging) ve Kurulumu Başlatma
Paket platform güncelleme kataloğuna kaydedilir. İster paketi beklemeye alabilir, isterseniz çok aşamalı kurulum hattını anında başlatabilirsiniz.

Paket Manifest Yapısı

Her çevrimdışı arşiv, kök dizininde target_version, SHA-256 imzaları, asgari sürüm gereksinimleri, şema migrasyon scriptleri ve kurulum sonrası tetikleyicilerini tanımlayan bir manifest.json barındırır.

Paket Hazırlama (Staging) & Aktivasyon Anahtarı#

Sunucuya yüklenen çevrimdışı paketler bağımsız bir aktif/pasif anahtarına sahiptir. Bu sayede yeni sürümler onaylı bakım penceresi öncesinde sunucuya yüklenebilir, ancak onay verilene kadar pasif tutularak kazara çalıştırılması engellenir.

Çok Aşamalı Otomatik Yürütme Hattı#

Platform güncelleme orkestratörü, gerçek zamanlı log akışı ve ilerleme takibi sağlayan 6 aşamalı sıralı bir asenkron durum makinesi çalıştırır:

İşlem Aşaması	İlerleme	Yürütülen İşlemler
İndirme / Paket Hazırlığı	10%	Bulut paketini indirir veya doğrulanmış yerel çevrimdışı arşiv dosyasını güncelleme dizinine açar.
Güvenlik Snapshot & Yedek	30%	Otomatik veritabanı snapshot yedeği alır ve aktif .env yapılandırmasının yedeğini arşivler.
Veritabanı Migrasyonları	50%	PostgreSQL ileri şema migrasyonlarını (Artisan migrate --force) ve özel SQL yamalarını uygular.
Servis Yeniden Başlatma	70%	Platform güncelleyici scriptini çalıştırır, servisleri atomik olarak yeniden başlatır ve önbellekleri yeniler.
Güncelleme Sonrası Sağlık Kontrolü	90%	PostgreSQL bağlantısı, Redis kuyruk motoru ve HTTP API uç noktalarında otomatik sağlık testleri yürütür.
Tamamlandı & Sürüm Terfisi	100%	Yeni platform sürüm numarasını onaylar, bakım modunu kaldırır ve denetim kaydını tamamlar.

Otomatik Geri Alma & Güvenlik Snapshot'ları#

Olası kesintileri ve veri tutarsızlıklarını önlemek için platform, değişiklik yapmadan önce otomatik yapılandırma ve veritabanı snapshot yedeği oluşturur. Herhangi bir migrasyon veya sağlık testi başarısız olduğunda sistem anında geri alma (rollback) sürecini başlatır:

Otomatik Hata Algılama: Veritabanı migrasyonunda hata oluşursa veya sağlık testi servis kesintisi raporlarsa geri alma süreci anında devreye girer.
Yapılandırma & .env Geri Yükleme: Platform, güncelleme öncesi snapshot yedeğinden eski .env yapılandırmasını ve sürüm sabitlerini geri yükler.
Bakım Kilitlerinin Kaldırılması: Bakım bayraklarını temizleyerek kullanıcı trafiğini ve ajan telemetri akışını kesintisiz olarak devam ettirir.
Manuel Tek Tıkla Geri Alma: Yöneticiler güncelleme geçmişi tablosundan istedikleri zaman önceki kararlı sürüme manuel geri alma başlatabilir.

Komut Satırı (CLI) ile Güncelleme (php artisan platform:update)#

Terminal üzerinden yönetim ve CI/CD bakım otomasyonları için platform yerleşik bir Artisan komutu sunar:

Terminal / Kabuk Komutları

# 1. Mevcut güncellemeleri denetle
php artisan platform:update --check

# 2. Belirli bir sürüme güncelle (Bulut)
php artisan platform:update --target-version=1.3.0

# 3. Çevrimdışı airgap paketini uygula
php artisan platform:update --package=/var/moftgate/updates/moftgate-v1.3.0.mpkg --force

Denetim İzi & Güncelleme Geçmişi#

Tüm platform güncelleme eylemleri; işlemi başlatan kullanıcı, dağıtım kanalı, zaman damgaları, toplam süre ve hata dökümleriyle birlikte veritabanına değiştirilemez şekilde kaydedilir:

Denetim Eylemi	Açıklama & Kapsam
platform_update.check	Bir yönetici Moftgate Cloud Registry üzerinden mevcut güncellemeleri sorguladığında tetiklenir.
platform_update.upload_package	Çevrimdışı .mpkg / .tar.gz paketi sunucuya yüklenip SHA-256 ile doğrulandığında kaydedilir.
platform_update.package_toggle	Yönetici hazır bir güncelleme paketini aktif/pasif yaptığında kaydedilir.
platform_update.start	Otomatik bulut veya çevrimdışı çok aşamalı güncelleme süreci başlatıldığında loglanır.
platform_update.completed	Tüm 6 aşama ve sağlık kontrolleri başarıyla tamamlandığında sürüm yükseltmesi loglanır.
platform_update.failed	Herhangi bir aşamada hata veya servis kesintisi oluştuğunda hata detaylarıyla birlikte loglanır.
platform_update.rollback	Otomatik veya manuel geri alma ile sistem eski sürüme ve .env snapshot yedeğine döndürüldüğünde loglanır.

Sık Sorulan Sorular#

Sunucu platform güncellemesi esnasında uç nokta (endpoint) ajanlarının bağlantısı kesilir mi?

Hayır. Moftgate ajanları yerel SQLite veritabanında 3 güne (veya 1 GB) kadar veri saklayabilen çevrimdışı dayanıklılık mimarisine sahiptir. Güncelleme sırasında sunucu kısa süreliğine (genellikle 5-15 saniye) yeniden başlatılsa bile ajanlar telemetri ve DLP olaylarını yerelde kuyruğa alır ve sunucu sağlık testi onaylandığında ağ trafiğini boğmadan senkronize eder.

Veritabanı migrasyonları sırasında bir hata oluşursa sistem nasıl davranır?

Güncelleme orkestratörü savunmacı mimari ile çalışır. Bir migrasyon veya servis adımı başarısız olursa sistem süreci derhal Failed olarak işaretler, güncellemeyi durdurur, otomatik olarak güncelleme öncesinde oluşturulan .env ve veritabanı snapshot yedeğine geri döner (rollback) ve sunucuyu bilinen kararlı duruma getirir.

İnternet erişimi olmayan kapalı devre (air-gapped) ağlarda güncelleme nasıl yapılır?

Çevrimdışı paket dağıtım mimarisi tam da savunma, finans ve kritik kamu altyapıları için tasarlanmıştır. Yöneticiler yetkili portaldan indirilen imzalı .mpkg veya .tar.gz paketlerini doğrudan web konsolundan veya sunucu komut satırından yükleyerek internet bağlantısı olmadan güvenle güncelleme yapabilir.

Yüklenen paketler için neden aktif/pasif (toggle) anahtarı var?

Paket aktivasyon anahtarı (is_active), planlı bakım pencereleri için hazırlık (staging) imkanı sunar. Yöneticiler paketleri mesai saatleri içinde sunucuya yükleyip hazırlayabilir, ancak onaylı bakım saati gelene kadar operatörlerin kazara güncellemeyi başlatmasını engellemek için pasif konumda tutabilir.

Platform güncellemeleri CI/CD veya zamanlanmış görevlerle otomatize edilebilir mi?

Evet. Sunucu üzerinde yer alan Artisan komutu ile güncellemeler yönetilebilir: `php artisan platform:update --target-version=1.3.0 --force` veya çevrimdışı paket için `php artisan platform:update --package=/dizin/paket.mpkg --force`. Tüm CLI işlemleri otomatik olarak denetim izine (audit log) kaydedilir.