Ruby: Déployer en production

Déployez du code Ruby en production en quelques minutes avec Stackhero

👋 Bienvenue dans la documentation Stackhero !

Stackhero propose une solution Ruby cloud clé en main 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 bénéficiez de la configuration automatique des certificats HTTPS pour une sécurité accrue.

Profitez de la sauvegarde automatique, des mises à jour en un clic et d'une tarification simple, transparente et prévisible.

Bénéficiez d'une performance optimale et d'une sécurité robuste grâce à une infrastructure privée et dédiée.

Gagnez du temps et simplifiez-vous la vie : il ne vous faut que 5 minutes pour essayer la solution Ruby cloud hosting de Stackhero !

Le service d'hébergement cloud Ruby de Stackhero vous permet de mettre en ligne vos projets Ruby en quelques minutes seulement. Vous profitez d'une plateforme robuste conçue pour simplifier le déploiement et vous permettre de vous concentrer sur votre application plutôt que sur l'infrastructure.

Voici ce que vous obtenez :

Déployez votre code avec un simple git push.
Utilisez votre propre nom de domaine, avec gestion automatique du certificat TLS (HTTPS).
Faites tourner votre application sur une infrastructure dédiée et isolée pour une sécurité et une confidentialité accrues.
Profitez de HTTP/2, TLS 1.3 (HTTPS), WebSockets, compression GZIP et Brotli, support ETag, accès aux ports TCP et UDP, et plus encore.

Prérequis

Tout ce dont vous avez besoin pour commencer, c'est d'avoir Git installé sur votre ordinateur.

Si vous souhaitez gagner du temps ou préférez éviter la configuration d'un environnement local, vous pouvez explorer Code-Hero de Stackhero.

Code-Hero est un environnement de développement accessible depuis le navigateur, compatible avec tous les appareils. Basé sur un fork de VSCode, il inclut les outils essentiels déjà installés et configurés, ce qui vous permet de commencer à coder immédiatement sans aucune configuration.

Étapes pour déployer sur Stackhero

Déployer votre application Ruby sur Stackhero est simple. Voici le déroulement, chaque étape est expliquée ci-dessous :

Créez un service Ruby sur Stackhero.
Ajoutez votre clé publique SSH à la configuration de votre service Ruby.
Configurez la commande git push sur votre plateforme de développement.
Ajoutez un Makefile à votre projet.
Déployez votre code en production.

Si vous rencontrez des problèmes lors du déploiement, la documentation Dépannage vous permet de trouver rapidement des solutions et de poursuivre votre travail.

Configuration de votre service Ruby

Si vous n'avez pas encore créé de service Stackhero for Ruby, vous pouvez le faire depuis votre tableau de bord Stackhero en quelques minutes.

Une fois votre service Ruby en ligne, l'étape suivante consiste à ajouter votre clé publique SSH. Pour afficher votre clé publique, exécutez :

cat ~/.ssh/id_*.pub

Vous n'avez pas encore de clés SSH ?

Vous pouvez en générer une avec :
ssh-keygen -t ed25519

Pour ajouter votre clé SSH, rendez-vous sur votre tableau de bord Stackhero, sélectionnez votre service Ruby, cliquez sur « Configurer » et collez votre clé publique dans la section « Clés publiques SSH ».

Astuce : pour gagner du temps par la suite, vous pouvez ajouter votre clé publique SSH à votre profil Stackhero. Les nouveaux services que vous créerez l'incluront automatiquement.

Cliquez sur votre photo de profil en haut à droite du tableau de bord, sélectionnez « Votre profil » et ajoutez votre clé publique SSH.

Configuration de la commande `git push` pour le déploiement

Le déploiement sur Stackhero utilise le CLI Git et la commande git push, il n'est donc pas nécessaire d'installer d'autres outils.

Vous pouvez copier la commande git remote depuis la page principale de votre service sur le tableau de bord Stackhero. Elle ressemble généralement à :

git remote add stackhero ssh://stackhero@<XXXXXX>.stackhero-network.com:222/project.git

Création d'un Makefile pour le déploiement Stackhero

Pour indiquer à Stackhero comment exécuter votre application, ajoutez un fichier Makefile à la racine de votre projet. Ce fichier définit les commandes que Stackhero utilisera lors du déploiement.

Si vous découvrez les Makefiles ou la commande make, les étapes ci-dessous vous guideront pour créer un Makefile fonctionnel.

Créez un fichier Makefile avec le contenu suivant :

run:
	rake assets:precompile
	rake db:migrate RAILS_ENV=production
	RAILS_ENV=production bundle exec puma -C config/puma.rb

Ce que fait ce Makefile :

La règle run est obligatoire. Stackhero recherche cette règle comme point d'entrée lors du déploiement. Gardez ce nom de règle.
L'exemple utilise rake et bundle, mais vous pouvez adapter ces commandes selon votre application.
Chaque ligne de commande doit commencer par une tabulation, pas des espaces. Si vous voyez une erreur *** missing separator, vérifiez la présence des tabulations.

Dans l'exemple ci-dessus, le déploiement va :

Précompiler les assets comme JavaScript et CSS dans le dossier public/assets.
Exécuter les migrations de base de données.
Lancer le serveur Puma pour servir votre application.

Déployer votre application Ruby

Vous êtes prêt à déployer. Utilisez :

git push stackhero main

Lors du premier déploiement, Git vous demandera de confirmer l'empreinte de la clé SSH. Tapez « yes » pour continuer.

Après quelques instants, votre application sera en ligne.

Accédez à votre application déployée à l'adresse indiquée sur votre tableau de bord Stackhero. L'adresse ressemblera à https://<XXXXXX>.stackhero-network.com.

Votre application est maintenant en production.

Si vous rencontrez des difficultés lors du déploiement, la section Dépannage couvre les problèmes courants et leurs solutions.

Conclusion

Vous avez vu comment déployer du code Ruby en production avec Stackhero, grâce à un processus à la fois puissant et simple.

Pour des sujets avancés, comme le déploiement de différentes branches Git, tags ou commits, ou la gestion de plusieurs environnements (staging, production), consultez la documentation Usages avancés du déploiement. Vous y trouverez aussi des conseils pour l'utilisation des variables d'environnement et d'autres fonctionnalités utiles.

Si vous avez des questions ou des difficultés, la documentation Dépannage est toujours disponible pour vous aider à garder un workflow de déploiement fluide et efficace.