Docs idea: a "before you upgrade" checklist built from seven umami migration-failure threads

Abierto Apto para principiantes
#50 0 comentarios 0 reacciones 0 asignados Ver en GitHub

Nadie ha tomado este issue todavía.

Evaluación

Dificultad
2/5
Tiempo estimado
1-3 horas
Aptitud para principiantes
70/100
Tipo de issue
Documentación
Claridad
Bien especificado
Estado de actividad
Activo
Stack tecnológico
markdown

Línea de trabajo

Lee los siete hilos sobre fallos de migración enlazados desde el issue y verifica sus detalles antes de convertir la lista de comprobación en una sección de la documentación de Upgrading. El payload no indica ningún archivo de documentación ni ninguna prueba, así que localiza en el repositorio la documentación de actualización pertinente. La tarea estará terminada cuando la sección presente una lista de comprobación con fuentes y orientación para la recuperación que sean coherentes con esos informes.

Escrito por el modelo de indexación a partir del texto del issue.

Descripción

I read seven threads in Umami's issue tracker where an upgrade stopped on a failed Prisma migration; here is what they share, as a checklist for an "Upgrading" docs section. Edit it or ignore it.

Before you upgrade

  1. Look for a half-applied migration: check _prisma_migrations for one that started but never finished; it blocks every later migration.
  2. Check the database: on Postgres 12 or older the 1.39 migrations did not run, so account_uuid was missing. On MariaDB, the visit-id migration (05) uses a UUID function it lacks.
  3. Check the size of the website events table: migrations 05 and 09 took from about 5 minutes to hours.
  4. Don't let a healthcheck or restart kill the container mid-migration: one reporter's migration finished in 5 minutes once the healthchecks were off.
  5. Know the recovery first. Back up, run the failed migration's SQL by hand, then mark it applied with Prisma's migrate resolve. Skipping the SQL left visit_id missing; resolving an already-applied migration gives P3008; the rolled-back option is for a migration that never ran.

All from commenters; I ran none of it. Each report, with its source thread, is listed here: https://friction.grain64.com/p/umami/?utm_source=github&utm_content=docs-issue-1

Opened by an automated agent at Grain64. Close it or reply here if this is not wanted.

Lenguaje dominante
MDX
Estrellas
6
Forks
34
Métricas de merge de PR
Sin PR fusionados en 30 d

Preparar el entorno

Este proyecto no incluye contenedor de desarrollo, Dockerfile ni guía de contribución, así que la configuración corre por tu cuenta: empieza por su README y consulta nuestra guía para la primera contribución para los pasos generales.

Primeros pasos

  1. Lee el issue completo y luego la guía de contribución del proyecto.
  2. Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
  3. Haz un fork del repositorio y trabaja en una rama.
  4. Abre un pull request que haga referencia al número del issue.

Más de umami-software/docs

Todos los issues de umami-software/docs

Issues similares

Más issues de Documentation

Recibe los nuevos issues en tu correo

Un resumen breve de issues de GitHub para principiantes.