Ruby on Rails

Installation de Ruby

Edgegap vous propose une plateforme très intuitive pour déployer une application web serverless où vous en avez besoin. Dans 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é sur 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 installé correctement avec la commande suivante :

ruby -v

Maintenant que Ruby est installé, vous devrez bien sûr installer Rails. C'est assez simple et peut être fait avec cette commande unique :

gem install rails

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

rails -v

Prérequis

Pour suivre ce tutoriel, vous devrez disposer de ce qui suit 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

Premiers pas 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 dedans :

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 doit 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. 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 certains 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 terminer votre projet est de déployer votre application Ruby on Rails localement. Encore une fois, la commande pour ce 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 puisque, par défaut, il n'ajoute pas d'extension à 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 dedans 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.), voir la page dédiée.

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

Il est préférable d'utiliser 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 proposons des dépôts privés via Edgegap Registry qui vous offrent une série d'avantages de sécurité que vous n'auriez pas nécessairement 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 qui reste est de pousser votre image comme ceci :

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

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

Déployez votre application sur Edgegap

Il existe deux façons 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. 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 saisir 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, dirigez-vous simplement vers 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 y aurez cliqué, le formulaire suivant devrait apparaître :

Vous devez remplir tous les champs obligatoires 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, donc veuillez l'ajouter dans la section « ports » du formulaire de création. Décochez l'option de vérification du port.

Une fois que vous avez terminé 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 terminé 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 aurez confirmé vos choix, 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

Bien que notre tableau de bord web soit 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 que vous visitiez 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 votre possession, la seule chose à faire est de 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 en tant que paramètre d'autorisation. Vous pouvez voir à quoi ressemble une requête complète dans notre documentation ici.

Une fois que vous aurez envoyé la requête, vous devriez voir une réponse sur votre ligne de commande ou sur Postman qui ressemble à 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 action en cliquant sur l'onglet « Deployments actifs ».