Archives par étiquette : git

Reprise de Pibou : Git, Rails et Heroku avec Windows

Bien le bonjour,

Comme promis, nous allons continuer Pibou sous Windows. Au menu du jour :

  1. Installer un environnement de développement Rails sous Windows
  2. Récupérer le projet Pibou qui est resté au chaud sur github 
  3. Tester le déploiement du projet sur heroku depuis Windows

Ruby & rails

  • Pour installer Ruby sur notre poste, nous allons utiliser rubyinstaller & ruby developement kit (outils pour les extensions natives) téléchargeables tous deux sur http://rubyinstaller.org/downloads/
  • Une fois Ruby installé, nous trouvons tout ce qu’il nous faut dans C:\Ruby193\bin (par défaut) et RubyGem prêt à servir
  • Pour le kit de développement, il suffit de suivre les instructions du wiki
  • Vous risquez devoir installer Python, allez faire un tour sur http://www.python.org/getit/ (ajoutez le répertoire d’installation dans votre path)
  • Pour se préparer à l’utilisation de SQLite3, nous allons l’installer à partir du zip pour windows
    1. déposer avec délicatesse les fichiers sqlite3.dll & sqlite3.def dans notre répertoire tout neuf C:\Ruby193\bin
    2. Lancer la commande gem install sqlite3 dans votre shell préféré
  • Tant que nous avons le shell sous la main, installons rails avec la commande gem install rails (il y en a pour un petit moment)

Et voila, vous pouvez vérifier votre installation via les commandes ruby –version  & rails –version

IDE & Récupération du projet pibou

  • Si vous ne l’avez pas déjà, installez GIT
  • Nous allons installer Aptana histoire de tester l’un des IDE gratuit les plus utilisé pour le développement web.
  • Puis, nous allons utiliser l’import Git avec l’url github du projet https://github.com/jbdoumenjou/pibou.git
  • Nous allons profiter de problèmes de compatibilité pour mettre à jour le Gemfile
      • Petite mise à jour de Rails en 3.2.8
    gem 'rails', '3.2.8'
      • Nous allons passer therubyracer dans le scope de production
    group :production do
      gem 'pg'
      gem 'libv8', '3.11.8.0'
      # See https://github.com/sstephenson/execjs#readme for more supported runtimes
      gem 'therubyracer', :platform => :ruby
    end
  • Un bundle install plus tard et nous sommes à jour
  • N’oublions pas d’indexer nos changements
    • git add Gemfile Gemfile.lock
  • Puis de les ajouter au dépôt local
    • git commit -m « Worked on the configuration to develop under windows »
  • Ces modifications sont visibles sur github
  • Pour lancer le projet sur notre poste, il faut commencer par générer la base
    • rake db:migrate
  • Puis lancer le server
    • rails s
  • Et vérifier sur http://localhost:3000/movies que nous avons bien l’application

Le dépoilement sur Heroku

  • Installons heroku belt sous windows
  • Ensuite, il faut nous connecter au service heroku via une commande lancée à la racine du projet
    • heroku login
  • Ajoutons la clé ssh de notre nouvelle machine
    • heroku keys:add
  • Ajoutons le dépot heroku à nos dépots distants
    • git remote add heroku git@heroku.com:pibou.git
  • Et envoyons nos modifications sur le dépôt distant heroku (ça prend un moment):
    • git push heroku master

Finalement ca marche

Nous y sommes! Ruby et tous ses amis se sont invités sur notre Windows sans trop de soucis. Git ne semble pas récalcitrant et Aptana s’est montré docile, que demander de plus ?
Nous allons pouvoir reprendre le développement de Pibou sous Windows et découvrir Aptana

@bientôt

site officiel d'Heroku

Pibou dans les nuages avec Heroku

site officiel d'HerokuDans l’article précédent, Pibou – Partage ton code, nous avons ajouté les sources du projet sur Github via Git. Nous allons maintenant déployer le projet sur Heroku.

A quoi ça sert Heroku ?

