Configurar un entorno de desarrollo de Ruby

En este instructivo, se muestra cómo preparar tu máquina local para el desarrollo de Ruby, incluido el desarrollo de aplicaciones 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 las distintas maneras 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 tutorial se aplica a las versiones de Ruby estables y sin fin del período de vigencia (EOL) enumeradas 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 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 según las instrucciones que aparecen en la página web de homebrew.

  4. Instala rbenv con homebrew siguiendo las instrucciones del léeme 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 distintas 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 específica 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 dependencias de gemas de proyectos, 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

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 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.

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 para 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 la que los desarrolladores de Ruby se integran con 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.

If you're using a local shell, then create local authentication credentials for your user account: 

gcloud auth application-default login

You don't need to do this if you're using Cloud Shell.

If an authentication error is returned, and you are using an external identity provider (IdP), confirm that you have signed in to the gcloud CLI with your federated identity.

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

¿Qué sigue?