Talos Linux on OpenStack: Step by Step

This repository contains Terraform resources for bringing up a cluster of Talos VMs on OpenStack using Terraform or OpenTofu.

A step-by-step guide can be found on our blog:

• English: Talos Linux on OpenStack: Step by Step
• German: Talos Linux auf OpenStack: Schritt fr Schritt

Quick Start

[!NOTE] If you are a NETWAYS Cloud customer and want to deploy Talos there, please see the resources on the netways-cloud branch [Link] for a tweaked version.

While we strongly encourage reading the whole step by step guide linked above, here's a primer on how to get started with this repository.

1. Clone the repository and initialize Terraform.

   git clone https://github.com/NETWAYS/terraform-talos-openstack
   cd terraform-talos-openstack
   terraform init
   

2. Configure the OpenStack provider in main.tf. For configuration options, see the
   official provider documentation.
3. Let Terraform provision the resources.

   terraform apply
   

4. Generate the Talos configuration(s). Use the Floating IP from the previous step's output.

   talosctl gen secrets
   talosctl gen config talos-on-openstack https://<floating-ip>:6443 --with-secrets secrets.yaml
   

5. Let Terraform provision the resources again to apply Talos' configuration(s).

   terraform apply
   

6. Bootstrap Kubernetes using talosctl.

   talosctl bootstrap -e <floating-ip> -n <floating-ip>
   

Questions and Support

Feel free to open an issue using one of the issue templates available.

License

The material published in this repository is licensed under the Creative Commons Zero license. A copy can be found in the LICENSE file in this repository.