Heroku est un service en ligne qui permet de déployer des applications dans « le cloud ». Concrètement ça permet :

  • De ne pas se soucier de l’infrastructure serveur
  • D’adapter les ressources en fonction de ses besoins (puissance/budget)
  • De profiter de git pour envoyer ses sources dans les nuages

Comment ça marche ?

Heroku utilise Git pour déployer l’application. Il s’agit en fait d’un nouveau dépôt de sources. Quand on pousse ses sources vers Heroku, il s’occupe de tout. Il faut quand même faire un peu de configuration. Pour aller plus loin -> http://www.heroku.com/how.

Mise en route

La documentation est bien faite, nous allons en profiter -> https://devcenter.heroku.com/articles/rails3.

Installation

Installer les outils ->  https://toolbelt.herokuapp.com/

Avoir un compte Heroku

  • Pour utiliser le service, il faut un compte. 😉 Ça se passe par ici -> https://api.heroku.com/signup Une fois l’enregistrement terminé, nous pouvons nous connecter via une commande lancée dans le Shell à la racine du projet : $heroku login
  • Lors de votre connexion au service, si on ne vous propose pas l’ajout de votre clé publique, vous pouvez le faire via la commande : $heroku keys:add
    Pour plus de détails -> https://devcenter.heroku.com/articles/keys

Configurer la base de données

Par défaut, nous avons des bases sqlite pour les tests, le développement et la production. Heroku demande une base en PostgreSQL. Nous allons donc :

  • Installer PostgreSQL sur son poste. Si vous rencontrez cette erreur https://gist.github.com/2400759, il suffit d’installer  la lib libpq-dev.
  • Mettre à jour le Gemfile pour prendre en compte la dépendance vers la gem ‘pg’ en environnement de production. Concrètement,  on modifie le fichier /pibou/Gemfile avec ces lignes :
group :test, :development do
  gem 'sqlite3'
end

# for heroku environment
group :production do
  gem 'pg'
end

  • Mettre à jour ces dépendances via la commande lancée à la racine du projet : $bundle install

Synchronisation des sources avec le dépôt Heroku

Le déploiement d’un projet sur Heroku se fait via l’envoie des sources sur un dépôt Git. Nous allons donc rajouter les fichiers que nous avons modifiés puis les envoyer sur nos dépôts :

Ajout des sources en local
$git add Gemfile Gemfile.lock config/database.yml
$git commit -m « Updated the dependencies »

Envoie des sources sur notre dépôt GitHub
$git push origin master

Déploiement Heroku
$git push heroku master

Mise à jour de la base de donnée distante

Tout se résume en une simple commande lancée à la racine du projet:
$heroku run rake db:migrate

Où est l’application ?

Si vous regardez votre Shell attentivement, vous verrez l’url de déploiement, pour moi -> http://pibou.herokuapp.com

En bref

Ce que nous avons réalisé :

Et après ?

Maintenant que nous avons une application déployée et un code partagé, nous allons pouvoir développer notre application de gestion de films. Mais pour bien faire, nous avons besoin de mettre en place des tests, ce sera le sujet suivant.

@bientôt

 

Pibou – Partage ton code

Dans l’article précédent, Pibou – scaffolding & structure, nous avons ajouté la notion de film et nous avons utilisé la génération de code. Il est grand temps de mettre en place un gestionnaire de versions.

Gestion des sources

Lors de la vie d’un projet, les sources évoluent sans cesse. Il est donc très important de pouvoir stocker les changements et rendre les sources accessibles à tous les acteurs du projet. Dans cette optique, nous allons utiliser GIT.

Utilisation de GitHub

Afin d’éviter les contraintes de l’installation de la partie serveur, nous allons utiliser un service en ligne : GitHub. C’est un outil bien pratique qui fourni entre autres :

  • Un dépôt de source en ligne
  • Un suivi des sources
  • Un wiki
  • Des statistiques
  • Suivi de bugs
  • Un outil de partage de code indépendant (gist)

Il existe plusieurs formules d’abonnements, celle de base est gratuite et vous permet 300Mo de stockage publique. Si vous voulez héberger des projets privé, il vous faudra dépenser au moins 7$/mois. Pour plus d’informations tarifaires : https://github.com/settings/billing.

Créer un projet GitHub

