Archives du tag: Ruby On Rails

Développement Ruby Ruby on Rails Serveur Web

Installation de Ruby et Rails sur un serveur Ubuntu 12.10

Nous allons découvrir dans cet article comment avoir un serveur clé en main, idéal comme machine virtuelle.

Installer et mettre à jour Ubuntu Server 12.10

Téléchargez Ubuntu Server 12.10 et installez le système à votre guise.

Pour ma part, j’ai fait l’installation dans une machine virtuelle Parallels 8 à partir de l’image disque Ubuntu officielle.

Afin d’accéder à la machine à distance, pensez à installer le serveur OpenSSH.

Ensuite, une mise à jour des paquets ne peut pas faire de mal.

Installer RVM

Pour installer RVM, une simple ligne de commande suffit.

curl -L get.rvm.io | bash -s stable

Ensuite, chargez RVM.

source ~/.profile

Puis activez RVM autolibs.

rvm autolibs enable

Lancez RVM requirements afin de mettre à jour automatiquement votre système.

rvm requirements

Installer Ruby

RVM permet d’installer plusieurs versions de Ruby sur une même machine. Nous allons donc installer la dernière en date : Ruby 2.0.0.

rvm install 2.0.0

Puis nous allons définir cette version comme version à utiliser par défaut.

rvm --default 2.0.0

Vérifiez l’installation. Vous devriez voir 2.0.0.

ruby --version

Parfois, il faut se déconnecter et se reconnecter afin que RVM soit bien rechargé.

Installer RubyGems

Pour continuer d’utiliser RVM afin d’installer les gems Ruby, utilisez la commande suivante.

rvm rubygems current

 Installer Rails

Nous allons utiliser gems afin d’installer Rails dans sa dernière version (3.2 à ce jour)

gem install rails

L’environnement Ruby on Rails est maintenant installé.

Il va maintenant falloir faire en sorte de pouvoir l’exécuter sur un serveur de production.

Installer Passenger

Passenger permet d’exécuter une application Rails au sein d’un serveur apache ou nginx.

gem install passenger

Tant que la version 4.0 n’est pas stable, installez-la via la commande suivante.

gem install passenger --version 4.0.0.rc6

Installer nginx et son module Passenger

RVM permet de simplifier l’installation du serveur nginx et du module Passenger.
Tout d’abord, installez les bibliothèques nécessaires.

sudo apt-get install libcurl4-openssl-dev

Ensuite, lancez l’assistant.

rvmsudo passenger-install-nginx-module

Pressez « Entrer ».
Prenez le choix par défaut en tapant « 1″, puis pressez la touche « Entrer ».
Validez le répertoire par défaut.
Laissez le système faire la suite : ça peut durer une petit moment. (5-10 minutes)

Lancer automatiquement nginx au démarrage

Première étape : arrêter toute instance éventuelle de nginx.

sudo kill `cat /usr/local/nginx/logs/nginx.pid`

Ensuite, éditez le fichier /etc/init.d/nginx

#! /bin/sh   ### BEGIN INIT INFO # Provides:          nginx # Required-Start:    $all # Required-Stop:     $all # Default-Start:     2 3 4 5 # Default-Stop:      0 1 6 # Short-Description: starts the nginx web server # Description:       starts nginx using start-stop-daemon ### END INIT INFO   PATH=/usr/local/sbin:/usr/local/bin:/sbin:/bin:/usr/sbin:/usr/bin:/opt/nginx/sbin DAEMON=/opt/nginx/sbin/nginx NAME=nginx DESC=nginx   test -x $DAEMON || exit 0   # Include nginx defaults if available if [ -f /etc/default/nginx ] ; then         . /etc/default/nginx fi   set -e   case "$1" in   start)         echo -n "Starting $DESC: "         start-stop-daemon --start --quiet --pidfile /opt/nginx/logs/$NAME.pid \                 --exec $DAEMON -- $DAEMON_OPTS         echo "$NAME.\n"         ;;   stop)         echo -n "Stopping $DESC: "         start-stop-daemon --stop --quiet --pidfile /opt/nginx/logs/$NAME.pid \                 --exec $DAEMON         echo "$NAME.\n"         ;;   restart|force-reload)         echo -n "Restarting $DESC: "         start-stop-daemon --stop --quiet --pidfile \                 /opt/nginx/logs/$NAME.pid --exec $DAEMON         sleep 1         start-stop-daemon --start --quiet --pidfile \                 /opt/nginx/logs/$NAME.pid --exec $DAEMON -- $DAEMON_OPTS         echo "$NAME.\n"         ;;   reload)       echo -n "Reloading $DESC configuration: "       start-stop-daemon --stop --signal HUP --quiet --pidfile /opt/nginx/logs/$NAME.pid \           --exec $DAEMON       echo "$NAME.\n"       ;;   *)         N=/etc/init.d/$NAME         echo "Usage: $N {start|stop|restart|force-reload}\n" >&2         exit 1         ;; esac exit 0

