matchbox

module

v0.8.0 Latest Latest Go to latest Published: May 7, 2019 License: Apache-2.0

Details

Valid go.mod file

The Go module system was introduced in Go 1.11 and is the official dependency management solution for Go.
Redistributable license

Redistributable licenses place minimal restrictions on how software can be used, modified, and redistributed.
Tagged version

Modules with tagged versions give importers more predictable builds.
Stable version

When a project reaches major version v1 it is considered stable.
Learn more about best practices

Repository

github.com/poseidon/matchbox

Links

Open Source Insights

README ¶

matchbox

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.

Documentation
matchbox Service
Profiles
Groups
Config Templates
- Container Linux Config
- Cloud-Config
Configuration
HTTP API / gRPC API
Background: Machine Lifecycle
Background: PXE Booting

Installation

Installation
- Installing on Container Linux / other distros
- Installing on Kubernetes
- Running with rkt / docker
Network Setup

Tutorials

Getting Started - provision physical machines with Container Linux
Local QEMU/KVM
- matchbox with Docker
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

dnsmasq - Run DHCP, TFTP, and DNS services with docker or rkt
terraform-provider-matchbox - Terraform provider plugin for Matchbox

Directories ¶

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

Path	Synopsis
cmd
bootcmd
matchbox
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.
tlsutil
version Package version provides the matchbox version.	Package version provides the matchbox version.