Controlador Ruby de MongoDB

El driver Ruby oficialmente soportado para MongoDB.

El controlador Ruby admite Ruby 2.7-3.3 y JRuby 9.3-9.4.

Instalación

Instalar a través de RubyGems, ya sea a través de la línea de comandos para usos ad-hoc:

$ gem instalar mongo

O mediante un Gemfile para un uso más general:

gem ‘mongo’

Integridad de la liberación

Cada versión del controlador MongoDB Ruby posterior a la versión 2.20.0 se ha creado y firmado automáticamente utilizando la clave GPG del equipo.

Para verificar el archivo gem del controlador:

  1. Descargar la clave GPG.

  2. Importa la clave a tu llavero GPG con gpg --import ruby-driver.asc.

  3. Descarga el archivo de la gema (si aún no lo tienes). Puedes descargarlo desde RubyGems con gem fetch mongo o desde la página de lanzamientos en GitHub.

  4. Descargue el archivo de firma independiente correspondiente de la misma versión. Busque en la parte inferior de la versión correspondiente al archivo de la gema, en la lista "Recursos", un .sig archivo con el mismo número de versión que la gema que desea instalar.

  5. Verifique la gema con gpg --verify mongo-X.Y.Z.gem.sig mongo-X.Y.Z.gem (reemplazando X.Y.Z con el número de versión real).

Busca texto como "Firma correcta de 'MongoDB Ruby Driver Release Signing Key packaging@mongodb.com' en la salida. Si lo ve, significa que la firma corresponde al archivo de gema indicado.

(Tenga en cuenta que otras salidas, como "¡Esta clave no está certificada con una firma confiable!", están relacionadas con la red de confianza y dependen de cuán firmemente usted, personalmente, confíe en la ruby-driver.asc clave que descargó de nosotros. Para obtener más información, consulte www.gnupg.org/gph/en/manual/x.html)334

¿Por qué no utilizar la funcionalidad de firma de gemas de RubyGems?

El sistema de firma de gemas de RubyGems es problemático, principalmente porque no existe una cadena de confianza establecida relacionada con las claves utilizadas para firmar gemas. La propia documentación de RubyGems admite que «este método de firma de gemas no se usa ampliamente» (véase guides.rubygems.org/security/). Se ha debatido este tema intermitentemente en la comunidad de RubyGems durante más de una década, y aunque con el tiempo se encontrará una solución, hemos optado por usar GPG en su lugar por las siguientes razones:

  1. Muchos de los demás equipos de controladores de MongoDB utilizan GPG para firmar sus lanzamientos de producto. La coherencia con los demás equipos nos permite reutilizar las herramientas existentes para nuestros propios lanzamientos de producto.

  2. GPG está ampliamente disponible y cuenta con herramientas y procedimientos existentes para lidiar con la red de confianza (aunque, lamentablemente, son bastante arcanos e intimidantes para los no iniciados).

En última instancia, la mayoría de los usuarios no se molestan en verificar las gemas y no se verán afectados por nuestra elección de GPG en lugar del método nativo de RubyGems.

Documentación

Aquí se encuentra documentación de alto nivel y ejemplos de uso.

La documentación de la API para la versión más reciente se encuentra aquí. Para compilar la documentación de la API para la rama maestra, consulte el repositorio local y rake docs ejecute.

La documentación del controlador de alto nivel, incluidos los tutoriales y la referencia que estaban en la carpeta docs, ahora se puede encontrar en el repositorio docs-ruby, aquí

Soporte

El soporte comercial para el controlador está disponible a través del Portal de soporte de MongoDB.

Para preguntas, debates o soporte técnico general, visite el Foro de la comunidad MongoDB.

Consulte la página de Soporte técnico en la documentación para obtener otros recursos de soporte.

Errores y solicitudes de funciones

Para informar un error en el controlador o solicitar una función específica del controlador Ruby:

  1. Visite nuestro rastreador de problemas e inicie sesión (o cree una cuenta si aún no tiene una).

  2. Navegue hasta el proyecto RUBY.

  3. Haga clic en “Crear problema” y complete todos los campos del formulario correspondientes.

Al crear un problema, tenga en cuenta que toda la información en JIRA para el proyecto RUBY, así como el servidor principal (el proyecto SERVER), es visible públicamente.

POR FAVOR HAGA:

  • Proporcionar tanta información como sea posible sobre el tema.

  • Proporcione pasos detallados para reproducir el problema.

  • Proporcione fragmentos de código, seguimientos de pila y datos de registro aplicables. No incluya datos confidenciales ni registros del servidor.

  • Especifique los números de versión del controlador y del servidor MongoDB.

POR FAVOR NO:

  • Proporcione cualquier dato confidencial o registro del servidor.

  • Informar públicamente sobre posibles problemas de seguridad (ver “Problemas de seguridad” a continuación).

Problemas de seguridad

Si ha identificado un posible problema relacionado con la seguridad en el controlador Ruby (o cualquier otro producto MongoDB), infórmelo siguiendo las instrucciones aquí.

Solicitudes de funciones del producto

Para solicitar una característica que no sea específica del controlador Ruby, o que afecte a más que el controlador solo (por ejemplo, una característica que requiera soporte del servidor MongoDB), envíe su idea a través del Foro de comentarios de MongoDB.

Política de mantenimiento y corrección de errores

Las nuevas funciones de los controladores se suelen añadir de forma retrocompatible, lo que da lugar a nuevas versiones menores de los controladores (2.x). Las correcciones de errores se suelen realizar primero en la versión maestra y se retroportan a la versión menor actual del controlador. Se pueden hacer excepciones según el caso; por ejemplo, las correcciones de seguridad se pueden retroportar a ramas estables anteriores. Solo se admite oficialmente la versión menor más reciente del controlador. Los clientes deben usar la versión más reciente del controlador en sus aplicaciones.

Ejecución de pruebas

Consulte spec/README.md para obtener instrucciones sobre cómo ejecutar el conjunto de pruebas del controlador.

Estrenos

Las notas de la versión completa y el historial de versiones están disponibles en la página de versiones de GitHub.

El controlador Ruby de MongoDB sigue un control de versiones semántico para sus versiones.

Licencia

Derechos de autor © 2009-2020 MongoDB, Inc.

Con licencia Apache, versión 2.0 (la «Licencia»); no puede usar este archivo excepto de conformidad con la Licencia. Puede obtener una copia de la Licencia en

www.apache.org/licenses/LICENCIA-2.0

Salvo que lo exija la legislación aplicable o se acuerde por escrito, el software distribuido bajo la Licencia se distribuye "TAL CUAL", SIN GARANTÍAS NI CONDICIONES DE NINGÚN TIPO, ni expresas ni implícitas. Consulte la Licencia para conocer el texto específico que rige los permisos y limitaciones de la misma.