TP-03 — Proposer et intégrer une modification sur GitHub

Étape 1 : Créer et cloner

# Créer le dossier indiqué pour les fichiers de travail du TP.
mkdir -p ~/devops-formation/tp-04-03

# Se placer dans le dossier requis pour les commandes suivantes.
cd ~/devops-formation/tp-04-03

Sur GitHub, créer un dépôt de TP, privé si souhaité, avec README.md. Relever son URL via Code. Utiliser HTTPS avec un jeton/gestionnaire d’identifiants, ou SSH après avoir enregistré la clé publique.

# Créer la paire de clés SSH dédiée au TP, avec les fichiers et le commentaire indiqués.
ssh-keygen -t ed25519 -C "vous@example.com"

# Lire le fichier pour vérifier son contenu.
cat ~/.ssh/id_ed25519.pub

# Enregistrer la clé publique dans Settings > SSH and GPG keys.
ssh -T git@github.com

# Copier le dépôt distant et configurer sa référence d’origine.
git clone git@github.com:VOTRE_COMPTE/VOTRE_DEPOT.git

# Se placer dans le dossier requis pour les commandes suivantes.
cd VOTRE_DEPOT

# Vérifier ou configurer l’adresse du dépôt distant.
git remote -v

La réponse SSH confirme l’authentification et précise que GitHub ne fournit pas d’accès shell ; son code de sortie peut être 1 même en cas de succès.

Étape 2 : Proposer une modification

# Vérifier ou définir le paramètre Git indiqué.
git config user.name "Votre nom"

# Vérifier ou définir le paramètre Git indiqué.
git config user.email "vous@example.com"

# Changer de branche ou créer la branche demandée.
git switch -c feature/documentation

# Lire le fichier pour vérifier son contenu.
cat > doc.txt <<'EOF'
Documentation ajoutée dans une branche de travail.
EOF

# Préparer les modifications indiquées dans l’index pour le prochain commit.
git add doc.txt

# Enregistrer les modifications préparées dans un nouveau commit.
git commit -m "Ajoute la documentation"

# Publier les commits ou la branche vers le dépôt distant.
git push -u origin feature/documentation

Sur GitHub, ouvrir une PR vers main. Lire Files changed, contrôler les checks, demander une revue si disponible, puis fusionner sur ce dépôt de TP.

Étape 3 : Synchroniser après fusion

# Changer de branche ou créer la branche demandée.
git switch main

# Récupérer les références distantes sans les fusionner dans la branche courante.
git fetch origin

# Examiner l’historique des commits.
git log --oneline HEAD..origin/main

# Récupérer puis intégrer les modifications du dépôt distant.
git pull --ff-only

# Distinguer les fichiers non suivis, préparés et modifiés.
git status

# Examiner l’historique des commits.
git log --oneline -5

Le fichier doc.txt apparaît sur main. Selon la méthode de fusion choisie (merge, squash, rebase), les identifiants et la forme de l’historique varient.

Étape 4 : Issue et fork

Créer une issue décrivant l’ajout documentaire et l’associer à la PR. Pour comprendre un fork, observer qu’il forme un dépôt GitHub distinct ; ne pas le confondre avec le clone local.