nixpkgs/nixos/lib
Graham Christensen 076f6e2d94 nixos/make-zfs-image: init
This is a private interface for internal NixOS  use. It is similar
to `make-disk-image` except it is much more opinionated about what
kind of disk image it'll make.

Specifically, it will always create *two* disks:

1. a `boot` disk formatted with FAT in a hybrid GPT mode.
2. a `root` disk which is completely owned by a single zpool.

The partitioning and FAT decisions should make the resulting images
bootable under EFI or BIOS, with systemd-boot or grub.

The root disk's zpools options are highly customizable, including
fully customizable datasets and their options.

Because the boot disk and partition are highly opinionated, it is
expected that the `boot` disk will be mounted at `/boot`. It is
always labeled ESP even on BIOS boot systems.

In order for the datasets to be mounted properly, the `datasets`
passed in to `make-zfs-image` are turned in to NixOS configuration
stored at /etc/nixos/configuration.nix inside the VM.
NOTE: The function accepts a system configuration in the `config`
argument. The *caller* must manually configure the system
in `config` to have each specified `dataset` be represented
by a corresponding `fileSystems` entry.

One way to test the resulting images is with qemu:

```sh
boot=$(find ./result/ -name '*.boot.*');
root=$(find ./result/ -name '*.root.*');

echo '`Ctrl-a h` to get help on the monitor';
echo '`Ctrl-a x` to exit';

qemu-kvm \
    -nographic \
    -cpu max \
    -m 16G \
    -drive file=$boot,snapshot=on,index=0,media=disk \
    -drive file=$root,snapshot=on,index=1,media=disk \
    -boot c \
    -net user \
    -net nic \
    -msg timestamp=on
```
2021-08-25 10:42:35 -04:00
..
make-options-doc
test-driver nixos/test: some test fixes in succession of #125992 2021-08-20 13:38:22 -05:00
build-vms.nix
eval-config.nix
from-env.nix
make-channel.nix
make-disk-image.nix
make-ext4-fs.nix
make-iso9660-image.nix
make-iso9660-image.sh
make-squashfs.nix
make-system-tarball.nix
make-system-tarball.sh
make-zfs-image.nix nixos/make-zfs-image: init 2021-08-25 10:42:35 -04:00
qemu-flags.nix
testing-python.nix nixos/tests/test-driver: better control test env symbols 2021-08-19 23:55:26 -05:00
utils.nix treewide: runCommandNoCC -> runCommand 2021-08-15 17:36:41 +02:00