Publicación en RubyGems

RubyGems.org es el servicio público donde se publican y descargan las gemas de Ruby. Cuando ejecuta gem install o bundle install, obtiene los paquetes de allí de forma predeterminada.

• Publicar hace que su gema se pueda instalar en todo el mundo.
• Cada nombre de gema es único y se asigna por orden de llegada.
• Una vez publicada una versión, debe considerarse permanente.

Antes de publicar, necesita una cuenta gratuita de RubyGems.org. Después, inicia sesión desde la línea de comandos para que la herramienta gem pueda autenticar sus cargas. Las credenciales se almacenan localmente para futuros envíos.

Antes de publicar, confirme lo siguiente:

• El número de versión se ha incrementado.
• Las pruebas pasan.
• El registro de cambios está actualizado.
• El gemspec enumera todos los archivos y la licencia correcta.

Unos minutos de comprobación evitan una publicación pública defectuosa.

Ejecute gem build mygem.gemspec. Esto lee el gemspec y genera un archivo como mygem-0.1.0.gem que contiene su código y metadatos. Este es el artefacto exacto que se sube.

Instale el archivo compilado en un entorno limpio con gem install ./mygem-0.1.0.gem e intente requerirlo. Así detectará archivos faltantes o errores de carga antes de que todo el mundo pueda verlos.

Publíquelo con gem push mygem-0.1.0.gem. En cuestión de instantes, la versión aparece en RubyGems.org y cualquiera puede instalarla. El comando utiliza sus credenciales guardadas para autorizar la carga.

Las gems generadas por Bundler incluyen una tarea rake release. Esta etiqueta la versión en git, compila la gem y la sube en un solo paso, de modo que la etiqueta de git y la versión publicada siempre coincidan.

Una vez publicada 1.0.0, no puede sobrescribirla con código diferente. Para corregir un problema, debe publicar una versión nueva como 1.0.1. Esto garantiza que una versión determinada siempre esté formada por los mismos bytes para todos los usuarios.

Si una versión está dañada o no es segura, gem yank mygem -v 1.0.1 la elimina de las instalaciones nuevas. Es posible que los lockfiles existentes sigan haciendo referencia a ella, por lo que retirar una versión es el último recurso, no un botón para deshacer.

Proteja su gem frente a posibles apropiaciones:

• Active la autenticación multifactor en RubyGems.org.
• Use claves de API con alcance y permisos limitados.
• Añada copropietarios de confianza con gem owner para que la gem siga disponible si usted deja de mantenerla.

Una vez publicada, comparta las instrucciones de instalación en su README, anuncie la versión y esté atento a los problemas. Responda a los informes de errores con versiones de parche. Una gem con un buen mantenimiento genera confianza y adopción con el tiempo.

Compruebe cuánto ha entendido sobre la publicación.

Ha aprendido el flujo de trabajo de publicación:

• Cree una cuenta e inicie sesión.
• Ejecute una lista de comprobación previa y, después, gem build.
• Pruebe localmente y luego ejecute gem push (o rake release).
• Las versiones son permanentes; publique las correcciones como versiones nuevas o use gem yank.
• Proteja su cuenta con MFA y copropietarios.

Con esto finaliza el curso Building Your Own Ruby Gem.