Rendez ce fichier exécutable.

sudo chmod +x /etc/init.d/nginx

Mettez à jour les runlevels des scripts lancés au démarrage.

sudo /usr/sbin/update-rc.d -f nginx defaults

Vous pouvez également ajouter /opt/nginx/sbin/ à votre PATH.

Ajoutez ensuite un utilisateur nginx à votre système.

sudo adduser --system --no-create-home --disabled-login --disabled-password --group nginx

Redémarrez votre serveur pour être bien sûr que tout fonctionne.

Si vous vous connectez via un navigateur web à votre serveur, vous devriez être accueilli par le message « Welcome to nginx! ».

Liez votre serveur web à votre app

Si ce n’est déjà fait, installez NodeJS. Certaine dépendances sont nécessaires au bon fonctionnement de Rails (en particulier grâce à la bibliothèque Javascript V8).

sudo apt-get install nodejs

Editez le fichier de configuration de nginx, /opt/nginx/conf/nginx.conf, en particulier la partie serveur :

server {   listen 80;   server_name demo.com;   passenger_enabled on;   root /var/www/app/public; }

Créons le répertoire /var/www et positionnons-nous à sa racine.

sudo mkdir -p /var/www && cd /var/www && chmod -R 777 .

Installons bundler.

gem install bundler

Il ne reste plus qu’à créer l’app de test.

rails new app && cd app

Pré-compilez les assets.

RAILS_ENV=production rake assets:precompile

Accédez à votre serveur depuis un navigateur : vous arriverez sur l’écran d’accueil de Rails.

Initialiser un dépôt git

Nous allons supprimer le contenu de l’app de test sur le serveur pour réinitialiser le répertoire /var/www/app.

Depuis le répertoire /var/git/app.git (nouvellement créé), initialisons le dépôt git.

git init --bare

Allons sur notre machine de développement.
Ajoutons le répertoire distant. (à personnaliser)

git remote add virtual ssh://ubuntu@192.168.1.39/var/git/app.git

Envoyons le contenu du code sur le serveur.

git push virtual master

Il vous suffit alors de cloner votre dépôt dans le répertoire /var/www/app et le tour est joué !

Si vous voulez faire plus simple…

Dans l’exemple d’aujourd’hui, vous avez vu la méthode « douloureuse » du déploiement Ruby on Rails. C’est formateur mais parfois indigeste.
Si vous n’avez pas trop de temps à perdre, passez par des solutions plus simples et au moins aussi efficaces telles que Heroku.

Share
Développement Web

Les services web RESTful

Les services web sont aujourd’hui au coeur du web et au coeur des applications connectées.

Pour cela, beaucoup de services et d’outils utilisent le modèle REST. Sur iOS, on peut notamment citer l’excellent framework AFNetworking permettant d’accéder aux services web et son prometteur petit frère AFIncrementalStore qui permet lui de synchroniser cache local et service distant.

Pour autant, comment un service web être réellement RESTful ?

Cette question est en suspend depuis quelques années. Au travers de cet article, amené à évoluer, je vais tâcher d’apporter quelques éléments de réponses.

REST : kézako ???

Déjà, qu’est-ce REST ?

C’est un modèle d’organisation de service web exploitant au maximum le protocole HTTP et les standards du web afin d’être aussi léger que performant.

