Skip to content

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

Pocker

Projet de groupe réalisé pour le cours de réseau (Bloc 2, 2025-2026) à la Haute École Robert Schuman (HERS).

Contexte

Le labo demandait de monter une infrastructure Docker comprenant un cache, un reverse proxy, un load balancer et un scanner de vulnérabilités.

Pour rendre l'effet du cache visible, nous avons créé Pocker, un Pokédex de 1 025 Pokémon avec des données en français. Les pages de démonstration affichent le temps d'accès aux données, selon que la requête passe par le serveur sans cache ou par celui qui utilise Redis.

Architecture

flowchart LR
    U[Navigateur] -->|port 80| N[Nginx<br/>reverse proxy]
    N -->|serveur principal| A1[apache1<br/>PHP, sans cache]
    N -.->|secours| A2[apache2<br/>PHP, cache Redis]
    A1 --> DB[(PostgreSQL 16)]
    A2 --> R[(Redis)]
    A2 --> DB
    T[Trivy] -.->|scan des images| A1
    T -.-> A2
Loading
Service Image Rôle
reverse-proxy nginx Point d'entrée sur le port 80. apache1 répond en priorité, apache2 prend le relais s'il ne répond plus (bascule automatique).
apache1 PHP + Apache Site sans cache (NullCache)
apache2 PHP + Apache Même site, avec cache Redis (RedisCache)
bd postgres:16 Base de données, initialisée par database/init.sql
redis redis Cache, protégé par mot de passe et surveillé par un healthcheck
trivy aquasec/trivy Scan des images du projet, rapport écrit dans logs/

Les conteneurs sont répartis sur deux réseaux Docker : front pour la partie exposée, back pour la base de données et le cache.

Le site

  • liste et fiche détaillée des Pokémon ;
  • comparaison de deux Pokémon ;
  • création de Pokémon personnalisés, avec photo ;
  • table des faiblesses entre types ;
  • démonstration du cache : une latence de 200 ms est simulée sur chaque requête PostgreSQL pour rendre la différence visible ;
  • démonstration de l'invalidation du cache : sans invalidation, la page affiche des données périmées jusqu'à l'expiration du cache (300 s).

Choix techniques

  • Code PHP orienté objet : contrôleurs, service, repositories et accès à la base séparés, avec des interfaces (CacheInterface, DatabaseInterface, repositories). Le même code tourne sur les deux serveurs : seul le cache injecté change (NullCache ou RedisCache).
  • Invalidation du cache : le cache des Pokémon est vidé dès qu'un Pokémon est créé, pour que l'affichage reste cohérent avec la base.
  • Sécurité :
    • requêtes préparées avec PDO ;
    • jeton CSRF sur le formulaire de création, comparé avec hash_equals() ;
    • dossier uploads/ protégé par un .htaccess qui interdit l'exécution de scripts ;
    • mots de passe de PostgreSQL et Redis dans un fichier .env, jamais versionné.
  • Scan de vulnérabilités : au démarrage, Trivy analyse les images du projet et écrit son rapport dans logs/. Il accède pour cela au socket Docker de l'hôte, ce qui lui donne un contrôle étendu sur Docker : ce compromis a été analysé dans le cadre du labo.

Lancer le projet

Prérequis

  • Docker et Docker Compose (les scripts sont prévus pour Linux ou WSL et utilisent sudo).

Démarrage

  1. Copier .env.example en .env et renseigner les identifiants PostgreSQL et Redis.
  2. Lancer ./start_project.sh : construit les images, démarre les conteneurs et enregistre les logs dans logs/.
  3. Ouvrir http://localhost.

Le détail des commandes Docker Compose est expliqué dans commande installation.md.

Scripts

Script Rôle
start_project.sh Construit et démarre le projet, enregistre les logs
stop_project.sh Arrête les conteneurs
reset_project.sh Redémarre en conservant les données
full_reset.sh Supprime les volumes et recharge init.sql, après avoir sauvegardé les Pokémon personnalisés
backup_custom.sh / restore_custom.sh Sauvegarde et restauration des Pokémon personnalisés

generate_pokemon.py régénère database/init.sql à partir de l'API publique PokeAPI (dépendance : aiohttp).

Bon à savoir

Docker Compose nomme ses réseaux d'après le nom du dossier du projet. Si le dossier est renommé, les anciens réseaux gardent leurs adresses IP et les nouveaux ne démarrent plus : il faut alors supprimer les ressources créées sous l'ancien nom.

Projet

Projet de groupe réalisé en Bloc 2 (2025-2026) à la Haute École Robert Schuman (HERS).

Version publiée à des fins de portfolio.

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages