Guías generales
Always make sure to back up your database before starting the upgrade process by runningdocker exec -it {db_container_name_or_id} pg_dumpall -U {postgres_user} > databases_backup.sql.
To restore backup, run cat databases_backup.sql | docker exec -i {db_container_name_or_id} psql -U {postgres_user}.
Si usó Docker Compose, siga estos pasos:
-
En una terminal, en el host donde Twenty está funcionando, apague Twenty:
docker compose down -
Actualice la versión cambiando el valor de
TAGen el archivo .env cerca de su docker-compose. ( Recomendamos consumir la versiónmajor.minorcomov0.53) -
Vuelva a conectar Twenty con
docker compose up -d
Pasos de actualización específicos por versión
v1.0
¡Hola Twenty v1.0! 🎉v0.60
Mejoras de rendimiento
Todas las interacciones con la API de metadatos han sido optimizadas para un mejor rendimiento, particularmente para la manipulación de metadatos de objetos y operaciones de creación de espacios de trabajo. Hemos reestructurado nuestra estrategia de almacenamiento en caché para priorizar los aciertos de caché sobre las consultas de base de datos cuando sea posible, mejorando significativamente el rendimiento de las operaciones de la API de metadatos. Si encuentra problemas de ejecución después de actualizar, es posible que deba vaciar su caché para asegurar que esté sincronizado con los cambios más recientes. Ejecute este comando en su contenedor del servidor de twenty:v0.55
Actualice su instancia de Twenty para usar la imagen v0.55 Ya no necesita ejecutar ningún comando, la nueva imagen se encargará automáticamente de ejecutar todas las migraciones necesarias.Error: El usuario no tiene permiso
Si encuentra errores de autorización en la mayoría de solicitudes después de actualizar, es posible que deba vaciar su caché para recalcular los permisos más recientes.
En su contenedor twenty-server, ejecute:
v0.54
Desde la versión0.53, no se necesitan acciones manuales.
Desaparición del esquema de metadatos
Hemos fusionado el esquemametadata en el esquema core para simplificar la recuperación de datos desde TypeORM.
Hemos fusionado el paso del comando migrate dentro del comando upgrade. No recomendamos ejecutar migrate manualmente dentro de ninguno de sus contenedores de servidor/trabajador.
Desde v0.53
A partir de0.53, la actualización se realiza de forma programática dentro del DockerFile, esto significa que de ahora en adelante, no debería necesitar ejecutar ningún comando manualmente.
Asegúrese de seguir actualizando su instancia secuencialmente, sin omitir ninguna versión principal (por ejemplo, de 0.43.3 a 0.44.0 está permitido, pero de 0.43.1 a 0.45.0 no lo está), de lo contrario, podría provocar un desincronización de la versión del espacio de trabajo que podría resultar en errores de ejecución y funciones faltantes.
Para verificar si un espacio de trabajo se ha migrado correctamente, puede revisar su versión en la base de datos en la tabla core.workspace.
Siempre debería estar dentro del rango de la versión major.minor actual de su instancia de Twenty; puede ver la versión de su instancia en el panel de administración (en /settings/admin-panel, accesible si su usuario tiene la propiedad canAccessFullAdminPanel establecida en verdadero en la base de datos) o ejecutando echo $APP_VERSION en su contenedor twenty-server.
Para corregir una versión de espacio de trabajo desincronizada, tendrá que actualizar desde la correspondiente versión de twenty siguiendo la guía de actualización relacionada secuencialmente, y así sucesivamente hasta alcanzar la versión deseada.
Eliminación de auditLog
Hemos eliminado el objeto estándar auditLog, lo que significa que el tamaño de su copia de seguridad podría reducirse significativamente después de esta migración.
v0.51 a v0.52
Actualice su instancia de Twenty para usar la imagen v0.52Tengo un espacio de trabajo bloqueado en la versión entre 0.52.0 y 0.52.6
Desafortunadamente, 0.52.0 y 0.52.6 se han eliminado completamente de dockerHub.
Tendrá que actualizar manualmente la versión de su espacio de trabajo a 0.51.0 en la base de datos y actualizar usando la versión twenty 0.52.11 siguiendo su guía de actualización justo arriba.
v0.50 a v0.51
Actualice su instancia de Twenty para usar la imagen v0.51v0.44.0 a v0.50.0
Actualice su instancia de Twenty para usar la imagen v0.50.0Mutación del docker-compose.yml
Esta versión incluye una mutación deldocker-compose.yml para dar acceso al servicio worker al volumen server-local-data.
Actualice su docker-compose.yml local con el docker-compose.yml de v0.50.0
v0.43.0 a v0.44.0
Actualice su instancia de Twenty para usar la imagen v0.44.0v0.42.0 a v0.43.0
Actualice su instancia de Twenty para usar la imagen v0.43.0(Opción 1) Migración de base de datos
Mantener la imagen postgres-spilo existente está bien, pero tendrá que congelar la versión en su docker-compose.yml a 0.43.0.(Opción 2) Migración de base de datos
Si desea migrar su base de datos a la nueva imagen de postgres:16, siga estos pasos:- Descargue su base de datos del contenedor antiguo de postgres-spilo
- Actualice su docker-compose.yml para usar la imagen de postgres:16 como en el archivo docker-compose.yml.
- Restaure la base de datos al nuevo contenedor postgres:16
v0.41.0 a v0.42.0
Actualice su instancia de Twenty para usar la imagen v0.42.0- Removidos:
FRONT_PORT,FRONT_PROTOCOL,FRONT_DOMAIN,PORT - Agregados:
FRONTEND_URL,NODE_PORT,MAX_NUMBER_OF_WORKSPACES_DELETED_PER_EXECUTION,MESSAGING_PROVIDER_MICROSOFT_ENABLED,CALENDAR_PROVIDER_MICROSOFT_ENABLED,IS_MICROSOFT_SYNC_ENABLED
v0.40.0 a v0.41.0
Actualice su instancia de Twenty para usar la imagen v0.41.0- Removido:
AUTH_MICROSOFT_TENANT_ID
v0.35.0 a v0.40.0
Actualice su instancia de Twenty para usar la imagen v0.40.0- Agregados:
IS_EMAIL_VERIFICATION_REQUIRED,EMAIL_VERIFICATION_TOKEN_EXPIRES_IN,WORKFLOW_EXEC_THROTTLE_LIMIT,WORKFLOW_EXEC_THROTTLE_TTL
v0.34.0 a v0.35.0
Actualice su instancia de Twenty para usar la imagen v0.35.0yarn database:migrate:prod aplicará las migraciones a la estructura de la base de datos (esquemas core y metadata)
El yarn command:prod upgrade-0.35 se encarga de la migración de datos de todos los espacios de trabajo.
Variables del entorno
- Reemplazamos
ENABLE_DB_MIGRATIONSporDISABLE_DB_MIGRATIONS(valor predeterminado ahora esfalse, probablemente no tenga que establecer nada)
v0.33.0 a v0.34.0
Actualice su instancia de Twenty para usar la imagen v0.34.0yarn database:migrate:prod aplicará las migraciones a la estructura de la base de datos (esquemas core y metadata)
El yarn command:prod upgrade-0.34 se encarga de la migración de datos de todos los espacios de trabajo.
Variables del entorno
- Removido:
FRONT_BASE_URL - Agregados:
FRONT_DOMAIN,FRONT_PROTOCOL,FRONT_PORT
FRONT_DOMAIN, FRONT_PROTOCOL y FRONT_PORT.
Si FRONT_DOMAIN no está configurado, la URL del frontend volverá a SERVER_URL.
v0.32.0 a v0.33.0
Actualice su instancia de Twenty para usar la imagen v0.33.0yarn command:prod cache:flush eliminará la caché de Redis.
El comando yarn database:migrate:prod aplicará las migraciones a la estructura de la base de datos (esquemas core y metadata)
El yarn command:prod upgrade-0.33 se encarga de la migración de datos de todos los espacios de trabajo.
A partir de esta versión, la imagen twenty-postgres para DB quedó obsoleta y ahora se usa twenty-postgres-spilo.
Si desea seguir usando la imagen twenty-postgres, simplemente reemplace twentycrm/twenty-postgres:${TAG} con twentycrm/twenty-postgres en docker-compose.yml.
v0.31.0 a v0.32.0
Actualice su instancia de Twenty para usar la imagen v0.32.0 Migración de esquemas y datosyarn database:migrate:prod aplicará las migraciones a la estructura de la base de datos (esquemas core y metadata)
El yarn command:prod upgrade-0.32 se encarga de la migración de datos de todos los espacios de trabajo.
Variables del entorno
Hemos actualizado la forma en que manejamos la conexión Redis.
- Removidos:
REDIS_HOST,REDIS_PORT,REDIS_USERNAME,REDIS_PASSWORD - Agregado:
REDIS_URL
.env para usar la nueva variable REDIS_URL en lugar de los parámetros de conexión individuales de Redis.
También hemos simplificado la forma en que manejamos los tokens JWT.
- Removidos:
ACCESS_TOKEN_SECRET,LOGIN_TOKEN_SECRET,REFRESH_TOKEN_SECRET,FILE_TOKEN_SECRET - Agregado:
APP_SECRET
.env para usar la nueva variable APP_SECRET en lugar de los secretos de tokens individuales (puede usar el mismo secreto que antes o generar una nueva cadena aleatoria)
Cuenta conectada
Si está utilizando cuentas conectadas para sincronizar sus correos electrónicos y calendarios de Google, deberá activar la API de People en su consola de administración de Google.
v0.30.0 a v0.31.0
Actualice su instancia de Twenty para usar la imagen v0.31.0 Migración de esquemas y datos:yarn database:migrate:prod aplicará las migraciones a la estructura de la base de datos (esquemas core y metadata)
El yarn command:prod upgrade-0.31 se encarga de la migración de datos de todos los espacios de trabajo.
v0.24.0 a v0.30.0
Actualice su instancia de Twenty para usar la imagen v0.30.0 Breaking change: To enhance performances, Twenty now requires redis cache to be configured. Hemos actualizado nuestro docker-compose.yml para reflejar esto. Asegúrese de actualizar su configuración y sus variables de entorno en consecuencia:yarn database:migrate:prod aplicará las migraciones a la estructura de la base de datos (esquemas core y metadata)
El yarn command:prod upgrade-0.30 se encarga de la migración de datos de todos los espacios de trabajo.
v0.23.0 a v0.24.0
Actualice su instancia de Twenty para usar la imagen v0.24.0 Ejecución de los siguientes comandos:yarn database:migrate:prod aplicará las migraciones a la estructura de la base de datos (esquemas core y metadata)
El yarn command:prod upgrade-0.24 se encarga de la migración de datos de todos los espacios de trabajo.
v0.22.0 a v0.23.0
Actualice su instancia de Twenty para usar la imagen v0.23.0 Ejecución de los siguientes comandos:yarn database:migrate:prod aplicará las migraciones a la base de datos.
El yarn command:prod upgrade-0.23 se encarga de la migración de datos, incluyendo la transferencia de actividades a tareas/notas.
v0.21.0 a v0.22.0
Actualice su instancia de Twenty para usar la imagen v0.22.0 Ejecución de los siguientes comandos:yarn database:migrate:prod aplicará las migraciones a la base de datos.
El comando yarn command:prod workspace:sync-metadata -f sincronizará la definición de objetos estándar a las tablas de metadatos y aplicará las migraciones requeridas a los espacios de trabajo existentes.
El comando yarn command:prod upgrade-0.22 aplicará transformaciones de datos específicas para adaptarse a las nuevas opciones predeterminadas de instrumentación de solicitud de objetos.