Le principe est d’accéder à des ressources en suivant le modèle objet.

Définition du service web

Afin de définir les ressources du service web, il suffit d’accéder à la racine de l’API.

Par exemple :

{   "url": "https://api.monservice.com",   "resources": {     "cars": {       "url": "https://api.monservice.com/cars"     },     "accounts": {       "url": "https://api.monservice.com/accounts"     }   } }

 

URL des ressources

Les resources sont accessibles via des URL.

Par convention, on utilisera toujours le pluriel pour les collections. Et on utilisera toujours des noms pour identifier les ressources.

Par exemple :

/cars : ensemble de voitures

/cars/count : nombre total de voiture

/cars/12 : voiture « 12″

/cars/12/options : options disponibles pour la voiture « 12″

/cars_models : toutes les relations entre voiture et modèle (many to many)

Options d’affichage

Il est possible de passer des paramètres dans les URL.

Par convention, pour n’afficher que certains champs, on utilisera « fields » séparé par des virgules ».

/cars?fields=immatriculation,color : je veux seulement les champs « immatriculation » et « color »

Egalement, on peut filtrer les résultats sur certains champs en les passant en paramètres.

/cars?color=red : seulement les voitures rouges

/cars?model.name=volvo : seulement les voiture dont le nom du modèle est volvo (certains caractères n’ont volontairement pas été échappés)

Pagination

Certaines options peuvent être passées dans l’URL afin de gérer la pagination.

- offset : premier résultat affiché

- limit : nombre maximal de résultats par page

- until : date maximale de création

- since : date minimale de création

- since_id : identifiant le plus ancien

- max_id : identifiant le plus récent

Cela permet de gérer un chargement progressif de manière très fiable.

L’en-tête HTTP « Link », avec les liens et les options « rel » (« next », « previous ») permet également de paginer la réponse.

L’en-tête HTTP « X-Result-Count » permet d’avoir le nombre total de résultats.

Aussi, on peut utiliser « Content-Range ». Ex. « Content-Range: cars 0-20/2550″. Et l’en-tête en requête serait « Range: cars=0-20″.

Actions

Idéalement, une action est définie par un verbe. La méthode HTTP dépend d’une modification ou non du contenu de la ressource ciblée.

POST /cars/12/buy : acheter la voiture « 12″

GET /cars/search : rechercher une voiture

Les verbes HTTP

Pour les ressources, utilisez la méthodes CRUD (Create, Read, Update, Delete) .

POST /cars : ajouter une voiture (redirige vers la ressource créée)

GET /cars/12 : voir la voiture 12

HEAD /cars/12 : savoir si la voiture 12 existe (aucune ressource retournée)

PUT /cars/12 : mettre à jour intégralement la voiture 12 (redirige vers la ressource mise à jour)

PATCH /cars/12 : mettre à jour intégralement la voiture 12 (redirige vers la ressource mise à jour)

DELETE /cars/12 : supprimer la voiture 12

OPTIONS /cars : description des actions possibles sur les ressources de type « cars » (via l’en-tête Allow, access-control-allow-methods, access-control-allow-origin et une description explicite dans le corps)

Pour les actions, on utilise souvent GET.

Lorsque l’on utilise AJAX, sur les navigateurs web par exemple, on n’a pas accès à PUT ou DELETE.

Ce n’est pas un problème : passez le paramètre « _method » avec comme nom la méthode HTTP à utiliser. Si vous utilisez un framework comme par exemple Ruby on Rails, la méthode sera automatiquement gérée.

Format des données

Plusieurs formats peuvent être utilisés. Ils sont définis en priorité par l’extension de l’URL, mais également par le Content-Type ou le Accept de la réponse et/ou de la requête.

application/xml est le plus ancien.

application/json est le plus courant. Parfaitement adapté aux services web orientés REST.

application/x-www-form-urlencoded est utilisé lors d’envoi de données. Chaque clé correspondant à une propriété de l’objet.

multipart/form-data est lui particulièrement adapté pour l’envoi de données binaires. Chaque champs correspond à une propriété et chacune de ces propriétés peut adopter son propre format. (binaire, XML, JSON, texte)

Format des dates et heures

