matchbox

module
Version: v0.9.1 Latest Latest
Warning

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

Go to latest
Published: Aug 1, 2022 License: Apache-2.0

README

matchbox

GoDoc Quay Workflow Downloads Sponsors Twitter

matchbox is a service that matches bare-metal machines to profiles that PXE boot and provision clusters. Machines are matched by labels like MAC or UUID during PXE and profiles specify a kernel/initrd, iPXE config, and Ignition config.

Features

  • Chainload via iPXE and match hardware labels
  • Provision Fedora CoreOS or Flatcar Linux (powered by Ignition)
  • Authenticated gRPC API for clients (e.g. Terraform)

Documentation

Installation

Matchbox can be installed from a binary or a container image.

Tutorials

Start provisioning machines with Fedora CoreOS or Flatcar Linux.

  • Terraform Usage
    • Fedora CoreOS (PXE install to disk)
    • Flatcar Linux (PXE install to disk)
  • Local QEMU/KVM
    • Fedora CoreOS (live PXE or PXE install to disk)
    • Flatcar Linux (live PXE or PXE install to disk)

Contrib

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