Build Sistemi

Nucora Linux ST 3.0 — Obsidian Engine | Resmî teknik dokümantasyon

nux-maker, OverlayFS chroot, SQLite kuyruk ve güvenli yayın akışı.

Komutları güvenli çalıştır

Örneklerdeki paket ve aygıt adlarını kendi sisteminle karşılaştır. Root yetkisi gerektiren işlemlerde komutun etkisini ve hedef yolu doğrulamadan devam etme.

Bileşen haritası

/opt/nucora/nux-maker/ Python build motorudur; tanımlanan modüller core/cli.py, engines/builder.py, orchestrator.py, queue.py, publisher.py, sandbox.py, auto_v2.py ve recipe_parser.py’dir. Görevleri sırasıyla CLI, tek paket build, bağımlılık sıralama, kuyruk, yayın, izolasyon, otomatik pipeline ve tarif okumadır.

Build yaşam döngüsü

Tarif ve metadata oku; zorunlu alanları doğrula.
Bağımlılıkları çöz; build sırasını DAG üzerinden planla.
SQLite kuyruğuna işi ekle ve durumunu kaydet.
OverlayFS chroot sandbox’ını hazırla, gerekli mount’ları denetle.
Kaynağı indir/checksum doğrula; prepare/build/check/package çalıştır.
Paketi doğrula, yayınla ve reindex adımını planla.

Bu sıra mimari özettir; gerçek hata/yeniden deneme semantiği uygulama koduna bağlıdır.

Sandbox ve kaynaklar

Chroot dizini /opt/nucora/chroots/st3-base olarak tanımlanmıştır. OverlayFS katmanlarının mount edilmiş olmasını, build sonrası temizlenmesini ve host /usr ağacına yazılamamasını doğrula. Build’i root yürütüyorsa dış kaynak ve tarif girdileri özellikle dikkatle incelenmelidir.

Yardımcı araçlar

nux-safe-build, nux-safe-build-r, nux-safe-auto, nux-safe-auto-r, nux-seed-deps, nux-seed-pkg, nux-clean-mounts, build-xfce-app, nbuild-list scriptleri tanımlanmıştır. Her birinin seçenekleri bu spesifikasyonda verilmediğinden --help çıktısına bak; isimden hareketle parametre uydurma.

Kuyruk, log ve recovery

SQLite kuyruk durumu eşzamanlı build’lerin orkestrasyonuna yarar. Log yolu verilmediği için nux-maker yapılandırmasını ve servis çağrısını incele. İş yarıda kalırsa önce çalışan process/mount durumunu denetle; aktif chroot’u temizleyen scripti gelişigüzel çalıştırma. Build sonucu, kaynak hash’i, tarif revizyonu ve paket hash’i birlikte arşivlenmelidir.

Güvenli uygulama akışı

Bu sayfadaki Build Sistemi adımlarını uygularken önce mevcut durumu kaydet; ilgili sistemde nux-maker --help komutunun kullanılabilirliğini ve yardım metnini doğrula. 1. Hedef cihazın ST sürümünü, x86_64 mimarisini, aktif kanalı ve gerekli disk alanını doğrula. 2. Geri alınması zor işlem öncesinde kullanıcı verisini yedekle ve cihazı kararlı güç kaynağına bağla. 3. Tek seferde tek değişiklik uygula; komut, zaman, çıkış kodu ve sonucu not et. 4. Başarısızlık halinde işlemi tekrarlamadan önce tam logu ve son başarılı durumu sakla. 5. Sonucu nux doctor, ilgili bileşen sorgusu ve gerçek kullanıcı senaryosuyla doğrula.

ST 3.0 referans matrisi

Bileşen	Verilen referans
Sürüm / kod adı	ST 3.0 / Obsidian Engine
Taban / mimari	Saf LFS / x86_64
Kernel / init	linux-nucora 6.4.12 / SysVinit
libc / derleyici	glibc 2.39 / GCC 14.2.0
Masaüstü / görüntü	XFCE 4.20, Xfwm4 / Xorg
Paket yöneticisi	nux 8.4.10; Go
Bellek / depolama	Boşta ~450 MB; minimum 2 GB RAM, 15 GB disk
Paket envanteri	stable 433; testing 46 (sağlanan sayılar)

Değişiklik sonrası doğrulama

Beklenen dosya/paket/ayar doğru yerde ve doğru sürümde.
İlgili servis, masaüstü oturumu veya ağ bağlantısı yeniden çalışıyor.
Paket veritabanı tutarlı; nux doctor yeni hata üretmiyor.
Loglarda checksum, bağımlılık veya izin hatası yok.
Geri dönüş yolu ve yedeğin okunabilirliği biliniyor.

Hata ayırma matrisi

Belirti	İlk kontrol	Güvenli sonraki adım
Paket bulunamıyor	`nux channel`, `nux repo list`	İndeksi yenile; gerçek paket adını ara.
Hash uyuşmuyor	Arşiv SHA256 ve repo metadata	Arşivi kurma; kaynağı/indeksi doğrula.
Bağımlılık eksik	`nux check-deps`, `nux info`	Sağlayıcıyı belirle; rastgele dosya kopyalama.
Sistem beklenmedik	History ve son log	Yeni değişiklik yapmayı durdur; yedekle ve raporla.

Güvenlik sınırları

Arşiv, recipe, maintainer script veya tester anahtarını güvenilir kaynaktan doğrulamadan root ile çalıştırma.
.nux checksum uyuşmazlığını görmezden gelme; hash düzeltme aracı kaynağın güvenilirliğini kanıtlamaz.
/var/lib/nux/ veritabanını elle düzenleme veya snapshot dosyalarını doğrulamadan silme.
-y bayrağını özellikle remove/upgrade işlemlerinde etkisini anlamadan kullanma.
Rapor ve ekran görüntülerinden parola, anahtar, kişisel dosya yolu ve token’ları ayıkla.

İlgili sayfalar

Dokümantasyon ve ürün verisi notu

Bu içerik proje tarafından sağlanan ST 3.0 tanımına dayanır; burada açıklanmayan endpoint, environment variable, CLI flag, canlı checksum veya otomatik downgrade davranışı varsayılmaz. Sistemde gözlenen davranış bu metinle çelişirse önce nux --version, aktif repo indeksi ve kaynak kodu/release notlarını karşılaştır; doğrulanmış düzeltmeyi issue veya değişiklik günlüğüne ekle. Bu sayfanın konusu: build sistemi. Üretim sistemlerinde değişiklikleri önce test kanalında veya yalıtılmış ortamda doğrula.

İşlem kaydını hazırlama

Destek veya bakım kaydı açarken dağıtım sürümünü, mimariyi, aktif kanalı ve etkilenen paket sürümünü ekle. Komutu kopyalayıp yapıştırmak yerine hedef dosya ve aygıt adlarını önce gözden geçir. Birden fazla adım varsa her adımın çıktısını ayrı sakla; sorunun ilk görüldüğü zamanı not et. Başarılı sonucu yalnızca komutun çıkış koduyla değil, beklenen işlevi test ederek doğrula. Kişisel verileri ve gizli anahtarları paylaşmadan önce logları redakte et. Bu sayfadaki sürüm bilgilerini yeni release çıktısıyla karşılaştırarak güncel tut.