Les dates et heures ont leur propre standard : ISO-8601.

Utilisez le format court pour les dates et le format complet pour date et heure.

Les codes HTTP

200 : message de réponse bien interprétée

201 : une ressource a été crée

304 : rien n’a été modifié

400 : requête non comprise

401 : accès non autorisé à l’utilisateur

403 : accès purement et simplement interdit

404 : élément non trouvé

500 : erreur du serveur

DNS

Utilisez, dans la mesure du mesure, un nom de domaine spécifique pour vos API.

ex. http://api.monservice.com

Version

Utilisez un chemin spécifique pour chaque version de votre API.

ex. http://api.monservice.com/v1/

Faire référence à une autre ressource

Utilisez les suffixes « _url » ou « _href » qui sont particulièrement adaptées. Surtout si vous faites références à des objets binaires.

Pour une autre entité, vous pouvez utiliser « _id » ou « _identifier ».

Identifier une ressource

On identifie une ressource soit par « id », soit par « identifier ». Parfois aussi par « url » ou « href ».

Représentation binaire

Certains objets ont des propriétés binaires.

Selon le volume d’information, utilisez :

- soit « url » / « href » ou « maprioriete_url »  pour faire référence à une URL de téléchargement

- soit « data » ou « mapropriete_data » afin de proposer une représentation encodée en Base64 des données.

Envoyer / récupérer des données binaires

Pour envoyer par exemple une photo avec un commentaire, utilisez le multipart/form-data.

POST /photos

champs « comment » : contenu texte

champs « photo » : la photo, en binaire

champs « thumb » : la miniature de la photo, en binaire

En réponse, ou à la lecture :

GET /photos/12

{   "id": 12,   "comment": "mon texte",   "photo_url": "http://lien_vers_photo.jpg",   "thumb_url": "http://lien_vers_thumb.jpg" }

C’est finalement très simple. :-)

Vous pouvez également choisir d’avoir des objets spécifiques pour les fichiers à télécharger, ce qui peut être pratique pour avoir par exemple les dates de modification.

{   "id": 12,   "comment": "mon texte",   "photo": {     "url": "http://lien_vers_photo.jpg",     "updated_at": "2013-04-22T06:00:00Z"   },   "thumb": {     "url": "http://lien_vers_thumb.jpg",     "updated_at": "2013-04-22T07:00:00Z"   }, }

 Gestion des erreurs

Ne pas avoir de code erreur autres que 200 ou 500 peut parfois s’avérer utile.

Pour cela, utilisez le paramètre « suppress_error_codes » dans votre URL.

Egalement, pensez à renvoyer un message d’erreur explicite.

{   "errors": [     {       "message": "Password length is at least 8 characters.",       "code": 400     },     {       "message": "Email format is invalid.",       "code": 400     }   ] }

Gestion du cache

L’utilisation des en-têtes Etag/If-not-match permet une gestion plus efficace du cache.

Egalement, les en-têtes Last-Modified/If-modified-since sont très efficaces côté performances.

Authentification

Si vous souhaitez authentifier votre client et/ou votre utilisateur, je ne peux que vous recommander le protocole OAuth 2.0.

Il est simple, fiable et performant. Particulièrement adapté aux services web moderne.

L’authentification basique sur du HTTPS est également fiable et a l’avantage d’être la plus simple de toutes.

Limites

Les limites d’accès aux ressources peuvent être définies via les en-têtes HTTP X-RateLimit-Limit et X-RateLimit-Remaining. X-RateLimit-Reset permet de définir à quelle date/heure la limite va être réinitialisée.

Outils de développement

Les outils de développement les plus adaptés sont les suivants.

Si vous ne connaissez que le PHP, utilisez le framework Symfony 2 (Dailymotion) qui est bien conçu pour les services web.

Si vous êtes plus à l’aise avec Java/Scala, le framework Play est assez sympa, bien qu’un peu jeune.

Si vous êtes à l’aise avec Ruby, je ne peux que vous conseiller le framework Ruby on Rails (Twitter, Shopify, Groupon, GitHub, Linkedin) et/ou son petit cousin Sinatra (idéal pour le prototypage rapide).

