Configurar un entorno de desarrollo de Ruby

En este instructivo, se muestra cómo preparar tu máquina local para el desarrollo en Ruby, lo que incluye el desarrollo de apps en 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 conocer las formas de ejecutar apps de Ruby en Google Cloud.

Objetivos

  • Instalar Ruby.
  • Instalar Bundler.
  • Instalar un editor (opcional).
  • Instala Google Cloud CLI.
  • Instala las bibliotecas cliente de Cloud para Ruby.
  • Configura la autenticación.

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 instructivo se aplica a las versiones de Ruby estables y que no están al final de su ciclo de vida (EOL) que se indican en Ruby-lang.

macOS

Te recomendamos que uses rbenv para administrar tus instalaciones de Ruby en macOS. rbenv administra varias instalaciones de versiones de Ruby en tu máquina, y un complemento de rbenv llamado ruby-build agrega compatibilidad con rbenv para instalar una versión especificada 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 según las instrucciones que aparecen en la página web de homebrew.

  4. Instala rbenv con homebrew siguiendo las instrucciones de la README de rbenv. La instalación de Homebrew incluye el complemento ruby-build.

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

Linux

Te recomendamos que uses rbenv para administrar tus instalaciones de Ruby en distribuciones de Linux. rbenv administra varias instalaciones de versiones de Ruby en tu máquina, y un complemento de 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 para 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 las dependencias de gemas del proyecto definidas en un archivo llamado Gemfile. Las muestras de Ruby en la documentación de Google Cloudusan archivos Gemfile para especificar las gemas y versiones requeridas.

  1. Instala Bundler.

    gem install bundler

  2. Instala las dependencias de gem definidas en el Gemfile.

    bundle install

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

    bundle exec ruby app.rb

Obtén más información para crear un Gemfile en 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 gcloud CLI

La CLI de gcloud es un conjunto de herramientas para Google Cloud. Contiene gcloud y bq, 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.

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

gcloud app deploy

Aprende a 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 en que los desarrolladores de Ruby se integran 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 y agregar la gema a tus dependencias Gemfile, como se muestra en el siguiente ejemplo:

bundle add google-cloud-storage

Configura la autenticación

Para usar las bibliotecas cliente de Cloud en un entorno de desarrollo local, configura las credenciales predeterminadas de la aplicación.

Si usas una shell local, crea credenciales de autenticación locales para tu cuenta de usuario: 

gcloud auth application-default login

No es necesario que lo hagas si usas Cloud Shell.

Si se muestra un error de autenticación y usas un proveedor de identidad (IdP) externo, confirma que accediste a la gcloud CLI con tu identidad federada.

Si deseas obtener más información, consulta Autentícate para usar las bibliotecas cliente.

¿Qué sigue?