From 26d2854c077c7da91a3b388eed5cf85cd9c4f579 Mon Sep 17 00:00:00 2001 From: Bernd Worsch Date: Sun, 14 Sep 2025 01:08:26 +0200 Subject: [PATCH] docs: added fast path documentation --- docs/provisioning.md | 27 +++++++++++++++++++++++++++ 1 file changed, 27 insertions(+) diff --git a/docs/provisioning.md b/docs/provisioning.md index 7a89a3c..98267cf 100644 --- a/docs/provisioning.md +++ b/docs/provisioning.md @@ -4,6 +4,33 @@ This guide explains **where you declare servers**, **how Terraform uses that dec --- +## 🚀 Fast Path: Using the Helper Script + +Instead of manually editing `inventory/servers.yaml` and running `make tf-apply`, you can use the convenience script [`scripts/hcloud_new_server.sh`](../scripts/hcloud_new_server.sh). +This script will: + +1. Add the new host entry to `inventory/servers.yaml` +2. Decrypt your Hetzner API token with SOPS +3. Run Terraform (`init/plan/apply`) to provision the server +4. Print the IPv4 address and a ready-to-use SSH command + +**Example:** + +```bash +scripts/hcloud_new_server.sh core-01 --type cpx11 --region nbg1 --role core +``` + +This will create a small cpx11 instance in the Nuremberg (nbg1) region, tagged with the role core. +You can then connect directly: + +```bash +ssh admin@ +``` + +👉 The script is optional. You can always manage servers by editing inventory/servers.yaml and running make tf-apply instead. + + + ## 1) Where you define servers All desired hosts live in **`inventory/servers.yaml`**. Each entry is a simple YAML object with the required attributes: