docs: add comprehensive README

README.md

@@ -1,3 +1,56 @@
-# docker-images
+# Docker Images
 
-Custom Docker images built with Buildkit and hosted on Gitea Container Registry
+Dépôt centralisé pour les images Docker custom, buildées avec Buildkit et hébergées sur le registry Gitea.
+
+## Structure
+
+```
+docker-images/
+├── .gitea/workflows/
+│   └── build-images.yml    # Pipeline Buildkit
+├── images/
+│   ├── terraform-ci/       # Image Terraform + tflint
+│   │   ├── Dockerfile
+│   │   └── README.md
+│   └── <future-image>/
+└── README.md
+```
+
+## Fonctionnement
+
+Le workflow détecte automatiquement quelles images ont changé et ne rebuild que celles-ci.
+
+### Build automatique
+
+Push sur `main` avec des modifications dans `images/` → build et push automatique.
+
+### Build manuel
+
+Utiliser "Run workflow" dans l'interface Gitea Actions et spécifier le nom de l'image.
+
+## Images disponibles
+
+| Image | Description | Tags |
+|-------|-------------|------|
+| `terraform-ci` | Terraform 1.5.7 + tflint | `latest`, `<commit-sha>` |
+
+## Utilisation
+
+```bash
+# Pull depuis le registry Gitea
+docker pull gitea.arnodo.fr/damien/terraform-ci:latest
+```
+
+## Configuration requise
+
+### Secret à configurer
+
+Dans les paramètres du repo → Secrets → Actions :
+
+- `REGISTRY_TOKEN` : Token Gitea avec les droits `write:package`
+
+### Génération du token
+
+1. Gitea → Settings → Applications → Access Tokens
+2. Créer un token avec le scope `write:package`
+3. Ajouter comme secret `REGISTRY_TOKEN`