Project Oxygen & Ideo-LabIDEO LAB Dashboard 2026

📦 Git & GitHub – Installation & Workflow

Installer Git localement, créer le dépôt GitHub (remote), sécuriser l’accès (PAT / .netrc / SSH) et pousser son code.

1.1

Git vs GitHub

Différence entre l’outil de versionnage (Git) et la plateforme d’hébergement (GitHub).

Local Remote
1.2

Installer Git

Windows (Git Bash), Linux (apt), macOS (brew). Vérifier la version.

git --version
1.3

Créer le dépôt GitHub

Depuis GitHub → New repo → nom → private/public → Create.

https ssh
2.1

Token (PAT)

GitHub n’accepte plus les mots de passe : on génère un token avec le scope repo.

Settings Developer
2.2

Fichier .netrc

Pour ne plus saisir le token à chaque git clone sur ton laptop.

~/.netrc chmod 600
2.3

Cloner le dépôt

Télécharger le code GitHub sur le poste local et commencer à travailler.

git clone
3.1

Workflow de base

status → add → commit → push. Ce que font 95% des devs au quotidien.

git add . git push
3.2

Connexion SSH

Alternative au PAT : on génère une clé et on clone en SSH.

id_ed25519
3.3

Dépannage

Fenêtre d’auth qui revient, 401, mauvais remote, credential Windows.

git remote -v
1.1 Git vs GitHub – comprendre le couple
Rôle de Git

Git est un outil local de gestion de versions :

  • Crée un historique des modifications
  • Permet de revenir en arrière
  • Gère les branches (expérimentations)
Rôle de GitHub

GitHub est un serveur Git distant :

  • Héberge tes dépôts
  • Donne l’accès à d’autres personnes
  • Ajoute des fonctions (Issues, PR, Actions)
Schéma
DEV (laptop)  ── git push ──►  GitHub (remote)
GitHub (remote) ── git pull ─►  autre DEV / serveur

Dans ton cas : laptop Windows → dépôt privé ideolab → serveur Ubuntu / staging.

1.2 Installer Git sur Windows / Linux / macOS
Windows

Télécharger Git for Windows → installer → ouvrir Git Bash.

git --version

Configurer ton identité :

git config --global user.name "Guillaume"
git config --global user.email "ton_email@domaine.com"
Linux / macOS
# Debian / Ubuntu
sudo apt update
sudo apt install git

# macOS
brew install git

Ces infos apparaîtront dans les commits GitHub.

1.3 Créer le dépôt GitHub (ideolab)
Sur GitHub
  1. Cliquer sur + puis New repository
  2. Nommer : ideolab
  3. Choisir Private (ton cas)
  4. Créer

Tu obtiens l’URL :

https://github.com/ideolab2025/ideolab.git
Si tu as déjà un projet local
git init
git remote add origin https://github.com/ideolab2025/ideolab.git
git add .
git commit -m "Initial commit"
git push -u origin main
2.1 Générer le Personal Access Token (PAT)
Chemin
  1. Avatar (en haut à droite) → Settings
  2. Developer settings
  3. Personal access tokens → Tokens (classic)
  4. Generate new token

Cocher le scope :

☑ repo
Utilisation

Le token généré ressemble à :

ghp_3AbCDefgHiJKLmno123456789

C’est lui que tu mettras dans .netrc ou que tu taperas quand Git te le demande.

2.2 Fichier .netrc (comme Unfuddle)
Contenu
machine github.com
  login ideolab2025
  password ghp_TON_TOKEN_ICI

machine api.github.com
  login ideolab2025
  password ghp_TON_TOKEN_ICI

Sous Git Bash / Linux : chmod 600 ~/.netrc

Désactiver le credential Windows
git config --global credential.helper ""

Sinon Windows t’ouvre une popup GitHub au lieu d’utiliser ton fichier.

2.3 Cloner le dépôt sur le laptop
Commande
cd D:\wamp5\
git clone https://github.com/ideolab2025/ideolab.git
cd ideolab

Si ton .netrc est bon → pas de question. Sinon Git demande “Password for https://github.com/…” → tu colles le PAT.

3.1 Workflow Git de base
Cycle standard
# 1. voir ce qui a changé
git status

# 2. ajouter fichiers
git add .

# 3. créer le commit
git commit -m "Ajout analyseur Django"

# 4. pousser sur GitHub
git push origin main

Astuce : si quelqu’un a push avant toi → git pull --rebase avant ton git push.

3.2 Authentification SSH
Générer
ssh-keygen -t ed25519 -C "ton_email@domaine.com"
# fichier : ~/.ssh/id_ed25519
Ajouter à GitHub

Copier le contenu de ~/.ssh/id_ed25519.pub → GitHub → Settings → SSH keys.

Puis cloner :

git clone git@github.com:ideolab2025/ideolab.git
3.3 Dépannage Git/GitHub
Fenêtre d’auth GitHub qui revient
git config --global credential.helper ""
Erreur 401 / 403
  • Token expiré → en régénérer un
  • Dépôt privé → scope repo obligatoire
  • Mauvaise URL (tu clones en SSH mais le remote est HTTPS)
Vérifier l’URL du remote
git remote -v
git remote set-url origin https://github.com/ideolab2025/ideolab.git