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
15 KiB
Plaintext
391 lines
15 KiB
Plaintext
---
|
||
title: מדריך שדרוג
|
||
image: /images/user-guide/notes/notes_header.png
|
||
---
|
||
|
||
<Frame>
|
||
<img src="/images/user-guide/notes/notes_header.png" alt="Header" />
|
||
</Frame>
|
||
|
||
## הנחיות כלליות
|
||
|
||
**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}`.
|
||
|
||
אם השתמשת ב-Docker Compose, עקוב אחרי השלבים הבאים:
|
||
|
||
1. בטרמינל, על המחשב המארח בו Twenty פועלת, כבה את Twenty: `docker compose down`
|
||
|
||
2. שדרוג את הגרסה על ידי שינוי ערך ה-`TAG` בקובץ `.env` ליד הקובץ docker-compose שלך. ( מומלץ לצרוך גרסת `major.minor` כמו `v0.53` )
|
||
|
||
3. העלה את Twenty בחזרה עם `docker compose up -d`
|
||
|
||
אם ברצונך לשדרג את המופע שלך בכמה גרסאות, למשל מ-v0.33.0 ל-v0.35.0, עליך לשדרג את המופע שלך באופן רצוף, בדוגמה זו מ-v0.33.0 ל-v0.34.0, ולאחר מכן מ-v0.34.0 ל-v0.35.0.
|
||
|
||
**ודא שאחרי כל גרסה משודרגת יש לך גיבוי בלתי פגום.**
|
||
|
||
## צעדי שדרוג ספציפיים לגרסה
|
||
|
||
## v1.0
|
||
|
||
שלום Twenty v1.0! 🎉
|
||
|
||
## v0.60
|
||
|
||
### שדרוגי ביצועים
|
||
|
||
All interactions with the metadata API have been optimized for better performance, particularly for object metadata manipulation and workspace creation operations.
|
||
|
||
We've refactored our caching strategy to prioritize cache hits over database queries when possible, significantly improving the performance of metadata API operations.
|
||
|
||
אם אתה נתקל בבעיות בזמן ריצה לאחר השדרוג, ייתכן שתצטרך לנקות את המטמון שלך כדי לוודא שהוא מסונכרן עם השינויים האחרונים. הרץ את הפקודה במיכל השרת שלך ב-Twenty:
|
||
|
||
```bash
|
||
yarn command:prod cache:flush
|
||
```
|
||
|
||
### v0.55
|
||
|
||
שדרג את מופע ה-Twenty שלך לשימוש בתמונת v0.55
|
||
|
||
You don't need to run any command anymore, the new image will automatically care about running all required migrations.
|
||
|
||
### שגיאה: `למשתמש אין הרשאה`
|
||
|
||
אם אתה נתקל בבעיות הרשאה ברוב הבקשות אחרי השדרוג, ייתכן שיהיה צורך לנקות את המטמון כדי לחשב מחדש את ההרשאות האחרונות.
|
||
|
||
במיכל השרת שלך ב-Twenty, הרץ:
|
||
|
||
```bash
|
||
yarn command:prod cache:flush
|
||
```
|
||
|
||
בעיה זו ספציפית לגרסה זו של Twenty ולא אמורה להידרש בשדרוגים עתידיים.
|
||
|
||
### v0.54
|
||
|
||
מאז גרסה `0.53`, אין צורך בפעולות ידניות.
|
||
|
||
#### התיישנות סכמת מטא נתונים
|
||
|
||
מיזגנו את סכמת ה`metadata` עם ה`core` כדי לפשט את שליפת הנתונים מ`TypeORM`.
|
||
מיזגנו את הצעד של `migrate` בתוך הצו `upgrade`. We do not recommend running `migrate` manually within any of your server/worker containers.
|
||
|
||
### מאז v0.53
|
||
|
||
החל מגרסה `0.53`, השדרוג מבוצע תיכנותית בתוך ה`DockerFile`, כלומר מעתה והלאה, אין צורך יותר בהרצת פקודה ידנית.
|
||
|
||
ודא שתשדרג את המופע שלך באופן רציף, מבלי לדלג על שום גרסת עיקרית (למשל מ`0.43.3` ל`0.44.0` מותר, אבל מ`0.43.1` ל`0.45.0` לא), אחרת זה עלול להוביל לתיאום גירסה שאינו נכון שיכול לגרום לשגיאת זמן ריצה ולחוסר פעולתיות.
|
||
|
||
כדי לבדוק אם מרחב העבודה הועבר כראוי ניתן לבדוק את גרסתו בבסיס הנתונים בטבלה `core.workspace`.
|
||
|
||
הוא תמיד צריך להיות בטווח של גרסת `major.minor` הנוכחית של מופע Twenty שלך, תוכל לבדוק את גרסת המופע שלך בפאנל הניהול (ב`/settings/admin-panel`, נגיש אם ההגדרה `canAccessFullAdminPanel` של המשתמש שלך מוגדרת כ-true בבסיס הנתונים) או על ידי הרצת `echo $APP_VERSION` במיכל השרת שלך.
|
||
|
||
כדי לתקן גרסת מרחב עבודה אונכתפית, תצטרך לשדרג מהגרסה הרלוונטית של Twenty על פי מדריך השדרוג המתאים ברציפות וכך הלאה עד שתגיע לגרסה הרצויה.
|
||
|
||
#### הסרת `auditLog`
|
||
|
||
הסרנו את אובייקט ה-standard של auditLog, כלומר גודל הגיבוי שלך עשוי להיות מופחת אוטומטית לאחר ההגירה הזו.
|
||
|
||
### v0.51 ל-v0.52
|
||
|
||
שדרג את מופע ה-Twenty שלך לשימוש בתמונת v0.52
|
||
|
||
```
|
||
yarn database:migrate:prod
|
||
yarn command:prod upgrade
|
||
```
|
||
|
||
#### יש לי מרחב עבודה שנחסם בין גרסה `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.51
|
||
|
||
```
|
||
yarn database:migrate:prod
|
||
yarn command:prod upgrade
|
||
```
|
||
|
||
### v0.44.0 ל-v0.50.0
|
||
|
||
שדרג את מופע ה-Twenty שלך לשימוש בתמונת v0.50.0
|
||
|
||
```
|
||
yarn database:migrate:prod
|
||
yarn command:prod upgrade
|
||
```
|
||
|
||
#### שינוי ב-docker-compose.yml
|
||
|
||
גרסה זו כוללת שינוי ב`docker-compose.yml` כדי להעניק לשירות `worker` גישה לנפח `server-local-data`.
|
||
אנא עדכן את ה`docker-compose.yml` המקומי שלך עם [v0.50.0 docker-compose.yml](https://github.com/twentyhq/twenty/blob/v0.50.0/packages/twenty-docker/docker-compose.yml)
|
||
|
||
### v0.43.0 ל-v0.44.0
|
||
|
||
שדרג את מופע ה-Twenty שלך לשימוש בתמונת v0.44.0
|
||
|
||
```
|
||
yarn database:migrate:prod
|
||
yarn command:prod upgrade
|
||
```
|
||
|
||
### v0.42.0 ל-v0.43.0
|
||
|
||
שדרג את מופע ה-Twenty שלך לשימוש בתמונת v0.43.0
|
||
|
||
```
|
||
yarn database:migrate:prod
|
||
yarn command:prod upgrade
|
||
```
|
||
|
||
בגרסה זו, העברנו לשימוש בתמונה postgres:16 בתוך docker-compose.yml.
|
||
|
||
#### (אפשרות 1) הגירת מסד נתונים
|
||
|
||
השארת התמונה הקיימת postgres-spilo זה טוב, אך יהיה עליך להקפיא את הגרסה ב-docker-compose.yml שלך ל-0.43.0.
|
||
|
||
#### (אפשרות 2) הגירת מסד נתונים
|
||
|
||
אם אתה מעוניין להמיר את מסד הנתונים שלך לתמונה החדשה postgres:16, אנא פעל לפי השלבים הבאים:
|
||
|
||
1. גבה את מסד הנתונים מהמיכל הישן postgres-spilo
|
||
|
||
```
|
||
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 .
|
||
```
|
||
|
||
ודא שקובץ הגיבוי שלך אינו ריק.
|
||
|
||
2. שדרג את ה-docker-compose.yml שלך לשימוש בתמונת postgres:16 כפי שבקובץ [docker-compose.yml](https://raw.githubusercontent.com/twentyhq/twenty/main/packages/twenty-docker/docker-compose.yml).
|
||
|
||
3. שחזר את בסיס הנתונים למיכל החדש postgres:16
|
||
|
||
```
|
||
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 ל-v0.42.0
|
||
|
||
שדרג את מופע ה-Twenty שלך לשימוש בתמונת v0.42.0
|
||
|
||
```
|
||
yarn database:migrate:prod
|
||
yarn command:prod upgrade-0.42
|
||
```
|
||
|
||
**משתני סביבה**
|
||
|
||
- הוסר: `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
|
||
|
||
```
|
||
yarn database:migrate:prod
|
||
yarn command:prod upgrade-0.41
|
||
```
|
||
|
||
**משתני סביבה**
|
||
|
||
- הוסר: `AUTH_MICROSOFT_TENANT_ID`
|
||
|
||
### v0.35.0 ל-v0.40.0
|
||
|
||
שדרג את מופע ה-Twenty שלך לשימוש בתמונת v0.40.0
|
||
|
||
```
|
||
yarn database:migrate:prod
|
||
yarn command:prod upgrade-0.40
|
||
```
|
||
|
||
**משתני סביבה**
|
||
|
||
- התווסף: `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.0
|
||
|
||
```
|
||
yarn database:migrate:prod
|
||
yarn command:prod upgrade-0.35
|
||
```
|
||
|
||
פקודת yarn database:migrate:prod תאיים את הגירות המבנה של בסיס הנתונים (סכמות ליבה ומטא נתונים)
|
||
פקודת yarn command:prod upgrade-0.35 תדאג להעברת נתונים של כל מרחבי העבודה.
|
||
|
||
**משתני סביבה**
|
||
|
||
- החלפנו את `ENABLE_DB_MIGRATIONS` ב`DISABLE_DB_MIGRATIONS` (כעת הערך הוא `false` כברירת מחדל, כנראה שלא תצטרך להגדיר דבר)
|
||
|
||
### v0.33.0 ל-v0.34.0
|
||
|
||
שדרג את מופע ה-Twenty שלך לשימוש בתמונת v0.34.0
|
||
|
||
```
|
||
yarn database:migrate:prod
|
||
yarn command:prod upgrade-0.34
|
||
```
|
||
|
||
פקודת yarn database:migrate:prod תאיים את הגירות המבנה של בסיס הנתונים (סכמות ליבה ומטא נתונים)
|
||
פקודת yarn command:prod upgrade-0.34 תדאג להעברת נתונים של כל מרחבי העבודה.
|
||
|
||
**משתני סביבה**
|
||
|
||
- הוסר: `FRONT_BASE_URL`
|
||
- התווסף: `FRONT_DOMAIN`, `FRONT_PROTOCOL`, `FRONT_PORT`
|
||
|
||
עדכנו את הדרך בה אנו מטפלים בכתובת ה-URL של הממשק הראשי.
|
||
כעת ניתן להגדיר את כתובת ה-URL של הממשק הראשי על ידי שימוש במשתני `FRONT_DOMAIN`, `FRONT_PROTOCOL` ו-`FRONT_PORT`.
|
||
אם ה-FRONT_DOMAIN לא נקבע, כתובת ה-URL של הממשק הראשי תחזור ל-SERVER_URL.
|
||
|
||
### v0.32.0 ל-v0.33.0
|
||
|
||
שדרג את מופע ה-Twenty שלך לשימוש בתמונת v0.33.0
|
||
|
||
```
|
||
yarn command:prod cache:flush
|
||
yarn database:migrate:prod
|
||
yarn command:prod upgrade-0.33
|
||
```
|
||
|
||
פקודת yarn command:prod cache:flush תנקה את מטמון ה-Redis.
|
||
פקודת yarn database:migrate:prod תאיים את הגירות המבנה של בסיס הנתונים (סכמות ליבה ומטא נתונים)
|
||
פקודת yarn command:prod upgrade-0.33 תדאג להעברת נתונים של כל מרחבי העבודה.
|
||
|
||
החל מגרסה זו, התמונה twenty-postgres עבור בסיס הנתונים נעשתה מיושנת ויש להשתמש בתמונה 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
|
||
yarn command:prod upgrade-0.32
|
||
```
|
||
|
||
פקודת yarn database:migrate:prod תאיים את הגירות המבנה של בסיס הנתונים (סכמות ליבה ומטא נתונים)
|
||
פקודת yarn command:prod upgrade-0.32 תדאג להעברת נתונים של כל מרחבי העבודה.
|
||
|
||
**משתני סביבה**
|
||
|
||
עדכנו את הדרך בה אנו מטפלים בחיבור Redis.
|
||
|
||
- הוסר: `REDIS_HOST`, `REDIS_PORT`, `REDIS_USERNAME`, `REDIS_PASSWORD`
|
||
- התווסף: `REDIS_URL`
|
||
|
||
עדכן את קובץ ה`.env` שלך לשימוש במשתנה החדש `REDIS_URL` במקום בפרמטרי החיבור הבודדים של Redis.
|
||
|
||
We have also simplified the way we handle the JWT tokens.
|
||
|
||
- הוסר: `ACCESS_TOKEN_SECRET`, `LOGIN_TOKEN_SECRET`, `REFRESH_TOKEN_SECRET`, `FILE_TOKEN_SECRET`
|
||
- התווסף: `APP_SECRET`
|
||
|
||
עדכן את קובץ ה`.env` שלך לשימוש במשתנה ה`APP_SECRET` החדש במקום בסודות הטוקנים הבודדים (ניתן להשתמש באותו הסוד כמו קודם או ליצור מחרוזת אקראית חדשה).
|
||
|
||
**חשבון מחובר**
|
||
|
||
אם אתה משתמש בחשבון מחובר לסנכרון הודעות דוא"ל ולוחות שנה של גוגל, תצטרך להפעיל את [API אנשים](https://developers.google.com/people) בקונסולת המנהל של גוגל שלך.
|
||
|
||
### v0.30.0 ל-v0.31.0
|
||
|
||
שדרג את מופע ה-Twenty שלך לשימוש בתמונת v0.31.0
|
||
|
||
**הגירה סכמתית ונתונים**:
|
||
|
||
```
|
||
yarn database:migrate:prod
|
||
yarn command:prod upgrade-0.31
|
||
```
|
||
|
||
פקודת yarn database:migrate:prod תאיים את הגירות המבנה של בסיס הנתונים (סכמות ליבה ומטא נתונים)
|
||
פקודת 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](https://raw.githubusercontent.com/twentyhq/twenty/main/packages/twenty-docker/docker-compose.yml) כדי לשקף זאת.
|
||
ודא לעדכן את תצורתך ולעדכן את משתני הסביבה שלך בהתאם:
|
||
|
||
```
|
||
REDIS_HOST={your-redis-host}
|
||
REDIS_PORT={your-redis-port}
|
||
CACHE_STORAGE_TYPE=redis
|
||
```
|
||
|
||
**הגירה סכמתית ונתונים**:
|
||
|
||
```
|
||
yarn database:migrate:prod
|
||
yarn command:prod upgrade-0.30
|
||
```
|
||
|
||
פקודת yarn database:migrate:prod תאיים את הגירות המבנה של בסיס הנתונים (סכמות ליבה ומטא נתונים)
|
||
פקודת yarn command:prod upgrade-0.30 תדאג להעברת נתונים של כל מרחבי העבודה.
|
||
|
||
### v0.23.0 ל-v0.24.0
|
||
|
||
שדרג את מופע ה-Twenty שלך לשימוש בתמונת v0.24.0
|
||
|
||
הרץ את הפקודות הבאות:
|
||
|
||
```
|
||
yarn database:migrate:prod
|
||
yarn command:prod upgrade-0.24
|
||
```
|
||
|
||
פקודת yarn database:migrate:prod תאיים את הגירות המבנה של בסיס הנתונים (סכמות ליבה ומטא נתונים)
|
||
פקודת 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
|
||
```
|
||
|
||
פקודת 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
|
||
```
|
||
|
||
פקודת yarn database:migrate:prod תאיים את הגירות המבנה של בסיס הנתונים.
|
||
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.
|
||
|
||
|
||
|
||
|