Installation et utilisation de GitHub (Debian 8.7)

GitHub est une plateforme web de développement collaboratif. Il est essentiellement utilisé dans le développement de logiciel Open-Source.

Création d’un compte GitHub

Pour créer un compte, nous devons nous rendre à l’adresse : https://github.com/join?source=header-home

On rempli les habituels champs, Username, Email Address, et Password, puis on clique sur le bouton « Create an account » pour passer à l’étape suivante

A la deuxième étape, on laisse sélectionner « Unlimited public repositories for free » puis on clique sur « Continue » pour passer à la dernière étape

Vous pouvez spécifier le niveau d’expérience en programmation que vous avez, le but de l’utilisation de GitHub, ainsi que votre profil. Une fois cela fait ou pas d’ailleurs, on clique sur « Submit »

Création d’un repository/dépôt GitHub

Un repository/dépôt GitHub est une sorte de répertoire qui contiendra l’ensemble des fichiers du projet. Pour en créer un, nous devons cliquer en haut à droite sur le petit « + », puis « New repository »

On renseigne le nom du repository/projet, ainsi qu’une description, puis l’on clique sur « Create repository »

Une nouvelle page va s’afficher avec les URL (au format HTTPS et SSH) pour la synchronisation avec notre futur repository/dépôt local. Nous allons copier l’URL au format SSH dans un document texte. Elle nous servira par la suite

Création d’une SSH

Nous allons maintenant nous attaquer à la création d’une paire clé SSH (Publique et Privée) afin de nous permettre de synchroniser notre repository/dépôt local avec notre repository/dépôt GitHub. Elles seront au format RSA et auront une longueur de 4096 bits. Pour cela on tape la commande suivante :

1

# ssh-keygen -t rsa -b 4096 -C "your_email@example.com"

Lors de la création, il va vous êtes proposer de créer une passphrase (« mot de passe ») pour la clé. Pour plus de sécurité, je vous conseille d’en mettre un. Maintenant que la paire de clé est créée, nous devons copier la clé publique sur GitHub. Pour cela, nous éditons le fichier « id_rsa.pub » via la commande suivante :

1

# vi .ssh/id_rsa.pub

On copie l’ensemble du contenu. Ensuite on se rend sur son compte GitHub, on clique en haut à droite, a droite du « + », puis sur « Settings »

On clique sur « SSH and GPG keys » dans les onglets verticaux

On clique sur le bouton « New SSH key »

Pour en simplifier la gestion on donne un nom (nom de l’ordinateur à partir duquel elle a été générée) à la clé publique et on la colle dans l’encadré « Key » prévu à cet effet, puis on clique sur « Add SSH key »

Installation du client Git

CentOS propose dans ses dépôts un client Git appelé « Git » que nous allons installer pour créer le repository/projet local. Pour cela, nous tapons la commande suivante :

1

# apt-get install git

Configuration du client Git

Afin de pouvoir utiliser le client Git, nous devons configurer un nom d’utilisateur et une adresse mail. Pour cela, on tape les commandes suivantes :

1
2

# git config --global user.name "your_name"
# git config --global user.email "your_email@example.com"

Synchronisation sur GitHub à l’aide du client Git

Maintenant que le client est installé, nous devons créer un répertoire dans lequel nous créerons le repository/projet. Pour cela, nous tapons la commande suivante :

1

# mkdir Git_Repository

On se rend dans le répertoire via la commande suivante :

1

# cd Git_Repository

Maintenant que l’on est dans le répertoire, on peu créer le repository/projet via la commande suivante :

1

# git init mon_projet

Le repository/projet étant créé, on créé/copie les fichiers dans le répertoire afin de pouvoir faire les actions qui vont suivre. Une fois les fichiers créés, nous allons devoir activer le suivi de version/modifications pour l’ensemble des fichiers présent dans le répertoire. Pour cela, nous allons taper les commandes suivantes :

1

# git add --all

Le suivi de version étant activé, nous devons maintenant « Valider » l’ensemble des modifications effectués dans le repository/projet. Pour cela on tape la commande suivante :

1

# git commit --all

Avant de pouvoir synchroniser le repository/projet local avec GitHub, nous devons configurer l’URL du repository/dépôt Gihut dans le client Git. Pour cela on tape la commande suivante :

1

# git remote add mon_projet git@github.com:Usernamme/mon_projet.git

On peut vérifier la bonne prise en compte de l’URL via la commande suivante :

1

# git remote -v

Maintenant que le client Git est configuré, on peut envoyer le contenu de notre repository dans la branche master sur GitHub via la commande suivante :

1

# git push -u mon_projet master

Quelques commandes supplémentaires

« Valider » les modifications avec un commentaire :

1

# git commit -m "mon_commentaire"

Effacer/Supprimer des fichiers du repository/projet :

1

# git rm mon_fichier

Renommer un fichier du repository/projet :

1

# git mv fichier_d_origine fichier_cible