discostur/matchbox

Network boot and provision Container Linux clusters (e.g. etcd3, self-hosted Kubernetes, and more)

matchbox

Network boot and provision Container Linux clusters on virtual or physical hardware.

Announcement: Matchbox v0.6.0 is released with a new Matchbox Terraform Provider and tutorial.

matchbox

matchbox is a service that matches machines (based on labels like MAC, UUID, etc.) to profiles to PXE boot and provision Container Linux clusters. Profiles specify the kernel/initrd, kernel arguments, iPXE config, GRUB config, Container Linux Config, Cloud-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
  • Container Linux Config
  • Cloud-Config
• Configuration
• HTTP API
• gRPC API
• Background: Machine Lifecycle
• Background: PXE Booting

Installation

• Installation
  • Installing on CoreOS / Linux distros
  • Installing on Kubernetes
  • Running with rkt / docker
• Network Setup

Tutorials

• Getting Started

Local QEMU/KVM

• matchbox with rkt
• matchbox with Docker

Example Clusters

Network boot the examples with QEMU/KVM VMs to try them on your Linux laptop.

• Multi-node self-hosted Kubernetes cluster
• Upgrading self-hosted Kubernetes clusters
• Multi-node Kubernetes cluster
• Multi-node rktnetes cluster (i.e. Kubernetes with rkt as the container runtime)

Contrib

• dnsmasq - Run DHCP, TFTP, and DNS services with docker or rkt

Enterprise

Tectonic is the enterprise-ready Kubernetes offering from CoreOS (free for 10 nodes!). The Tectonic Installer app integrates directly with matchbox through its gRPC API to provide a rich graphical client for populating matchbox with machine configs.

Learn more from our docs or blog.