Generalidades
A continuación se describe cómo configurar y utilizar Bundler para tus aplicaciones de RubyGem.
Antecedentes
Si tu aplicación de Ruby no se inicia debido a que falta una gema, debes instalarla localmente usando Bundler.
Bundler proporciona un entorno consistente para proyectos Ruby al rastrear e instalar las gemas y versiones exactas que se requieren en el desarrollo, la preparación, y la producción.
Ruby
Este artículo asume que ya has configurado un sitio Ruby on Rails usando RVM.
SSH
Asegúrate de que también hayas creado un usuario de shell y que puedas iniciar sesión en tu servidor a través de SSH.
Configurar Bundler
- Inicia sesión en tu servidor a través de SSH.
- Instala Bundler:
[server]$ gem install bundler
- Naviega al directorio raíz del proyecto.
- Especifica las dependencias en un Gemfile:
source 'https://rubygems.org' gem 'multi_json' gem 'rack'
gem 'rspec', '~>3.7.0' - Instala todas las gemas necesarias de las fuentes especificadas. Esto agrega Gemfile y Gemfile.lock a tu repositorio, lo que garantiza que otros desarrolladores de tu aplicación, así como tu entorno de implementación, utilicen el mismo código de terceros que estás usando ahora.
[server]$ bundle install
- Dentro de tu aplicación, carga el entorno incluido:
Este paso solo es necesario si no estás ejecutando RVM.
require 'rubygems' require 'bundler/setup' # require your gems as usual require 'multi_json'
- Corre un ejecutable que viene con una gema en tu paquete:
[server]$ bundle exec rspec spec/models
En algunos casos, ejecutar archivos ejecutables sin bundle exec puede funcionar si el ejecutable está instalado en tu sistema y no incluye ninguna gema que entre en conflicto con tu paquete. Sin embargo, esto no es confiable y no se recomienda. Incluso si parece que funciona, puede que no funcione en el futuro o en otra máquina.
- Crea un acceso directo a las gemas en tu paquete:
[server]$ bundle install --binstubs [server]$ bin/rspec spec/models
Los ejecutables instalados en bin están limitados al paquete y siempre funcionarán.
Crear un RubyGem con Bundler
Bundler también es una forma sencilla de crear nuevas gemas. Del mismo modo que puedes crear un proyecto Rails estándar con rails new, puedes crear un proyecto de gema estándar con bundle gem.
Por ejemplo, lo siguiente crea una nueva gema con un archivo README, .gemspec, Rakefile, estructura de directorio y el código básico que necesitas para describir, probar, y publicar una gema:
[server]$ bundle gem my_gem create my_gem/Gemfile create my_gem/.gitignore create my_gem/lib/my_gem.rb create my_gem/lib/my_gem/version.rb create my_gem/my_gem.gemspec create my_gem/Rakefile create my_gem/README.md create my_gem/bin/console create my_gem/bin/setup create my_gem/CODE_OF_CONDUCT.md create my_gem/LICENSE.txt create my_gem/.travis.yml create my_gem/test/test_helper.rb create my_gem/test/my_gem_test.rb Initializing git repo in ./my_gem
Usar Bundler con aplicaciones de Ruby
Revisa los siguientes enlaces para obtener más información.
Ver también
Enlaces de DreamHost
Enlaces de terceros