david_igou.armbian.rootfs_provision role – Provision a per-host NFS rootfs from an .img.xz source

Note

This role is part of the david_igou.armbian collection (version 0.0.5-alpha).

It is not included in ansible-core. To check whether it is installed, run ansible-galaxy collection list.

To install it use: ansible-galaxy collection install david_igou.armbian.

To use it in a playbook, specify: david_igou.armbian.rootfs_provision.

Entry point main – Provision a per-host NFS rootfs from an .img.xz source

Synopsis

  • Downloads or copies an Armbian .img.xz, extracts the rootfs into a per-host directory on the netboot server, stages kernel/initrd/dtb to a TFTP cache directory, and resets host identity (hostname, machine-id, SSH host keys).

  • Provisioning is purely per-host — the rootfs is extracted directly into the per-host target directory (no shared per-model template, no reflink cloning). Hosts pointing at the same upstream URL share only the .img.xz download, via the URL-keyed armbian_rootfs_image_cache.

Parameters

Parameter

Comments

armbian_rootfs_dtb

string / required

DTB path under /boot/dtb/ to stage as the TFTP board.dtb (e.g. “rockchip/rk3588-rock-5b.dtb”). Comes from the host’s resolved armbian_board_config.dtb.

armbian_rootfs_force_refresh

boolean

Force re-extract regardless of sentinel.

Choices:

  • false ← (default)

  • true

armbian_rootfs_host

string / required

inventory_hostname this rootfs is for. Drives identity reset (hostname, machine-id) and the default target_dir suffix.

armbian_rootfs_image_cache

string

URL-keyed shared download cache. Hosts pointing at the same URL share the download.

armbian_rootfs_mount_dir

string

Mount point for the image’s rootfs partition (loop device) during extraction.

Default: "/mnt/armbian_rootfs_provision"

armbian_rootfs_src

string / required

.img.xz source. https:// URL, http:// URL, or absolute path. Resolved by the caller per the precedence in playbooks/tasks/_resolve_rootfs_src.yml.

armbian_rootfs_target_dir

string

NFS rootfs destination. Default per-host suffix under armbian_nfs_rootfs_path.

armbian_rootfs_tftp_dir

string

Per-host TFTP staging dir. Default per-host suffix under armbian_image_cache/sbc-tftp.