The Horizon Provider allows Terraform to manage Horizon certificates and their lifecycle.
Compatibility between the provider and Horizon versions is as follows:
| Provider version | Horizon version |
|---|---|
>= 0.1.x |
<=2.3 |
>= 0.2.x |
>=2.4 |
- Go >= 1.25
- Terraform >= 1.6 (for
terraform test) - mise for the task runner used below
- Docker (for the e2e suite — it spins Horizon up via testcontainers)
- An Horizon instance (only required for the live acceptance suite)
To build and test the provider, follow the steps described here. You have two options:
- Use Development Overrides if you need to quickly test out a change to the provider for a single configuration. This is the fastest way to test a change.
- Use Debugger-based Debugging which will allow you to run the provider separately from Terraform and attach a debugger to it. This is the best way to test a change thoroughly.
mise run build produces the binary under bin/.
The release process is automated via GitHub Actions, which can be audited int the release.yml file.
To release a new version, you need to create a new tag. The tag name must follow
the Semantic Versioning convention, starting with the letter v.