Les premiers pas

Avant de commencer à utiliser le serveur web Thin, il est essentiel d'avoir une installation fonctionnelle de Ruby sur ta machine. Ruby est le langage dans lequel Thin est écrit, et c'est la base de tout l'écosystème. vous pouvez vérifier si Ruby est déjà installé en exécutant la commande ruby -v dans ton terminal. Si ce n'est pas le cas, tu peux l'installer via un gestionnaire comme RVM, rbenv ou directement depuis le site officiel. Il est aussi important d'avoir RubyGems, le gestionnaire de paquets pour Ruby, permettant d'installer facilement Thin et ses dépendances. Dans la plupart des installations modernes de Ruby, RubyGems est déjà inclus. Si vous n'êtes pas sûr, vous pouvez taper :

pour vérifier sa présence.

Ensuite, pour installer Thin, il est nécessaire d'avoir un environnement de développement propre et organisé. Cela signifie, idéalement, utiliser des gestionnaires de versions pour Ruby (comme rbenv) et des gestionnaires de gemsets (comme Bundler) pour séparer tes projets. Ces outils te permettent d'éviter des conflits entre différentes versions de bibliothèques Ruby et assurent une meilleure portabilité de ton code. Il est aussi utile d'avoir un éditeur de texte ou un IDE configuré pour Ruby afin de faciliter l'écriture et la navigation dans ton code. Enfin, assure-toi d'avoir les droits administratifs sur ta machine, car certaines installations de gem peuvent nécessiter des permissions élevées, surtout sur macOS ou Linux.

En plus de Ruby et RubyGems, avoir quelques connaissances de base sur Rack est recommandé, car Thin est un serveur compatible Rack. Rack est une interface minimale entre les serveurs web et les applications Ruby, utilisée par la majorité des cadres d'applications Ruby modernes comme Sinatra ou Rails. Comprendre comment une application Rack fonctionne t'aidera à mieux appréhender le comportement de Thin, notamment lors du déploiement ou de la configuration avancée. Même si tu n'utilises pas directement Rack, savoir comment il s'intègre dans la chaîne de traitement HTTP est un plus. Avoir des notions de HTTP, des ports, des requêtes et réponses, t'aidera aussi à diagnostiquer rapidement les éventuels problèmes de serveur. En résumé, une bonne base Ruby + quelques outils + une compréhension légère de l'écosystème te mettront sur la voie du succès avec Thin.

Prérequis

Avant tout, vous devez avoir :

• Ruby installé (vérifie avec ruby -v)
• RubyGems (normalement inclus avec Ruby)
• Optionnel : un cadre d'application comme Sinatra ou Rails

Installation de Thin

Vous pouvez tapez la commande suivante pour installer les binaires Thin :

Tester Thin avec une application Rack minimale

Vous pouvez créons une app minimaliste pour tester Thin :

• Crée un fichier config.ru :
1. # config.ru
2. run Proc.new { |env|
3.   [200, { 'Content-Type' => 'text/html' }, ['Bonjour depuis Thin !']]
4. }


• Lance l'application avec Thin :

thin start

Par défaut, Thin écoute sur le port 3000. Tu peux visiter http://localhost:3000 pour voir le résultat.

Options utiles

Voici quelques options pratiques :

Utiliser Thin avec Sinatra

Si vous voulez une app un peu plus stylée :

• Installe Sinatra :

gem install sinatra



• Crée un fichier app.rb :
1. require 'sinatra'
2.  
3. get '/' do
4.   'Bienvenue sur Sinatra avec Thin !'
5. end


• Lance avec Thin :

thin start -R app.rb

Vous pouvez aussi lancer Sinatra normalement (ruby app.rb) : si Thin est installé, il sera utilisé automatiquement comme serveur (sauf si vous forcez un autre).

Astuce pour Rails

Si vous êtes dans un projet Rails, vous pouvez démarrer Thin comme ceci :

Ou l'ajouter à ton Gemfile :

Puis bundle install, et Rails utilisera Thin au lieu de Puma si vous le voulez.