La documentation sur GitHub étant très complète, je vous laisse découvrir la création du projet et l’installation de Git (attendez un peu avant d’envoyer le code) :

Définir des règles d’exclusion de fichiers pour git

Nous allons rajouter un fichier pibou/.gitignore afin de définir les fichiers et/ou dossier qui n’ont rien à faire sur le dépôt. Vous pouvez trouver des exemples ici : https://github.com/github/gitignore. Nous allons compléter le fichier existant avec : https://github.com/github/gitignore/blob/master/Rails.gitignore.

Le premier push

  • Tout d’abord, nous nous plaçons à la racine « /pibou »
  • Ajout des sources $git add -A (le -A permet un ajout de toutes les sources. On l’utilise pour cette fois, mais nous ciblerons dorénavant les fichiers à ajouter)
  • Si vous n’avez pas encore désigné votre dépôt distant : $git remote add origin git@github.com:<username>/pibou.git
  • Le code est seulement enregistré en local, pour l’envoyer sur le serveur : $git push -u origin master

Pour plus de détails sur le partage d’un projet : http://help.github.com/create-a-repo/

Le petit plus de RVM

N’oublions pas notre configuration ruby! RVM permet de créer un fichier .rvmrc qui fourni une configuration par projet. Pour cela, une petite commande à la racine du projet : $rvm ruby-1.9.3-p125@pibou –create –rvmrc (lire : interpréteur ruby-version@gemset)

Maintenant que nous avons une configuration de l’environnement ruby pour le projet, il suffit de le partager :

git add .rvmrc
git commit -m "Added ruby environment configuration"
git push origin master

Et voilà, votre code est sur le dépôt et vous avez partagé votre configuration rvm via votre .rvmrc. Pour plus de détails : http://beginrescueend.com/workflow/rvmrc/

Et après?

Je vous laisse digérer tout çà. La prochaine fois, nous allons déployer notre application en ligne grâce à heroku. En attendant, vous pouvez accéder aux sources du projet sur https://github.com/jbdoumenjou/pibou

@bientôt

SVN tu l’aimes ou tu prends GIT!

Tout développeur qui se respecte utilise un outil de gestion de sources. Si vous me dites que vous envoyez encore des archives par mail, je ne peux plus rien pour vous…

De quoi parle-t-on ?

Plaçons le contexte, SubVersioN (2000) fut créé pour remplacer CVS (1989) et reste utilisé dans de nombreux projets. Quant à GIT (2005), que dire ? Rapide, puissant, efficace. Ok, j’en fais un peu trop. Pour vous faire une idée plus précise sur le fonctionnement et l’utilisation de GIT, je vous invite à regarder une excellente présentation réalisée par Sébastien Douche (partie 1, partie 2).

Au début, tu as peur de GIT

  • les commandes à apprendre/comprendre
  • la gestion locale/distante
  • mal utiliser sa puissance (ex: suppression sur tout l’historique)
  • la compréhension topologie vs timeline

Puis tu te rappelles de SVN

  • Pour enregistrer ton travail, tu es obligé de l’envoyer sur le serveur
  • Tu as peur de faire des branches (surtout pour le merge en fait)
  • Si tu copies/colles un dossier et tu te lamentes
  • Tu as des .svn dans tous les dossiers

Et là, tu t’amouraches de GIT

  • merge hyper efficace et paramétrable (plusieurs algo sont disponibles)
  • Un renommage de fichier, si vous l’avez déjà pratiqué avec svn, vous savez de quoi je parle 😉
  • Pas de .svnquisefoupartout
  • La logique qui vous permet de mieux structurer votre code (création et utilisation des branches & Tag)
  • Grande liberté de manipulation
  • La rapidité d’utilisation (on se demande parfois s’il s’est passé quelque chose)

Le mot de la fin

J’ai aimé SVN comme un premier amour, la lumière après les ténèbres mais notre histoire est finie.

La puissance et le confort de GIT en font une arme redoutable. Si vous prenez la peine de passer vos a priori et le début de la courbe d’apprentissage, vous ne pourrez plus vous en passer.

Et vous, êtes-vous GIT ?