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.
- Installez XCode.
Installez les outils de ligne de commande de XCode en exécutant la commande suivante dans une fenêtre de terminal :
xcode-select --install
Installez
homebrew
en suivant les instructions de la page d’accueil Homebrew.Installez
rbenv
à l'aide dehomebrew
, en suivant les instructions du fichier readme de rbenv. L'installation à l'aide de Homebrew inclut le plug-inruby-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.
Installez
rbenv
sur votre distribution Linux à l'aide du fichier readme derbenv
.Installez le
ruby-build
plug-in pourrbenv
en suivant les instructions du fichier readme deruby-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.
Installer Bundler
gem install bundler
Installez les dépendances
gem
définies dans le fichierGemfile
.bundle install
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) :
- Sublime Text de Jon Skinner
- Atom de GitHub
- RubyMine, par JetBrains
- Vim, par Vim the editor
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
- Parcourez la documentation concernant les produits Google Cloud.
- Clonez le dépôt de fichiers d'exemple Ruby à partir de GitHub.
- Découvrez les tutoriels Ruby soumis par la communauté.
- Découvrez comment déployer Ruby on Rails dans l'environnement flexible Google App Engine.