En este instructivo, se muestra cómo preparar tu máquina local para el desarrollo de Ruby, incluido el desarrollo de aplicaciones de Java 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).
- Instala Google Cloud CLI.
- Instala las bibliotecas 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 las 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 a rbenv
para instalar un 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.
- Instala XCode.
Instala las herramientas de línea de comandos de XCode con el siguiente comando en una terminal:
xcode-select --install
Instala
homebrew
según las instrucciones que aparecen en la página web de homebrew.Instala
rbenv
mediantehomebrew
. Para ello, sigue las instrucciones indicadas en readenv readme. La instalación de Homebrew incluye el complementoruby-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 las 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 a rbenv
para instalar un versión especificada de Ruby.
Instala
rbenv
en la distribución de Linux mediante el uso delrbenv
readme.Instala el
ruby-build
complemento pararbenv
siguiendo las instrucciones enruby-build
readme.
Obtén más información sobre el uso de 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.
Instala Bundler.
gem install bundler
Instala las dependencias de
gem
definidas en elGemfile
.bundle install
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):
- Sublime Text de Jon Skinner
- Atom de GitHub
- RubyMine de JetBrains
- Vim de Vim the editor
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 la CLI de gcloud
La CLI de gcloud es un conjunto de herramientas para Google Cloud. Contiene gcloud
, gsutil
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 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 y agregar la gema a tus dependencias Gemfile
, como se muestra en el siguiente 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?
- Explora la documentación de los productos de Google Cloud.
- Clona el repositorio de muestras de Ruby en GitHub.
- Explora los instructivos de Ruby que envía la comunidad.
- Obtén información sobre cómo implementar Ruby on Rails en el entorno flexible de Google App Engine.