Files
matchbox/examples

Examples

These examples network boot and provision machines into CoreOS clusters using bootcfg. You can re-use their profiles to provision your own physical machines.

Name Description CoreOS Version FS Docs
simple CoreOS with autologin, using iPXE beta/1185.1.0 RAM reference
simple-install CoreOS Install, using iPXE beta/1185.1.0 RAM reference
grub CoreOS via GRUB2 Netboot beta/1185.1.0 RAM NA
etcd A 3 node etcd cluster with proxies beta/1185.1.0 RAM reference
etcd-install Install a 3 node etcd cluster to disk beta/1185.1.0 Disk reference
etcd3 A 3 node etcd3 cluster with proxies beta/1185.1.0 RAM None
etcd3-install Install a 3 node etcd3 cluster to disk beta/1185.1.0 Disk None
k8s Kubernetes cluster with 1 master, 2 workers, and TLS-authentication beta/1185.1.0 Disk tutorial
k8s-install Kubernetes cluster, installed to disk beta/1185.1.0 Disk tutorial
rktnetes Kubernetes cluster with rkt container runtime, 1 master, workers, TLS auth (experimental) beta/1185.1.0 Disk tutorial
rktnetes-install Kubernetes cluster with rkt container runtime, installed to disk (experimental) beta/1185.1.0 Disk tutorial
bootkube iPXE boot a self-hosted Kubernetes cluster (with bootkube) beta/1185.1.0 Disk tutorial
bootkube-install Install a self-hosted Kubernetes cluster (with bootkube) beta/1185.1.0 Disk tutorial
torus Torus distributed storage beta/1185.1.0 Disk tutorial

Tutorials

Get started running bootcfg on your Linux machine to network boot and provision clusters of VMs or physical hardware.

SSH Keys

Most examples allow ssh_authorized_keys to be added for the core user as machine group metadata.

# /var/lib/bootcfg/groups/default.json
{
    "name": "Example Machine Group",
    "profile": "pxe",
    "metadata": {
        "ssh_authorized_keys": ["ssh-rsa pub-key-goes-here"]
    }
}

Conditional Variables

"pxe"

Some examples check the pxe variable to determine whether to create a /dev/sda1 filesystem and partition for PXEing with root=/dev/sda1 ("pxe":"true") or to write files to the existing filesystem on /dev/disk/by-label/ROOT ("pxe":"false").