Getting Started

Quick start guide to begin with the system

Menu

Theme

Toggle between light and dark mode

Language

Choose your preferred language

Font Size

Adjust text size for better readability

Content Width

Choose optimal width for your screen

Table of Contents

Show or hide the table of contents

Actions

More options coming soon...

Getting Started

Welcome to the automatic grading system! This guide explains how to get started quickly.


πŸ“§ 1. Receiving your account

πŸ“₯ View your account information

You will receive an email containing:

  • Username: firstname.lastname
  • Temporary password: To be changed on first login
  • Gitea link: https://git.zohrabi.cloud
  • Your group: CDOF1, CDOF2, etc.

πŸ”‘ 2. First login

🌐 Step 1: Access Gitea
  1. Open your browser
  2. Go to: https://git.zohrabi.cloud
  3. Click "Sign in" in the top right
πŸ”“ Step 2: Login
  1. Username: The one received by email
  2. Password: The temporary password
  3. Click "Sign in"
πŸ”’ Step 3: Change password

⚠️ Important: You will need to change your password on first login.

  1. Choose a strong password (min. 8 characters)
  2. Confirm the new password
  3. Validate

πŸ“ 3. Access your repositories

πŸ“‚ View your repository structure

After logging in, you will see one repository per 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

Each repository is already created and ready to receive your work.


πŸ’» 4. Clone a workshop repository

πŸ”— Option A: HTTPS (Recommended for beginners)
# Replace with your username and desired workshop
git clone https://git.zohrabi.cloud/firstname.lastname/workshop1.git

cd workshop1

When cloning, Git will ask you for: - Username: your Gitea username - Password: your Gitea password

πŸ” Option B: SSH (Advanced)

Prerequisites: Have configured an SSH key in Gitea

  1. Generate an SSH key (if you don't have one): bash ssh-keygen -t ed25519 -C "your.email@example.com"

  2. Copy the public key: bash cat ~/.ssh/id_ed25519.pub

  3. In Gitea: Settings > SSH/GPG Keys > Add Key

  4. Clone with SSH: bash git clone git@git.zohrabi.cloud:firstname.lastname/workshop1.git


πŸ—οΈ 5. Structure by Workshop

πŸ“ Workshop 1: Docker Setup

For this workshop, you need to create a docker.txt file containing the output of the docker info command.

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

Your repository must contain:

workshop2/
β”œβ”€β”€ Dockerfile              # nginx image
β”œβ”€β”€ index.html              # HTML page
β”œβ”€β”€ build.sh                # Script to build the image
└── run.sh                  # Script to run the container

Dockerfile:

FROM nginx
COPY index.html /usr/share/nginx/html/index.html

build.sh:

#!/bin/bash
docker build -t my-tiny-web-server .

run.sh:

#!/bin/bash
docker run --name webserver -p 8080:80 -d --rm my-tiny-web-server
πŸ“ Workshops 3-8: Check the assignments

Each workshop has specific requirements. Check each workshop's assignment to know the required structure.


πŸ“€ 6. Submit your project

πŸ“ Git: Add, Commit, Push

Once everything is ready:

# Add all files
git add .

# Commit with a descriptive message
git commit -m "Workshop2: Simple web server with Nginx"

# Push to Gitea
git push origin main

βœ… 7. Automatic grading

⚑ Triggering

As soon as you do git push, automatic grading starts:

  1. Gitea Actions detects the push
  2. The grading system analyzes your repository
  3. Automatic tests according to workshop criteria
  4. Email sent with your grade and detailed report
πŸ‘€ Follow grading in real-time
  1. Go to Gitea
  2. Open your repository
  3. Click on the "Actions" tab
  4. View the running workflow

You will see: - βœ… Running: Grading in progress - βœ… Success: Grading completed successfully - ❌ Failure: Error detected

πŸ“Š View your grades

Grades Dashboard: https://grades.zohrabi.cloud

Log in with your Gitea credentials to see:

  • πŸ“Š Your grades by workshop
  • πŸ“‹ Test details passed/failed
  • πŸ“ Correction logs
  • πŸ”’ Remaining attempts

πŸ”„ 8. Iterate and improve

πŸ” Submit multiple times

You have 3 attempts per workshop (by default):

  • The best grade is kept
  • Each push triggers a new grading
  • Check the logs to understand errors
# Modify your files
nano Dockerfile

# If OK, push again
git add .
git commit -m "Workshop2: Dockerfile fix"
git push origin main

⚠️ Note: Your instructor can add extra attempts if needed.


πŸ“Œ Important points

βœ… TO DO
  • βœ… Test locally before pushing (when applicable)
  • βœ… Use official images
  • βœ… Follow the required structure for each workshop
  • βœ… Document with a README.md (recommended)
  • βœ… Descriptive commit messages
❌ TO AVOID
  • ❌ Push without checking file names
  • ❌ Passwords in plain text
  • ❌ Unnecessary files (node_modules, etc.)

πŸ†˜ Need help?

  • πŸ“Š Dashboard: https://grades.zohrabi.cloud
  • πŸ“– Wiki: https://wiki.zohrabi.cloud
  • πŸ“§ Contact: Reza@zohrabi.fr

Ready to start? Good luck! πŸš€

Other pages