mirror of
https://github.com/outbackdingo/matchbox.git
synced 2026-01-27 10:19:35 +00:00
e432763f51
* Add support for fcos v1.5.0 Butane Configs * Add support for flatcar v1.1.0 Butane Configs * Render Butane or raw Ignition to Ignition spec v3.4.0 using Ignition's forward compatibility support Rel: * https://coreos.github.io/butane/config-fcos-v1_5/ * https://coreos.github.io/butane/config-flatcar-v1_1/ * https://coreos.github.io/ignition/configuration-v3_4/
63 lines
2.3 KiB
Markdown
63 lines
2.3 KiB
Markdown
# Examples
|
|
|
|
Matchbox automates network booting and provisioning of clusters. These examples show how to use Matchbox on-premise or locally with QEMU/KVM.
|
|
|
|
## Terraform Examples
|
|
|
|
These examples use [Terraform](https://www.terraform.io/intro/) as a client to Matchbox.
|
|
|
|
| Name | Description |
|
|
|-------------------------------|-------------------------------|
|
|
| [fedora-coreos-install](terraform/fedora-coreos-install) | Fedora CoreOS disk install |
|
|
| [flatcar-install](terraform/flatcar-install) | Flatcar Linux disk install |
|
|
|
|
### Customization
|
|
|
|
Look through the examples and Terraform modules and use them as a starting point. Learn more about [matchbox](../docs/matchbox.md).
|
|
|
|
## Manual Examples
|
|
|
|
These examples mount raw Matchbox objects into a Matchbox server's `/var/lib/matchbox/` directory.
|
|
|
|
| Name | Description | FS | Docs |
|
|
|---------------|------------------------------|-----|-------|
|
|
| fedora-coreos | Fedora CoreOS live PXE | RAM | [docs](https://docs.fedoraproject.org/en-US/fedora-coreos/live-booting/) |
|
|
| fedora-coreos-install | Fedora CoreOS install | Disk | [docs](https://docs.fedoraproject.org/en-US/fedora-coreos/bare-metal/) |
|
|
| flatcar | Flatcar Linux live PXE | RAM | [docs](https://docs.flatcar-linux.org/os/booting-with-ipxe/) |
|
|
| flatcar-install | Flatcar Linux install | Disk | [docs](https://docs.flatcar-linux.org/os/booting-with-ipxe/) |
|
|
|
|
### SSH Access
|
|
|
|
For Fedora CoreOS, add an SSH authorized key to the Butane Config (`ignition/fedora-coreos.yaml`) and regenerate the Ignition Config.
|
|
|
|
```yaml
|
|
variant: fcos
|
|
version: 1.5.0
|
|
passwd:
|
|
users:
|
|
- name: core
|
|
ssh_authorized_keys:
|
|
- ssh-ed25519 SET_PUBKEY_HERE
|
|
```
|
|
|
|
```
|
|
podman run -i --rm quay.io/coreos/fcct:release --pretty --strict < fedora-coreos.yaml > fedora-coreos.ign
|
|
```
|
|
|
|
For Flatcar Linux, add an SSH authorized key to the Butane config (`ignition/flatcar.yaml` or `ignition/flatcar-install.yaml`) and regenerate the Ignition Config.
|
|
|
|
```yaml
|
|
variant: flatcar
|
|
version: 1.1.0
|
|
passwd:
|
|
users:
|
|
- name: core
|
|
ssh_authorized_keys:
|
|
- ssh-ed25519 SET_PUBKEY_HERE
|
|
```
|
|
|
|
```
|
|
podman run -i --rm quay.io/coreos/fcct:release --pretty --strict < flatcar.yaml > flatcar.ign
|
|
podman run -i --rm quay.io/coreos/fcct:release --pretty --strict < flatcar-install.yaml > flatcar-install.ign
|
|
```
|