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
13 KiB
Plaintext
391 lines
13 KiB
Plaintext
---
|
|
title: Päivitysopas
|
|
image: /images/user-guide/notes/notes_header.png
|
|
---
|
|
|
|
<Frame>
|
|
<img src="/images/user-guide/notes/notes_header.png" alt="Header" />
|
|
</Frame>
|
|
|
|
## Yleiset ohjeet
|
|
|
|
**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}`.
|
|
|
|
Jos käytit Docker Composea, noudata näitä ohjeita:
|
|
|
|
1. Päätelaitteessa, jossa Twenty on käynnissä, sammuta Twenty: `docker compose down`
|
|
|
|
2. Päivitä versio muuttamalla `TAG` -arvoa .env-tiedostossa lähellä docker-composea. ( Suosittelemme käyttämään version `major.minor` muotoa, kuten `v0.53` )
|
|
|
|
3. Käynnistä Twenty uudelleen käyttämällä `docker compose up -d`
|
|
|
|
Jos haluat päivittää useamman version kerralla, esimerkiksi v0.33.0:sta v0.35.0:aan, sinun on päivitettävä vaiheittain, tässä esimerkissä v0.33.0:sta v0.34.0:aan ja sitten v0.34.0:sta v0.35.0:aan.
|
|
|
|
**Varmista, että jokaisen päivityksen jälkeen varmuuskopio on ehjä.**
|
|
|
|
## Versiokohtaiset päivitysaskeleet
|
|
|
|
## v1.0
|
|
|
|
Tervetuloa Twenty versioon v1.0! 🎉
|
|
|
|
## v0.60
|
|
|
|
### Suorituskyvyn parannukset
|
|
|
|
Kaikki vuorovaikutukset metadata API:n kanssa on optimoitu paremman suorituskyvyn saavuttamiseksi, erityisesti kohdemetadatan käsittelyssä ja työtilojen luontitoiminnoissa.
|
|
|
|
Olemme uudistaneet välimuististrategiamme niin, että etusijalle asetetaan välimuistin osumat tietokantakyselyiden sijaan aina kun mahdollista, mikä parantaa merkittävästi metadata API:n suorituskykyä.
|
|
|
|
Jos kohtaat suoritusongelmia päivityksen jälkeen, saatat joutua tyhjentämään välimuistisi varmistaaksesi sen synkronoinnin uusimpien muutosten kanssa. Suorita tämä komento twenty-server-säilössäsi:
|
|
|
|
```bash
|
|
yarn command:prod cache:flush
|
|
```
|
|
|
|
### v0.55
|
|
|
|
Päivitä Twenty-asennuksesi käyttämään v0.55-kuvaa
|
|
|
|
Sinun ei tarvitse enää suorittaa mitään komentoja, uusi kuva huolehtii automaattisesti kaikista tarvittavista migraatioista.
|
|
|
|
### `Käyttäjällä ei ole oikeuksia` -virhe
|
|
|
|
Jos kohtaat valtuutusvirheitä useimmissa pyynnöissä päivityksen jälkeen, sinun saattaa olla tarpeen tyhjentää välimuistisi laskeaksesi uusimmat oikeudet uudelleen.
|
|
|
|
Suorita seuraava komento `twenty-server`-säilössäsi:
|
|
|
|
```bash
|
|
yarn command:prod cache:flush
|
|
```
|
|
|
|
Tämä ongelma koskee vain tätä Twenty-versiota eikä pitäisi olla tarpeen jatkossa.
|
|
|
|
### v0.54
|
|
|
|
Versiosta `0.53` eteenpäin ei vaadita manuaalisia toimia.
|
|
|
|
#### Metadataskeeman vanhentuminen
|
|
|
|
Olemme yhdistäneet `metadata`-skeeman ja `core`-skeeman yksinkertaistaaksemme datan hakua `TypeORM`:stä.
|
|
Olemme yhdistäneet `migrate`-komennon vaiheet `upgrade`-komennon sisälle. Emme suosittele `migrate`:n ajamista manuaalisesti missään palvelin- tai työntekijäsäilöissäsi.
|
|
|
|
### Versiosta v0.53 alkaen
|
|
|
|
Starting from `0.53`, upgrade is programmatically done within the `DockerFile`, this means from now on, you shouldn't have to run any command manually anymore.
|
|
|
|
Varmista, että päivität asennuksesi vaiheittain, ilman että sivuutat merkittäviä versioita (esim. `0.43.3` versioon `0.44.0` on sallittua, mutta ei `0.43.1` versioon `0.45.0`), muuten se voi johtaa työtilan version epäyhtenäisyyksiin, mikä voi aiheuttaa suoritusvirheitä ja puuttuvaa toiminnallisuutta.
|
|
|
|
Voit tarkistaa, onko työtila päivitetty oikein tarkistamalla sen version tietokannasta `core.workspace`-taulussa.
|
|
|
|
Sen tulisi aina olla nykyisen Twentyn asennusversion `major.minor`-välillä, voit tarkistaa asennusversion hallintapaneelista (osoitteessa `/settings/admin-panel`, saavutettavissa jos käyttäjälläsi on `canAccessFullAdminPanel`-omaisuus määritetty arvoksi true tietokannassa) tai suorittamalla komento `echo $APP_VERSION` `twenty-server`-säilössäsi.
|
|
|
|
Voit ratkaista epäyhtenäisen työtilan version päivittämällä vastaavasta Twentyn versiosta liittyvän päivitysoppaan ohjeiden mukaisesti vaiheittain, kunnes saavutat toivotun version.
|
|
|
|
#### `auditLog`-poisto
|
|
|
|
Olemme poistaneet auditLog-standardiobjektin, mikä voi pienentää varmuuskopion kokoa merkittävästi tämän migraation jälkeen.
|
|
|
|
### v0.51:stä v0.52:een
|
|
|
|
Päivitä Twenty-asennuksesi käyttämään v0.52-kuvaa
|
|
|
|
```
|
|
yarn database:migrate:prod
|
|
yarn command:prod upgrade
|
|
```
|
|
|
|
#### Minulla on työtila, joka on juuttunut välillä versioiden `0.52.0` ja `0.52.6` väliin
|
|
|
|
Valitettavasti versiot `0.52.0` ja `0.52.6` on poistettu täysin dockerHubista.
|
|
Sinun on päivitettävä työtilan versioksi `0.51.0` tietokantaan käsin ja päivitettävä Twenty-versiolla `0.52.11` seuraamalla sen yläpuolella annettua päivitysopasta.
|
|
|
|
### v0.50:stä v0.51:een
|
|
|
|
Päivitä Twenty-asennuksesi käyttämään v0.51-kuvaa
|
|
|
|
```
|
|
yarn database:migrate:prod
|
|
yarn command:prod upgrade
|
|
```
|
|
|
|
### v0.44.0:sta v0.50.0:aan
|
|
|
|
Päivitä Twenty-asennuksesi käyttämään v0.50.0-kuvaa
|
|
|
|
```
|
|
yarn database:migrate:prod
|
|
yarn command:prod upgrade
|
|
```
|
|
|
|
#### Docker-compose.yml:in muutos
|
|
|
|
Tämä versio sisältää `docker-compose.yml`-tiedoston muutoksen, jolla `worker`-palvelulle annetaan pääsy `server-local-data`-volyymiin.
|
|
Päivitä paikallinen `docker-compose.yml` [v0.50.0 docker-compose.yml](https://github.com/twentyhq/twenty/blob/v0.50.0/packages/twenty-docker/docker-compose.yml) avulla
|
|
|
|
### v0.43.0:sta v0.44.0:aan
|
|
|
|
Päivitä Twenty-asennuksesi käyttämään v0.44.0-kuvaa
|
|
|
|
```
|
|
yarn database:migrate:prod
|
|
yarn command:prod upgrade
|
|
```
|
|
|
|
### v0.42.0:sta v0.43.0:aan
|
|
|
|
Päivitä Twenty-asennuksesi käyttämään v0.43.0-kuvaa
|
|
|
|
```
|
|
yarn database:migrate:prod
|
|
yarn command:prod upgrade
|
|
```
|
|
|
|
Tässä versiossa olemme siirtyneet postgres:16-kuvaan docker-compose.yml:ssä.
|
|
|
|
#### (Vaihtoehto 1) Tietokannan migraatio
|
|
|
|
Pidetään olemassa oleva postgres-spilo-kuva, mutta sinun on jäädytettävä versio docker-compose.yml:ssä versioksi 0.43.0.
|
|
|
|
#### (Vaihtoehto 2) Tietokannan migraatio
|
|
|
|
Jos haluat siirtää tietokantasi uuteen postgres:16-kuvaan, noudata seuraavia vaiheita:
|
|
|
|
1. Vie tietokanta vanhasta postgres-spilo-säilöstä
|
|
|
|
```
|
|
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 .
|
|
```
|
|
|
|
Varmista, että dump-tiedostosi ei ole tyhjä.
|
|
|
|
2. Päivitä docker-compose.yml käyttämään postgres:16-kuvaa, kuten [docker-compose.yml](https://raw.githubusercontent.com/twentyhq/twenty/main/packages/twenty-docker/docker-compose.yml) -tiedostossa on.
|
|
|
|
3. Palauta tietokanta uuteen postgres:16-säilöön
|
|
|
|
```
|
|
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:stä v0.42.0:aan
|
|
|
|
Päivitä Twenty-asennuksesi käyttämään v0.42.0-kuvaa
|
|
|
|
```
|
|
yarn database:migrate:prod
|
|
yarn command:prod upgrade-0.42
|
|
```
|
|
|
|
**Ympäristömuuttujat**
|
|
|
|
- Poistettu: `FRONT_PORT`, `FRONT_PROTOCOL`, `FRONT_DOMAIN`, `PORT`
|
|
- Lisätty: `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:sta v0.41.0:aan
|
|
|
|
Päivitä Twenty-asennuksesi käyttämään v0.41.0-kuvaa
|
|
|
|
```
|
|
yarn database:migrate:prod
|
|
yarn command:prod upgrade-0.41
|
|
```
|
|
|
|
**Ympäristömuuttujat**
|
|
|
|
- Poistettu: `AUTH_MICROSOFT_TENANT_ID`
|
|
|
|
### v0.35.0:sta v0.40.0:aan
|
|
|
|
Päivitä Twenty-asennuksesi käyttämään v0.40.0-kuvaa
|
|
|
|
```
|
|
yarn database:migrate:prod
|
|
yarn command:prod upgrade-0.40
|
|
```
|
|
|
|
**Ympäristömuuttujat**
|
|
|
|
- Lisätty: `IS_EMAIL_VERIFICATION_REQUIRED`, `EMAIL_VERIFICATION_TOKEN_EXPIRES_IN`, `WORKFLOW_EXEC_THROTTLE_LIMIT`, `WORKFLOW_EXEC_THROTTLE_TTL`
|
|
|
|
### v0.34.0:sta v0.35.0:aan
|
|
|
|
Päivitä Twenty-asennuksesi käyttämään v0.35.0-kuvaa
|
|
|
|
```
|
|
yarn database:migrate:prod
|
|
yarn command:prod upgrade-0.35
|
|
```
|
|
|
|
Komento `yarn database:migrate:prod` soveltaa migraatiot tietokannan rakenteeseen (ydin ja metadata-skeemat)
|
|
Komento `yarn command:prod upgrade-0.35` huolehtii kaikkien työtilojen datamigraatioista.
|
|
|
|
**Ympäristömuuttujat**
|
|
|
|
- Olemme korvanneet `ENABLE_DB_MIGRATIONS` `DISABLE_DB_MIGRATIONS`-muuttujalla (oletusarvo on nyt `false`, luultavasti sinun ei tarvitse asettaa mitään)
|
|
|
|
### v0.33.0:sta v0.34.0:aan
|
|
|
|
Päivitä Twenty-asennuksesi käyttämään v0.34.0-kuvaa
|
|
|
|
```
|
|
yarn database:migrate:prod
|
|
yarn command:prod upgrade-0.34
|
|
```
|
|
|
|
Komento `yarn database:migrate:prod` soveltaa migraatiot tietokannan rakenteeseen (ydin ja metadata-skeemat)
|
|
Komento `yarn command:prod upgrade-0.34` huolehtii kaikkien työtilojen datamigraatioista.
|
|
|
|
**Ympäristömuuttujat**
|
|
|
|
- Poistettu: `FRONT_BASE_URL`
|
|
- Lisätty: `FRONT_DOMAIN`, `FRONT_PROTOCOL`, `FRONT_PORT`
|
|
|
|
Olemme päivittäneet etuosan URL-osoitteen käsittelytavan.
|
|
Voit nyt asettaa etuosan URL-osoitteen käyttämällä muuttujia `FRONT_DOMAIN`, `FRONT_PROTOCOL` ja `FRONT_PORT`.
|
|
Jos FRONT_DOMAIN ei ole asetettu, etuosan URL-osoite palautuu `SERVER_URL`:ään.
|
|
|
|
### v0.32.0:stä v0.33.0:aan
|
|
|
|
Päivitä Twenty-asennuksesi käyttämään v0.33.0-kuvaa
|
|
|
|
```
|
|
yarn command:prod cache:flush
|
|
yarn database:migrate:prod
|
|
yarn command:prod upgrade-0.33
|
|
```
|
|
|
|
Komento `yarn command:prod cache:flush` tyhjentää Redis-välimuistin.
|
|
Komento `yarn database:migrate:prod` soveltaa migraatiot tietokannan rakenteeseen (ydin ja metadata-skeemat)
|
|
Komento `yarn command:prod upgrade-0.33` huolehtii kaikkien työtilojen datamigraatioista.
|
|
|
|
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:stä v0.32.0:aan
|
|
|
|
Päivitä Twenty-asennuksesi käyttämään v0.32.0-kuvaa
|
|
|
|
**Skeeman ja datan migraatio**
|
|
|
|
```
|
|
yarn database:migrate:prod
|
|
yarn command:prod upgrade-0.32
|
|
```
|
|
|
|
Komento `yarn database:migrate:prod` soveltaa migraatiot tietokannan rakenteeseen (ydin ja metadata-skeemat)
|
|
Komento `yarn command:prod upgrade-0.32` huolehtii kaikkien työtilojen datamigraatioista.
|
|
|
|
**Ympäristömuuttujat**
|
|
|
|
We have updated the way we handle the Redis connection.
|
|
|
|
- Poistettu: `REDIS_HOST`, `REDIS_PORT`, `REDIS_USERNAME`, `REDIS_PASSWORD`
|
|
- Lisätty: `REDIS_URL`
|
|
|
|
Päivitä `.env`-tiedostosi käyttämään uutta `REDIS_URL`-muuttujaa yksittäisten Rediksen yhteysparametrien sijasta.
|
|
|
|
Olemme myös yksinkertaistaneet tapaamme käsitellä JWT-tokeneita.
|
|
|
|
- Poistettu: `ACCESS_TOKEN_SECRET`, `LOGIN_TOKEN_SECRET`, `REFRESH_TOKEN_SECRET`, `FILE_TOKEN_SECRET`
|
|
- Lisätty: `APP_SECRET`
|
|
|
|
Päivitä `.env`-tiedostosi käyttämään uutta `APP_SECRET`-muuttujaa yksittäisten tokeneiden salasanojen sijasta (voit käyttää samaa salasanaa kuin aiemmin tai luoda uuden satunnaisen merkkijonon)
|
|
|
|
**Liitetty tili**
|
|
|
|
Jos käytät yhdistettyjä tilejä Google-sähköpostisi ja kalenteriesi synkronoimiseen, sinun on aktivoitava [People API](https://developers.google.com/people) Google-hallintakeskuksessasi.
|
|
|
|
### v0.30.0:sta v0.31.0:aan
|
|
|
|
Päivitä Twenty-asennuksesi käyttämään v0.31.0-kuvaa
|
|
|
|
**Skeeman ja datan migraatio**:
|
|
|
|
```
|
|
yarn database:migrate:prod
|
|
yarn command:prod upgrade-0.31
|
|
```
|
|
|
|
Komento `yarn database:migrate:prod` soveltaa migraatiot tietokannan rakenteeseen (ydin ja metadata-skeemat)
|
|
Komento `yarn command:prod upgrade-0.31` huolehtii kaikkien työtilojen datamigraatioista.
|
|
|
|
### v0.24.0:sta v0.30.0:aan
|
|
|
|
Päivitä Twenty-asennuksesi käyttämään v0.30.0-kuvaa
|
|
|
|
**Breaking change**:
|
|
To enhance performances, Twenty now requires redis cache to be configured. Olemme päivittäneet [docker-compose.yml](https://raw.githubusercontent.com/twentyhq/twenty/main/packages/twenty-docker/docker-compose.yml) heijastamaan tätä.
|
|
Varmista, että päivität konfiguraatiosi ja ympäristömuuttujasi vastaavasti:
|
|
|
|
```
|
|
REDIS_HOST={your-redis-host}
|
|
REDIS_PORT={your-redis-port}
|
|
CACHE_STORAGE_TYPE=redis
|
|
```
|
|
|
|
**Skeeman ja datan migraatio**:
|
|
|
|
```
|
|
yarn database:migrate:prod
|
|
yarn command:prod upgrade-0.30
|
|
```
|
|
|
|
Komento `yarn database:migrate:prod` soveltaa migraatiot tietokannan rakenteeseen (ydin ja metadata-skeemat)
|
|
Komento `yarn command:prod upgrade-0.30` huolehtii kaikkien työtilojen datamigraatioista.
|
|
|
|
### v0.23.0:sta v0.24.0:aan
|
|
|
|
Päivitä Twenty-asennuksesi käyttämään v0.24.0-kuvaa
|
|
|
|
Suorita seuraavat komennot:
|
|
|
|
```
|
|
yarn database:migrate:prod
|
|
yarn command:prod upgrade-0.24
|
|
```
|
|
|
|
Komento `yarn database:migrate:prod` soveltaa migraatiot tietokannan rakenteeseen (ydin ja metadata-skeemat)
|
|
Komento `yarn command:prod upgrade-0.24` huolehtii kaikkien työtilojen datamigraatioista.
|
|
|
|
### v0.22.0:sta v0.23.0:aan
|
|
|
|
Päivitä Twenty-asennuksesi käyttämään v0.23.0-kuvaa
|
|
|
|
Suorita seuraavat komennot:
|
|
|
|
```
|
|
yarn database:migrate:prod
|
|
yarn command:prod upgrade-0.23
|
|
```
|
|
|
|
Komento `yarn database:migrate:prod` soveltaa migraatiot tietokantaan.
|
|
Komento `yarn command:prod upgrade-0.23` huolehtii datamigraatioista, mukaan lukien aktiviteettien siirtäminen tehtäviin/muistiinpanoihin.
|
|
|
|
### v0.21.0:sta v0.22.0:aan
|
|
|
|
Päivitä Twenty-asennuksesi käyttämään v0.22.0-kuvaa
|
|
|
|
Suorita seuraavat komennot:
|
|
|
|
```
|
|
yarn database:migrate:prod
|
|
yarn command:prod workspace:sync-metadata -f
|
|
yarn command:prod upgrade-0.22
|
|
```
|
|
|
|
Komento `yarn database:migrate:prod` soveltaa migraatiot tietokantaan.
|
|
The `yarn command:prod workspace:sync-metadata -f` command will sync the definition of standard objects to the metadata tables and apply to required migrations to existing workspaces.
|
|
The `yarn command:prod upgrade-0.22` command will apply specific data transformations to adapt to the new object defaultRequestInstrumentationOptions.
|
|
|
|
|
|
|
|
|