infrastructure/docs/01-architecture.md

Architecture de l'infrastructure Git CI/CD

Vue d'ensemble

Cette infrastructure fournit une solution complete de gestion de code source et d'integration continue.

                    +------------------+
                    |   Utilisateurs   |
                    +--------+---------+
                             |
              +--------------+--------------+
              |                             |
              v                             v
    +-------------------+         +-------------------+
    |  git.syoul.fr     |         |  ci.syoul.fr      |
    |  (Gitea :3300)    |         |  (Woodpecker:9001)|
    +--------+----------+         +--------+----------+
             |                             |
             |   +---------------------+   |
             +-->|   Consul :8500      |<--+
                 |   Service Discovery |
                 +----------+----------+
                            |
                 +----------+----------+
                 |    Registrator      |
                 | (auto-registration) |
                 +---------------------+
                            |
              +-------------+-------------+
              |                           |
    +---------+---------+       +---------+---------+
    |    PostgreSQL     |       |   Woodpecker      |
    |    (gitea_db)     |       |   Agent           |
    +-------------------+       +-------------------+

Composants

Services principaux

Service	Port externe	Port interne	Description
Gitea	3300	3000	Serveur Git auto-heberge
Gitea SSH	2222	22	Acces SSH pour Git
Woodpecker Server	9001	8000	Serveur CI/CD
Woodpecker Agent	-	3000	Agent d'execution des pipelines
PostgreSQL	-	5432	Base de donnees Gitea
Consul	8500	8500	Service discovery et UI
Consul DNS	8600	8600	Resolution DNS des services
Registrator	-	-	Enregistrement automatique

Reseau Docker

Tous les services utilisent le reseau Docker : gitgit_syoul_fr_gitea_net

• Sous-reseau : 172.18.0.0/16
• Gateway : 172.18.0.1

Volumes persistants

Volume	Service	Chemin dans le conteneur
gitgit_syoul_fr_gitea_data	Gitea	/data
gitgit_syoul_fr_db_data	PostgreSQL	/var/lib/postgresql/data
woodpecker-data	Woodpecker Server	/var/lib/woodpecker
consul-data	Consul	/consul/data

Flux de communication

Authentification OAuth2 (Woodpecker <-> Gitea)

1. Utilisateur accede a ci.syoul.fr
2. Woodpecker redirige vers git.syoul.fr/login/oauth/authorize
3. Utilisateur s'authentifie sur Gitea
4. Gitea redirige vers ci.syoul.fr/authorize avec le code
5. Woodpecker echange le code contre un token via gitea:3000

Communication interne (avec Consul)

1. Registrator detecte les nouveaux conteneurs
2. Registrator enregistre les services dans Consul
3. Les services peuvent se trouver via DNS Consul : gitea.service.consul

Webhooks CI/CD

1. Commit sur Gitea
2. Gitea envoie un webhook a Woodpecker
3. Woodpecker Server planifie le build
4. Woodpecker Agent execute le pipeline
5. Resultats affiches dans Gitea et Woodpecker

URLs d'acces

Service	URL
Gitea	http://git.syoul.fr
Woodpecker	https://ci.syoul.fr
Consul UI	http://[serveur]:8500