Ruby on Rails

Installation de Ruby

Edgegap vous propose une plateforme très intuitive pour déployer une application web sans serveur où vous en avez besoin. Pour ce tutoriel, nous passerons en revue les étapes pour déployer une application Ruby on Rails. Avant de vérifier quoi que ce soit d'autre, assurez-vous d'avoir Ruby installé.

Si vous utilisez une machine Linux/UNIX, vous pouvez utiliser le gestionnaire de paquets préinstallé de votre machine et installer Ruby via votre terminal. Vous pouvez vous référer à la documentation officielle de Ruby pour trouver la commande précise correspondant à votre distribution Linux/UNIX.

Sur les machines Windows, vous devrez télécharger RubyInstaller pour obtenir Ruby.

À la fin de l'installation, vous pouvez vérifier que Ruby est correctement installé avec la commande suivante :

ruby -v

Maintenant que Ruby est installé, vous devrez évidemment installer Rails. C'est assez simple et peut être fait avec cette seule commande :

gem install rails

Vous pouvez facilement confirmer que Rails a été correctement installé de la même manière que nous avons vérifié l'installation de Ruby.

rails -v

Exigences

Pour suivre ce tutoriel, vous devrez disposer des éléments suivants en plus de Ruby et Ruby on Rails :

• Docker Desktop

• Un compte sur Edgegap

• Accès à le dépôt privé de conteneurs d'Edgegap ou un autre registre comme le registre de conteneurs de Docker

Démarrage avec Ruby on Rails

Pour commencer avec Ruby on Rails, vous devrez créer un dossier pour votre nouveau projet et exécuter la commande suivante à l'intérieur :

rails new edgegap-ruby-rails-demo

Une fois le processus d'installation terminé, vous devrez modifier votre fichier routes.rb, que vous trouverez dans le dossier config. Votre fichier de routes devrait contenir ce qui suit :

Rails.application.routes.draw do
  root 'hello_world#index'
end

Vous remarquerez peut-être qu'il n'y a pas de page ‘hello_world’ dans votre projet dans le dossier ‘views’. Vous pouvez facilement la générer avec son contrôleur correspondant. Tout d'abord, assurez-vous d'être dans le dossier que Rails a généré pour vous lorsque vous avez exécuté la commande rails new .

Si vous utilisez une distribution Linux, utilisez la commande suivante pour créer le contrôleur HelloWorld :

rails generate controller HelloWorld index --skip-routes

L'option skip-routes garantit que cette commande ne générera pas une nouvelle route pour ce contrôleur, ce que nous voulons puisque nous en avons déjà créé une manuellement.

Pour Windows, vous devrez ajouter quelques mots-clés à votre commande comme suit :

ruby bin/rails generate controller HelloWorld index –skip-routes

Une fois la commande exécutée avec succès, vous verrez la page HelloWorld dans le dossier ‘views’. Vous devrez peut-être corriger la syntaxe HTML pour obtenir une section correcte avant de la déployer. Le fichier devrait ressembler à ceci :

La seule étape restante pour finaliser votre projet est de déployer votre application Ruby on Rails localement. Encore une fois, la commande pour le faire varie entre Linux et Windows comme suit :

Linux :

rails server

Windows :

ruby bin/rails server

Conteneuriser votre application

La conteneurisation de la plupart des applications est simple. Vous devez créer un Dockerfile puis exécuter ce fichier sur Docker pour créer l'image. Visual Studio Code est une bonne plateforme pour créer votre Dockerfile puisqu'il n'ajoute pas d'extension par défaut à chaque nouveau fichier que nous créons. C'est exactement ce dont nous avons besoin. Créez simplement un nouveau fichier et nommez-le Dockerfile. Vous verrez le petit logo Docker apparaître à côté. Maintenant, vous pouvez copier et coller ce script pour obtenir les principales dépendances. L'image que ce Dockerfile créera fait environ 700 Mo. Bien sûr, vous pouvez l'optimiser, mais un conteneur de cette taille fonctionnera très bien sur Edgegap :

FROM ruby:3-alpine
WORKDIR /app
COPY . .
RUN apk add --no-cache build-base tzdata nodejs yarn sqlite-dev postgresql-dev mysql-dev
RUN gem install bundler
RUN bundle install
ENV RAILS_ENV=production
RUN bundle exec rails assets:precompile
EXPOSE 3000
CMD ["rails", "server", "-b", "0.0.0.0"]

