AI Infrastructure Documentation

Overview

Documentation complète de l'infrastructure IA basée sur Hetzner GEX44 pour déploiement multi-environnement avec Terraform, Ansible, et GitLab CI/CD.

Architecture

Environnements : Development, Staging, Production
Plateforme : Hetzner Cloud + Serveurs Dédiés GEX44
OS : Ubuntu 24.04 LTS sur tous les serveurs
GPU : NVIDIA RTX 4000 Ada Generation (20GB VRAM)
Container Runtime : Docker 24.0.x
Orchestration : Terraform + Ansible
CI/CD : GitLab Pipeline

Quick Links

🔧 Tools & Technologies - Liste complète des outils utilisés
🏗️ Infrastructure - Architecture détaillée
🚀 Deployment - Guide de déploiement
📊 Monitoring - Monitoring et observabilité
🔒 Security - Configuration sécurité
💰 Costs - Analyse des coûts

Structure du Projet

.
├── inventories/           # Configuration par environnement
│   ├── development/       # Environnement dev
│   ├── staging/          # Environnement staging
│   ├── production/       # Environnement production
│   └── generate_inventory.py  # Générateur d'inventaire Ansible
├── terraform/            # Infrastructure as Code
│   ├── environments/     # Configuration par environnement
│   └── modules/          # Modules réutilisables
├── ansible/              # Configuration Management
│   ├── roles/            # Rôles Ansible
│   ├── playbooks/        # Playbooks
│   └── group_vars/       # Variables par environnement
├── scripts/              # Scripts d'automatisation
├── monitoring/           # Configuration monitoring
└── docs/                 # Documentation

Coûts par Environnement

Environnement	Serveurs	Coût/mois	Description
Development	1x CX31 (CPU-only)	23€	Simulation GPU, tests dev
Staging	1x GEX44 + 2x Cloud	206€	Validation complète
Production	3x GEX44 + 3x Cloud	609€	Haute disponibilité
Total		838€	vs 15,840€ cloud équivalent

Getting Started

1. Prérequis

# Outils requis
terraform >= 1.12
ansible >= 8.0
python >= 3.12
docker >= 24.0

2. Configuration Initial

# Clone du projet
git clone <repository>
cd ai-infrastructure-hetzner

# Configuration des variables d'environnement
cp .env.example .env
# Éditer .env avec vos tokens Hetzner

# Installation des dépendances Python
pip install -r requirements.txt

3. Déploiement

# Déploiement development
cd terraform/environments/development
terraform init && terraform apply

# Génération de l'inventaire Ansible
cd ../../../inventories
python3 generate_inventory.py development

# Configuration avec Ansible
cd ../ansible
ansible-playbook -i inventories/development/hosts.yml site.yml

Support

Issues : Utiliser le système de tickets du projet
Documentation : Voir dossier docs/
Monitoring : Grafana accessible via les URLs d'environnement