matchbox

module
Version: v0.5.0 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Jan 23, 2017 License: Apache-2.0

README

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
  • Multi-node Torus distributed storage 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

Directories

Path Synopsis
cmd
matchbox
cli
Package cli provides a command line interface client.
Package cli provides a command line interface client.
client
Package client provides the matchbox gRPC client.
Package client provides the matchbox gRPC client.
http
Package http provides the matchbox HTTP server
Package http provides the matchbox HTTP server
rpc
Package rpc provides the matchbox gRPC server
Package rpc provides the matchbox gRPC server
rpc/rpcpb
Package rpcpb provides RPC client and server interfaces.
Package rpcpb provides RPC client and server interfaces.
server
Package server is a matchbox library package for implementing servers.
Package server is a matchbox library package for implementing servers.
server/serverpb
Package serverpb provides matchbox message types.
Package serverpb provides matchbox message types.
sign
Package sign adds signatures to matchbox responses.
Package sign adds signatures to matchbox responses.
storage
Package storage defines matchbox's storage and object types.
Package storage defines matchbox's storage and object types.
storage/storagepb
Package storagepb provides storage protobuf client and server interfaces.
Package storagepb provides storage protobuf client and server interfaces.
storage/testfakes
Package testfakes provides shared storage implementations for testing.
Package testfakes provides shared storage implementations for testing.
version
Package version provides the matchbox version.
Package version provides the matchbox version.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL