Skip to content

Latest commit

 

History

History
86 lines (51 loc) · 3.32 KB

README.md

File metadata and controls

86 lines (51 loc) · 3.32 KB
Raw

ignition-configs

Author: Brian Tomlinson btomlins@redhat.com

Description

Ignition configs for my Fedora CoreOS based projects.

IMPORTANT! - Once the prepare-sdcard.yaml playbook exits you will need to expand the root partition of the sdcard to take all avaialble space. Fedora CoreOS will not boot with the ~1GB root partition, it's there to keep the download size small.

Requirements

Microshift on Raspberry Pi 400

The repo is currently structured for creating configurations necessary for deploying to and preparing the Raspberry Pi 400 for Microshift.

All-in-one Automation

To generate the ignition configs simply clone the repo and execute make ansible.

The make ansible command will execute ansible-playbook -i inventory/hosts.ini main.yaml -K by default. This will prompt you for your sudo password before ensuring running the playbooks/fedora-prereqs.yaml playbook to install package dependencies and then immediately generate dist/master.ign and dist/worker.ign via the playbooks/generate-ign.yaml playbook.

Once the command exits, check dist/ and you will find the etc directory tree populated with configurations included in the ignition configs, as well as the ignition files.

Available make targets

  • make all: All-in-one automation via Ansible
  • make fedora-prereqs: Install dependencies to Fedora control node via fedora-prereqs.yaml playbook
  • make generate-ignition: Execute the generate-ign.yaml playbook
  • make prepare-sdcard: Execute the prepare-sdcard.yaml playbook
  • make clean: Deletes the build and dist directories
  • make clean-build: Only delete the build directory
  • make clean-dist: Only delete the dist directory
  • make distribution: Creates the dist directory, copies the etc directory tree, and processes the butane configs

Playbook structure

  • main.yaml imports the all playbooks, is the "all in one" entrypoint
  • fedora-prereqs.yaml ensures package dependencies are present
  • generate-ign.yaml processes the templates in playbooks/templates to build and copies the etc directory tree
  • prepare-sdcard.yaml attempts to write a bootable Fedora CoreOS configured with the supplied ignition config to the sdcard

Inventory variables

This is a non-exhaustive list, see the inventory/group_vars/all.yaml file for more options.

state: defaults to 'present', 'absent' is also valid and will remove elements similar to 'make clean'

ssh_user: defaults to the current $USER, used for finding the public SSH key of the user

ssh_pub_key: the public SSH key of the user, used to enable SSH for the 'core' user in the resulting image

prereq_pkgs:  list of package dependencies necessary for generating and consuming ignition configs

worker_hostname: the desired hostname of the worker node(s)

worker_ip: defaults to 'false', if declared will add the ip to the microshift config.yaml

master_hostname: the desired hostname of the master node(s)

master_ip: defaults to 'false', if declared will add the ip to the microshift config.yaml

LICENSE

MIT, see LICENSE file.