Obecné pokyny
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}.
Pokud jste použili Docker Compose, postupujte takto:
-
V terminálu, na hostiteli, kde Twenty běží, vypněte Twenty:
docker compose down -
Upgradujte verzi změnou hodnoty
TAGv souboru .env vedle vašeho docker-compose. (Doporučujeme zvážit verzimajor.minor, jako jev0.53) -
Opětovně zapněte Twenty pomocí
docker compose up -d
Kroky upgradu specifické pro danou verzi
v1.0
Ahoj Twenty v1.0! 🎉v0.60
Vylepšení výkonu
Všechny interakce s metadatovým API byly optimalizovány pro lepší výkon, zejména pro manipulaci s metadaty objektů a operace vytváření pracovních prostorů. We’ve refactored our caching strategy to prioritize cache hits over database queries when possible, significantly improving the performance of metadata API operations. Pokud po upgradu narazíte na problémy s výkonem, může být nutné vyprázdnit cache, aby bylo zajištěno její sladění s nejnovějšími změnami. Spusťte tento příkaz v kontejneru twenty-server:v0.55
Upgradujte svou instanci Twenty pro použití v0.55 image Už nemusíte spouštět žádný příkaz, nový obraz se automaticky postará o spuštění všech požadovaných migrací.Chyba Uživatel nemá oprávnění
Pokud po upgradu narazíte na chyby autorizace na většině požadavků, může být nutné vyprázdnit cache, abyste znovu provedli vyhodnocení nejnovějších oprávnění.
Ve svém kontejneru twenty-server spusťte:
v0.54
Od verze0.53, nejsou nutné žádné manuální akce.
Omezení metadatového schématu
Sloučili jsme schémametadata do core, abychom zjednodušili načítání dat z TypeORM.
Sloučili jsme krok příkazu migrate do příkazu upgrade. Nedoporučujeme ručně spouštět migrate v žádném z vašich kontejnerů server/worker.
Od v0.53
Od0.53 je upgrade programově upraven v rámci DockerFile, což znamená, že od této chvíle již nemusíte ručně spouštět žádný příkaz.
Ujistěte se, že upgradujete svou instanci postupně, aniž byste přeskočili hlavní verzi (např. 0.43.3 na 0.44.0 je povoleno, ale 0.43.1 na 0.45.0 nikoli), aby se předešlo asynchronizaci verzí pracovního prostoru, což by mohlo mít za následek chybu při běhu a chybějící funkčnost.
Chcete-li zkontrolovat, zda byl pracovní prostor správně migrován, můžete zkontrolovat jeho verzi v databázi v tabulce core.workspace.
Měla by se vždy nacházet v rozmezí vaší aktuální instance Twenty major.minor verze. Můžete zkontrolovat verzi instance na ovládacím panelu administrátora (na /settings/admin-panel, přístupné, pokud máte v databázi nastaveno uživatelské vlastnosti canAccessFullAdminPanel na true) nebo spuštěním echo $APP_VERSION ve vašem kontejneru twenty-server.
Chcete-li opravit asynchronizaci verzí pracovního prostoru, budete muset upgradovat z odpovídající verze twenty podle souvisejícího průvodce upgradem po jednotlivých krocích, až do dosažení požadované verze.
Odstranění auditLog
Odstranili jsme standardní objekt auditLog, což znamená, že váš záložní soubor může být po této migraci výrazně zmenšen.
v0.51 až v0.52
Upgradujte svou instanci Twenty pro použití v0.52 imageMám pracovní prostor zablokovaný ve verzi mezi 0.52.0 a 0.52.6
Bohužel 0.52.0 a 0.52.6 byly zcela odstraněny z dockerHub.
Budete muset ručně změnit verzi pracovního prostoru na 0.51.0 v databázi a upgradovat pomocí twenty verze 0.52.11 podle jejího výše uvedeného průvodce upgradem.
v0.50 až v0.51
Upgradujte svou instanci Twenty pro použití v0.51 imagev0.44.0 až v0.50.0
Upgradujte svou instanci Twenty pro použití v0.50.0 imageMutace Docker-compose.yml
Tato verze obsahuje mutacidocker-compose.yml, která zajišťuje, že služba worker má přístup k objemu server-local-data.
Aktualizujte svůj místní docker-compose.yml pomocí docker-compose.yml v0.50.0
v0.43.0 až v0.44.0
Upgradujte svou instanci Twenty pro použití v0.44.0 imagev0.42.0 až v0.43.0
Upgradujte svou instanci Twenty pro použití v0.43.0 image(Možnost 1) Migrace databáze
Zachování existujícího obrazu postgres-spilo je v pořádku, ale budete muset zmrazit verzi vdocker-compose.yml na 0.43.0.
(Možnost 2) Migrace databáze
Pokud chcete migrovat svou databázi na nový obraz postgres:16, postupujte podle těchto kroků:- Zálohujte svou databázi z kontejneru postgres-spilo
-
Upgradujte svůj
docker-compose.ymlna použití obrazu postgres:16 podle docker-compose.yml soubor. - Obnovte databázi do nového kontejneru postgres:16
v0.41.0 až v0.42.0
Upgradujte svou instanci Twenty pro použití v0.42.0 image- Odstraněno:
FRONT_PORT,FRONT_PROTOCOL,FRONT_DOMAIN,PORT - Přidáno:
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
Upgradujte svou instanci Twenty pro použití v0.41.0 image- Odstraněno:
AUTH_MICROSOFT_TENANT_ID
v0.35.0 až v0.40.0
Upgradujte svou instanci Twenty pro použití v0.40.0 image- Přidáno:
IS_EMAIL_VERIFICATION_REQUIRED,EMAIL_VERIFICATION_TOKEN_EXPIRES_IN,WORKFLOW_EXEC_THROTTLE_LIMIT,WORKFLOW_EXEC_THROTTLE_TTL
v0.34.0 až v0.35.0
Upgradujte svou instanci Twenty pro použití v0.35.0 imageyarn database:migrate:prod aplikuje změny struktury databáze (core a metadata schémata)
Příkaz yarn command:prod upgrade-0.35 se postará o datovou migraci všech pracovních míst.
Proměnné prostředí
- Nahradili jsme
ENABLE_DB_MIGRATIONSsDISABLE_DB_MIGRATIONS(výchozí hodnota je nynífalse, pravděpodobně nemusíte nastavovat nic)
v0.33.0 až v0.34.0
Upgradujte svou instanci Twenty pro použití v0.34.0 imageyarn database:migrate:prod aplikuje změny struktury databáze (core a metadata schémata)
Příkaz yarn command:prod upgrade-0.34 se postará o datovou migraci všech pracovních míst.
Proměnné prostředí
- Odstraněno:
FRONT_BASE_URL - Přidáno:
FRONT_DOMAIN,FRONT_PROTOCOL,FRONT_PORT
FRONT_DOMAIN, FRONT_PROTOCOL a FRONT_PORT.
Pokud není FRONT_DOMAIN nastavena, frontend URL se vrátí na SERVER_URL.
v0.32.0 až v0.33.0
Upgradujte svou instanci Twenty pro použití v0.33.0 imageyarn command:prod cache:flush vyprázdní cache Redis.
Příkaz yarn database:migrate:prod aplikuje změny struktury databáze (core a metadata schémata)
Příkaz yarn command:prod upgrade-0.33 se postará o datovou migraci všech pracovních míst.
Od této verze se obraz twenty-postgres pro DB stal zastaralým a místo něj se používá twenty-postgres-spilo.
Pokud chcete pokračovat v používání obrazu twenty-postgres, jednoduše nahraďte twentycrm/twenty-postgres:${TAG} za twentycrm/twenty-postgres v docker-compose.yml.
v0.31.0 až v0.32.0
Upgradujte svou instanci Twenty pro použití v0.32.0 image Migrace schématu a datyarn database:migrate:prod aplikuje změny struktury databáze (core a metadata schémata)
Příkaz yarn command:prod upgrade-0.32 se postará o datovou migraci všech pracovních míst.
Proměnné prostředí
Aktualizovali jsme způsob, jakým zpracováváme připojení k Redis.
- Odstraněno:
REDIS_HOST,REDIS_PORT,REDIS_USERNAME,REDIS_PASSWORD - Přidáno:
REDIS_URL
.env soubor tak, aby používal novou proměnnou REDIS_URL místo jednotlivých parametrů připojení k Redis.
Také jsme zjednodušili způsob, jakým zpracováváme tokeny JWT.
- Odstraněno:
ACCESS_TOKEN_SECRET,LOGIN_TOKEN_SECRET,REFRESH_TOKEN_SECRET,FILE_TOKEN_SECRET - Přidáno:
APP_SECRET
.env soubor tak, aby používal novou proměnnou APP_SECRET místo jednotlivých tokenů (můžete použít stejný tajný řetězec jako dříve nebo vygenerovat nový náhodný řetězec)
Propojený účet
Pokud používáte propojený účet k synchronizaci vašich emailů a kalendářů Google, budete muset aktivovat People API na konzoli Google Admin.
v0.30.0 až v0.31.0
Upgradujte svou instanci Twenty pro použití v0.31.0 image Migrace schématu a dat:yarn database:migrate:prod aplikuje změny struktury databáze (core a metadata schémata)
Příkaz yarn command:prod upgrade-0.31 se postará o datovou migraci všech pracovních míst.
v0.24.0 až v0.30.0
Upgradujte svou instanci Twenty pro použití v0.30.0 image Breaking change: To enhance performances, Twenty now requires redis cache to be configured. Aktualizovali jsme náš docker-compose.yml, aby to odrážel. Ujistěte se, že jste aktualizovali svou konfiguraci a své proměnné prostředí odpovídajícím způsobem:yarn database:migrate:prod aplikuje změny struktury databáze (core a metadata schémata)
Příkaz yarn command:prod upgrade-0.30 se postará o datovou migraci všech pracovních míst.
v0.23.0 až v0.24.0
Upgradujte svou instanci Twenty pro použití v0.24.0 image Spusťte následující příkazy:yarn database:migrate:prod aplikuje změny struktury databáze (core a metadata schémata)
Příkaz yarn command:prod upgrade-0.24 se postará o datovou migraci všech pracovních míst.
v0.22.0 až v0.23.0
Upgradujte svou instanci Twenty pro použití v0.23.0 image Spusťte následující příkazy:yarn database:migrate:prod aplikuje změny na databázi.
Příkaz yarn command:prod upgrade-0.23 se postará o datovou migraci, včetně přesunu aktivit na úkoly/poznámky.
v0.21.0 až v0.22.0
Upgradujte svou instanci Twenty pro použití v0.22.0 image Spusťte následující příkazy:yarn database:migrate:prod aplikuje změny na databázi.
Příkaz yarn command:prod workspace:sync-metadata -f synchronizuje definici standardních objektů s tabulkami metadata a aplikuje nezbytné migrace na existující pracovní prostory.
Příkaz yarn command:prod upgrade-0.22 aplikuje specifické datové transformace pro adaptaci na nové objektové defaultRequestInstrumentationOptions.