Files
matchbox/examples/README.md
Dalton Hubble e59b2b7b55 Update Flatcar Linux examples and use Ignition
* Discontinue using Matchbox's Container Linux Config features
* Flatcar Linux OS now supports Ignition v2.13+ which means it
can accept Ignition v3.x spec's, like Fedora CoreOS. Matchbox
supports this by serving Ignition documents directly
* Users of the poseidon/matchbox Terraform provider can pass
a `matchbox_profile` `raw_ignition` contents with the desired
Ignition v3.3 spec
* Users of the poseidon/ct Terraform provider can write Butane
Config YAML, perform templating, and render an Ignition document
using either the fcos or the flatcar variant
2022-07-29 22:12:20 -07:00

2.3 KiB

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.4.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.0.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