Controlador Ruby de MongoDB

El driver Ruby oficialmente soportado para MongoDB.

El controlador Ruby es compatible con 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 installar mongo

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

gem ‘mongo’

Integridad de la liberación

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

Para verificar el archivo gem del controlador:

  1. Descargue la clave GPG.

  2. Importa la clave en 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. Descargar el archivo de firma separada correspondiente de la misma versión. Busca en la parte inferior de la versión que corresponde al archivo gem, en la lista 'Activos', un archivo .sig con el mismo número de versión que el gem que deseas instalar.

  5. Verifica el gem 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 otros output, como “¡Esta clave no está certificada con una firma de confianza!”, están relacionados con la red de confianza y dependen de cuán personalmente usted confíe en la clave ruby-driver.asc que descargó de nosotros. Para obtener más información, consulte www.gnupg.org/gph/en/manual/x334.html)

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

La firma de gemas de RubyGems presenta problemas, principalmente porque no existe una cadena de confianza establecida relacionada con las claves utilizadas para firmar las gemas. La propia documentación de RubyGems admite que “este método para firmar gems no se usa extendidamente” (ver guides.rubygems.org/security/). Se han producido debates sobre este tema en la Community de RubyGems durante más de una década y, aunque eventualmente se encontrará una solución, hemos decidido usar GPG 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 ya existentes para tratar 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

La documentación de alto nivel y los ejemplos de uso se encuentran aquí.

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 para driver de alto nivel, incluidos los tutoriales y la referencia que estaban en la carpeta de docs, ahora se pueden encontrar en el repositorio docs-ruby, aquí

Soporte

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

Para preguntas, discusiones o asistencia técnica general, por favor visita el Foro de la Community de MongoDB.

Por favor consulta la página de Soporte Técnico en la documentación para otros recursos de soporte.

Bugs & Peticiones de funcionalidades

Para informar de un bug en el driver o solicitar una funcionalidad específica del driver 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. Haz clic en 'Crear problema' y completa todos los campos aplicables del formulario.

Al crear un problema, ten 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:

  • Proporcione la mayor cantidad de información posible sobre el asunto.

  • Proporciona los 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 sensible o registros del servidor.

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

Problemas de seguridad

Si has identificado un posible problema de seguridad en el driver de Ruby (o en cualquier otro producto de MongoDB), por favor repórtalo siguiendo las instrucciones aquí.

Solicitudes de funcionalidades del producto

Para solicitar una funcionalidad que no sea específica del driver de Ruby o que afecte más que solo al driver (por ejemplo, una funcionalidad que requiera soporte del servidor MongoDB), por favor, envía tu 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.

Ejecutando pruebas

Por favor, consulta spec/README.md para obtener instrucciones sobre cómo ejecutar la suite de pruebas del controlador.

Estrenos

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

El controlador Ruby de MongoDB sigue versionado semántico para sus lanzamientos.

Licencia

Copyright © 2009-2020 MongoDB, Inc.

Licenciado bajo la Licencia Apache, Versión 2.0 (la “Licencia”); no puedes usar este archivo salvo en cumplimiento 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.