😇Guide de Dépannage Git

Procédure rapide pour remettre le dépôt correctement

Schéma de fonctionnement attendu

OBJECTIFS

L'objectif est d'obtenir le fonctionnement de déploiement ci-dessus avec

• Un Dossier en LOCAL (Votre poste de Travail) qui contient votre code et sur lequel vous développez la SAE. Ce Dossier fait aussi de Dépôt Git LOCAL

• Un Dépôt GitHUB qui est votre dépôt Git DISTANT

• Un Dossier /var/www/sae203 sur votre VPS qui est le dépôt Git de PRODUCTION

Pour simplifier le fonctionnement, vos dépôts Git ne doivent posséder qu'une seule branche : main (la branche principale)

NETTOYAGE DE L'EXISTANT

Pour corriger vos problèmes, il est surement plus simple de repartir de zéro, donc nous allons supprimer tous les dépôts et les récréer.

IMPORTANT : Sur votre poste de travail faites une copie de tous le contenu de votre site sae203 dans un dossier autre que sae203 . Copiez les fichiers en les sélectionnant dans votre gestionnaire de fichiers, ne copiez pas le sous-dossier .git !!! Ne vous contentez pas de renommer le dossier ou d'en faire une copie !! Il faut copier son contenu uniquement (sauf .git qui est constitue le dépôt actuel)

Ensuite:

• Sur votre poste de travail, supprimez complétement le dossier de votre site sae203

• Sur GitHub, supprimez le dépôt sae203 (pas seulement son contenu)

Pour supprimer un dépôt GitHub, sélectionnez Settings dans le menu du dépôt

Sélectionnez Settings dans le menu du dépôt

Ensuite , allez en bas de la page et sélectionnez l'option : Delete This Repository

Choisissez l'Option Delete this repository et confirmer comme demandé

RECONSTRUCTION DU DEPOT

Attention, l'ordre de réalisation des différentes étapes est important.

ETAPE 1 : DEPOT SAE203 sur GitHUB

CREATION DU DEPOT

1. Connectez-vous à GitHub

2. Créez un nouveau dépôt privé nommé sae203. Ajoutez le fichier README Ajoutez le fichier .gitignore avec le template de votre choix.

Création du dépôt sae203 en privé avec les fichiers README et .gitignore

AJOUT DES COLLABORATEURS AU DEPOT

Ensuite ajouter les collaborateurs suivants en cliquant sur Sur Settings, puis Collaborators

Ajoutez des collborateurs

Les collaborateurs à ajouter : jlandre72 , pgommery , Dannebicque , haraou01, meuzer01 , f-libbrecht

RECUPERATION DU LIEN DE CLONAGE

Pour terminer cette partie, récupérez le lien de stockage en déroulant le menu Code Faites une copie du lien avant de continuer.

Copiez le lien SSH si vous avez créez votre clé publique sur GitHub

Si vous avez recopiez votre clé SSH sur GitHub, prenez le lien SSH Sinon, prenez le lien HTTPS

ETAPE 2 : LE DEPOT LOCAL

CREATION DU DEPOT

Sur votre poste de travail, créez un dossier vide nommé sae203 Ce dossier contiendra les pages de votre site, mais ne les copier pas dedans pour l'instant.

Ouvrez un terminal, positionnez-vous dans le répertoire parent de sae203 et saisissez la commande : git clone LIEN_GITHUB sae203

ATTENTION : Vous ne devez pas être dans le dossier sae203, mais bien dans le dossier supérieur avant de saisir la commande.

Remplacez LIEN_GITHUB par le lien de clonage que vous avez copié à l'étape précédente.

Création et Clonage du dépôt en local

Vous pouvez vérifier que tout est correct en ouvrant le dossier sae203

Vérifier le présence du fichier README et du .gitignore

PUSH DU PROJET SAE203

Si tout est correct à l'étape précédente, recopiez les fichiers de votre site dans le dossier sae203

Après recopié les fichiers dans le dossier, nous pouvons maintenant les inclures (add) dans le dépôt Git local (commit) et ensuite les envoyer sur le dépôt distant (push)

Ouvrez un terminal et positionnez-vous dans le dossier sae203

git config --global user.name "NOM GITHUB"
git config --global user.email "VOTRE ADRESSE MAIL de GITHUB"
git add .
git commit -m "Debut de la SAE203"
git push origin main

Exemple de commit et de push vers le dépôt distant

Vous pouvez vérifier sur GitHub que vos fichiers ont bien été envoyés dans le dépôt distant.

Les fichier ont bien été poussés sur le dépot distant

MISE A JOUR DU DEPOT

Lorsque vous voulez envoyez vos modifications vers le dépôt distant, il vous suffit de saisir les commandes (en se positionnant dans le dossier sae203 avant !)

git add .
git commit -m "ma modification"
git push

ETAPE 3 : LE DEPOT DE PRODUCTION

Nous appelons le dépôt de production, le dépôt Git du dossier /var/www/sae203 Comme le montre le schéma au début de cette page, il est alimenté par le dépôt distant, pas directement par votre poste de travail. Il faut donc réaliser un pull du dépôt GitHub vers le dépôt de production (et pas l'inverse)

Considérant que vous avez déjà installé Git sur votre VPS et recopier la clé publique de votre utilisateur MMI sur GitHub (TD07), nous ne reprenons ici que les étapes de création du dépôt de production.

INITIALISATION du dépôt de Production sur le VPS

Connectez-vous en SSH sur votre VPS

Vous ne devez pas avoir fait sudo -i pour continuer. l'invite de commandes doit être MMI@MMI:~$ (et surtout pas #)

Commençons par initialiser git pour avec votre compte github

git config --global user.name NOM_GITHUB
git config --global user.email EMAIL_UTILISEE_POUR_GITHUB

Ensuite dans GitHUB, récupérer le lien SSH de votre dépôt sae203

Exemple : le lien ssh de mon dépôt sae203

Pour terminer , placez-vous dans le dossier /var/www et clonez le dépôt distant sur votre VPS avec les commandes suivantes

Ne faites pas de copier/coller, remplacez MMI par vos identifiants et surtout le LIEN SSH GITHUB par celui de votre dépôt

cd /var/www
sudo rm -Rf sae203    (si vous ne l'avez pas déjà supprimé)
sudo mkdir sae203     (pour recréer le dossier vide, sans dépôt .git)
sudo chown -R MMI:MMI sae203
git clone LIEN_SSH_DU_DEPOT_GITHUB_SAE203 sae203
cd sae203
ls -l                  (pour vérifier que tout est là)

Normalement, vous devriez retrouver tous vos fichiers dans votre dossier sae203. Vérifiez que votre site fonctionne avec l'URL: MMI.sae203.ovh