Administración/Archivos de Configuración

Configuración de MongoDB

Configurar los ajustes de conexión de la base de datos MongoDB para tu instancia de Gigantics.

Propiedades de Configuración

La sección de configuración de MongoDB en tu archivo config/default.yaml controla cómo se conecta Gigantics a la base de datos:

mongodb:
  host: localhost
  port: 27017
  dbname: gigantics
  username: ''
  password: ''

Detalles de las Propiedades

host

  • Tipo: Cadena
  • Valor por defecto: 'localhost'
  • Descripción: El nombre de host o dirección IP de tu servidor MongoDB. También puede ser un URI completo de MongoDB.

port

  • Tipo: Número
  • Valor por defecto: 27017
  • Descripción: El número de puerto en el que MongoDB está escuchando.

dbname

  • Tipo: Cadena
  • Valor por defecto: 'gigantics'
  • Descripción: El nombre de la base de datos que Gigantics utilizará para almacenar sus datos.

username

  • Tipo: Cadena
  • Valor por defecto: ''
  • Descripción: El nombre de usuario para la autenticación con MongoDB (si es necesario).

password

  • Tipo: Cadena
  • Valor por defecto: ''
  • Descripción: La contraseña para la autenticación con MongoDB (si es necesario).

Ejemplos

Conexión Local de MongoDB

mongodb:
  host: localhost
  port: 27017
  dbname: gigantics
  username: ''
  password: ''

Conexión Remota de MongoDB

mongodb:
  host: mongodb.tuempresa.com
  port: 27017
  dbname: gigantics_prod
  username: 'usuario_gigantics'
  password: 'contraseña_segura'

Conexión a MongoDB Atlas

mongodb:
  host: 'mongodb+srv://usuario:contraseña@cluster0.ejemplo.mongodb.net/gigantics'
  port: 27017
  dbname: gigantics
  username: ''
  password: ''

MongoDB con Autenticación

mongodb:
  host: localhost
  port: 27017
  dbname: gigantics
  username: 'admin'
  password: 'contraseña_admin_segura'

Generación de URI de Conexión

Gigantics genera automáticamente el URI de conexión de MongoDB basado en tu configuración:

  1. Si host comienza con 'mongodb://', utiliza el host como el URI completo
  2. Si tanto username como password están proporcionados, crea un URI con autenticación: mongodb://usuario:contraseña@host:puerto
  3. De lo contrario, crea un URI simple: mongodb://host:puerto

Mejores Prácticas

  1. Seguridad: Siempre usa autenticación en entornos de producción
  2. Respaldos: Asegúrate de que tu instancia de MongoDB tenga procedimientos de respaldo adecuados
  3. Rendimiento: Considera el ajuste de rendimiento de MongoDB para conjuntos de datos grandes
  4. Red: Asegúrate de que el servidor MongoDB sea accesible desde el servidor Gigantics
  5. Versión: Usa MongoDB versión 4.0 o superior como se recomienda

Probar Cambios de Configuración

Después de modificar la configuración de MongoDB, reinicia la aplicación:

./gig stop
./gig start

Verifica los registros en busca de errores de conexión. Una conexión exitosa mostrará mensajes de inicialización de la base de datos.