Katkıda Bulunma

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

Forgejo üzerinde hata bildirimi, tarif katkısı, test ve saygılı topluluk iş 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.

Başlamadan önce

Nucora kaynak kodu Forgejo’da nucorafoundation organizasyonu altında listelenmiştir: nux, nux-maker, nux-gen, nux-intake, nux-reindex, nux-fix-sha, nux-tester. Katkıya başlamadan önce hedef repo lisansını, CONTRIBUTING dosyasını ve mevcut issue/PR’ları oku.

Bug raporu

Rapor; Nucora sürümü, mimari, kanal, paket sürümü, beklenen/gerçek davranış, tekrar üretim adımları ve redakte edilmiş log içermelidir. Parola, tester anahtarı, e-posta token’ı, özel IP ve kullanıcı verisini ekleme. Tek sorun için tek rapor oluştur.

Recipe katkısı

Tarif PR’ında upstream URL, SHA256 kaynağı, lisans, build bağımlılıkları, runtime bağımlılıkları ve test sonucu yer alsın. Build’i mümkünse /opt/nucora/chroots/st3-base benzeri izole ortamda yap. Paket manifestinin yalnızca amaçlanan dosyaları içerdiğini denetle.

Kod ve test disiplini

Go nux, Python build araçları ve shell yardımcıları farklı test/format araçları kullanabilir; repo içindeki yönerge önceliklidir. Test geçişini, komutları ve ortamı PR açıklamasında kaydet. Çalıştırmadığın testi başarılıymış gibi bildirme.

Değerlendirme ve davranış

Bakımcı geri bildirimi için küçük, odaklı değişiklikler gönder. Güvenlik açığını kamuya açık issue yerine proje tarafından ilan edilmiş özel bildirim yolundan ilet; özel kanal tanımlı değilse önce bakımcıyla güvenli iletişim yolunu sor. Katkıların lisans ve üçüncü taraf kaynak şartlarını ihlal etmediğini doğrula.

Güvenli uygulama akışı

Bu sayfadaki Katkıda Bulunma adımlarını uygularken önce mevcut durumu kaydet; ilgili sistemde nux doctor 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: katkıda bulunma. Ü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.