Общие рекомендации
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}.
Если вы использовали Docker Compose, выполните следующие шаги:
-
В терминале на хосте, где работает Twenty, отключите Twenty:
docker compose down. -
Обновите версию, изменив значение
TAGв файле .env рядом с вашим docker-compose. ( Мы рекомендуем использовать версииmajor.minor, такие какv0.53. ) -
Верните Twenty в сеть с
docker compose up -d.
Специфические для версии шаги обновления
v1.0
Привет, Twenty v1.0! 🎉v0.60
Улучшение производительности
Все взаимодействия с метаданными API оптимизированы для повышения производительности, особенно для манипуляции метаданными объектов и операций создания рабочих пространств. Мы обновили стратегию кэширования, чтобы приоритетом были попадания кэша перед запросами к базе данных, что значительно улучшило производительность операций с метаданными API. Если после обновления у вас возникнут проблемы с запуском, возможно, потребуется очистить ваш кэш, чтобы синхронизировать его с последними изменениями. Запустите эту команду в вашем контейнере twenty-server:v0.55
Обновите вашу инстанцию Twenty для использования изображения v0.55 Вам больше не нужно запускать никакие команды, новое изображение автоматически выполнит все необходимые миграции.User does not have permission error
Если после обновления вы столкнетесь с ошибками авторизации в большинстве запросов, возможно, потребуется очистить кэш для пересчета последних прав доступа.
В вашем контейнере twenty-server, запустите:
v0.54
Начиная с версии0.53, ручные действия не требуются.
Отказ от схемы метаданных
Мы объединили схемуmetadata в core, чтобы упростить извлечение данных из TypeORM.
Мы объединили этап команды migrate в команду upgrade. Мы не рекомендуем запускать migrate вручную в ваших контейнерах серверов/рабочих.
Начиная с v0.53
Начиная с0.53, обновление программно выполняется внутри DockerFile, это означает, что отныне вам больше не нужно запускать команды вручную.
Убедитесь, что вы обновляете свою инстанцию последовательно, без пропуска основной версии (например, 0.43.3 на 0.44.0 допускается, но 0.43.1 на 0.45.0 нет), иначе это может привести к десинхронизации версии рабочего пространства, что может вызвать ошибку во время выполнения и отсутствовать функциональность.
Чтобы проверить, правильно ли было мигрировано рабочее пространство, вы можете просмотреть его версию в базе данных в таблице core.workspace.
Она всегда должна находиться в диапазоне текущей версии вашего инстанции Twenty major.minor, вы можете просмотреть версию инстанции в админ-панели (на /settings/admin-panel, доступна, если свойство canAccessFullAdminPanel вашего пользователя установлено на true в базе данных) или запустив echo $APP_VERSION в вашем контейнере twenty-server.
Чтобы исправить десинхронизированную версию рабочего пространства, вам потребуется обновить его с соответствующей версии Twenty, следуя последовательному руководству по обновлению и так далее, пока он не достигнет желаемой версии.
Удаление auditLog
Мы удалили стандартный объект auditLog, что означает, что размер вашей резервной копии может значительно уменьшиться после этой миграции.
v0.51 до v0.52
Обновите вашу инстанцию Twenty для использования изображения v0.52У меня рабочее пространство заблокировано на версии между 0.52.0 и 0.52.6.
К сожалению, 0.52.0 и 0.52.6 были полностью удалены из dockerHub.
Вам потребуется вручную обновить версию рабочего пространства до 0.51.0 в базе данных и обновить с использованием версии twenty 0.52.11, следуя её руководству по обновлению.
v0.50 до v0.51
Обновите вашу инстанцию Twenty для использования изображения v0.51v0.44.0 до v0.50.0
Обновите вашу инстанцию Twenty для использования изображения v0.50.0Модификация в docker-compose.yml
Эта версия включает модификациюdocker-compose.yml, чтобы предоставить сервису worker доступ к тому server-local-data.
Обновите ваш локальный docker-compose.yml с v0.50.0 docker-compose.yml
v0.43.0 до v0.44.0
Обновите вашу инстанцию Twenty для использования изображения v0.44.0v0.42.0 до v0.43.0
Обновите вашу инстанцию Twenty для использования изображения v0.43.0(Вариант 1) Миграция базы данных
Сохранение существующего изображения postgres-spilo приемлемо, но вам потребуется зафиксировать версию в вашем docker-compose.yml на 0.43.0.(Вариант 2) Миграция базы данных
Если вы хотите мигрировать вашу базу данных на новое изображение postgres:16, следуйте этим шагам:- Сделайте дамп вашей базы данных из старого контейнера postgres-spilo
- Обновите ваш файл docker-compose.yml с использованием изображения postgres:16, как в файле docker-compose.yml.
- Восстановите базу данных в новый контейнер postgres:16.
v0.41.0 до v0.42.0
Обновите вашу инстанцию Twenty для использования изображения v0.42.0- Удалено:
FRONT_PORT,FRONT_PROTOCOL,FRONT_DOMAIN,PORT - Добавлено:
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 до v0.41.0
Обновите вашу инстанцию Twenty для использования изображения v0.41.0- Удалено:
AUTH_MICROSOFT_TENANT_ID
v0.35.0 до v0.40.0
Обновите вашу инстанцию Twenty для использования изображения v0.40.0- Добавлено:
IS_EMAIL_VERIFICATION_REQUIRED,EMAIL_VERIFICATION_TOKEN_EXPIRES_IN,WORKFLOW_EXEC_THROTTLE_LIMIT,WORKFLOW_EXEC_THROTTLE_TTL
v0.34.0 до v0.35.0
Обновите вашу инстанцию Twenty для использования изображения v0.35.0yarn database:migrate:prod применяет миграции к структуре базы данных (схемы core и metadata)
Команда yarn command:prod upgrade-0.35 заботится о миграции данных всех рабочих пространств.
Переменные окружения
- Мы заменили
ENABLE_DB_MIGRATIONSнаDISABLE_DB_MIGRATIONS(значение по умолчанию теперьfalse, вероятно, вам не потребуется ничего устанавливать)
v0.33.0 до v0.34.0
Обновите вашу инстанцию Twenty для использования изображения v0.34.0yarn database:migrate:prod применяет миграции к структуре базы данных (схемы core и metadata)
Команда yarn command:prod upgrade-0.34 заботится о миграции данных всех рабочих пространств.
Переменные окружения
- Удалено:
FRONT_BASE_URL - Добавлено:
FRONT_DOMAIN,FRONT_PROTOCOL,FRONT_PORT
FRONT_DOMAIN, FRONT_PROTOCOL и FRONT_PORT.
Если FRONT_DOMAIN не установлен, URL frontend будет зависеть от SERVER_URL.
v0.32.0 до v0.33.0
Обновите вашу инстанцию Twenty для использования изображения v0.33.0yarn command:prod cache:flush очистит кэш Redis.
Команда yarn database:migrate:prod применяет миграции к структуре базы данных (схемы core и metadata)
Команда yarn command:prod upgrade-0.33 заботится о миграции данных всех рабочих пространств.
Начиная с этой версии, образ twenty-postgres для DB становится устаревшим, и вместо него используется twenty-postgres-spilo.
Если вы хотите продолжать использовать изображение twenty-postgres, просто замените twentycrm/twenty-postgres:${TAG} на twentycrm/twenty-postgres в файле docker-compose.yml.
v0.31.0 до v0.32.0
Обновите вашу инстанцию Twenty для использования изображения v0.32.0 Миграция схемы и данныхyarn database:migrate:prod применяет миграции к структуре базы данных (схемы core и metadata)
Команда yarn command:prod upgrade-0.32 заботится о миграции данных всех рабочих пространств.
Переменные окружения
Мы обновили способ обработки соединения с Redis.
- Удалено:
REDIS_HOST,REDIS_PORT,REDIS_USERNAME,REDIS_PASSWORD - Добавлено:
REDIS_URL
.env для использования новой переменной REDIS_URL вместо индивидуальных параметров подключения Redis.
Мы также упростили способ обработки JWT токенов.
- Удалено:
ACCESS_TOKEN_SECRET,LOGIN_TOKEN_SECRET,REFRESH_TOKEN_SECRET,FILE_TOKEN_SECRET - Добавлено:
APP_SECRET
.env для использования новой переменной APP_SECRET вместо индивидуальных секрета токенов (вы можете использовать прежний секрет или сгенерировать новую случайную строку).
Подключенный Аккаунт
Если вы используете подключенный аккаунт для синхронизации ваших электронных писем и календарей Google, вам потребуется активировать API людей на вашей консоли администратора Google.
v0.30.0 до v0.31.0
Обновите вашу инстанцию Twenty для использования изображения v0.31.0 Миграция схемы и данных:yarn database:migrate:prod применяет миграции к структуре базы данных (схемы core и metadata)
Команда yarn command:prod upgrade-0.31 заботится о миграции данных всех рабочих пространств.
v0.24.0 до v0.30.0
Обновите вашу инстанцию Twenty для использования изображения v0.30.0 Breaking change: To enhance performances, Twenty now requires redis cache to be configured. Мы обновили docker-compose.yml для этого. Убедитесь, что вы обновили свою конфигурацию и обновили переменные окружения соответственно:yarn database:migrate:prod применяет миграции к структуре базы данных (схемы core и metadata)
Команда yarn command:prod upgrade-0.30 заботится о миграции данных всех рабочих пространств.
v0.23.0 до v0.24.0
Обновите вашу инстанцию Twenty для использования изображения v0.24.0 Выполните следующие команды:yarn database:migrate:prod применяет миграции к структуре базы данных (схемы core и metadata)
Команда yarn command:prod upgrade-0.24 заботится о миграции данных всех рабочих пространств.
v0.22.0 до v0.23.0
Обновите вашу инстанцию Twenty для использования изображения v0.23.0 Выполните следующие команды:yarn database:migrate:prod применяет миграции к Базе данных.
Команда yarn command:prod upgrade-0.23 заботится о миграции данных, включая перенос активностей в задачи/заметки.
v0.21.0 до v0.22.0
Обновите вашу инстанцию Twenty для использования изображения v0.22.0 Выполните следующие команды:yarn database:migrate:prod применяет миграции к Базе данных.
Команда yarn command:prod workspace:sync-metadata -f синхронизирует определение стандартных объектов с таблицами метаданных и применит необходимые миграции к существующим рабочим пространствам.
Команда yarn command:prod upgrade-0.22 выполнит преобразование данных для адаптации к новым параметрам по умолчанию объекта defaultRequestInstrumentationOptions.