Si vous êtes aventurier et que vous visez plus de performances, Node.js (Linkedin, eBay) peut être utilisé seul ou en parallèle de l’un des frameworks pré-cités.

Share
Web

Installer Ruby 1.9, Ruby on Rails 3 et Passenger sur un serveur Apache 2 sous Ubuntu 12.04

Comme beaucoup aujourd’hui, vous avez choisi d’utiliser les services d’Amazon Web Service pour vos déploiements de solutions web.

Seulement, plutôt que d’utiliser le classique Apache + PHP + MySQL, vous vous orientez vers une solution à base de Ruby on Rails.

Les instances EC2 d’Amazon utilisent, dans leur version Linux, Ubuntu 12.04 Server LTS. Et c’est là qu’est le problème : Ubuntu 12.04 est fourni en standard avec Ruby 1.8. Les dernières versions de Rails 3 nécessitent la version 1.9 de Ruby et il en va de même pour les futures versions.

Je vais donc considérer que vous avez en place un système Ubuntu 12.04 fonctionnel, ainsi que le serveur Apache 2 pleinement opérationnel.

Cet article est fortement inspiré d’une autre source orientée Nginx / PostgreSQL.

Première étape : installer les paquets pré-requis

Mettez à jour vos paquets via Aptitude.

sudo aptitude update;sudo aptitude upgrade

Puis, installez les paquets nécessaires à la suite des opérations.

sudo aptitude install build-essential zlib1g-dev libssl-dev libreadline-dev libyaml-dev libcurl4-openssl-dev curl git-core python-software-properties wget apache2-prefork-dev

Si vous utilisez une base de données MySQL

sudo aptitude install libmysqlclient-dev

Ou PostgreSQL

sudo aptitude install libpq-dev

Installer Ruby 1.9

Au moment de la rédaction de cette article, la dernière version en date de Ruby est la 1.9.3-p374.

Téléchargez et décompressez l’archive.

wget ftp://ftp.ruby-lang.org/pub/ruby/1.9/ruby-1.9.3-p374.tar.gz tar -xvzf ruby-1.9.3-p374.tar.gz

Allez dans le répertoire des sources et compiler le tout.

cd ruby-1.9.3-p374/ ./configure make

Installez Ruby. (installé dans /usr/local)

sudo make install

Configurez Gem. (optionnel mais conseillé dans une configuration serveur)

echo "gem: --no-ri --no-rdoc" >> ~/.gemrc

Enfin, installez le gem Bundler.

sudo gem install bundler

Installer Passenger

Passenger permet de lancer des applications Ruby on Rails directement via Apache ou Nginx.

Installons Passenger.

sudo gem install passenger

Installons maintenant le module Passenger pour Apache 2.

sudo passenger-install-apache2-module

Un assistant va se lancer : laissez le faire son job.

Il faut maintenant créer les fichiers de configuration.

/etc/apache2/mods-available/passenger.conf

PassengerRoot /usr/local/lib/ruby/gems/1.9.1/gems/passenger-3.0.19 PassengerRuby /usr/local/bin/ruby PassengerUserSwitching off PassengerDefaultUser www-data

/etc/apache2/mods-available/passenger.load

LoadModule passenger_module /usr/local/lib/ruby/gems/1.9.1/gems/passenger-3.0.19/ext/apache2/mod_passenger.so

Ensuite, activons le module passenger.

sudo a2enmod passenger sudo service apache2 restart

Pour déployer une application Ruby on Rails, il suffit de créer le fichier de configuration correspondant dans le répertoire /etc/apache2/sites-available.
Appelons ce fichier /etc/apache/sites-available/test.

On considère que le répertoire où est installée l’application est /var/www/test.

<VirtualHost *:80>     ServerAdmin webmaster@test.fr     ServerName test.fr       PassengerDefaultUser www-data       DocumentRoot /var/www/test/public     <Directory /var/www/test/public>         AllowOverride all         Options -MultiViews     </Directory> </VirtualHost>

Le fichier est configuré. Vérifiez les autorisations sur /var/www/test.
Vérifiez que vous avez installé les gems nécessaires et que vous avez pré-compilé vos assets.
Dans le répertoire de l’application, pensez à réinitialiser l’app.

