Configurar un entorno de desarrollo de Ruby

En este instructivo, se muestra cómo preparar tu máquina local para el desarrollo en Ruby, incluido el desarrollo de apps de Ruby que se ejecutan en Google Cloud. Sigue este instructivo para instalar Ruby y las herramientas relevantes.

Lee la Guía de inicio rápido para Ruby y Google Cloud para obtener una descripción general de Ruby y aprender sobre cómo ejecutar apps de Ruby en Google Cloud.

Objetivos

  • Instalar Ruby.
  • Instalar Bundler.
  • Instalar un editor (opcional).
  • Instalar el SDK de Cloud.
  • Instalar la Biblioteca cliente de Cloud para Ruby.

Instala Ruby

Las instrucciones de instalación de Ruby varían según el sistema operativo. Sigue la guía del sistema operativo que usas en tu máquina de desarrollo local. Este tutorial se aplica a las versiones de Ruby estables y sin fin del período de vigencia (EOL) enumeradas en Ruby-lang.

macOS

Recomendamos usar rbenv para administrar tus instalaciones de Ruby en macOS. rbenv administra varias instalaciones de versiones de Ruby en tu máquina, y un complemento rbenv llamado ruby-build agrega compatibilidad a rbenv para instalar una versión específica de Ruby.

Si bien macOS incluye una versión de Ruby de manera predeterminada, es mejor instalar las versiones más recientes de Ruby de manera independiente para estar actualizado y evitar conflictos con el uso que hace el sistema operativo de su versión predeterminada.

  1. Instala XCode.
  2. Instala las herramientas de línea de comandos de XCode con el siguiente comando en una terminal:

    xcode-select --install
    
  3. Instala homebrew mediante las instrucciones de la página principal de homebrew.

  4. Instala rbenv mediante homebrew. Para ello, sigue las instrucciones en el archivo readme. La instalación de homebrew incluye el complemento ruby-build.

Obtén más información sobre cómo usar rbenv y ruby-build para instalar diferentes versiones de Ruby.

Linux

Te recomendamos usar rbenv para administrar tus instalaciones de Ruby en las distribuciones de Linux. rbenv administra varias instalaciones de versiones de Ruby en tu máquina, y un complemento rbenv llamado ruby-build agrega compatibilidad con rbenv para instalar una versión especificada de Ruby.

  1. Instala rbenv en la distribución de Linux mediante el uso del rbenv readme.

  2. Instala el ruby-build complemento para rbenv siguiendo las instrucciones en ruby-build readme.

Obtén más información sobre cómo usar rbenv y ruby-build para instalar diferentes versiones de Ruby.

Windows

Para Windows, te recomendamos una de las siguientes opciones:

Instala Bundler

Bundler es una gema de Ruby que administra dependencias de gemas de proyectos, definidas en un archivo llamado Gemfile. Las muestras de Ruby en la documentación de Google Cloud usan archivos Gemfile para especificar las gemas y versiones requeridas.

  1. Instala Bundler.

    gem install bundler
    
  2. Instala dependencias gem definidas en el Gemfile.

    bundle install
    
  3. Ejecuta tu proyecto de Ruby solo con gemas definidas en tu Gemfile.

    bundle exec ruby app.rb
    

Para obtener más información sobre cómo crear un Gemfile, consulta la documentación de Bundler.

Instala un editor

Estos son algunos editores populares que se usan para desarrollar apps de Ruby (sin un orden especial):

Estos editores (con la ayuda de complementos, en algunos casos) te proporcionan todas las herramientas, como la sintaxis destacada, IntelliSense, funciones de autocompletar código y funciones de depuración completamente integradas, lo que maximiza la eficacia de tu desarrollo en Ruby.

Instala el SDK de Cloud

El SDK de Cloud es un conjunto de herramientas de Google Cloud. Contiene gcloudgsutilbq, que puedes usar para acceder a Compute Engine, Cloud Storage, BigQuery y otros productos y servicios desde la línea de comandos. Puedes ejecutar estas herramientas de manera interactiva o en tus secuencias de comandos automatizadas.

A modo de ejemplo, aquí hay un comando simple que implementa una aplicación web de Ruby en el entorno flexible de App Engine. Después de la implementación, App Engine intenta iniciar la aplicación con bundle exec ruby app.rb -p 8080.

gcloud app deploy

Obtén información sobre cómo implementar una app de Ruby on Rails en el entorno flexible de App Engine.

Instala la Biblioteca cliente de Cloud para Ruby

La biblioteca cliente de Cloud para Ruby es la forma idiomática que pueden usar los desarrolladores de Ruby a fin de realizar integraciones en los servicios de Google Cloud. Puedes instalar el paquete para una API individual, como Cloud Storage; por ejemplo:

gem install google-cloud-storage

También puedes usar Bundler para agregar la gema a tus dependencias Gemfile, por ejemplo:

bundle add google-cloud-storage

Autenticación

Para usar la Biblioteca cliente de Cloud para Ruby, primero debes autenticarte. Completa los pasos de comenzar con la autenticación.

Qué sigue