Pembungkus mewah di sekitar dnf --installroot
, apt
, pacman
dan zypper
yang menghasilkan image disk yang disesuaikan dengan sejumlah fitur tambahan.
Untuk deskripsi yang lebih panjang serta fitur dan opsi yang tersedia, lihat halaman manual.
Anda dapat menginstal mkosi dari distribusi Anda menggunakan manajer paketnya atau menginstal versi pengembangan dari git. Jika Anda menginstal mkosi menggunakan manajer paket distribusi Anda, pastikan mkosi menginstal setidaknya mkosi v16 atau lebih baru (Gunakan mkosi --version
untuk memeriksanya). Jika distribusi Anda hanya mengemas mkosi versi lama, disarankan untuk menginstal mkosi menggunakan salah satu metode instalasi alternatif yang tercantum di bawah.
Untuk menjalankan mkosi langsung dari repositori gitnya, Anda dapat memanggil shim bin/mkosi
. Variabel lingkungan MKOSI_INTERPRETER
dapat diatur saat menggunakan shim bin/mkosi
untuk mengkonfigurasi interpreter python yang digunakan untuk mengeksekusi mkosi. Shim dapat disinkronkan misalnya /usr/local/bin
agar dapat diakses dari PATH
.
git clone https://github.com/systemd/mkosi
ln -s $PWD /mkosi/bin/mkosi /usr/local/bin/mkosi
mkosi --version
mkosi juga dapat diinstal langsung dari url repositori git menggunakan pipx
:
pipx install git+https://github.com/systemd/mkosi.git
mkosi --version
yang secara transparan akan menginstal mkosi ke dalam lingkungan virtual Python dan biner mkosi ke ~/.local/bin
. Ini, hingga jalur lingkungan virtual dan biner mkosi, setara dengan
python3 -m venv mkosivenv
mkosivenv/bin/pip install git+https://github.com/systemd/mkosi.git
mkosivenv/bin/mkosi --version
Anda juga dapat mengemas mkosi sebagai zipapp yang dapat Anda terapkan di mana saja di PATH
Anda. Menjalankan ini akan meninggalkan biner mkosi
di builddir/
git clone https://github.com/systemd/mkosi
cd mkosi
tools/generate-zipapp.sh
builddir/mkosi --version
Selain biner mkosi, Anda juga dapat menghubungi mkosi melalui
python3 -m mkosi
ketika tidak diinstal sebagai zipapp.
Harap diperhatikan, bahwa modul python hanya ada untuk penggunaan biner mkosi dan tidak dianggap sebagai API publik.
mkosi juga dapat digunakan sebagai plugin instalasi kernel untuk membangun initrds. Untuk mengaktifkan fitur ini, instal kernel-install/50-mkosi.install
ke /usr/lib/kernel/install.d
. Konfigurasi distro tambahan untuk initrd dapat dikonfigurasi di /usr/lib/mkosi-initrd
. Pengguna dapat menambahkan penyesuaian mereka sendiri di /etc/mkosi-initrd
.
Setelah terinstal, plugin mkosi dapat diaktifkan dengan menulis initrd_generator=mkosi-initrd
ke /usr/lib/kernel/install.conf
atau ke /etc/kernel/install.conf
.
Untuk meretas mkosi sendiri Anda juga memerlukan mypy, untuk pemeriksaan tipe, dan pytest, untuk menjalankan tes. Kami memeriksa pengujian dan mengetik di CI (lihat .github/workflows
), namun Anda juga dapat menjalankan pengujian secara lokal.
Temukan kami di Matrix di #mkosi:matrix.org.