Un elegante contenedor para dnf --installroot
, apt
, pacman
y zypper
que genera imágenes de disco personalizadas con una serie de detalles.
Para obtener una descripción más detallada y las funciones y opciones disponibles, consulte la página de manual.
Puedes instalar mkosi desde tu distribución usando su administrador de paquetes o instalar la versión de desarrollo desde git. Si instala mkosi usando el administrador de paquetes de su distribución, asegúrese de que instale al menos mkosi v16 o más reciente (use mkosi --version
para verificar). Si su distribución solo incluye una versión anterior de mkosi, se recomienda instalar mkosi utilizando uno de los métodos de instalación alternativos que se enumeran a continuación.
Para ejecutar mkosi directamente desde su repositorio git, puede invocar shim bin/mkosi
. La variable de entorno MKOSI_INTERPRETER
se puede configurar cuando se usa el shim bin/mkosi
para configurar el intérprete de Python utilizado para ejecutar mkosi. El shim puede tener un enlace simbólico, por ejemplo, /usr/local/bin
para que sea accesible desde PATH
.
git clone https://github.com/systemd/mkosi
ln -s $PWD /mkosi/bin/mkosi /usr/local/bin/mkosi
mkosi --version
mkosi también se puede instalar directamente desde la URL del repositorio de git usando pipx
:
pipx install git+https://github.com/systemd/mkosi.git
mkosi --version
que instalará mkosi de forma transparente en un entorno virtual Python y un binario mkosi en ~/.local/bin
. Esto es, hasta la ruta del entorno virtual y el binario mkosi, equivalente a
python3 -m venv mkosivenv
mkosivenv/bin/pip install git+https://github.com/systemd/mkosi.git
mkosivenv/bin/mkosi --version
También puede empaquetar mkosi como una aplicación zip que puede implementar en cualquier lugar de su PATH
. Al ejecutar esto, se dejará un binario mkosi
en builddir/
git clone https://github.com/systemd/mkosi
cd mkosi
tools/generate-zipapp.sh
builddir/mkosi --version
Además del binario mkosi, también puedes llamar a mkosi a través de
python3 -m mkosi
cuando no está instalado como zipapp.
Tenga en cuenta que el módulo Python existe únicamente para el uso del binario mkosi y no debe considerarse una API pública.
mkosi también se puede utilizar como complemento de instalación del kernel para crear initrds. Para habilitar esta función, instale kernel-install/50-mkosi.install
en /usr/lib/kernel/install.d
. La configuración de distribución adicional para initrd se puede configurar en /usr/lib/mkosi-initrd
. Los usuarios pueden agregar sus propias personalizaciones en /etc/mkosi-initrd
.
Una vez instalado, el complemento mkosi se puede habilitar escribiendo initrd_generator=mkosi-initrd
en /usr/lib/kernel/install.conf
o en /etc/kernel/install.conf
.
Para hackear mkosi, también necesitarás mypy, para verificar tipos, y pytest, para ejecutar pruebas. Verificamos las pruebas y escribimos CI (consulte .github/workflows
), pero también puede ejecutar las pruebas localmente.
Encuéntrenos en Matrix en #mkosi:matrix.org.