dnf --installroot
、 apt
、 pacman
、およびzypper
の派手なラッパーで、多数の付加機能を備えたカスタマイズされたディスク イメージを生成します。
詳しい説明と利用可能な機能とオプションについては、マニュアル ページを参照してください。
パッケージ マネージャーを使用してディストリビューションから mkosi をインストールすることも、git から開発バージョンをインストールすることもできます。ディストリビューションのパッケージ マネージャーを使用して mkosi をインストールする場合は、少なくとも mkosi v16 以降がインストールされていることを確認してください (確認するにはmkosi --version
を使用します)。ディストリビューションが古いバージョンの mkosi のみをパッケージ化している場合は、代わりに以下にリストされている代替インストール方法のいずれかを使用して mkosi をインストールすることをお勧めします。
mkosi を git リポジトリから直接実行するには、shim bin/mkosi
呼び出します。 MKOSI_INTERPRETER
環境変数は、 bin/mkosi
shim を使用して mkosi の実行に使用される Python インタープリターを構成するときに設定できます。 shim を/usr/local/bin
などにシンボリックリンクして、 PATH
からアクセスできるようにすることができます。
git clone https://github.com/systemd/mkosi
ln -s $PWD /mkosi/bin/mkosi /usr/local/bin/mkosi
mkosi --version
mkosi は、 pipx
使用して git リポジトリ URL から直接インストールすることもできます。
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 を zipapp としてパッケージ化し、 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 バイナリの使用のみを目的として存在し、パブリック API とはみなされないことに注意してください。
mkosi は、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
を参照) が、テストをローカルで実行することもできます。
#mkosi:matrix.org で Matrix を見つけてください。