Premiers Pas
Bienvenue dans le système de correction automatique ! Ce guide vous explique comment démarrer rapidement.
📧 1. Réception de votre compte
📥 Voir les informations de votre compte
Vous recevrez un email contenant : - **Nom d'utilisateur** : `prenom.nom` - **Mot de passe temporaire** : À changer à la première connexion - **Lien Gitea** : https://git.zohrabi.cloud - **Votre groupe** : CDOF1, CDOF2, etc.🔑 2. Première connexion
🌐 Étape 1 : Accéder à Gitea
1. Ouvrez votre navigateur 2. Allez sur : **https://git.zohrabi.cloud** 3. Cliquez sur **"Se connecter"** en haut à droite🔓 Étape 2 : Connexion
1. **Nom d'utilisateur** : Celui reçu par email 2. **Mot de passe** : Le mot de passe temporaire 3. Cliquez sur **"Se connecter"**🔒 Étape 3 : Changer le mot de passe
⚠️ **Important** : Vous devrez changer votre mot de passe lors de la première connexion. 1. Choisissez un mot de passe fort (min. 8 caractères) 2. Confirmez le nouveau mot de passe 3. Validez📁 3. Accéder à vos repositories
📂 Voir la structure de vos repositories
Après connexion, vous verrez **un repository par workshop** : - `workshop1` - Installing Docker and getting started - `workshop2` - Simple Web Server with Docker - `workshop3` - Docker Registry - `workshop4` - Networking in Docker - `workshop5` - Volumes - `workshop6` - Docker Compose - `workshop7` - CI/CD - `workshop8` - SAST and CI Chaque repository est déjà créé et prêt à recevoir votre travail.💻 4. Cloner un repository de workshop
🔗 Option A : HTTPS (Recommandé pour débuter)
# Remplacer par votre nom d'utilisateur et le workshop souhaité
git clone https://git.zohrabi.cloud/prenom.nom/workshop1.git
cd workshop1
🔐 Option B : SSH (Avancé)
**Prérequis** : Avoir configuré une clé SSH dans Gitea 1. Générer une clé SSH (si vous n'en avez pas) : ```bash ssh-keygen -t ed25519 -C "votre.email@example.com" ``` 2. Copier la clé publique : ```bash cat ~/.ssh/id_ed25519.pub ``` 3. Dans Gitea : **Paramètres → Clés SSH/GPG → Ajouter une clé** 4. Cloner avec SSH : ```bash git clone git@git.zohrabi.cloud:prenom.nom/workshop1.git ```🏗️ 5. Structure par Workshop
📐 Workshop 1 : Docker Setup
Pour ce workshop, vous devez créer un fichier `docker.txt` contenant la sortie de la commande `docker info`.docker info > docker.txt
git add docker.txt
git commit -m "Workshop1: Docker info"
git push origin main
📐 Workshop 2 : Simple Web Server with Nginx
Votre repository doit contenir :workshop2/
├── Dockerfile # Image nginx
├── index.html # Page HTML
├── build.sh # Script pour construire l'image
└── run.sh # Script pour lancer le conteneur
FROM nginx
COPY index.html /usr/share/nginx/html/index.html
#!/bin/bash
docker build -t my-tiny-web-server .
#!/bin/bash
docker run --name webserver -p 8080:80 -d --rm my-tiny-web-server
📐 Workshops 3-8 : Consultez les sujets
Chaque workshop a des exigences spécifiques. Consultez le sujet de chaque workshop pour connaître la structure requise.📤 6. Soumettre votre projet
📝 Git : Add, Commit, Push
Une fois que tout est prêt :# Ajouter tous les fichiers
git add .
# Commit avec un message descriptif
git commit -m "Workshop2: Simple web server with Nginx"
# Push vers Gitea
git push origin main
✅ 7. Correction automatique
⚡ Déclenchement de la correction
Dès que vous faites `git push`, la correction automatique se lance : 1. **Gitea Actions** détecte le push 2. Le **système de correction** analyse votre repository 3. Tests automatiques selon les critères du workshop 4. **Email envoyé** avec votre note et rapport détaillé👀 Suivre la correction en temps réel
1. Aller sur Gitea 2. Ouvrir votre repository 3. Cliquer sur l'onglet **"Actions"** 4. Voir le workflow en cours Vous verrez : - ✅ **Running** : Correction en cours - ✅ **Success** : Correction terminée avec succès - ❌ **Failure** : Erreur détectée📊 Consulter vos notes
**Dashboard des notes** : https://grades.zohrabi.cloud Connectez-vous avec vos identifiants Gitea pour voir : - 📊 **Vos notes** par workshop - 📋 **Détails des tests** passés/échoués - 📝 **Logs** de la correction - 🔢 **Tentatives restantes**🔄 8. Itérer et améliorer
🔁 Soumettre plusieurs fois
Vous avez **3 tentatives par workshop** (par défaut) : - La **meilleure note** est conservée - Chaque push déclenche une nouvelle correction - Consultez les logs pour comprendre les erreurs# Modifier vos fichiers
nano Dockerfile
# Si OK, push à nouveau
git add .
git commit -m "Workshop2: Correction du Dockerfile"
git push origin main
📌 Points importants
✅ À FAIRE
- ✅ Tester **localement** avant de push - ✅ Utiliser des **images officielles** - ✅ Respecter la **structure requise** - ✅ Documenter avec un **README.md** - ✅ Messages de commit **descriptifs**❌ À ÉVITER
- ❌ Push sans test local - ❌ Images sans tag spécifique - ❌ Mots de passe en clair - ❌ Fichiers inutiles (node_modules, etc.)🆘 Besoin d'aide ?
- 📖 Consultez la FAQ
- 📧 Contactez : Reza@zohrabi.fr
Prêt à commencer ? Bon courage ! 🚀