Github un web-service qui utilise le logiciel libre Git et est développé en Ruby on Rail. Il permet d'héberger et de gérer ces projets logiciels en SaaS . Il propose deux offres une professionnelle payante et une gratuite pour les projets personnels et/ou communautaire libre (Open-source). Dans cette article nous essaiyerons de vous montrer comment utiliser github pour un compte gratuit tout en sachant que la différence c'est seulement qu'on doit payer pour l'offre professionnelle. Auparavant nous allons parler de git et comment l'utiliser.
- Git Git est un logiciel libre sous Licence GPL V2 développé par Linux Torvald sous forme de Systéme de gestion de version décentralisé c'est à dire :
- Un logiciel qui permet de stocker un ensemble de document et/ou fichier et conserve la chronologie qui a été faite dessus. Il nous permet de suivre les modifications effectuées au niveau des fichiers, la date de modification et nous permet d'avoir différentes versions d'un même fichier selon la branche, le moment, le tag, ...
- Un logiciel qui permet à chacun de travailler à son rythme et de soumettre son travail à la communauté si besoin est.
- Installer git sur Ubuntu Linux
sudo apt-get install git
- Configurer git
git config --global user.name "MonNom"
git config --global user.email "username@domaine.ext"
- initialiser votre dépots git
git init
- Ajouter un fichier / un dossier
git add nomfichier
git add nomdossier
- Faire un premier commit
git commit -m "Description de la sauvegarde"
- Pour revenir en arriére et annuler les modifications :
git reset --hard - Re-enregistrer votre travail:
git commit -a -m "Nouvelle description de sauvegarde"
- Supprimer un fichier / un dossier :
git rm file.c
git rm -r dossier/sousdossiers/
- Renommer un fichier / un dossier :
git mv old.c new.c
git mv -r dossier/old-dossier/ dossier/news-dossiers/
- Faire une copie d'un projet :
git clone git://serveur/chemin/vers/les/fichiers
- mettre à jour une copie d'un projet :
git pull
- Envoyer notre dépôt local vers un serveur distant
git push rep branche
- Github Nous allons maintenant vous montrer comment utiliser github pour héberger votre code et le partager. Aller sur le site https://github.com/ et créer un compte.
Commandes de bases :
Nous allons voir que les commandes essentielles dont nous allons avoir besoin pour utiliser github.
Nous allons voir que les commandes essentielles dont nous allons avoir besoin pour utiliser github.
Créer un dépôt :
Pour créer un dépôt, il faut sur ta page github cliquer sur l'onglet "Nouveau dépôt" et remplir le formulaire qui s'affiche devant vous, puis cliquer sur "Créer un dépôt". Si, à ce moment il n 'y a pas d'erreur au niveau du formulaire il vous redirige directement au niveau du répertoire de votre nouveau dépôt. À ce niveau vous pouvez voir qu' il y'a un petit tutoriel pour vous montrer comment utiliser github. C'est que nous allons détailler dans la suite
Configurer votre environnement local:
Pour configurer notre environnement git local, nous allons d'abord installer git comme indiqué précédemment puis configurer git avec la commande git config . Aprés installation et configuration de git au niveau local, on doit générer une paire de clé SSH avec les commandes ssh-keygen -t rsa -C "votremail@mail.com" qui vas générer une paire de clé privée et publique. Il ne nous reste plus qu'a copier la clé publique. Pour cela il faut aller sur le répertoire dans lequel on l'a enregistré lors de création par défaut c'est : ~/.ssh/ puis copier le contenu du fichier avec l'extension .pub ( par défaut id_rsa.pub). Il faut maintenant aller sur notre interface github puis cliquer sur "Tableau de bord" puis sur "Clés SSH publiques" et enfin "Ajouter une nouvelle clé" et là coller le contenu de la clé publique qu'on avait copié au niveau du champ "clé" de notre formulaire puis cliquer sur "Ajouter une clé" pour enregistrer.
Dépôt local:
- créons le dossier de travail :
- rentrer dans le dossier puis initialiser le git :
- Créer les fichiers de notre projet (ici nos allons créer un fichier README):
- Ajouter README dans notre dépôt
- Première sauvegarde :
- Ajouter le dossier "origin" au niveau de votre dépôt sous github
- Envoyer les modifications sur le serveur distant github
Maintenant que nous avons configurer notre premier environnement de travail local il ne nous reste plus qu'à configurer notre dépôt local. Pour cela :
mkdir nomdepots
cd nomdepots
git init
echo "Ceci est un exemple de fichier README d'un dossier vide" > README
git add README
git commit -m "Première sauvegarde : Ajout du fichier README"
git remote add origin git@github.com:username/nomdepot.git
git push -u origin master
- Comment faire des modifications sur Github
- Forker et modifier un projet sous github
- Créer un dépôts communautaire