Operar una instalación de Mirket

Entienda el entorno de ejecución aislado por centro, el límite de configuración, las comprobaciones de estado y lo que se espera en una recuperación.

For
Operador
Reading time
11 min
Updated
16 de agosto de 2026
Facility analytics built from durable daily projections rather than ad-hoc queries.
The screen this guide describes, captured from the product. Las capturas de pantalla se muestran en inglés. El producto en sí está disponible en este idioma.

Before you start

  • 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.

You are done when

  • 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 sanos.
  • 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.

If something goes wrong

  • 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 acordada y el manual de procedimientos.

Conozca el límite del despliegue

  • Una instalación sirve a un centro educativo.
  • Los procesos de la aplicación, PostgreSQL, Redis y los espacios de almacenamiento de objetos están aislados entre centros.
  • 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

  1. 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 extremos de estado live y ready de la API y del servicio de sockets.

  2. 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.

  3. 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.

  4. 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.

  5. 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.

Continue with