Advertencia
Funcionalidad experimental
Esta funcionalidad es experimental. MongoDB no proporciona soporte para Fragmentos. Esta funcionalidad puede ser cambiada o eliminada en cualquier momento sin previo aviso.
No se esperan errores, sin embargo, si encuentras uno, abre un issue en el repositorio de GitHub de este proyecto.
Esta página analiza diferentes registros y cómo configurar tu sistema para utilizarlos.
Tipos de configuración del registro
La funcionalidad de segmentos utiliza el gestor de paquetes npm para instalar segmentos desde un registro preespecificado. Puedes configurar tu mongosh local para usar uno o más registros:
El registro comunitario que está gestionado por MongoDB
Un registro privado que usted mantiene
Registros múltiples utilizados juntos
Uso del registro de MongoDB
Este es un registro comunitario público que mantiene MongoDB.
El registro Community es el registro por defecto. Proporciona varios fragmentos útiles que pueden ayudarte a empezar. Los snippets en el registro de la Community también son buenos ejemplos para usar cuando estés listo para crear tus propios snippets.
Se anima a los usuarios de MongoDB a contribuir en este registro público. Para saber cómo compartir tu código con otros usuarios de MongoDB, consulta Contribuir un paquete de snippets a la Community de MongoDB.
Uso de registros privados de snippets
Puedes compartir código internamente usando un registro privado.
Si tus fragmentos revelan información confidencial o propietaria, puedes almacenarlos en un registro privado y local en lugar del registro público.
Para crear un registro privado, consulte Definir un nuevo registro.
Uso de múltiples registros
Un registro privado también se puede usar en conjunto con el Community Registry y otros registros privados. El uso de varios registros permite beneficiarse de fragmentos mantenidos por MongoDB o terceros, al tiempo que se mantiene el control sobre el código que no se desea compartir externamente.
Para configurar múltiples registros, consulta Connexion a registros.
Cómo configurar un registro
Para usar un registro privado o varios registros:
Cree un archivo de índice de registro.
Actualizar
snippetIndexSourceURLspara que contenga un enlace a tu archivo de índice del registro.Actualizar
snippetRegistryURLpara que apunte a tu host de registro (opcional).
Definir un nuevo Registro
El registro público de npm aloja el registro comunitario de fragmentos de MongoDB. También puedes usar npm para host tu propio registro público o privado.
Crear un repositorio de GitHub.
Enviarás paquetes de fragmentos desde tu repositorio de GitHub a tu registro de npm.
Siga la documentación de GitHub para crear un repositorio.
Crea un registro npm.
Sigue la documentación del registro de npm para crear un registro.
Update snippetIndexSourceURLs.
Para hacer que el nuevo registro esté disponible en tu instalación local de mongosh, actualiza la configuración de snippetIndexSourceURLs.
config.set('snippetIndexSourceURLs', 'https://github.com/YOUR_COMPANY/PATH_TO_YOUR_REPOSITORY/index.bson.br;' + config.get('snippetIndexSourceURLs') )
Conexión a los registros
Se puede usar un registro privado además del registro de la Community MongoDB, o en lugar de este.
snippetIndexSourceURLs ia una lista de URLs. Cada URL define una ruta hacia un archivo de índice que contiene metadatos para los segmentos en ese registro.
Configura un registro adicional agregando una URL a snippetIndexSourceURLs.
config.set('snippetIndexSourceURLs', 'https://github.com/YOUR_COMPANY/PATH_TO_YOUR_REPOSITORY/index.bson.br;' + config.get('snippetIndexSourceURLs') )
Reiniciar mongosh para que la actualización surta efecto.
Importante
Si dos fragmentos con el mismo nombre aparecen en varios registros, las actualizaciones del sistema local se basarán en la entrada del primer registro en la lista snippetIndexSourceURLs.
No reutilices los nombres de fragmentos para evitar posibles conflictos.