matchbox/examples

Examples

Matchbox automates network booting and provisioning of clusters. These examples show how to use Matchbox on-premise or locally with QEMU/KVM.

Terraform Examples

These examples use Terraform as a client to Matchbox.

Name	Description
fedora-coreos-install	Fedora CoreOS disk install
flatcar-install	Flatcar Linux disk install

Customization

Look through the examples and Terraform modules and use them as a starting point. Learn more about matchbox.

Manual Examples

These examples mount raw Matchbox objects into a Matchbox server's /var/lib/matchbox/ directory.

Name	Description	FS	Docs
fedora-coreos	Fedora CoreOS live PXE	RAM	docs
fedora-coreos-install	Fedora CoreOS install	Disk	docs
flatcar	Flatcar Linux live PXE	RAM	docs
flatcar-install	Flatcar Linux install	Disk	docs

SSH Access

For Fedora CoreOS, add an SSH authorized key to the Butane Config (ignition/fedora-coreos.yaml) and regenerate the Ignition Config.

variant: fcos
version: 1.5.0
passwd:
  users:
    - name: core
      ssh_authorized_keys:
        - ssh-ed25519 SET_PUBKEY_HERE

podman run -i --rm quay.io/coreos/fcct:release --pretty --strict < fedora-coreos.yaml > fedora-coreos.ign

For Flatcar Linux, add an SSH authorized key to the Butane config (ignition/flatcar.yaml or ignition/flatcar-install.yaml) and regenerate the Ignition Config.

variant: flatcar
version: 1.1.0
passwd:
  users:
    - name: core
      ssh_authorized_keys:
        - ssh-ed25519 SET_PUBKEY_HERE

podman run -i --rm quay.io/coreos/fcct:release --pretty --strict < flatcar.yaml > flatcar.ign
podman run -i --rm quay.io/coreos/fcct:release --pretty --strict < flatcar-install.yaml > flatcar-install.ign