mirror of
https://github.com/outbackdingo/matchbox.git
synced 2026-01-27 10:19:35 +00:00
1f96cd36b2
* Add initrd=main karg directive for UEFI (ignored by BIOS) * Update Butane config version to v1.4.0 (generates Ignition v3.3.0) in `fedora-coreos` and `fedora-coreos-install` examples * Update virt-install flag --os-variant * Removed virt-install deprecated flag --os-type * Remove virt-install QEMU/KVM event preserve since it apparently wasn't implemented anyway and QEMU/KVM now warns about it * Remove serial consol kernel argument from examples, but still mention it in docs Rel: * https://github.com/coreos/fedora-coreos-docs/pull/282 * https://www.spinics.net/linux/fedora/libvir/msg222078.html
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"]
}
}