Skip to content

📖 Guide Visuel - Configuration Terraform Cloud UI

🎯 Vue d'ensemble

Tout se fait via l'interface web, aucun terminal nécessaire !

📋 Étape 1 : Créer le Workspace

Dans Terraform Cloud (app.terraform.io) :

┌─────────────────────────────────────┐
│  🏠 Organizations                   │
│  ├── Your Organization              │
│  │   └── Workspaces                │
│  │       └── [+ New Workspace]     │
└─────────────────────────────────────┘

Choisir : - ✅ CLI-driven workflow - Nom : docker-swarm-hetzner - Description : Docker Swarm cluster on Hetzner Cloud

🔑 Étape 2 : Variables d'Environnement

Workspace → Settings → Variables → Environment Variables

Cliquez [+ Add variable] :

┌──────────────────────────────────────────┐
│  Key:         HCLOUD_TOKEN               │
│  Value:       [votre-token-hetzner]      │
│  Description: Hetzner Cloud API Token    │
│  ☑️ Sensitive                            │
│  [Save variable]                         │
└──────────────────────────────────────────┘

📝 Étape 3 : Variables Terraform

Dans la même page, section "Terraform Variables" :

Variable 1 : Organization

┌──────────────────────────────────────────┐
│  Key:         terraform_cloud_organization│
│  Value:       votre-org-name             │
│  Description: Your TF Cloud organization │
│  ☐ Sensitive                            │
│  [Save variable]                         │
└──────────────────────────────────────────┘

Variable 2 : Workspace

┌──────────────────────────────────────────┐
│  Key:         terraform_cloud_workspace  │
│  Value:       docker-swarm-hetzner       │
│  Description: Workspace name             │
│  ☐ Sensitive                            │
│  [Save variable]                         │
└──────────────────────────────────────────┘

Variable 3 : Token Hetzner (Terraform)

┌──────────────────────────────────────────┐
│  Key:         hcloud_token               │
│  Value:       [votre-token-hetzner]      │
│  Description: Hetzner API Token          │
│  ☑️ Sensitive                            │
│  [Save variable]                         │
└──────────────────────────────────────────┘

📤 Étape 4 : Upload Configuration

Workspace → Overview → [Upload configuration]

Fenêtre d'upload :

┌────────────────────────────────────────┐
│  📁 Select files to upload:            │
│                                        │
│  ☑️ main.tf                           │
│  ☑️ variables.tf                      │
│  ☑️ outputs.tf                        │
│  ☑️ resources.tf                      │
│  ☑️ terraform.auto.tfvars             │
│  ☑️ scripts/                          │
│     ├── ☑️ cloud-init-manager.yaml   │
│     └── ☑️ cloud-init-worker.yaml    │
│                                        │
│  [Upload configuration]                │
└────────────────────────────────────────┘

💡 Astuce : Sélectionnez tous les fichiers d'un coup avec Ctrl+A

🚀 Étape 5 : Déploiement

Dans Overview, cliquez :

┌────────────────────────────────────┐
│  [Actions ▼] → Start new run       │
└────────────────────────────────────┘

Écran de Plan :

┌─────────────────────────────────────────────┐
│  Plan: 35 to add, 0 to change, 0 to destroy│
│                                             │
│  Resources to create:                      │
│  + hcloud_server.manager[0]               │
│  + hcloud_server.manager[1]               │
│  + hcloud_server.manager[2]               │
│  + hcloud_server.worker[0]                │
│  + hcloud_server.worker[1]                │
│  + hcloud_server.worker[2]                │
│  + hcloud_load_balancer.swarm             │
│  + hcloud_network.swarm                   │
│  + hcloud_firewall.swarm                  │
│  ...                                       │
│                                             │
│  Estimated monthly cost: 45.96 EUR         │
│                                             │
│  [Confirm & Apply]                         │
└─────────────────────────────────────────────┘

📊 Étape 6 : Outputs

Après déploiement (5 min), voir Outputs :

┌─────────────────────────────────────────────┐
│  Outputs:                                   │
│                                             │
│  load_balancer_ip = "95.217.xxx.xxx"      │
│  manager_ips = ["88.99.xxx.xxx", ...]     │
│  portainer_url = "http://88.99.xxx:9000"  │
│  grafana_url = "http://88.99.xxx:3000"    │
│  ssh_manager_command = "ssh -i keys/..."   │
│  estimated_monthly_cost = "45.96 EUR"      │
└─────────────────────────────────────────────┘

⚙️ Variables Optionnelles (Personnalisation)

Pour modifier la configuration, ajoutez ces variables Terraform :

Variable Valeur par défaut Options
manager_count 3 1, 3, 5 (impair pour consensus)
worker_count 3 1-100
location nbg1 nbg1, fsn1, hel1, ash, hil
manager_server_type cx21 cx11, cx21, cx31, cx41
worker_server_type cx11 cx11, cx21, cx31, cx41
admin_ips ["0.0.0.0/0"] ["votre.ip/32"]

Exemple : Cluster plus grand

manager_count = 5
worker_count = 10
worker_server_type = "cx21"

→ Coût : ~95€/mois

Exemple : Cluster minimal (dev)

manager_count = 1
worker_count = 2
manager_server_type = "cx11"

→ Coût : ~20€/mois

🔄 Mise à jour du Cluster

  1. Modifier les variables dans Settings → Variables
  2. Actions → Start new run
  3. Vérifier le plan
  4. Confirm & Apply

🗑️ Destruction

⚠️ ATTENTION : Supprime tout !

Settings → Destruction and Deletion → Queue destroy plan

Confirmation requise : tapez le nom du workspace

💡 Tips & Tricks

🔐 Sécurité

  • Toujours marquer hcloud_token comme Sensitive
  • Remplacer admin_ips = ["0.0.0.0/0"] par vos IPs réelles

💰 Économies

  • Utilisez cx11 pour les tests (3.29€/mois)
  • Désactivez create_floating_ips si pas nécessaire (-3.57€)
  • Réduisez volume_size si peu de données

🚀 Performance

  • cx21 minimum pour les managers en production
  • cpx series pour CPU partagé (moins cher)
  • ccx series pour CPU dédié (performance max)

📊 Monitoring

  • Grafana : admin/admin (changez le mot de passe !)
  • Prometheus : Métriques sur :9090
  • Portainer : Interface Docker sur :9000

❓ FAQ

Q: Où trouver mon token Hetzner ?

console.hetzner.cloud → Security → API Tokens

Q: Comment voir les logs ?

Workspace → Runs → Cliquez sur un run → View log

Q: Comment changer la région ?

Variable location : nbg1, fsn1, hel1, ash, hil

Q: Le déploiement échoue ?

Vérifiez : Token valide, Quotas Hetzner, Variables correctes

🎉 Félicitations !

Votre cluster Docker Swarm est opérationnel sur Hetzner Cloud !

Prochaines étapes : 1. Accédez à Portainer pour gérer vos containers 2. Consultez Grafana pour le monitoring 3. Déployez vos applications !

Support : - 📧 Hetzner : support@hetzner.com - 💬 Community : reddit.com/r/hetzner - 📚 Docs : docs.hetzner.cloud

Commentaires