raspios-cloudinit

Packer configuration for building RaspiOS Lite image with Cloud-Init and Netplan included for first-boot provisioning

Using release version

1. Open latest release and download an image with required architecture.

2. (Optional) Download file with .sha256 extension and run sha256sum --check raspios-cloudinit*.zip.sha256 to verify that downloaded image is intact.

3. Extract .img file from downloaded zip.

4. Run lsblk -pdo name,tran,size,label to find path to SD card that you intend for use. It should be simular to /dev/sda and have usb transfer type.

5. CAREFUL! (this step can overwrite data on any device)

sudo dd if={Extracted .img file} of={Path from previous step} conv=fsync bs=8M status=progress

1. Open boot partition on SD card and edit network-config and user-data for first boot setup. Syntax for user-data is documented at cloudinit.readthedocs.io and for network-config at netplan.io

Building from scratch

Dependencies

Ubuntu

1. Add Hashicorp keys and repository to install packer:

curl -fsSL https://apt.releases.hashicorp.com/gpg | sudo apt-key add -
sudo apt-add-repository "deb [arch=amd64] https://apt.releases.hashicorp.com $(lsb_release -cs) main"

1. Add Ansible PPA for newest release

sudo add-apt-repository --yes --update ppa:ansible/ansible

1. Install packer and ansible:

sudo apt-get update
sudo apt-get install -y packer ansible

Fedora

1. Add Hashicorp repository to install packer:

sudo dnf config-manager --add-repo https://rpm.releases.hashicorp.com/fedora/hashicorp.repo

1. Install packer and ansible:

sudo dnf install packer ansible-core ansible-collection-community-general

Other

You are on your own, open PR if you want to add support for other platform

• packer
• ansible-core
• ansible-collection-community-general

Build

1. Make any changes in group_vars/all.yml for image settings.

2. Make any needed changes in ./config for cloud-init.

3. Run sudo packer build -var arch=arm64 . (You can replace arch with armhf for 32bit version). Resulting image will be put into ./output-raspios-cloudinit directory.

Flashing

Makefile includes simple script to flash and verify built image.

1. Run make lsblk to find name of SD Card, it should have an "usb" transfer type.

2. CAREFUL! (this step can overwrite data on any device) run sudo make flash SD_CARD=/dev/sd* where "/dev/sd*" is a name from previous step