Gemas son los paquetes de Ruby (librerías) distribuidas a través de RubyGems. Bundler gestiona las dependencias de gemas de un proyecto — instalando las versiones correctas y garantizando entornos consistentes y reproducibles entre máquinas mediante un archivo de bloqueo. Juntos son la forma en que los proyectos de Ruby gestionan dependencias.
gem install rails
gem list
Una gema es una librería de Ruby empaquetada (código + metadatos). RubyGems es el gestor de paquetes y rubygems.org es el registro — el equivalente de Ruby a npm/pip.
# Gemfile — declares your project's gem dependencies
source "https://rubygems.org"
gem "rails", "~> 7.0" # version constraint (~> allows compatible updates)
gem "pg" # PostgreSQL adapter
gem "rspec", group: :test # only in the test environment
bundle install # install all gems from the Gemfile (creates Gemfile.lock)
bundle update # update gems to newer allowed versions
bundle exec rspec # run a command with the project's exact gem versions
El Gemfile declara las dependencias de tu proyecto con restricciones de versión. bundle install las instala y genera el Gemfile.lock.
Gemfile → declares dependencies with constraints (e.g. rails ~> 7.0)
Gemfile.lock → records the EXACT versions of every gem (and sub-dependency) installed
→ COMMIT Gemfile.lock → everyone (team, CI, production) gets the IDENTICAL versions.
Prevents "works on my machine" bugs from version differences.
El Gemfile.lock fija las versiones exactas de todas las gemas (incluyendo dependencias transitivas), por lo que comprometerse a él garantiza que todos los desarrolladores, CI y producción instalen el idéntico árbol de dependencias — entornos reproducibles y consistentes. Siempre comprométete a él.
bundle exec rspec # runs rspec using the EXACT versions in Gemfile.lock
# (vs `rspec` which might use a different globally-installed version)
Las gemas y Bundler son fundamentales para el desarrollo en Ruby — son cómo prácticamente todos los proyectos de Ruby gestionan dependencias, por lo que comprenderlas es esencial. Las gemas (paquetes de Ruby de rubygems.org) proporcionan las librerías y frameworks (Rails, RSpec, etc.) de los que dependen las aplicaciones reales, y Bundler es la herramienta estándar para gestionarlas en un proyecto.
El valor clave que proporciona Bundler — y el concepto más importante de entender — es entornos reproducibles y consistentes: el Gemfile declara dependencias con restricciones de versión, y el Gemfile.lock fija las versiones exactas de todas las gemas (incluyendo dependencias transitivas) que fueron instaladas.
Comprometerse a Gemfile.lock garantiza que todos — todo el equipo, CI y producción — instalen el árbol de dependencias idéntico, previniendo los bugs de "funciona en mi máquina" que surgen de diferencias de versión.
Esta reproducibilidad es crítica para un desarrollo y despliegue confiables y colaborativos.
Comprender las gemas (los paquetes de Ruby), el Gemfile (declarar dependencias), bundle install, el archivo de bloqueo y por qué comprometerse a él (instalaciones reproducibles — el beneficio central), y bundle exec (ejecutar comandos con las versiones exactas del proyecto) es conocimiento importante y cotidiano para cualquier proyecto de Ruby.
Ya que la gestión de dependencias es fundamental para aplicaciones reales, y ya que la reproducibilidad basada en archivos de bloqueo de Bundler es cómo los equipos de Ruby aseguran entornos consistentes entre desarrollo, CI y producción, dominar gemas y Bundler — análogo a npm/package-lock.json en Node — es conocimiento esencial y frecuentemente aplicado para desarrollo profesional de Ruby.