8cadd00d34
Created by Github action --------- Co-authored-by: Crowdin Bot <support+bot@crowdin.com> Co-authored-by: github-actions <github-actions@twenty.com>
391 lines
14 KiB
Plaintext
391 lines
14 KiB
Plaintext
---
|
|
title: Uppgraderingsguide
|
|
image: /images/user-guide/notes/notes_header.png
|
|
---
|
|
|
|
<Frame>
|
|
<img src="/images/user-guide/notes/notes_header.png" alt="Header" />
|
|
</Frame>
|
|
|
|
## Allmänna riktlinjer
|
|
|
|
**Always make sure to back up your database before starting the upgrade process** by running `docker 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}`.
|
|
|
|
Om du använde Docker Compose, följ dessa steg:
|
|
|
|
1. I en terminal, på värden där Twenty körs, stäng av Twenty: `docker compose down`
|
|
|
|
2. Uppgradera versionen genom att ändra `TAG`-värdet i .env-filen nära din docker-compose. (Vi rekommenderar att använda `major.minor` version som `v0.53`)
|
|
|
|
3. Sätt igång Twenty igen med `docker compose up -d`
|
|
|
|
Om du vill uppgradera din instans med några versioner, t.ex. från v0.33.0 till v0.35.0, måste du uppgradera din instans sekventiellt, i det här exemplet från v0.33.0 till v0.34.0, sedan från v0.34.0 till v0.35.0.
|
|
|
|
**Se till att efter varje uppgraderad version har du en icke-korrupt säkerhetskopia.**
|
|
|
|
## Versionsspecifika uppgraderingssteg
|
|
|
|
## v1.0
|
|
|
|
Hej Twenty v1.0! 🎉
|
|
|
|
## v0.60
|
|
|
|
### Prestandaförbättringar
|
|
|
|
Alla interaktioner med metadata-API:t har optimerats för bättre prestanda, särskilt för manipulering av objektmetadata och skapande av arbetsytor.
|
|
|
|
Vi har omstrukturerat vår cachestrategi för att prioritera cacheträffar över databasfrågor när det är möjligt, vilket avsevärt förbättrar prestanda för metadata-API-operationer.
|
|
|
|
Om du stöter på några problem vid körning efter uppgradering kan du behöva rensa cachen för att säkerställa att den är synkroniserad med de senaste ändringarna. Kör detta kommando i din twenty-server-container:
|
|
|
|
```bash
|
|
yarn command:prod cache:flush
|
|
```
|
|
|
|
### v0.55
|
|
|
|
Uppgradera din Twenty-instans till att använda v0.55-bilden
|
|
|
|
Du behöver inte längre köra något kommando, den nya bilden tar automatiskt hand om att köra alla nödvändiga migrationer.
|
|
|
|
### `Användaren har inte behörighet` fel
|
|
|
|
Om du stöter på auktoriseringsfel på de flesta förfrågningar efter uppgradering kan du behöva rensa din cache för att räkna om de senaste behörigheterna.
|
|
|
|
I din `twenty-server`-container, kör:
|
|
|
|
```bash
|
|
yarn command:prod cache:flush
|
|
```
|
|
|
|
Detta problem är specifikt för denna Twenty-version och bör inte behövas för framtida uppgraderingar.
|
|
|
|
### v0.54
|
|
|
|
Sedan version `0.53`, inga manuella åtgärder behövs.
|
|
|
|
#### Metadata-schema avveckling
|
|
|
|
Vi har sammanfogat `metadata`-schema till `core` för att förenkla datatillgång från `TypeORM`.
|
|
Vi har sammanfogat `migrate` kommandosteget inom `upgrade` kommandot. Vi rekommenderar inte att köra `migrate` manuellt inom någon av dina server-/arbetsbehållare.
|
|
|
|
### Sedan v0.53
|
|
|
|
Från och med `0.53`, uppgraderingen görs programmeringsmässigt inom `DockerFile`, vilket innebär att du från och med nu inte bör behöva köra något kommando manuellt längre.
|
|
|
|
Se till att fortsätta uppgradera din instans sekventiellt, utan att hoppa över någon större version (t.ex. `0.43.3` till `0.44.0` är tillåtet, men `0.43.1` till `0.45.0` är inte), annars kan det leda till desynkronisering av arbetsytaversionen som kan resultera i körfel och saknad funktionalitet.
|
|
|
|
För att kontrollera om en arbetsyta har migrerats korrekt kan du granska dess version i databasen i tabellen `core.workspace`.
|
|
|
|
Det bör alltid ligga inom intervallet för din nuvarande Twenty-instans `major.minor` version, du kan se din instansversion i administratörspanelen (på `/settings/admin-panel`, åtkomligt om din användare har `canAccessFullAdminPanel` egenskap satt till true i databasen) eller genom att köra `echo $APP_VERSION` i din `twenty-server`-container.
|
|
|
|
För att åtgärda en osynkroniserad arbetsytaversion måste du uppgradera från motsvarande Twentys version genom att följa den relaterade uppgraderingsguiden sekventiellt och så vidare tills önskad version uppnås.
|
|
|
|
#### `auditLog` borttagning
|
|
|
|
Vi har tagit bort standardobjektet auditLog, vilket innebär att din säkerhetskopiors storlek kan minska avsevärt efter denna migration.
|
|
|
|
### v0.51 till v0.52
|
|
|
|
Uppgradera din Twenty-instans till att använda v0.52-bilden
|
|
|
|
```
|
|
yarn database:migrate:prod
|
|
yarn command:prod upgrade
|
|
```
|
|
|
|
#### Jag har en arbetsyta blockerad i version mellan `0.52.0` och `0.52.6`
|
|
|
|
Tyvärr har `0.52.0` och `0.52.6` helt tagits bort från dockerHub.
|
|
Du måste manuellt uppdatera din arbetsytaversion till `0.51.0` i databasen och uppgradera med twenty version `0.52.11` genom att följa den just ovanstående uppgraderingsguiden.
|
|
|
|
### v0.50 till v0.51
|
|
|
|
Uppgradera din Twenty-instans till att använda v0.51-bilden
|
|
|
|
```
|
|
yarn database:migrate:prod
|
|
yarn command:prod upgrade
|
|
```
|
|
|
|
### v0.44.0 till v0.50.0
|
|
|
|
Uppgradera din Twenty-instans till att använda v0.50.0-bilden
|
|
|
|
```
|
|
yarn database:migrate:prod
|
|
yarn command:prod upgrade
|
|
```
|
|
|
|
#### Docker-compose.yml mutation
|
|
|
|
Denna version inkluderar en `docker-compose.yml`-mutation för att ge tjänstenen `worker` åtkomst till volymen `server-local-data`.
|
|
Vänligen uppdatera din lokala `docker-compose.yml` med [v0.50.0 docker-compose.yml](https://github.com/twentyhq/twenty/blob/v0.50.0/packages/twenty-docker/docker-compose.yml)
|
|
|
|
### v0.43.0 till v0.44.0
|
|
|
|
Uppgradera din Twenty-instans till att använda v0.44.0-bilden
|
|
|
|
```
|
|
yarn database:migrate:prod
|
|
yarn command:prod upgrade
|
|
```
|
|
|
|
### v0.42.0 till v0.43.0
|
|
|
|
Uppgradera din Twenty-instans till att använda v0.43.0-bilden
|
|
|
|
```
|
|
yarn database:migrate:prod
|
|
yarn command:prod upgrade
|
|
```
|
|
|
|
I den här versionen har vi också bytt till en postgres:16-bild i docker-compose.yml.
|
|
|
|
#### (Alternativ 1) Datamigrering
|
|
|
|
Att behålla den befintliga postgres-spilo-bilden är okej, men du måste frysa versionen i din docker-compose.yml till 0.43.0.
|
|
|
|
#### (Alternativ 2) Datamigrering
|
|
|
|
Om du vill migrera din databas till den nya postgres:16-bilden, följ dessa steg:
|
|
|
|
1. Dumpa din databas från den gamla postgres-spilo-behållaren
|
|
|
|
```
|
|
docker exec -it twenty-db-1 sh
|
|
pg_dump -U {YOUR_POSTGRES_USER} -d {YOUR_POSTGRES_DB} > databases_backup.sql
|
|
exit
|
|
docker cp twenty-db-1:/home/postgres/databases_backup.sql .
|
|
```
|
|
|
|
Se till att dumpfilen inte är tom.
|
|
|
|
2. Uppgradera din docker-compose.yml för att använda postgres:16 bilden som i [docker-compose.yml](https://raw.githubusercontent.com/twentyhq/twenty/main/packages/twenty-docker/docker-compose.yml) filen.
|
|
|
|
3. Återställ databasen till den nya postgres:16-behållaren
|
|
|
|
```
|
|
docker cp databases_backup.sql twenty-db-1:/databases_backup.sql
|
|
docker exec -it twenty-db-1 sh
|
|
psql -U {YOUR_POSTGRES_USER} -d {YOUR_POSTGRES_DB} -f databases_backup.sql
|
|
exit
|
|
```
|
|
|
|
### v0.41.0 till v0.42.0
|
|
|
|
Uppgradera din Twenty-instans till att använda v0.42.0-bilden
|
|
|
|
```
|
|
yarn database:migrate:prod
|
|
yarn command:prod upgrade-0.42
|
|
```
|
|
|
|
**Miljövariabler**
|
|
|
|
- Borttaget: `FRONT_PORT`, `FRONT_PROTOCOL`, `FRONT_DOMAIN`, `PORT`
|
|
- Tillagt: `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 till v0.41.0
|
|
|
|
Uppgradera din Twenty-instans till att använda v0.41.0-bilden
|
|
|
|
```
|
|
yarn database:migrate:prod
|
|
yarn command:prod upgrade-0.41
|
|
```
|
|
|
|
**Miljövariabler**
|
|
|
|
- Borttaget: `AUTH_MICROSOFT_TENANT_ID`
|
|
|
|
### v0.35.0 till v0.40.0
|
|
|
|
Uppgradera din Twenty-instans till att använda v0.40.0-bilden
|
|
|
|
```
|
|
yarn database:migrate:prod
|
|
yarn command:prod upgrade-0.40
|
|
```
|
|
|
|
**Miljövariabler**
|
|
|
|
- Tillagt: `IS_EMAIL_VERIFICATION_REQUIRED`, `EMAIL_VERIFICATION_TOKEN_EXPIRES_IN`, `WORKFLOW_EXEC_THROTTLE_LIMIT`, `WORKFLOW_EXEC_THROTTLE_TTL`
|
|
|
|
### v0.34.0 till v0.35.0
|
|
|
|
Uppgradera din Twenty-instans till att använda v0.35.0-bilden
|
|
|
|
```
|
|
yarn database:migrate:prod
|
|
yarn command:prod upgrade-0.35
|
|
```
|
|
|
|
Kommandot `yarn database:migrate:prod` kommer att tillämpa migrationerna på databasstrukturen (kärn- och metadatascheman)
|
|
Kommandot `yarn command:prod upgrade-0.35` tar hand om datamigreringen av alla arbetsytor.
|
|
|
|
**Miljövariabler**
|
|
|
|
- Vi ersatte `ENABLE_DB_MIGRATIONS` med `DISABLE_DB_MIGRATIONS` (standardvärdet är nu `false`, du behöver förmodligen inte ställa in något)
|
|
|
|
### v0.33.0 till v0.34.0
|
|
|
|
Uppgradera din Twenty-instans till att använda v0.34.0-bilden
|
|
|
|
```
|
|
yarn database:migrate:prod
|
|
yarn command:prod upgrade-0.34
|
|
```
|
|
|
|
Kommandot `yarn database:migrate:prod` kommer att tillämpa migrationerna på databasstrukturen (kärn- och metadatascheman)
|
|
Kommandot `yarn command:prod upgrade-0.34` tar hand om datamigreringen av alla arbetsytor.
|
|
|
|
**Miljövariabler**
|
|
|
|
- Borttaget: `FRONT_BASE_URL`
|
|
- Tillagt: `FRONT_DOMAIN`, `FRONT_PROTOCOL`, `FRONT_PORT`
|
|
|
|
Vi har uppdaterat sättet vi hanterar frontend-adressen.
|
|
Du kan nu ställa in frontend-adressen med hjälp av variablerna `FRONT_DOMAIN`, `FRONT_PROTOCOL` och `FRONT_PORT`.
|
|
Om FRONT_DOMAIN inte är inställt kommer frontend-adressen att falla tillbaka till `SERVER_URL`.
|
|
|
|
### v0.32.0 till v0.33.0
|
|
|
|
Uppgradera din Twenty-instans till att använda v0.33.0-bilden
|
|
|
|
```
|
|
yarn command:prod cache:flush
|
|
yarn database:migrate:prod
|
|
yarn command:prod upgrade-0.33
|
|
```
|
|
|
|
Kommandot `yarn command:prod cache:flush` kommer att rensa Redis-cachen.
|
|
Kommandot `yarn database:migrate:prod` kommer att tillämpa migrationerna på databasstrukturen (kärn- och metadatascheman)
|
|
Kommandot `yarn command:prod upgrade-0.33` tar hand om datamigreringen av alla arbetsytor.
|
|
|
|
Starting from this version, twenty-postgres image for DB became deprecated and twenty-postgres-spilo is used instead.
|
|
If you want to keep using twenty-postgres image, simply replace `twentycrm/twenty-postgres:${TAG}` with `twentycrm/twenty-postgres` in docker-compose.yml.
|
|
|
|
### v0.31.0 till v0.32.0
|
|
|
|
Uppgradera din Twenty-instans till att använda v0.32.0-bilden
|
|
|
|
**Schema och datamigrering**
|
|
|
|
```
|
|
yarn database:migrate:prod
|
|
yarn command:prod upgrade-0.32
|
|
```
|
|
|
|
Kommandot `yarn database:migrate:prod` kommer att tillämpa migrationerna på databasstrukturen (kärn- och metadatascheman)
|
|
Kommandot `yarn command:prod upgrade-0.32` tar hand om datamigreringen av alla arbetsytor.
|
|
|
|
**Miljövariabler**
|
|
|
|
Vi har uppdaterat sättet vi hanterar Redis-anslutningen.
|
|
|
|
- Borttaget: `REDIS_HOST`, `REDIS_PORT`, `REDIS_USERNAME`, `REDIS_PASSWORD`
|
|
- Tillagt: `REDIS_URL`
|
|
|
|
Uppdatera din `.env`-fil för att använda den nya `REDIS_URL`-variabeln istället för de individuella Redis-anslutningsparametrarna.
|
|
|
|
Vi har också förenklat sättet vi hanterar JWT-tokens.
|
|
|
|
- Borttaget: `ACCESS_TOKEN_SECRET`, `LOGIN_TOKEN_SECRET`, `REFRESH_TOKEN_SECRET`, `FILE_TOKEN_SECRET`
|
|
- Tillagt: `APP_SECRET`
|
|
|
|
Uppdatera din `.env`-fil för att använda den nya `APP_SECRET`-variabeln istället för de individuella token-hemligheterna (du kan använda samma hemlighet som tidigare eller generera en ny slumpmässig sträng)
|
|
|
|
**Anslutet konto**
|
|
|
|
Om du använder ett kopplat konto för att synkronisera dina Google-e-postmeddelanden och kalendrar måste du aktivera [People API](https://developers.google.com/people) i din Google Admin-konsol.
|
|
|
|
### v0.30.0 till v0.31.0
|
|
|
|
Uppgradera din Twenty-instans till att använda v0.31.0-bilden
|
|
|
|
**Schema och datamigrering**:
|
|
|
|
```
|
|
yarn database:migrate:prod
|
|
yarn command:prod upgrade-0.31
|
|
```
|
|
|
|
Kommandot `yarn database:migrate:prod` kommer att tillämpa migrationerna på databasstrukturen (kärn- och metadatascheman)
|
|
Kommandot `yarn command:prod upgrade-0.31` tar hand om datamigreringen av alla arbetsytor.
|
|
|
|
### v0.24.0 till v0.30.0
|
|
|
|
Uppgradera din Twenty-instans till att använda v0.30.0-bilden
|
|
|
|
**Breaking change**:
|
|
To enhance performances, Twenty now requires redis cache to be configured. Vi har uppdaterat vår [docker-compose.yml](https://raw.githubusercontent.com/twentyhq/twenty/main/packages/twenty-docker/docker-compose.yml) för att återspegla detta.
|
|
Se till att uppdatera din konfiguration och dina miljövariabler därefter:
|
|
|
|
```
|
|
REDIS_HOST={your-redis-host}
|
|
REDIS_PORT={your-redis-port}
|
|
CACHE_STORAGE_TYPE=redis
|
|
```
|
|
|
|
**Schema och datamigrering**:
|
|
|
|
```
|
|
yarn database:migrate:prod
|
|
yarn command:prod upgrade-0.30
|
|
```
|
|
|
|
Kommandot `yarn database:migrate:prod` kommer att tillämpa migrationerna på databasstrukturen (kärn- och metadatascheman)
|
|
Kommandot `yarn command:prod upgrade-0.30` tar hand om datamigreringen av alla arbetsytor.
|
|
|
|
### v0.23.0 till v0.24.0
|
|
|
|
Uppgradera din Twenty-instans till att använda v0.24.0-bilden
|
|
|
|
Kör följande kommandon:
|
|
|
|
```
|
|
yarn database:migrate:prod
|
|
yarn command:prod upgrade-0.24
|
|
```
|
|
|
|
Kommandot `yarn database:migrate:prod` kommer att tillämpa migrationerna på databasstrukturen (kärn- och metadatascheman)
|
|
Kommandot `yarn command:prod upgrade-0.24` tar hand om datamigreringen av alla arbetsytor.
|
|
|
|
### v0.22.0 till v0.23.0
|
|
|
|
Uppgradera din Twenty-instans till att använda v0.23.0-bilden
|
|
|
|
Kör följande kommandon:
|
|
|
|
```
|
|
yarn database:migrate:prod
|
|
yarn command:prod upgrade-0.23
|
|
```
|
|
|
|
Kommandot `yarn database:migrate:prod` kommer att tillämpa migrationerna på databasen.
|
|
Kommandot `yarn command:prod upgrade-0.23` tar hand om datamigreringen, inklusive att överföra aktiviteter till uppgifter/anteckningar.
|
|
|
|
### v0.21.0 till v0.22.0
|
|
|
|
Uppgradera din Twenty-instans till att använda v0.22.0-bilden
|
|
|
|
Kör följande kommandon:
|
|
|
|
```
|
|
yarn database:migrate:prod
|
|
yarn command:prod workspace:sync-metadata -f
|
|
yarn command:prod upgrade-0.22
|
|
```
|
|
|
|
Kommandot `yarn database:migrate:prod` kommer att tillämpa migrationer på databasen.
|
|
Kommandot `yarn command:prod workspace:sync-metadata -f` kommer att synkronisera definitionen av standardobjekt till metadatatabellerna och tillämpa nödvändiga migrationer till befintliga arbetsytor.
|
|
Kommandot `yarn command:prod upgrade-0.22` kommer att tillämpa specifika datatransformationer för att anpassa till den nya objektstandardinställningen defaultRequestInstrumentationOptions.
|
|
|
|
|
|
|
|
|