====== Premier pas avec git ======

<note> Pour grand débutant qui ne sait pas par ou commencer</note>

===== Récupérer un dépot existant sur gitLab =====

1 - avoir un compte sur GitLab: [[https://gitlab.com/|https://gitlab.com/]]

2 - créer un répertoire sur sa machine (par example: monGitLocal) qui contiendra le repertoire des sources à récupérer\\
3 - se déplacer dans ce répertoire
<code>

cd monGitLocal

</code>

4 - importer les sources en local

<code>
git clone https://gitlab.com/un_compte/projet.git

</code>

===== Envoyer son code (dépot) local sur gitLab =====

1 - avoir un compte sur GitLab: [[https://gitlab.com/|https://gitlab.com/]]\\
2 - installer git sur sa machine pour avoir les commande CLI
<code>

apt install git

</code>

3 - créer un répertoire sur sa machine (par example: monGitLocal) qui contiendra le repertoire des sources de notre dev\\
4 - se déplacer dans ce répertoire

<code>
cd monGitLocal

</code>

5 - créer un répertoire pour mon premier projet git et s'y déplacer dedans

<code>
mkdir test1
cd test1

</code>

5 - activer/initialiser mon propjet test1 avec git.

<code>
git init

</code>

la commande va créer un répertoire caché .git pour gérer votre développement. NE RIEN y faire, c'est pour le fonctionnement de git.

<note>INFO pour le site gitlab.com :

Dans un dépot git, on a la notion de branche pour gérer les différentes version/fork possibles. Deux branches peuvent etre présentes: MAIN et MASTER.\\
En informatique on utilise historiquement des termes "racistes" tel que master/slave ou whitelist/blacklist… soit! Pour etre dans l'ère du temp on remplace juste le mot mais pas le role ou fonction.\\
Donc c'est la meme chose MAIS pour conserver l'existant :\\
- soit on duplique la branche MASTER et en branche MAIN\\
- soit on renomme master en main\\
Dans le cas ou vous ne voyez pas vos pushes dans le master pensez à voir si ce n'est pas dans le le main et vice versa.

</note>

6 - créer ou copier/coller un fichier quelconque dans votre dossier de projet test1 pour tester.

<code>
echo titi>test.txt

</code>

7 - Pour savoir dans quel état est votre git local (commit ou pas, nouveaux fichiers,..)

<code>
git status

</code>

8 - Faite savoir à git (loccal) que vous avez des choses dans votre projet et qu'il faut suivre leurs modifications. On fait simple:

<code>
git add .

ou git add fichier1 fichier2 ...

</code>

la commande va créer un index des fichiers pour ce projet test1.\\
[[https://git-scm.com/docs/git-add|https://git-scm.com/docs/git-add]]

9 - Vérifiez que les nouveaux fichiers sont pris en compte pour le prochain commit (passe en vert normalement)
<code>

git status

</code>

10 - On va faire un commit pour dire à git qu'on valide nos modifications et qu'il doit enregistrer cette étape dans le suivi.

<code>
git commit
git status

</code>

On voit là que le commit est sur la branche MASTER en local.\\
[[https://www.atlassian.com/fr/git/tutorials/saving-changes/git-commit|https://www.atlassian.com/fr/git/tutorials/saving-changes/git-commit]]

ou
<code>

git commit -m "mon suivi de changement"

</code>

11 - On peut envoyer sur le dépot gitLab pour la première fois notre branche MASTER local.

<code>
git push --set-upstream https://gitlab.com/moncompte/test master

</code>

upstream permet de lier le dépot local à une branche pendant le premier push. Une fois que c'est lié on pourra faire que (sans upstream)

<code>
git push https://gitlab.com/moncompte/test master

</code>

[[https://code-garage.com/blog/a-quoi-sert-le-parametre-u-lors-d-un-git-push|https://code-garage.com/blog/a-quoi-sert-le-parametre-u-lors-d-un-git-push]]