mirror of
https://github.com/outbackdingo/matchbox.git
synced 2026-01-27 18:19:36 +00:00
* 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
2.3 KiB
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