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 bénéficiez de la configuration automatique des certificats HTTPS pour une sécurité renforcée.

Profitez de la tranquillité d'esprit avec des sauvegardes automatiques, des mises à jour en un clic, et une tarification simple, transparente et prévisible.

Obtenez des performances optimales et une sécurité robuste grâce à une VM privée et dédiée.

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

Bienvenue dans le guide de démarrage pour Ruby on Rails. Dans ce guide, vous êtes introduit à 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 simplement appelé Rails) est un framework d'application web côté serveur construit avec Ruby. Il suit le modèle architectural model-view-controller (MVC) et adopte les principes Convention over Configuration (CoC) et Don't Repeat Yourself (DRY). Ces caractéristiques font de Rails une option puissante, efficace et flexible pour le développement web.

Ci-dessous, nous vous guidons à travers 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 simple application "Hello World". Des conseils supplémentaires sont fournis 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 d'application web robuste côté serveur qui fonctionne sur Ruby. Il offre une approche structurée et standardisée pour construire des applications web en proposant des outils et des bibliothèques pour simplifier les tâches de développement courantes.

De nombreux développeurs choisissent Ruby on Rails plutôt que d'utiliser Ruby seul car son framework complet rationalise le développement et améliore la productivité.

Configurer un projet Ruby

Commencer un nouveau projet Ruby est simple. Suivez ces étapes pour démarrer :

Tout d'abord, assurez-vous d'avoir la dernière version de Ruby installée sur votre système. Vous pouvez vérifier cela 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 vous référer à la documentation officielle d'asdf pour des instructions d'installation détaillées.

Alternativement, vous pouvez utiliser Stackhero Code-Hero, une solution de développement en ligne où tous les outils nécessaires sont pré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 simple :
```
gem install rails
```
Puis, créez une nouvelle application Rails nommée my_app et spécifiez la version de Ruby en utilisant 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
```
Écran de bienvenue Ruby on Rails

Ces étapes créent un nouveau projet Ruby tout en définissant la version appropriée de Ruby. Cela pose 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 lié à un service de contrôle de version à distance.

Pour un contrôle de version approprié et la sécurité des données, il est conseillé 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ôt, Stackhero propose un service cloud GitLab qui peut être configuré en seulement 2 minutes.

Cas particulier avec Stackhero Code-Hero

Lors de l'utilisation d'une solution de développement en ligne comme Stackhero Code-Hero, vous devez ajuster votre fichier config/environments/development.rb. Ajoutez la configuration suivante près du mot-clé final 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 hôtes

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

bin/rails server -b 0.0.0.0

Cette commande garantit que le serveur Rails est accessible depuis n'importe quelle adresse IP, ce qui est particulièrement utile lors du travail à distance via Stackhero Code-Hero.

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

Passons en revue le processus de création d'une simple application "Hello World" en utilisant Ruby on Rails.

Tout d'abord, configurez 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 faite au chemin URL / sera gérée par le HelloController.
Pour afficher le message "Hello World", créez une vue. Ouvrez le fichier à app/views/hello/index.html.erb et remplacez tout contenu existant par le code suivant :
```
<h1>Hello World!</h1>
```
Enfin, démarrez le serveur Rails en exécutant la commande ci-dessous dans votre terminal. Puis, connectez-vous à 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" en 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 telles que les clés API et les mots de passe de base de données.

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

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

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

Installez le 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 complété ces étapes, redémarrez votre serveur Rails. Les variables d'environnement définies dans le fichier .env seront désormais automatiquement accessibles dans votre application.

Variables d'environnement pour votre plateforme de développement