غلاف فاخر حول dnf --installroot
و apt
و pacman
و zypper
يقوم بإنشاء صور قرص مخصصة مع عدد من الأجراس والصفارات.
للحصول على وصف أطول والميزات والخيارات المتاحة، راجع صفحة الدليل.
يمكنك تثبيت mkosi من توزيعتك باستخدام مدير الحزم الخاص به أو تثبيت إصدار التطوير من git. إذا قمت بتثبيت mkosi باستخدام مدير حزم التوزيع الخاص بك، فتأكد من تثبيته على الأقل mkosi v16 أو الأحدث (استخدم mkosi --version
للتحقق). إذا كان توزيعك يحتوي فقط على إصدار أقدم من mkosi، فمن المستحسن تثبيت mkosi باستخدام إحدى طرق التثبيت البديلة المدرجة أدناه بدلاً من ذلك.
لتشغيل mkosi مباشرةً من مستودع git الخاص به، يمكنك استدعاء shim bin/mkosi
. يمكن تعيين متغير البيئة MKOSI_INTERPRETER
عند استخدام bin/mkosi
shim لتكوين مترجم python المستخدم لتنفيذ mkosi. يمكن ربط الرقائق بـ /usr/local/bin
على سبيل المثال لتسهيل الوصول إليها من PATH
.
git clone https://github.com/systemd/mkosi
ln -s $PWD /mkosi/bin/mkosi /usr/local/bin/mkosi
mkosi --version
يمكن أيضًا تثبيت mkosi مباشرة من عنوان url لمستودع git باستخدام pipx
:
pipx install git+https://github.com/systemd/mkosi.git
mkosi --version
والذي سيقوم بتثبيت mkosi بشفافية في بيئة Python الافتراضية وملف mkosi الثنائي إلى ~/.local/bin
. وهذا ما يعادل مسار البيئة الافتراضية وثنائي mkosi
python3 -m venv mkosivenv
mkosivenv/bin/pip install git+https://github.com/systemd/mkosi.git
mkosivenv/bin/mkosi --version
يمكنك أيضًا حزم mkosi كتطبيق مضغوط يمكنك نشره في أي مكان في PATH
الخاص بك. سيؤدي تشغيل هذا إلى ترك ملف mkosi
الثنائي في builddir/
git clone https://github.com/systemd/mkosi
cd mkosi
tools/generate-zipapp.sh
builddir/mkosi --version
بالإضافة إلى ثنائي mkosi، يمكنك أيضًا الاتصال بـ mkosi عبر
python3 -m mkosi
عندما لا يتم تثبيته باعتباره zipapp.
يرجى ملاحظة أن وحدة python موجودة فقط لاستخدام ملف mkosi الثنائي ولا تعتبر واجهة برمجة تطبيقات عامة.
يمكن أيضًا استخدام mkosi كمكوِّن إضافي لتثبيت kernel لإنشاء initrds. لتمكين هذه الميزة، قم بتثبيت kernel-install/50-mkosi.install
في /usr/lib/kernel/install.d
. يمكن تكوين تكوين التوزيعة الإضافية لـ initrd في /usr/lib/mkosi-initrd
. يمكن للمستخدمين إضافة التخصيصات الخاصة بهم في /etc/mkosi-initrd
.
بمجرد التثبيت، يمكن تمكين المكون الإضافي mkosi عن طريق كتابة initrd_generator=mkosi-initrd
إلى /usr/lib/kernel/install.conf
أو إلى /etc/kernel/install.conf
.
لاختراق mkosi نفسه، ستحتاج أيضًا إلى mypy، للتحقق من النوع، وpytest، لإجراء الاختبارات. نحن نتحقق من الاختبارات ونكتب CI (انظر .github/workflows
)، ولكن يمكنك إجراء الاختبارات محليًا أيضًا.
تابعنا على Matrix على #mkosi:matrix.org.