Skip to content
Network boot and provision Container Linux clusters (e.g. etcd3, Kubernetes, more)
Branch: master
Clone or download
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
Documentation Show the full OpenPGP fingerprint instead of long form May 7, 2019
cmd Rename Go module/packages org to poseidon May 3, 2019
contrib Prepare for Matchbox v0.8.0 release May 7, 2019
examples Update Kubernetes cluster example to v1.14.1 May 7, 2019
matchbox Rename Go module/packages org to poseidon May 3, 2019
scripts Prepare for Matchbox v0.8.0 release May 7, 2019
vendor Vendor Go module dependencies Mar 11, 2019
.dockerignore Update dockerignore to slim the build context Jan 13, 2017
.gitignore contrib/rpm: Fixing the source URL format May 10, 2017
.travis.yml Update coreos/dnsmasq image and automate deploys May 3, 2019
CHANGES.md Prepare for Matchbox v0.8.0 release May 7, 2019
CONTRIBUTING.md licenses: Add license and contributing guide Dec 21, 2015
DCO licenses: Add license and contributing guide Dec 21, 2015
Dockerfile Update base container image from alpine:3.6 to alpine:3.9 Mar 11, 2019
LICENSE licenses: Add license and contributing guide Dec 21, 2015
MAINTAINERS Add a MAINTAINERS file Nov 20, 2018
Makefile Rename Go module/packages org to poseidon May 3, 2019
NOTICE licenses: Add license and contributing guide Dec 21, 2015
README.md Update Kubernetes cluster example to v1.14.1 May 7, 2019
code-of-conduct.md update CoC Jan 4, 2018
go.mod Rename Go module/packages org to poseidon May 3, 2019
go.sum

README.md

matchbox Build Status GoDoc Docker Repository on Quay

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.

Installation

Tutorials

  • Getting Started - provision physical machines with Container Linux
  • Local QEMU/KVM
  • Clusters
    • etcd3 - Install a 3-node etcd3 cluster
    • Kubernetes - Install a 3-node Kubernetes v1.8.5 cluster
  • Clusters (Terraform-based)
    • etcd3 - Install a 3-node etcd3 cluster
    • Kubernetes - Install a 3-node Kubernetes v1.14.1 cluster

Contrib

You can’t perform that action at this time.