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)
  • Installez Google Cloud CLI.
  • Installez les bibliothèques clientes 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 les installations de plusieurs versions de Ruby sur votre ordinateur et un plug-in rbenv nommé ruby-build ajoute la compatibilité avec rbenv pour installer une version de Ruby spécifiée.

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 à l'aide de 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 les installations de plusieurs versions de Ruby sur votre ordinateur et un plug-in rbenv nommé ruby-build ajoute la compatibilité avec rbenv pour installer une version de Ruby spécifiée.

  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 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 gcloud CLI

La CLI gcloud est un ensemble d'outils pour 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. Suivez la procédure de la page Premiers pas avec l'authentification.

Étapes suivantes