mirror of
https://github.com/outbackdingo/matchbox.git
synced 2026-01-27 18:19:36 +00:00
d081cf30d3
* Update Fedora CoreOS live PXE and disk install examples to Fedora 33 * Increase libvirt VM memory from 2GB to 3GB to support live PXE example, which is mostly just for laptop examples/demos. Reduce the VM count from 3 to 2 to compensate. * Change `fedora-coreos.ign` to suggest using an ed25519 SSH key since Fedora CoreOS 33 disables RSA SHA1 (256 is still ok but most people won't know which they have)
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"]
}
}