Operar una instalación de Mirket
Entienda el entorno de ejecución aislado por organización, el límite de configuración, las comprobaciones de estado y lo que se espera en una recuperación.
- Para
- Operador
- Tiempo de lectura
- 11 min
- Actualizado
- 22 de octubre de 2026

Antes de empezar
- Acceso por consola al servidor de la instalación, la versión inmutable descargada y el archivo de entorno de la instalación.
- Acceso a los registros de los servicios, al destino de las copias de seguridad y a un archivo protegido con la frase de paso.
Ha terminado cuando
- docker compose --env-file .env -f compose.yml ps informa de que los servicios esperados están en marcha y los que tienen comprobación de estado están en buen estado.
- Las comprobaciones /health/live y /health/ready de la API y del servicio de sockets responden correctamente.
- La copia de seguridad cifrada más reciente ha superado el simulacro de restauración del repositorio.
- Cada perfil de servicio opcional debe coincidir con su indicador de aplicación; los módulos que solo usan un indicador y la activación por la organización se comprueban por separado.
Si algo sale mal
- No sobrescriba un despliegue ni una copia de seguridad fallidos. Conserve los registros, la huella exacta de la versión, la ruta del entorno y la salida de los comandos.
- Restaure únicamente desde un archivo cifrado verificado y respete la ventana de recuperación y el manual de procedimientos acordados por su organización.
- Cuando falle un servicio opcional, conserve el LMS básico y diagnostique la disponibilidad, las credenciales, el origen y los registros de ese servicio antes de reiniciarlo. Nunca copie tokens de acceso, cabeceras de solicitud, direcciones de correo ni datos de menores en los diagnósticos.
Conozca el límite del despliegue
- Una instalación sirve a una organización.
- Los procesos de la aplicación, PostgreSQL, Redis y los espacios de almacenamiento de objetos están aislados entre organizaciones.
- La configuración del cliente se monta en tiempo de ejecución en lugar de integrarse en los artefactos inmutables de la aplicación.
Responda a un aviso de operación
Valide la configuración antes de cambiar el estado
Ejecute docker compose --env-file .env -f compose.yml config --quiet y revise después docker compose --env-file .env -f compose.yml ps y los puntos de conexión de estado live y ready de la API y del servicio de sockets.
Identifique el servicio afectado y la franja horaria
Reúna la aplicación, el rol, la ruta, la marca de tiempo, el estado de recuperación visible y los registros pertinentes, sin pedir contenido de usuario innecesario.
Use los comandos de copia de seguridad del repositorio
Ejecute pnpm ops:check y cree después la copia cifrada coordinada con pnpm ops:backup, indicando de forma explícita las rutas absolutas de entorno, de salida y del archivo con la frase de paso.
Demuestre que se puede recuperar
Ejecute pnpm ops:restore-drill sobre el archivo generado con las mismas entradas explícitas de frase de paso y de entorno. Para darlo por completo hacen falta sumas de verificación comprobadas y restauraciones desechables de PostgreSQL correctas.
Recupere con acciones reversibles
Prefiera los procedimientos documentados de reinicio, reintento y restauración verificada. Conserve las pruebas y haga una copia de seguridad verificada antes de una actualización o de intervenir en el esquema.
Elegir explícitamente los módulos opcionales
Los módulos basados en servicios necesitan tanto su perfil de Compose como el indicador de aplicación correspondiente. La certificación, la integridad académica y los adaptadores institucionales usan configuración privada sin un perfil de Compose aparte. Ejecute config --quiet antes de iniciar y compruebe que cada módulo esté listo antes de activarlo para una organización.
- El acceso de familias usa el perfil parents con PARENT_MODULE_ENABLED=true. El administrador todavía debe elegir Activar portal de familias; restaurar la disponibilidad del operador nunca reactiva ese ajuste de la organización.
- El chat usa el perfil chat con CHAT_ENABLED=true. Una interrupción de Matrix debe mantener disponibles el inicio de sesión en el LMS y el trabajo ajeno al chat, mientras Chat muestra información de recuperación.
- La edición de documentos usa el perfil documents con ONLYOFFICE_ENABLED=true. Una interrupción debe conservar los archivos protegidos de los cursos y su descarga original, mientras el espacio de trabajo ofrece Reintentar.
- Las conferencias en directo usan el perfil live con LIVEKIT_ENABLED=true. Un fallo de admisión o del servicio debe bloquear el acceso a la conferencia sin debilitar las comprobaciones actuales de cuenta, rol, curso o sesión.
- La certificación usa el ajuste privado CERTIFICATION_MODULE_ENABLED=true sin perfil de Compose. El administrador aún debe elegir Activar certificación; recuperar la disponibilidad para el operador no la reactiva.
- La integridad académica requiere ACADEMIC_INTEGRITY_ENABLED=true, un modo de proveedor explícito y credenciales, seguidos de la activación independiente por el administrador y la aceptación del docente en la tarea. El modo de pruebas sirve para desarrollo y ensayos, no para decisiones sobre clientes.
- Los adaptadores de acceso institucional, listas y archivos en la nube usan configuraciones privadas de proveedor independientes. Desactivar uno debe dejar disponibles el acceso local, la creación manual de cuentas y la carga habitual de archivos del curso.
Continuar con
Gestione personas, cursos, comunicación y visibilidad operativa preservando los límites de organización y de rol.
Orientarse en MirketEntienda las aplicaciones de rol, la navegación, las preferencias y los límites que determinan lo que puede ver.
Seguir las novedades académicas de un hijoUse la aplicación para familias para revisar el trabajo autorizado, las calificaciones publicadas, la asistencia confirmada por el docente y las opciones de notificación de cada hijo vinculado.