Docs idea: a "before you upgrade" checklist built from seven umami migration-failure threads
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
- Área
- documentation
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
- Look for a half-applied migration: check _prisma_migrations for one that started but never finished; it blocks every later migration.
- 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.
- Check the size of the website events table: migrations 05 and 09 took from about 5 minutes to hours.
- 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.
- 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
- Lee el issue completo y luego la guía de contribución del proyecto.
- Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
- Haz un fork del repositorio y trabaja en una rama.
- Abre un pull request que haga referencia al número del issue.
Más de umami-software/docs
-
Dificultad 1/5 Menos de una hora Aptitud para principiantes 84/100
umami-software/docs#47 · 1 comentario ·
-
Dificultad 2/5 1-3 horas Aptitud para principiantes 68/100
umami-software/docs#33 · 2 comentarios ·
-
Dificultad 2/5 1-3 horas Aptitud para principiantes 88/100
umami-software/docs#31 ·
-
Tip for cloudflare configurationAbierto
Dificultad 1/5 Menos de una hora Aptitud para principiantes 82/100
umami-software/docs#15 ·
-
Dificultad 3/5 1-2 días Aptitud para principiantes 35/100
umami-software/docs#21 ·
Todos los issues de umami-software/docs
Issues similares
-
Dificultad 1/5 Menos de una hora Aptitud para principiantes 75/100
Los mantenedores suelen responder en 5 días
-
documentation
Dificultad 1/5 Menos de una hora Aptitud para principiantes 82/100
PaloAltoNetworks/pan.dev#1604 ·
Los mantenedores suelen responder en 4 días
-
Dificultad 1/5 Menos de una hora Aptitud para principiantes 65/100
Southampton-RSG-Training/ai-fundamentals-for-researchers#28 ·
-
content 📄 needs triage 🤔
Dificultad 1/5 Menos de una hora Aptitud para principiantes 82/100
Qiskit/documentation#6033 ·
Los mantenedores suelen responder en 1 día
-
Dificultad 2/5 1-3 horas Aptitud para principiantes 68/100
openwatersio/slackwater#550 ·
Los mantenedores suelen responder en 1 día