Skip to content

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

License

Notifications You must be signed in to change notification settings

bubble501/matchbox

 
 

Repository files navigation

matchbox Build Status GoDoc Docker Repository on Quay IRC

Network boot and provision CoreOS clusters on virtual or physical hardware.

Announcement: coreos-baremetal and bootcfg have been renamed to CoreOS matchbox, which will be reflected in v0.5.0. Please see CHANGES or #400. If you're looking for older docs, be sure to use the branch/tag switcher.

Guides

matchbox

matchbox is an HTTP and gRPC service that renders signed Ignition configs, cloud-configs, network boot configs, and metadata to machines to create CoreOS clusters. Groups match machines based on labels (e.g. MAC, UUID, stage, region) and use named Profiles for provisioning. Network boot endpoints provide PXE, iPXE, and GRUB. matchbox can be deployed as a binary, as an appc container with rkt, or as a Docker container.

Examples

The examples network boot and provision CoreOS clusters. Network boot QEMU/KVM VMs to try the examples on your Linux laptop.

  • Multi-node Kubernetes cluster
  • Multi-node rktnetes cluster (i.e. Kubernetes with rkt as the container runtime)
  • Multi-node self-hosted Kubernetes cluster
  • Upgrading self-hosted Kubernetes clusters
  • Multi-node etcd2 or etcd3 cluster
  • Network boot and/or install to disk (multi-stage installs)

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.

Tectonic Installer

Tectonic Console

About

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

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Go 82.1%
  • Shell 14.4%
  • Protocol Buffer 2.0%
  • Makefile 1.5%