Ruby: Plateforme de développement

Configurez votre environnement de développement pour un workflow fluide et efficace

👋 Bienvenue sur la documentation de Stackhero !

Stackhero propose une solution Ruby cloud prête à l'emploi qui offre de nombreux avantages, notamment :

Déployez votre application en quelques secondes avec un simple git push.

Utilisez votre propre nom de domaine et profitez de la configuration automatique des certificats HTTPS pour une sécurité renforcée.

Bénéficiez de la sauvegarde automatique, des mises à jour en un clic, ainsi que d'une tarification simple, transparente et prévisible.

Profitez d'une performance optimale et d'une sécurité renforcée grâce à une infrastructure privée et dédiée.

Gagnez du temps et simplifiez-vous la vie : il suffit de 5 minutes pour essayer la solution d'hébergement Ruby cloud de Stackhero !

Une plateforme de développement bien préparée rend votre travail plus rapide, agréable et fiable.

Ce guide vous aide à choisir entre un développement local ou distant, vous accompagne dans l'installation de Ruby avec asdf, et vous montre comment démarrer un nouveau projet Ruby.

Choisir votre environnement de développement : local ou distant

Vous pouvez exécuter des projets Ruby de deux façons : en local sur votre ordinateur ou dans le cloud via un service prêt à coder comme Code-Hero. Chaque méthode a ses avantages, à vous de choisir celle qui correspond le mieux à votre façon de travailler.

Le développement local est idéal si vous souhaitez travailler hors ligne. Tout est installé sur votre machine, mais la configuration et la maintenance prennent plus de temps, surtout si vous débutez ou si vous avez besoin de plusieurs outils. Vous gérez vous-même les mises à jour, les sauvegardes et la sécurité, et vous êtes limité par les ressources de votre ordinateur. Accéder à votre travail depuis un autre appareil peut aussi être compliqué.

Le développement distant avec Code-Hero vous offre un environnement préconfiguré prêt en quelques secondes. Il inclut une version personnalisée de Visual Studio Code et le support natif d'outils comme Git, Docker, Ruby, Rails, et bien d'autres. Les serveurs cloud proposent généralement plus de CPU, de RAM et de stockage que les machines locales. Comme tout fonctionne dans le navigateur, vous pouvez travailler depuis n'importe quel appareil ou système d'exploitation.

Des outils intégrés comme Docker et Traefik facilitent l'utilisation de TLS et de vrais domaines (par exemple, https://your-project.you.your-company.dev). Cela reproduit fidèlement un environnement de production, ce qui permet de tester des webhooks (depuis GitHub, Slack, Stripe, etc.), de gérer le CORS et de développer avec des services proches du réel sans configuration supplémentaire.

Choisissez l'option qui correspond à votre workflow, vos compétences et les besoins de votre projet :

Développement local :
- ✅ Fonctionne hors ligne : Pas besoin d'internet
- ❌ Ressources limitées : Dépend des performances de votre ordinateur
- ❌ Configuration manuelle : Vous installez et configurez les outils vous-même
- ❌ Maintenance continue : Les mises à jour et sauvegardes sont à votre charge
Développement distant (sur Code-Hero) :
- ✅ Prêt instantanément : Tous les outils sont installés et configurés
- ✅ Haute performance : Utilise des serveurs cloud puissants et dédiés
- ✅ Travaillez partout : Accédez à votre environnement depuis n'importe quel appareil
- ✅ Intégrations en direct : Domaines HTTPS intégrés pour les webhooks et services tiers
- ❌ Connexion internet requise : Nécessite un accès réseau

Développer en Ruby : configuration distante

Un environnement distant supprime la configuration manuelle et accélère votre premier commit. Code-Hero fonctionne sur des serveurs haute performance, vous permettant de vous concentrer sur les fonctionnalités plutôt que sur la configuration des outils. Vous obtenez un espace de travail neuf et prêt à coder pour chaque projet, et la mise en place prend quelques secondes.

Si vous utilisez Code-Hero, vous pouvez passer directement à Créer un projet Ruby. Pour un développement local, poursuivez la lecture.

Développer en Ruby : configuration locale

Un environnement Ruby local vous donne un contrôle total, mais nécessite quelques étapes supplémentaires. Vous installez Ruby, les dépendances et les outils vous-même.

Installer Ruby avec asdf

asdf est un gestionnaire de versions flexible pour plusieurs langages, dont Ruby, Node.js, Python et PHP. Il facilite la gestion de projets sur différentes versions et évite les conflits entre outils.

Pour commencer, installez asdf en suivant le guide d'installation officiel.

Une fois installé, vous pouvez vérifier que asdf fonctionne en lançant :

asdf version

Si un numéro de version s'affiche, asdf est correctement installé.

Pour installer la dernière version de Ruby :

asdf plugin add ruby https://github.com/asdf-vm/asdf-ruby.git
asdf install ruby latest
asdf global ruby latest

Vérifiez que Ruby fonctionne :

ruby --version

Cela confirme que Ruby est prêt à l'emploi.

Créer un projet Ruby

Une fois Ruby installé :

asdf install ruby latest \
  && asdf global ruby latest

Installez Rails :

gem install rails

Créez votre application (remplacez my_app par le nom de votre projet) :

rails new my_app
cd my_app
asdf local ruby latest

Démarrez le serveur Rails :

bin/rails server

Ruby on Rails welcome screen

Ces étapes vous offrent une base propre pour démarrer votre projet, et asdf garantit que vous utilisez toujours la bonne version de Ruby.

Par défaut, Rails crée un dépôt Git local pour votre projet, mais il n'est pas relié à un service d'hébergement distant.

Pour un contrôle de version fiable et des sauvegardes, vous pouvez connecter votre dépôt à un service comme GitHub, GitLab ou Bitbucket. Stackhero propose un service GitLab cloud fonctionnant sur une infrastructure dédiée, vous offrant confidentialité et sécurité en Europe ou aux USA.

Configuration spécifique pour Code-Hero

Si vous travaillez dans Stackhero Code-Hero, adaptez la configuration de Rails pour l'accès distant. Ouvrez config/environments/development.rb et ajoutez cette ligne juste avant le dernier end, en remplaçant <XXXXXX>.stackhero-network.com par le nom d'hôte de votre serveur Code-Hero :

config.hosts << "<XXXXXX>.stackhero-network.com"

Hosts configurations example

Démarrez ensuite le serveur en l'écoutant sur toutes les interfaces réseau :

bin/rails server -b 0.0.0.0