mirror of
https://github.com/outbackdingo/matchbox.git
synced 2026-01-27 10:19:35 +00:00
70f6621044
We still support passing the rootfs image as an appended initrd, but we recommend using coreos.live.rootfs_url instead: it generally boots faster and requires less RAM.
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 |
Customization
For Fedora CoreOS, add an SSH authorized key to Fedora CoreOS Config (ignition/fedora-coreos.yaml) and regenerate the Ignition Config.
variant: fcos
version: 1.1.0
passwd:
users:
- name: core
ssh_authorized_keys:
- ssh-rsa pub-key-goes-here
podman run -i --rm quay.io/coreos/fcct:release --pretty --strict < fedora-coreos.yaml > fedora-coreos.ign
For Flatcar Linux, add a Matchbox variable to a Group (groups/flatcar-install/flatcar.json) to set the SSH authorized key (or directly update the Container Linux Config).
{
"id": "stage-1",
"name": "Flatcar Linux",
"profile": "flatcar",
"selector": {
"os": "installed"
},
"metadata": {
"ssh_authorized_keys": ["ssh-rsa pub-key-goes-here"]
}
}