dimanche 20 mars 2011

Github : Créer un dépôt Github

Après une longue absence de retour pour vous  parler d'un outil de travail collaboratif trés prisé par les développeurs : Github.


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.

  1. Git
  2. 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.
    Commandes de bases : 
     Nous allons voir que les commandes essentielles dont nous allons avoir besoin pour utiliser github.
    • 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  
  1. Github
  2. 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. 
          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: 
    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 :
    • créons le dossier de travail :   
    • mkdir nomdepots
    • rentrer dans le dossier puis initialiser le git :   
    • cd nomdepots 
      git init
    • Créer les fichiers de notre projet (ici nos allons créer un fichier README): 
    • echo "Ceci est un exemple de fichier README d'un dossier vide" > README
    • Ajouter README dans notre dépôt  
    • git add README
    • Première sauvegarde : 
    • git commit -m "Première sauvegarde : Ajout du fichier README"
    • Ajouter le dossier "origin" au niveau de votre dépôt sous github
    • git remote add origin git@github.com:username/nomdepot.git
    • Envoyer les modifications sur le serveur distant github
    • git push -u origin master
Et voilà félicitation vous venez juste de créer votre premier dépôt git sous github. Dans les prochains articles nous allons voir :
  • Comment faire des modifications sur Github
  • Forker et modifier un projet sous github
  • Créer un dépôts communautaire