HostingRails est un site formé par une bande de développeurs passionnés de Ruby. Ils ont développé leur propre interface d’administration en Ruby afin de gérer leur serveur. Ils proposent differentes offres d’hébergement dont une sur laquelle j’ai déployé mon propre blog sous Typo.
La source principale de cet article est le “Step by Step Tutorial” du site de HostingRails.
La connexion SSH
Il faut savoir établir une connexion SSH ! Après l’inscription, HostingRails vous communique par mail votre identifiant et votre mot de passe. Ces identifiants vous permettront de vous connecter directement au serveur.
Pour la connexion SSH il faut un logiciel dédié. Si vous êtes sous windows, je vous recommande Putty (putty.exe). Un excellent logiciel à l’interface austère mais qui fait ce qu’on lui demande et qui le fait bien. Un fois putty récupéré, il suffit de le lancer et d’établir la connexion vers l’ip du serveur que vous a fourni HostingRails. (Je vous recommande ce tuto, si vous ne savez pas du tout utiliser Putty.)
Sous Linux, il suffit d’ouvrir un terminal et de tapper :
$ ssh www.stoneageblog.com -l identifiant
(Remplacer stoneageblog par votre nom de domaine ou directement par l’adresse IP du serveur.)
Fichiers
A partir d’ici, quel que soit votre système d’exploitation c’est la même chose ! Nous allons donc installer Typo à la racine de votre serveur de sorte que si l’on tappe www.votrenomdedomaine.com on arrive directement sur le blog !
La première étape consiste à télécharger Typo. La commande suivante vous permettra de le récupérer directement depuis le site officiel : Typoshere.Org.
$ svn checkout svn://typosphere.org/typo/trunk typo
“typo” est le répertoire ou seront mis les fichiers. Vous pouvez le changer, il faudra veiller cepdendant à bien écrire les lignes de commandes qui suivront en fonction de votre choix.
Ensuite il faut indiquer au serveur que nous devons directement aller vers le répertoire de typo lorsque on tappe notre nom de domaine dans la barre d’adresse de votre navigateur favoris 
Pour se faire on sauvegade d’abord le répertoire existant :
$ mv ~/public_html ~/public_html_backup
Ceci fait il faut créer un lien symbolique de public_html vers typo.
$ ln -s ~/typo/public ~/public_html
Voila Typo est en place. Il faut maintenant créer la base de donnée et la “peupler” avec le script de Typo.
Base de donnée
Typo peut fonctionner avec plusieurs type de base de données, nous utiliserons MySQL car c’est celle qui est la plus courante. Il faut donc tout d’abord créer la base. Rendez vous sur l’interface d’administration de votre compte chez HostingRails : Cpanel. Identifiez vous, et cliquez sur l’icone “MySQL”. Sur la nouvelle page, suivez l’ordre chronologique de la page et procédez comme suit 1. Créer une base : typobdd (par exemple) 2. Créer un utilisateur : typouser (par exemple) 3. Associer l’utilisateur à la base (Laisser les privilèges sur ALL)
Votre base est en place, il faut maintenant installer les tables et les données par défaut de Typo. Rien de plus simple, de retour sur votre terminal, tappez la commande suivante :
$ cd typo
Cela vous mettra dans le répertoire de votre installation.
$ mysql -u typouser -p typobdd < db/schema.mysql.sql
(/!\ typouser & typobdd doivent être préfixés par votre identifiant !) Tappez votre mot de passe et quelques secondes plus tard, votre base est prête. Il faut maintenant indiquer à typo d’utiliser cette base de donnée.
Configuration
Si vous êtes familier avec Rails, cette étape consiste à renseigner le fichier “database.yml”. Voici comment cela se fait. Toujours en ligne de commande, dupliquer le fichier par défaut et utiliser votre éditeur favoris et ouvrez le fichier database.yml. Je vous conseille d’utiliser “nano” si vous ne savez pas quoi choisir.
$ cp config/database.yml.example config/database.yml
puis :
$ nano config/database.yml
Renseignez le fichier comme suit, (sans les commentaires entre parenthèses !)
login: &login
adapter: mysql
host: localhost
username: identifiant_typouser
password: ********* (mettez le votre ici
)
development: database: identifiant_typobdd (inutile si vous ne comptez pas faire de dev sur typo) <<: *login
test: database: identifiant_typobdd (idem) <<: *login
production: database: identifiant_typobdd (important !) <<: *login
Ok, maintenant typo sait comment communiquer avec votre BDD, il faut maintenant dire à typo qu’il est en production.
NB : Chez hostingrails, une application ruby ne fonctionnera qu’en mode production. Voila pourquoi les noms des bases de données pour le dev et le test ne sont pas utiles.
Editez le fichier environment.rb afin de mettre Typo en production :
$ nano config/environment.rb
et decommenter la ligne suivante :
#ENV['RAILS_ENV'] = 'production'
qui deviendra donc :
ENV['RAILS_ENV'] = 'production'
Tests
Reprennez votre navigateur favoris et allez sur votre URL. Au premier accès, Typo le détectera et vous demandera de spécifier plusieurs paramètres de configuration. Si typo vous demande tout ça c’est que ça marche, sinon, hésitez pas à me laisser des commentaires, on verra si on peu pas débloquer tout ça !
Pour aller plus loin.
Typo utilise des thèmes, en début d’année il ya eu un concours afin d’en créer un peit paquet. Tout ces thèmes peuvent être consultés et téléchargés sur le site du concours : www.typogarden.com/.
Pour installer un thème il faut donc le récupérer sur votre serveur, le dézipper, et le placer dans le répertoire des thèmes :
$ wget http://url/vers/le/fichier/zip/contenant/le/thème
$ unzip theme.zip (unrar, ou tar -xvzf selon l'archive)
$ mv theme/ themes/ (déplacement)
Ensuite rendez vous sur l’admin de typo afin de le sélectionner ! Cependant attention, les thèmes ne sont peu être pas parfaitement compatible avec la dernière version de typo. J’ai eu beaucoup de problème de plantage d Typo à répétition car j’avais mis un thème dès le début qui ne marchait pas correctement.
Je vais probablement me faire un thème perso bientôt, j’expliquerai la démarche à suivre afin de pouvoir développer son propre thème.
Tips and Tricks
$ ps aux | grep votreidentifiant
Vous permettra de savoir quels sont les processus qui sont lancés, logiquement il devrait y avoir : ruby dispatch.fcgi. HostingRails autorise 5 instance de ruby par utilisateur si je ne me trompe pas.
Donc si vous avez un problèmes avec Typo ou si tout simplement vous voulez prendre en compte des modifications de configuration, vous serez obliger de tuer le processus du dispatch. (Cf mode production)
$ killall -usr1 ruby
Cette commande vous permettra de le faire, elle affichera aussi des warning comme quoi elle n’a pas réussi à tuer tout les processus ‘ruby’ mais c’est normal car c’est un serveur partagé et d’autre utilisateurs ont leur propre instance de ruby ! Cette commande vous permettra de “tuer” le serveur qui permet à typo de foncitonner. Plus précisément : ‘ruby dispatch.fcgi’ qui fait office de serveur
