La 57ième boule de cristal

Comme annoncé dans l’article d’introduction, je vous propose de passer en revue les étapes de mon installation d’une configuration de développement ‘Ruby on Rails’ sous Windows XP.

Rails vient de passer à la version 1.2.x
Pour ceux qui installent Rails pour la première fois, cet article reste d’actualité dans ses grandes lignes excepté le passage concernant l’intégration de MySQL: il n’est plus nécessaire de passer par l’étape Ruby For Apache. Une installation ‘en pur et dur’ depuis le lien de Ruby InsTaller Wiki fonctionne parfaitement ‘du premier coup’.

(i) Pour ceux qui veulent mettre leur version existante à jour, voir ici la marche à suivre. Attention aux conflits toujours possibles entre les différentes versions des composants.

Première partie: confectionnons le gâteau.

La première partie de mon installation suit, dans les grandes lignes, l’article¹ de Denis Schoob tiré de son site ‘The rail mixer‘.

Soit dans l’ordre:

• Installation de MySQL 4.1 Windows Essentials, dernière version pour Windows² en prenant toutes les valeurs par défaut, excepté dans le ’security panel’, où il faut décocher ‘Modify Security Settings’ comme décrit dans l’article de Curt Hibbs, ‘Rolling with Ruby on Rails’, sur le site de O’Reilly ONLamp.com.

(i) Afin de préserver des ressources système, je vous conseille de gérer manuellement le démarrage et l’arrêt du service Mysql via le Panneau de configuration³

(i) Je vous conseille également d’ajouter le chemin vers les exécutables de MySQL⁴ à la variable système Path⁵

• Installation de la dernière version de Ruby pour Windows⁶
• Installation de Ruby For Apache 1.3.1⁷ et copie de mysql.so dans c:\ruby\lib\ruby\site_ruby\1.8\i386-msvcrt\
• Installation de Rails proprement dit:

> gem install rails --include-dependencies
Bulk updating Gem source index for: http://gems.rubyforge.org
Successfully installed rails-1.2.2

(i) pour les ‘coincés’ derrière un proxy, faire usage des variables environnement HTTP_PROXY= <http://adresse du proxy:port>⁸ HTTP_PROXY_USER=user.name et HTTP_PROXY_PASS=password⁹

(i)Je vous conseille de placer une copie du fichier C:\Program Files\MySQL\MySQL Server 4.1\bin\libmySQL.dll dans c:\ruby\bin.

Deuxième partie: vérifions que le gâteau est bien cuit.

• vérifions d’abord les versions des composants installés:

Microsoft Windows XP [version 5.1.2600]
(C) Copyright 1985-2001 Microsoft Corp.
 
>rails -v
Rails 1.2.2
 
>gem environment
Rubygems Environment:
- VERSION: 0.9.2 (0.9.2)
- INSTALLATION DIRECTORY: C:/ruby/lib/ruby/gems/1.8
- GEM PATH:
- C:/ruby/lib/ruby/gems/1.8
- REMOTE SOURCES:
- http://gems.rubyforge.org
>

• vérifions ensuite le bon fonctionnement de Rails en créant une application de test¹⁰

