mirror of
https://github.com/outbackdingo/matchbox.git
synced 2026-01-27 10:19:35 +00:00
a7d19dfdd2
* Matchbox examples should be simple and educational to show how to PXE provision machines into clusters. Today, these goals are achieved well enough by the 3-node etcd cluster example * Several years ago, I put together examples PXE booting Kubernetes clusters with Matchbox. That was before we wrote Tectonic or Kubernetes was as popular as it is. Today, a Kubernetes distro is a project in its own right. It no longer makes sense to maintain (duplicate) a Kubernetes distro as "an example" inside Matchbox. * Matchbox is now used for Kubernetes cluster provisioning in more organizations than ever. It backs the poseidon/Typhoon and kinvolk/Locomotive distros. These both serve as great external examples of using Matchbox to provision Kubernetes clusters Attention: If you relied on Matchbox Kubernetes docs, you can find a similar guide at https://typhoon.psdn.io/cl/bare-metal/ (same author). https://github.com/poseidon/typhoon/
matchbox 
matchbox is a service that matches bare-metal machines (based on labels like MAC, UUID, etc.) to profiles that PXE boot and provision Container Linux clusters. Profiles specify the kernel/initrd, kernel arguments, iPXE config, GRUB config, Container Linux Config, or other configs a machine should use. Matchbox can be installed as a binary, RPM, container image, or deployed on a Kubernetes cluster and it provides an authenticated gRPC API for clients like Terraform.
- Documentation
- matchbox Service
- Profiles
- Groups
- Config Templates
- Configuration
- HTTP API / gRPC API
- Background: Machine Lifecycle
- Background: PXE Booting
Installation
- Installation
- Installing on Container Linux / other distros
- Installing on Kubernetes
- Running with rkt / docker
- Network Setup
Tutorials
- Getting Started - provision physical machines with Container Linux
- Local QEMU/KVM
- Clusters
- etcd3 - Install a 3-node etcd3 cluster
- Clusters (Terraform-based)
- etcd3 - Install a 3-node etcd3 cluster
Contrib
- dnsmasq - Run DHCP, TFTP, and DNS services with docker or rkt
- terraform-provider-matchbox - Terraform provider plugin for Matchbox