mirror of https://github.com/outbackdingo/matchbox.git synced 2026-01-27 18:19:36 +00:00

Files

Dalton Hubble c002e06639 Migrate container image builds to GitHub Workflows

* Migrate from the internal Drone server using a GitHub Workflow
to perform the multi-arch container image build
* Use self-hosted GitHub runners on ARM64 to perform the ARM64
build step faster that QEMU/KVM emulation
* Mandate approval for all workflow runs from outside contributors
since the builds use push credentials and partially run internally

2023-05-20 11:59:17 -07:00

2.2 KiB

Raw Blame History

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

2.2 KiB Raw Blame History