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
matchbox 
matchbox is a service that matches bare-metal machines to profiles that PXE boot and provision clusters. Machines are matched by labels like MAC or UUID during PXE and profiles specify a kernel/initrd, iPXE config, and Ignition config.
Features
- Chainload via iPXE and match hardware labels
- Provision Fedora CoreOS or Flatcar Linux (powered by Ignition)
- Authenticated gRPC API for clients (e.g. Terraform)
Documentation
Installation
Matchbox can be installed from a binary or a container image.
- Install Matchbox as a binary, as a container image, or on Kubernetes
- Setup a PXE-enabled network
Tutorials
Start provisioning machines with Fedora CoreOS or Flatcar Linux.
- Terraform Usage
- Fedora CoreOS (PXE install to disk)
- Flatcar Linux (PXE install to disk)
- Local QEMU/KVM
- Fedora CoreOS (live PXE or PXE install to disk)
- Flatcar Linux (live PXE or PXE install to disk)
Contrib
- dnsmasq - Run DHCP, TFTP, and DNS services as a container
- terraform-provider-matchbox - Terraform provider plugin for Matchbox