mirror of
https://github.com/outbackdingo/matchbox.git
synced 2026-01-27 10:19:35 +00:00
* Regenerate example Ignition using fcct v0.18.0 to produce Ignition spec v3.4.0 as a followup to https://github.com/poseidon/matchbox/pull/1079 * Fix one profile example where a double escape isn't needed
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