touch tmp/restart.txt

Ensuite, on peut activer le site.

sudo a2ensite test sudo service apache2 reload

Normalement, tout devrait être opérationnel. :-)

Share
Développement Mac OS X Web

Le développement web sur Mac

Un rapide article pour vous présenter les différents outils vous permettant d’être rapidement opérationnel pour le développement web sur Mac OS X.

Apache / PHP / Ruby On Rails / MySQL

Concernant Apache, il faut savoir que le serveur est déjà installé d’origine sur le Mac, il y a juste à le configurer dans les options de partage. Il en va de même pour PHP 5 et Ruby.

Pour installer Ruby On Rails, gem sera votre allié.

Pour ce qui est de MySQL, ce n’est guère plus compliqué : vous trouverez la version serveur sur le site officiel. Je vous conseille également l’outil MySQL Workbench qui est très bien fait pour gérer ses bases de données.

L’éditeur TextMate

L’éditeur ViM est intégré à Mac OS X. Cependant, je ne suis pas certain qu’il satisfasse tout le monde.

Personnellement, j’utilise TextMate. Il coûte 45 € mais il est très performant. On peut le tester pendant 30 jours gratuitement.

Son gros avantage est qu’il est généraliste et intègre de nombreux Bundles, et certains se trouvent également sur le web : ActionScript, PHP, Apache, JavaScript, HTML, CSS, Git, Subversion, SQL, Prototype / Script.aculo.us, JQuery, JQTouch,  Ruby On Rails, SproutCore, XML, Perl, Cake PHP, Python… Et ça, uniquement pour les langages web.

Il permet par exemple de compresser le JavaScript, déboguer le code, avoir une auto-complétion efficace.

CyberDuck

Une fois que l’on a testé le code localement, on souhaite bien entendu l’envoyer sur un serveur. CyberDuck permet de gérer correctement tout type de serveur. Il est relativement puissant et regorge de fonctionnalités et de protocoles. (FTP, FTPS, SSH, ..)

Il est disponible en version gratuite (donation optionnelle) ou payante si le logiciel convient. ( 18,99 € sur le Mac App Store )

Synchronisation FTP / SSH avec MacFusion

Pouvoir éditer le code avec TextMate en sélectionnant les fichiers dans CyberDuck, c’est bien.

Pouvoir accéder au projet complet dans un répertoire donnée synchronisé avec le serveur, c’est mieux !

Pour cela, installez MacFUSE.

Ensuite, installez Macfusion.

Et c’est parti, vous pouvez synchroniser comme vous voulez n’importe quel répertoire en montant le répertoire distant localement.

Le débogage

Les différents navigateurs intègrent chacun leurs outils de débogage.

Concernant Safari, le navigateur par défaut de Mac OS X, vous pouvez afficher le menu Développement en passant par les préférences avancées.

Par exemple, grâce à l’inspecteur web (qui s’affiche justement via le menu développement), vous pouvez voir comment sont gérées les ressources, comment est organisée la hiérarchie de votre page, vous pouvez également entrer du code javascript à la volée… c’est vraiment très pratique.

Tester les services web

Souvent, nous avons accès à des services web permettant d’exploiter telle ou telle ressource. Cependant, il est souvent bien difficile de les tester.

Il y a bien entendu l’outil curl, accessible en ligne de commande, qui permet d’effectuer des tests complets, mais qui reste très austère.

Personnellement, j’utilise HTTP Client, disponible pour 1,59 € sur le Mac App Store. Il permet d’effectuer des tests rapidement et de voir les données HTTP brutes, le tout dans une interface graphique simple mais efficace.

RapidWeaver : l’éditeur WYSIWYG

RapidWeaver est disponible sur le Mac App Store pour 39,99 € et vous permet de concevoir très rapidement des sites web, sans connaissances techniques.

Pour les applications web

Le kit de développement fourni avec XCode intègre Dashcode, qui permet de concevoir visuellement des applications web pour Mac, iPhone et iPad.

MobDis, disponible gratuitement sur le Mac App Store, permet de concevoir des applications web également.

Share