Configurer un environnement de développement Ruby

Ce tutoriel explique comment préparer votre ordinateur local pour le développement en Ruby, y compris le développement d'applications Ruby exécutées sur Google Cloud. Suivez-le pour installer Ruby et les outils pertinents.

Lisez le Guide de démarrage rapide concernant Ruby et Google Cloud Platform pour obtenir un aperçu du langage Ruby et pour apprendre à exécuter les applications Ruby sur Google Cloud.

Objectifs

  • Installer Ruby
  • Installer Bundler
  • Installer un éditeur (facultatif)
  • Installer le SDK Cloud
  • Installer la bibliothèque cliente Cloud pour Ruby

Installer Ruby

Les instructions d'installation de Ruby varient en fonction du système d'exploitation. Suivez celles correspondant au système d’exploitation utilisé sur votre ordinateur local de développement. Ce tutoriel s’applique aux versions de Ruby stables qui ne sont pas arrivées en fin de vie, répertoriées sur Ruby-lang.

macOS

Nous vous recommandons d'utiliser rbenv pour gérer vos installations Ruby sur macOS. rbenv gère l'installation de plusieurs versions de Ruby sur votre ordinateur. Un plug-in rbenv nommé ruby-build permet à rbenv d'installer une version spécifiée de Ruby.

Bien que macOS inclue une version de Ruby par défaut, il est préférable d'effectuer une autre installation des dernières versions de Ruby pour que votre environnement de développement soit à jour et afin d'éviter les conflits, dans les cas où le système d'exploitation utilise la version de Ruby par défaut.

  1. Installez XCode.
  2. Installez les outils de ligne de commande de XCode en exécutant la commande suivante dans une fenêtre de terminal :

    xcode-select --install
    
  3. Installez homebrew en suivant les instructions de la page d'accueil Homebrew.

  4. Installez rbenv à l'aide de homebrew, en suivant les instructions du fichier readme de rbenv. L'installation de l'outil Homebrew inclut le plug-in ruby-build.

Obtenez plus d'informations sur l'utilisation de rbenv et de ruby-build pour installer différentes versions de Ruby.

Linux

Nous vous recommandons d'utiliser rbenv pour gérer vos installations Ruby sur les distributions Linux. rbenv gère l'installation de plusieurs versions de Ruby sur votre ordinateur. Un plug-in rbenv nommé ruby-build permet à rbenv d'installer une version spécifiée de Ruby.

  1. Installez rbenv sur votre distribution Linux à l'aide du fichier readme de rbenv.

  2. Installez le ruby-build plug-in pour rbenv en suivant les instructions du fichier readme de ruby-build.

Obtenez plus d'informations sur l'utilisation de rbenvrbenv et de ruby-build pour installer différentes versions de Ruby.

Windows

Pour Windows, nous recommandons l'une des solutions suivantes :

Installer Bundler

Bundler est un gem Ruby qui gère les dépendances de gem d'un projet définies dans un fichier nommé Gemfile. Les exemples Ruby de la documentation Google Cloud utilisent des fichiers Gemfile pour spécifier les gems et les versions requis.

  1. Installer Bundler

    gem install bundler
    
  2. Installez les dépendances gem définies dans le fichier Gemfile.

    bundle install
    
  3. Exécutez votre projet Ruby uniquement avec des gems définis dans votre fichier Gemfile.

    bundle exec ruby app.rb
    

Obtenez plus d'informations sur la création d'un fichier Gemfile en consultant la documentation Bundler.

Installer un éditeur

Voici une liste non exhaustive d'éditeurs courants permettant de développer des applications Ruby (sans ordre particulier) :

Ces éditeurs, parfois accompagnés de plug-ins, contiennent de nombreuses fonctionnalités permettant d'optimiser l'efficacité de votre développement Ruby, telles que la coloration syntaxique, IntelliSense, le complètement du code, et les fonctions de débogage entièrement intégrées.

Installer le SDK Cloud

Le SDK Cloud est un ensemble d'outils associé à Google Cloud. Il contient gcloud, gsutil et bq, qui vous permettent d'accéder à Compute Engine, Cloud Storage, BigQuery et à d'autres produits et services à partir de la ligne de commande. Exécutez ces outils de façon interactive ou dans des scripts automatisés.

À titre d'exemple, voici une commande simple qui déploie une application Web Ruby dans l'environnement flexible App Engine. Après le déploiement, App Engine tente de démarrer l'application en exécutant la commande bundle exec ruby app.rb -p 8080 :

gcloud app deploy

Découvrez comment déployer une application Ruby on Rails dans l'environnement flexible App Engine.

Installer la bibliothèque cliente Cloud pour Ruby

La bibliothèque cliente Cloud pour Ruby est le moyen idiomatique dont disposent les développeurs Ruby pour intégrer les services Google Cloud. Vous pouvez installer le package pour une API individuelle, par exemple pour Cloud Storage, en exécutant la commande suivante :

gem install google-cloud-storage

Vous pouvez également utiliser Bundler et ajouter le gem à vos dépendances Gemfile. Par exemple :

bundle add google-cloud-storage

Authentification

Pour utiliser la bibliothèque cliente Cloud pour Ruby, vous devez d'abord vous authentifier. Effectuez les étapes de la page Premiers pas avec l'authentification.

Étape suivante