Contexte
Votre hébergement web Winheberg peut faire tourner des applications Ruby basées sur Rack, comme celles écrites avec Sinatra, Roda ou Hanami. Plesk les sert avec Phusion Passenger, qui démarre votre application à la première visite et la garde en mémoire.
L'extension Ruby de Plesk s'occupe de la version de Ruby, de l'installation des gems listées dans votre Gemfile et du redémarrage de l'application. Vous n'avez besoin d'aucun accès en ligne de commande.
Ce guide couvre l'arborescence attendue, le réglage de la racine du site, l'activation de Ruby, l'installation des gems et les erreurs les plus courantes.
Prérequis
- Un hébergement web Winheberg avec accès au panel Plesk
- Un domaine ou un sous-domaine dédié à l'application, voir notre guide Comment relier un domaine externe à votre hébergement Plesk ?
- Votre application, avec son fichier
config.ruet sonGemfile
Une application qui a besoin de lancer des commandes en ligne de commande, comme les migrations de Ruby on Rails, demande un accès SSH. Si votre offre ne l'ouvre pas, un VPS Winheberg vous donne un contrôle complet du serveur.
1. Préparer l'arborescence de l'application
Plesk attend une organisation précise. Le dossier de l'application contient config.ru et le Gemfile, et un sous-dossier public reçoit les fichiers statiques comme les images ou les feuilles de style.
| Élément | Emplacement |
|---|---|
| Dossier de l'application | app.exemple.fr |
| Fichier de démarrage | app.exemple.fr/config.ru |
| Liste des gems | app.exemple.fr/Gemfile |
| Fichiers statiques | app.exemple.fr/public |
Pour tester l'hébergement avant d'envoyer votre vraie application, voici une application minimale. Le fichier config.ru contient l'application elle-même.
run lambda { |env|
[200, { "content-type" => "text/html; charset=utf-8" }, ["<h1>Bonjour depuis Ruby #{RUBY_VERSION}</h1>"]]
}
Le fichier Gemfile déclare la gem rack dont elle a besoin.
source "https://rubygems.org"
gem "rack"
Envoyez ces fichiers dans le dossier de l'application avec le gestionnaire de Fichiers de Plesk, ou avec notre guide Comment se connecter en FTP à votre hébergement Plesk avec FileZilla ?
2. Faire pointer le site vers le dossier public
Ouvrez votre domaine depuis Sites Web & Domaines, puis l'onglet Hébergement et DNS et l'entrée Hébergement. Dans Racine du document, ajoutez /public au chemin du dossier de l'application, puis cliquez sur Enregistrer.
Plesk crée alors le dossier public s'il n'existe pas, avec sa page par défaut index.html. Supprimez ce fichier depuis le gestionnaire de Fichiers, sinon c'est lui qui s'affiche à l'adresse de votre site, à la place de votre application.
3. Activer Ruby
Dans l'onglet Démarrer du domaine, cliquez sur Ruby, puis sur Activer Ruby.
La page Ruby affiche alors les réglages de l'application et ses boutons d'action.
| Réglage | Ce qu'il indique |
|---|---|
| Version de Ruby | La version utilisée par l'application, modifiable en cliquant dessus |
| Mode d'application | production, le mode à garder pour un site en ligne |
| Root d'application | Le dossier de l'application, toujours le dossier parent de la racine du site |
| Variables d'environnement personnalisées | Les variables transmises à l'application, à renseigner avec préciser |
| Type d'app Ruby | Basé sur Rack, détecté grâce au fichier config.ru |
Vérifiez que Root d'application affiche bien le dossier de votre application, par exemple /app.exemple.fr. S'il affiche /, la racine du site n'a pas été réglée sur le dossier public, revenez à l'étape 2.
4. Installer les gems
Cliquez sur Installation de bundle. Plesk lit votre Gemfile, installe les gems dans le dossier vendor de l'application et crée le fichier Gemfile.lock.
Relancez Installation de bundle à chaque modification du Gemfile.
5. Redémarrer et tester l'application
Cliquez sur Redémarrer l'app, puis ouvrez votre domaine dans un navigateur. L'application minimale affiche la version de Ruby utilisée.
Pensez à Redémarrer l'app après chaque envoi d'une nouvelle version de votre code, Passenger garde sinon l'ancienne en mémoire.
En cas de problème
❌ La page Ruby indique « Fichier de démarrage /config.ru introuvable »
Plesk cherche config.ru dans le dossier parent de la racine du site, et ne l'y trouve pas.
- Vérifiez que la Racine du document se termine par
/public, comme à l'étape 2 - Vérifiez que
config.ruse trouve dans le dossier de l'application, et non danspublic - Rechargez la page Ruby, Root d'application doit afficher le dossier de l'application
❌ La page par défaut de Plesk s'affiche à la place de l'application
Passenger sert d'abord les fichiers présents dans public, dont la page par défaut créée par Plesk.
- Supprimez
public/index.htmldepuis le gestionnaire de Fichiers - Rechargez votre site sans le cache avec Ctrl+F5
❌ L'application renvoie une erreur après une mise à jour
Une gem manque ou l'application a gardé l'ancienne version en mémoire.
- Relancez Installation de bundle, puis Redémarrer l'app
- Ouvrez le bouton Logs de la page Ruby pour lire le message d'erreur
- Si l'installation d'une gem échoue à la compilation, ouvrez un ticket auprès de notre support en joignant le message
Bonnes pratiques
- Gardez le mode production pour le site public
- Rangez vos clés et mots de passe dans les Variables d'environnement personnalisées, jamais dans le code
- Versionnez le fichier
Gemfile.lock, il garantit les mêmes versions de gems en local et sur l'hébergement - Placez uniquement des fichiers statiques dans
public, le reste de l'application ne doit pas être accessible depuis le web - Activez le HTTPS avec notre guide Comment générer un certificat SSL Let's Encrypt pour votre site web ?
Besoin d'aide ?
Si votre application ne démarre toujours pas, ouvrez un ticket auprès de notre support depuis votre espace client, département Technique, en renseignant le champ Produit lié avec l'hébergement web concerné. Joignez le contenu des Logs de la page Ruby et la version de Ruby utilisée.
Votre application Ruby tourne sur votre hébergement, sans une ligne de commande 💎