Après avoir enregistré votre Dockerfile, il est temps de créer l'image. Vous pouvez facilement le faire en exécutant la commande suivante :

Pour les utilisateurs de CPU ARM (Mac M1, M2, etc.), ajoutez --platform linux/amd64 en option à votre commande de build.

docker build -t registry.edgegap.com/<YOUR_REPO>/ruby-rails-demo:<YOUR_VERSION_NUMBER> .

Il est préférable d'ajouter un numéro de version suivant le versionnage sémantique, mais si vous ne prévoyez pas de mettre à jour votre build sur Edgegap après votre premier déploiement, vous pouvez omettre complètement le numéro de version. Mais avant cela, vous devez pousser votre image Docker nouvellement créée vers le dépôt d'images de votre choix. N'oubliez pas que nous offrons des dépôts privés via Edgegap Registry qui vous apportent une série d'avantages de sécurité que vous n'auriez pas forcément en utilisant le dépôt Docker par défaut. Pour pousser votre image vers notre dépôt, vous devrez d'abord vous connecter avec vos identifiants en utilisant cette commande :

docker login registry.edgegap.com

Maintenant, la seule chose restante est de pousser votre image comme ceci :

docker push registry.edgegap.com/<YOUR_REPO>/ruby-rails-demo:<YOUR_VERSION_NUMBER>

Super ! Vous n'êtes plus qu'à une étape de déployer votre application Nuxt sur la plateforme d'Edgegap.

Déployez votre application sur Edgegap

Il existe deux manières de déployer une application sur Edgegap. Pour les deux, vous devrez avoir un compte chez nous, que vous pouvez créer gratuitement en cliquant sur le lien ici. Tout d'abord, voyons comment déployer notre application conteneurisée via notre site web.

Déployer une application via le tableau de bord d'Edgegap

Vous devrez vous rendre sur le site de la plateforme Edgegap et entrer vos identifiants. Une fois fait, vous serez automatiquement redirigé vers votre tableau de bord. Si vous venez de créer votre compte, vous verrez une option pour lancer votre première application immédiatement. Sinon, rendez-vous simplement dans l'onglet « Applications & Games » dans le menu à gauche de votre écran. Vous verrez une option pour créer une nouvelle application dans le coin droit :

Une fois que vous aurez cliqué dessus, le formulaire suivant devrait apparaître :

Vous devez remplir tous les champs requis et, une fois que vous avez terminé, il y a quelques éléments que vous devrez modifier par rapport aux valeurs par défaut :

• Numéro de port : Cette application doit avoir le port 3000 ouvert, veuillez donc l'ajouter dans la section « ports » du formulaire de création. Désactivez l'option de vérification du port.

Une fois que vous avez fini de remplir le formulaire avec les informations adéquates, il vous suffit de le soumettre, et vous serez prêt pour le déploiement. Sélectionnez simplement la région et le nombre de joueurs que vous souhaitez émuler.

Une fois que vous avez fini de remplir le formulaire avec les informations adéquates, il vous suffit de le soumettre, et vous serez prêt pour le déploiement. Sélectionnez simplement la région et le nombre de joueurs que vous souhaitez émuler.

Une fois vos choix confirmés, votre application sera en ligne sous peu. Voici ce que vous verrez une fois qu'elle aura été déployée. Vous pouvez y accéder vous-même en cliquant sur l'icône que nous avons entourée sur cette image.

Cela ouvrira un nouvel onglet où vous trouverez la page d'accueil par défaut de votre application Nuxt.

Déployer une application via l'API d'Edgegap

Alors que notre tableau de bord web est la manière la plus conviviale de déployer une application, vous pouvez également le faire via une requête API très simple. Pour cela, vous pouvez utiliser Postman. Il est important de visiter le tableau de bord pour créer un jeton API via les options de votre profil.

Une fois que vous avez le jeton API en main, il ne vous reste plus qu'à formuler une requête de déploiement avec le nom de votre application, sa version, les adresses IP, la région dans laquelle vous souhaitez effectuer votre déploiement et, bien sûr, votre jeton dans les paramètres d'autorisation. Vous pouvez voir à quoi ressemble une requête complète dans notre documentation ici.

Une fois que vous envoyez la requête, vous devriez voir une réponse dans votre ligne de commande ou sur Postman ressemblant à ceci :

C'est tout ce que vous devez faire pour déployer une application via une CLI. Pour confirmer que votre application a été déployée, vous pouvez retourner sur le tableau de bord et voir votre déploiement actif en cliquant sur l'onglet « Active deployments ».