Configurer un environnement de développement Ruby

Ce tutoriel explique comment préparer votre machine locale pour le développement Ruby, y compris pour le développement d'applications Ruby qui s'exécutent sur Google Cloud. Suivez-le pour installer Ruby et les outils pertinents.

Consultez le guide de démarrage rapide pour Ruby et Google Cloud pour obtenir une présentation de Ruby et découvrir comment exécuter des 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.
  • Configurez l'authentification.

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 plusieurs installations de versions de Ruby sur votre machine, et un plug-in rbenv nommé ruby-build ajoute la compatibilité avec rbenv pour installer une version spécifique 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 Xcode en utilisant la commande suivante dans un 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.

Découvrez comment utiliser rbenv et 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 plusieurs installations de versions de Ruby sur votre machine, et un plug-in rbenv nommé ruby-build ajoute la compatibilité avec rbenv pour installer une version spécifique 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.

Découvrez comment utiliser rbenv et 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 du projet définies dans un fichier nommé Gemfile. Les exemples Ruby de la documentation de Google Cloudutilisent des fichiers Gemfile pour spécifier les gems et les versions requises.

  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 gcloud CLI est un ensemble d'outils pour Google Cloud. Il contient gcloud et bq, que vous pouvez utiliser pour accéder à Compute Engine, Cloud Storage, BigQuery et à d'autres produits et services depuis la ligne de commande. Vous pouvez exécuter ces outils de façon interactive ou dans des scripts automatisés.

Voici un exemple de 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 avec 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 la méthode idiomatique permettant aux développeurs Ruby d'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

Configurer l'authentification

Pour utiliser les bibliothèques clientes Cloud dans un environnement de développement local, configurez les Identifiants par défaut de l'application.

Si vous utilisez un shell local, créez des identifiants d'authentification locaux pour votre compte utilisateur : 

gcloud auth application-default login

Vous n'avez pas besoin de le faire si vous utilisez Cloud Shell.

Si une erreur d'authentification est renvoyée et que vous utilisez un fournisseur d'identité (IdP) externe, vérifiez que vous vous êtes connecté à la gcloud CLI avec votre identité fédérée.

Pour en savoir plus, consultez la section S'authentifier à l'aide des bibliothèques clientes.

Étapes suivantes