Git

Nous utilisons Git pour versionner le projet.

Le lien du projet est: https://github.com/parlemonde/1village

• Créez votre compte Github
• Group Git Asso-ParLeMonde
• Ajouter un clé SSH sur Github
• Installer Github Desktop
• Cloner le projet

Si ce n'est déjà fait, créez votre compte Github

==> https://github.com/join

Vérifiez que vous êtes bien membre du group Git Asso-ParLeMonde

Allez sur la page: https://github.com/orgs/parlemonde/people Et vérifiez votre présence. Si vous n'êtes pas encore membre, demandez un invitation à Laurent Arnoult où David Robert-Ansart sur le Slack (https://join.slack.com/share/zt-kjee5hu8-y_ESxGcR2HTLdf4AXrIvgg).

🚨 Vous pouvez suivre le tutoriel ci-dessous ou directement celui de Github en respectant bien les étapes et vos environnements => tutoriel ici

Ajouter un clé SSH sur Github (Mac et Linux seulement)

Cette étape est optionnelle si vous utilisez le logiciel Github Desktop. (Je reviendrai dessus plus tard.)

Pour les utilisateurs Windows, utilisez Github Desktop.

Si vous utilisez des postes Windows avec WSL2, Github Desktop risque de ne pas fonctionner correctement (cf issue ici).

Le mieux reste d'utiliser VS Code (ou autre) et le terminal dans ce cas.

1. Ouvrez votre terminal.
2. Tapez:

ssh-keygen -o -b 4096

3. Entrez un mot de passe lorsque cela est demandé (si vous voulez utiliser une passphrase).
4. Vous devriez avoir maintenant une clé privée ~/.ssh/id_rsa et une clé publique ~/.ssh/id_rsa.pub (Notez bien le .pub pour la clé publique). Votre clé privée est sensible, ne la perdez pas et ne la copiez pas! Elle doit rester sans rien faire la où elle est.
5. Nous allons utiliser ssh-agent pour éviter d'avoir à taper le mot de passe tout le temps (si vous avez entré une passphrase à l'étape 3) :

eval "$(ssh-agent -s)"

touch ~/.ssh/config

7. Ouvrez ~/.ssh/config et ajoutez:

Host *
  AddKeysToAgent yes
  UseKeychain yes
  IdentityFile ~/.ssh/id_rsa

Si ça ne marche pas avec les lignes plus haut, il faut ajouter IgnoreUnknown UseKeychain comme suit :

Host * 
  IgnoreUnknown UseKeychain 
  AddKeysToAgent yes 
  UseKeychain yes 
  IdentityFile ~/.ssh/id_rsa 

8. Tapez dans le terminal:

ssh-add -K ~/.ssh/id_rsa

Si une erreur “Unprotected Private Key File” (Permissions 0644) arrive, faites: chmod 0600 ~/.ssh/id_rsa Si vous n'avez pas utilisé un poste Wnidows, il faut taper la commande suivante :

ssh-add ~/.ssh/id_rsa

9. Enfin, ajoutez votre clé publique sur Github:
   • Copiez votre clé publique sur le presse papier:

pbcopy < ~/.ssh/id_rsa.pub

• Allez sur les Paramètres github
• Cliquez sur Nouvelle clé SSH
• Ajouter un titre: "Clé ssh perso"
• Coller votre clé publique sur le champ "Key"
• Enfin, cliquez sur ajouter votre clé SSH.

Installer Github Desktop

Allez sur Github Desktop et installer le logiciel. Ce n'est pas nécessaire, mais c'est plus simple qu'utiliser Git en ligne de commande sur le terminal.

Cloner le projet

• Avec le terminal Dans le dossier de votre choix, clonez le projet git. (Un dossier nommé "1village" sera créé avec tout le contenu dedans)

git clone [email protected]:parlemonde/1village.git

• Avec Github desktop
  • Ouvrez github desktop.
  • Connectez vous.
  • Cliquez sur 'Add', puis sur 'Clone repository'.
  • Cherchez 1village!, saisissez le répertoire de destination et clonez le projet.

Vous êtes maintenant prêt à utiliser Git!

<= Précédent: Premiers pas               Suivant: Installer VSCode =>