C:\>rails testapplication
create
create app/controllers
create app/helpers
create app/models
create app/views/layouts
create config/environments
create components
create db
create doc
create lib
create lib/tasks
create log
create public/images
create public/javascripts
create public/stylesheets
create script/performance
create script/process
create test/fixtures
create test/functional
create test/integration
create test/mocks/development
create test/mocks/test
create test/unit
create vendor
create vendor/plugins
create tmp/sessions
create tmp/sockets
create tmp/cache
create Rakefile
create README
create app/controllers/application.rb
create app/helpers/application_helper.rb
create test/test_helper.rb
create config/database.yml
create config/routes.rb
create public/.htaccess
create config/boot.rb
create config/environment.rb
create config/environments/production.rb
create config/environments/development.rb
create config/environments/test.rb
create script/about
create script/breakpointer
create script/console
create script/destroy
create script/generate
create script/performance/benchmarker
create script/performance/profiler
create script/process/reaper
create script/process/spawner
create script/runner
create script/server
create script/plugin
create public/dispatch.rb
create public/dispatch.cgi
create public/dispatch.fcgi
create public/404.html
create public/500.html
create public/index.html
create public/favicon.ico
create public/robots.txt
create public/images/rails.png
create public/javascripts/prototype.js
create public/javascripts/effects.js
create public/javascripts/dragdrop.js
create public/javascripts/controls.js
create public/javascripts/application.js
create doc/README_FOR_APP
create log/server.log
create log/production.log
create log/development.log
create log/test.log
 
C:\>

• un coup d’oeil à l’arborescence des répertoires pour vérifier que tout est bien là:

C:\>tree testapplication
Structure du dossier
 
C:\TESTAPPLICATION
├───app
│ ├───controllers
│ ├───helpers
│ ├───models
│ └───views
│ └───layouts
├───components
├───config
│ └───environments
├───db
├───doc
├───lib
│ └───tasks
├───log
├───public
│ ├───images
│ ├───javascripts
│ └───stylesheets
├───script
│ ├───performance
│ └───process
├───test
│ ├───fixtures
│ ├───functional
│ ├───integration
│ ├───mocks
│ │ ├───development
│ │ └───test
│ └───unit
├───tmp
│ ├───cache
│ ├───sessions
│ └───sockets
└───vendor
└───plugins
 
C:\>

• démarrons le service MySQL¹¹ vérifions également que le module MySQL est bien présent:

Microsoft Windows XP [version 5.1.2600]
(C) Copyright 1985-2001 Microsoft Corp.
 
>cd c:\testapplication
 
C:\testapplication>rake db:migrate
c:0:Warning: require_gem is obsolete. Use gem instead.
(in C:/testapplication)
rake aborted!
#42000Unknown database ‘testapplication_development’
 
(See full trace by running task with –trace)
 
C:\testapplication>

• OK (y) tout semble correct: Rails a bien connecté MySQL et a essayé d’ouvrir la base de données testapplication_development¹²

• nous pouvons maintenant effacer les répertoires de l’application test, nous n’en avons plus besoin.

Troisième partie: la cerise sur le gâteau: Eclipse.

Comme conseillé par Frédéric sur son Fred’s Blog¹³, j’ai installé EasyEclipse for LAMP version 1.2.1 ainsi que son plugin Subversion.

…du caviar (*)

Je vous montrerai comment s’en servir dans le(s) prochain(s) article(s)

---

---

A suivre…

Retour vers l’article d’introduction

 

---

1. en français [retour]
2. 4.1.21 lors de mon installation [retour]
3. Outils d’administration - Gestion de l’ordinateur - Services - Mysql [retour]
4. par défaut, chez moi C:\Program Files\MySQL\MySQL Server 4.1\bin [retour]
5. Panneau de configuration - Système - Avancé - Variables d’environnement - Variables système - Path - Modifier - Valeur de la variable [retour]
6. 1.8.5 lors de mon installation [retour]
7. l’endroit de l’installation n’a que peu d’importance car la seule chose qui nous intéresse est le fichier mysql.o [retour]
8. voir par exemple dans les paramètres de connexion des options internet du menu Outils de IE [retour]
9. soit simplement avec la commande set ou alors de façon permanente via le Panneau de configuration - Système - Avancé - Variables d’environnement [retour]
10. lancer la commande rails dans un (sous-)répertoire de votre choix, nous effacerons cette application après nos test. [retour]
11. si il n’est pas en mode démarrage automatique. En cas d’oubli, le message est : Bad file descriptor - connect(2) [retour]
12. voir config/database.yml [retour]
13. et aussi ici [retour]