Skip to content

Latest commit

 

History

History
80 lines (76 loc) · 2.09 KB

README.md

File metadata and controls

80 lines (76 loc) · 2.09 KB
Raw

ShellCheck

image-builder

builds disk images consisting of

  • ESP with systemd-boot and kernel
  • Root filesystem with either Alpine, Gentoo or FreeBSD
  • Optional A/B partitioning scheme
  • Optional read-only rootfs for bare metal or use as virtual machines

Usage

$ image-builder help

  Usage:

    image-builder build   TARGET: alpine|gentoo|freebsd
    image-builder create  TARGET: alpine|gentoo|freebsd
    image-builder write   DEVICE
    image-builder mount   [PARTITION: esp|rootfs]
    image-builder install

Create disk image

$ image-builder create alpine

Mount disk image

$ image-builder mount

Write disk image

$ image-builder write /dev/sdb

Alpine

Utilises raspi-alpine/builder to build an armhf image for Raspberry Pi

Gentoo

Fetches a custom kernel, custom binpkgs and an offical stage3 to create a disk image

Build

Linux

$ image-builder build linux-kernel
Alpine
$ image-builder build alpine
Gentoo
$ image-builder build gentoo

FreeBSD

$ image-builder build freebsd
$ image-builder build freebsd-kernel
$ image-builder build freebsd-world

Network

Wifi

If a wpa_supplicant.conf exists it gets copied to the image during post-build.
Alternatively if wifi credentials are supplied via env during post-build, a config is created from those. Use WIFI_SECURITY, WIFI_ESSID, WIFI_PASSPHRASE, e.g. via the file ENVIRONMENT to supply confguration

Environment

ANSIBLE_USER
ANSIBLE_ROLES
BUILD_TARGET_ARCH
BUILD_USE_CONTAINER
DEBUG
NET_DEV
NET_ADDRESS
NET_GATEWAY
SSH_USER
SSH_PUBKEY

Resources

raspi-alpine builder
Gentoo Handbook
FreeBSD Handbook
systemd-boot