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.
- Network Setup
- Machine Lifecycle
- Background: PXE Booting
- Tutorials (QEMU/KVM/libvirt)
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.
- matchbox Service
- Config Templates
- HTTP API
- gRPC API
- 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)
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.
Package cli provides a command line interface client.
|Package cli provides a command line interface client.|
Package client provides the matchbox gRPC client.
|Package client provides the matchbox gRPC client.|
Package http provides the matchbox HTTP server
|Package http provides the matchbox HTTP server|
Package rpc provides the matchbox gRPC server
|Package rpc provides the matchbox gRPC server|
Package rpcpb provides RPC client and server interfaces.
|Package rpcpb provides RPC client and server interfaces.|
Package server is a matchbox library package for implementing servers.
|Package server is a matchbox library package for implementing servers.|
Package serverpb provides matchbox message types.
|Package serverpb provides matchbox message types.|
Package sign adds signatures to matchbox responses.
|Package sign adds signatures to matchbox responses.|
Package storage defines matchbox's storage and object types.
|Package storage defines matchbox's storage and object types.|
Package storagepb provides storage protobuf client and server interfaces.
|Package storagepb provides storage protobuf client and server interfaces.|
Package testfakes provides shared storage implementations for testing.
|Package testfakes provides shared storage implementations for testing.|
Package version provides the matchbox version.
|Package version provides the matchbox version.|