Ruby: Premiers pas

Premiers pas avec Ruby on Rails

👋 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 et d'une tarification simple, transparente et prévisible.

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

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

Bienvenue dans le guide de démarrage pour Ruby on Rails. Ce guide vous présente l'un des frameworks d'applications web les plus populaires, conçu pour simplifier et accélérer votre processus de développement.

Ruby on Rails (souvent appelé simplement Rails) est un framework d'applications web côté serveur développé en Ruby. Il suit le modèle architectural model-view-controller (MVC) et applique les principes Convention over Configuration (CoC) et Don't Repeat Yourself (DRY). Ces caractéristiques font de Rails une solution puissante, efficace et flexible pour le développement web.

Vous trouverez ci-dessous les étapes essentielles pour lancer un nouveau projet Ruby on Rails. Vous apprendrez à installer Ruby et Rails, à configurer votre premier projet, et même à créer une application "Hello World". Des conseils supplémentaires sont proposés pour différents environnements de développement, y compris l'utilisation de la plateforme en ligne Stackhero Code-Hero.

Comprendre la différence entre Ruby et Rails

Ruby est un langage de programmation dynamique et open-source, similaire à PHP, JavaScript ou Python. Il met l'accent sur la simplicité et la productivité, avec une syntaxe élégante, facile à lire et à écrire.

Rails est un framework robuste d'applications web côté serveur qui s'exécute sur Ruby. Il propose une approche structurée et standardisée pour créer des applications web, en fournissant des outils et des bibliothèques qui simplifient les tâches courantes de développement.

De nombreux développeurs choisissent Ruby on Rails plutôt que Ruby seul, car son framework complet accélère le développement et améliore la productivité.

Mise en place d'un projet Ruby

Démarrer un nouveau projet Ruby est simple. Suivez ces étapes pour commencer :

Tout d'abord, assurez-vous d'avoir la dernière version de Ruby installée sur votre système. Vous pouvez le vérifier en exécutant la commande suivante dans votre terminal :
```
asdf install ruby latest \
  && asdf global ruby latest
```
Si vous n'avez pas encore installé asdf, vous devrez le faire avant de continuer. Veuillez consulter la documentation officielle d'asdf pour des instructions détaillées.

Vous pouvez également utiliser Stackhero Code-Hero, une solution de développement en ligne où tous les outils nécessaires sont déjà installés. Cette plateforme vous permet de commencer à coder immédiatement, sans installation manuelle.
Ensuite, installez Rails. Rails est distribué sous forme de RubyGem, ce qui rend l'installation très simple :
```
gem install rails
```
Puis, créez une nouvelle application Rails nommée my_app et spécifiez la version de Ruby avec ces commandes :
```
rails new my_app
cd my_app
asdf local ruby latest
```
Pour lancer le serveur Rails, exécutez la commande suivante :
```
bin/rails server
```
Ecran d'accueil Ruby on Rails

Ces étapes créent un nouveau projet Ruby tout en définissant la version appropriée de Ruby. Cela constitue une base solide pour le développement de votre application.

Important : Lors de l'exécution de la commande rails new, un dépôt Git local est automatiquement créé pour votre projet Ruby. Cependant, il n'est pas encore relié à un service de gestion de versions distant.

Pour assurer un bon suivi de version et la sécurité de vos données, il est recommandé de connecter votre projet à un service d'hébergement tel que GitLab, GitHub ou Bitbucket.

Si vous avez besoin d'un service d'hébergement de dépôts, Stackhero propose un service GitLab cloud qui peut être configuré en seulement 2 minutes.

Cas particulier avec Stackhero Code-Hero

Lorsque vous utilisez une solution de développement en ligne comme Stackhero Code-Hero, il est nécessaire d'ajuster votre fichier config/environments/development.rb. Ajoutez la configuration suivante près du dernier mot-clé end. Remplacez <XXXXXX>.stackhero-network.com par le nom d'hôte réel de votre serveur :

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

Exemple de configuration des hosts

Enfin, démarrez le serveur Rails avec cette commande :

bin/rails server -b 0.0.0.0

Cette commande permet d'accéder au serveur Rails depuis n'importe quelle adresse IP, ce qui est particulièrement utile lors d'un travail à distance via Stackhero Code-Hero.

Créer votre première application "hello world" avec Ruby on Rails

Voyons ensemble comment créer une application "Hello World" simple avec Ruby on Rails.

Commencez par définir une nouvelle route pour votre application. Ouvrez le fichier config/routes.rb et définissez une route racine qui pointe vers l'action hello#index :
```
Rails.application.routes.draw do
  root "hello#index"
end
```
Ensuite, générez le contrôleur Hello pour gérer la logique de cette route. Exécutez la commande suivante dans votre terminal :
```
bin/rails generate controller Hello index --skip-routes
```
Avec cette configuration, toute requête vers le chemin URL / sera traitée par le contrôleur HelloController.
Pour afficher le message "Hello World", créez une vue. Ouvrez le fichier app/views/hello/index.html.erb et remplacez tout le contenu existant par le code suivant :
```
<h1>Hello World!</h1>
```
Enfin, démarrez le serveur Rails en lançant la commande ci-dessous dans votre terminal. Connectez-vous ensuite à votre URL de développement (par exemple, http://<XXXXXX>.stackhero-network.com:3000) pour voir votre application :
```
bin/rails server -b 0.0.0.0
```
Première page "Hello World" avec Ruby on Rails

Félicitations. Vous venez de créer votre première application Ruby on Rails !

Gestion des variables d'environnement

Les variables d'environnement sont essentielles pour protéger les données sensibles comme les clés API et les mots de passe de base de données.

La gem dotenv-rails offre un moyen pratique de gérer les variables d'environnement dans votre environnement de développement. Voici les étapes à suivre :

Ajoutez la gem à votre Gemfile dans les groupes appropriés :

# Gemfile
gem 'dotenv-rails', groups: [:development, :test]

Installez la gem en exécutant :
```
bundle install
```
Créez un fichier .env à la racine de votre projet et définissez vos variables d'environnement. Par exemple :
```
RAILS_ENV=development
```
Pour protéger vos données sensibles, assurez-vous que le fichier .env est exclu de votre dépôt Git. Ajoutez la ligne suivante à votre .gitignore :
```
echo '.env*' >> .gitignore
```

Après avoir suivi ces étapes, redémarrez votre serveur Rails. Les variables d'environnement définies dans le fichier .env seront alors automatiquement accessibles dans votre application.

Variables d'environnement pour votre plateforme de développement