Shutterstock 5933068913

Cómo compartir nuestra gema en rubygems.org


12063705 10207273024561428 59106377850244238 n
Felipe Barrios

Formas de compartir su código de gema con otros usuarios.

INTRODUCCIÓN

Ahora que ha creado su gema, probablemente esté listo para compartirla. Si bien es perfectamente razonable crear gemas privadas únicamente para organizar el código en grandes proyectos privados, es más común construir gemas para que puedan ser utilizadas por múltiples proyectos. Esta guía analiza las diversas formas en que puede compartir su gema con el mundo.

COMPARTIR CÓDIGO FUENTE

La forma más sencilla (desde la perspectiva del autor) de compartir una gema para el uso de otros desarrolladores es distribuirla en forma de código fuente. Si coloca el código fuente completo de su gema en un repositorio público de git, entonces otros usuarios pueden instalarlo con la funcionalidad git de Bundler .

 

Por ejemplo, puede instalar el último código para la gema wicked_pdf en un proyecto al incluir esta línea en su Gemfile

 
gem "wicked_pdf", :git => "git://github.com/mileszs/wicked_pdf.git

 

Instalar una gema directamente desde un repositorio git es una característica de Bundler, no una característica de RubyGems. Las gemas instaladas de esta manera no se mostrarán cuando ejecutes gem list.

TUS PROPIAS GEMAS

Si desea controlar quién puede instalar una gema, o realizar un seguimiento directo de la actividad que rodea a una gema, entonces querrá configurar un servidor de gemas privado. Puede configurar su propio servidor de gemas o utilizar un servicio comercial como Gemfury .

RubyGems 2.2.0 y posteriores admiten el allowed_push_hostvalor de metadatos para restringir los empujes de gemas a un solo host. Si está publicando gemas privadas, debe establecer este valor para evitar empujes accidentales a rubygems.org:

 

Gem::Specification.new 'my_gem', '1.0' do |s| 
	# ... s.metadata['allowed_push_host'] = 'https://gems.my-company.example'
end

Consulte la guía de Recursos para obtener una lista actualizada de opciones para servidores de gemas privadas.

PUBLICAR EN RUBYGEMS.ORG

La forma más sencilla de distribuir una gema para consumo público es usar RubyGems.org. Las gemas que se publican en RubyGems.org se pueden instalar mediante el gem installcomando o mediante el uso de herramientas como Isolate o Bundler.

Para comenzar, deberá crear una cuenta en RubyGems.org. Visitar la muestra encima de página y proporcionar una dirección de correo electrónico que usted controla, un mango (nombre de usuario) y una contraseña.

 

 

Le damos clic en registrar

Después de crear la cuenta, use su correo electrónico y contraseña cuando empuje la gema. (RubyGems guarda las credenciales en ~ / .gem / credentials para usted, por lo que solo necesita iniciar sesión una vez).

 

 

Para publicar la versión 0.1.0 de una nueva gema llamada 'datatable':

$ gem push datatable-0.1.0.gem
Enter your RubyGems.org credentials.
Don't have an account yet? Create one at https://rubygems.org/sign_up
   Email:   gem_author@example
Password:
Signed in.
Pushing gem to RubyGems.org...
Successfully registered gem: datatable (0.1.0)

¡Felicidades! ¡Tu nueva gema ya está lista para que la instale cualquier usuario de ruby ​​en el mundo!