mirror of
https://github.com/outbackdingo/terraform-provider-matchbox.git
synced 2026-01-27 10:20:39 +00:00
* Terraform Registry does not yet support ed25519 so revert to using the older RSA key that has been used to sign prior releases
1.1 KiB
1.1 KiB
Matchbox Provider
terraform-provider-matchbox allows defining Matchbox Profiles and Groups in Terraform. Matchbox matches machines, by label (e.g. MAC address), to Profiles with iPXE configs, Ignition configs, or generic free-form configs to provision clusters. Resources are created via the client certificate authenticated Matchbox API.
Usage
Setup a PXE network boot environment and deploy a Matchbox instance. Be sure to enable the gRPC API and follow the instructions to generate TLS credentials.
Configure the Matchbox provider with the Matchbox API endpoint and client certificate (e.g. providers.tf).
provider "matchbox" {
endpoint = "matchbox.example.com:8081"
client_cert = "${file("~/.matchbox/client.crt")}"
client_key = "${file("~/.matchbox/client.key")}"
ca = "${file("~/.matchbox/ca.crt")}"
}
terraform {
required_providers {
matchbox = {
source = "poseidon/matchbox"
version = "0.5.4"
}
}
}