Skip to main content
Provereno na Izumi 0.5.7, 2026-11-21: ./tb upgrade uživo na probnom steku (Docker Desktop, Mac, arm64), a produkcija čitanjem. Nadogradnja je jedna komanda, ./tb upgrade <verzija>, koja prvo pravi backup, pa menja verziju. Ova stranica opisuje korake, izlazne kodove i put nazad.
Nije provereno uživo: nadogradnja na stvarno novije izdanje sa migracijom, izlazni kodovi 4, 5 i 6 i put nazad posle neuspeha. Pokrenuto uživo i prošlo: ./tb upgrade sa 0.5.7 na 0.5.8 (ista slika sa drugom oznakom, “migrations: nothing to apply”, svih sedam koraka, .env.bak-0.5.7, TB_IMAGE_TAG=0.5.8, /readyz 200), kao i izlaz 2 za pogrešnu verziju i za verziju koja već radi.

Pre nadogradnje

  • Pročitajte CHANGELOG.md novog izdanja. Svaki unos kaže “No migration” ili imenuje migraciju i kako se vraća. Na primer, 0.5.3 je imao jednu migraciju (0036_pending_clips.sql, samo nova funkcija), a većina izdanja 0.5.x nema nijednu.
  • Proverite da .env ima TB_BACKUP_KEY. Nadogradnja bez njega staje, jer prvo pravi backup.
  • Migracija može da zaključa tabelu: planirajte prozor. app, worker i backup su tokom nadogradnje ionako zaustavljeni.

Nadogradite

1

Stavite fajlove novog izdanja u direktorijum i napravite sliku

2

Proverite TB_BACKUP_KEY

Mora ispisati 1.
3

Pokrenite nadogradnju

./tb upgrade redom:
  1. Pravi backup (greška staje nadogradnju sa izlazom 4 i ništa ne menja).
  2. Koristi sliku ako postoji lokalno, inače pokušava docker compose pull (neuspeh staje sa izlazom 1).
  3. Zaustavlja app, worker i backup.
  4. Pokreće migrate sa novom slikom.
  5. Kopira env fajl u .env.bak-<stara verzija> i upisuje TB_IMAGE_TAG=<verzija>.
  6. Pokreće app, worker i backup.
  7. Čeka /readyz (TB_READY_WAIT sekundi, podrazumevano 120).
Na kraju ispisuje staru i novu verziju, fajl backupa i primenjene migracije.

Izlazni kodovi

Put nazad posle neuspeha

Posle izlaza 5 ili 6 (i posle greške pri upisu env fajla) ./tb upgrade ispisuje put nazad sa vašim putanjama. Pokrenite redove kako su ispisani:
  • Ispred restore stoji sudo: folderi sa backupom pripadaju root-u, a bez root-a ./tb restore ne vidi fajl i javlja da ne postoji. Zadržite TB_COMPOSE_PROJECT=... TB_ENV_FILE=... iz ispisanog reda posle sudo.
  • Dok vraćanje nije završeno, ./tb upgrade odbija da radi (izlaz 2) i ispisuje iste redove, jer bi novi backup držao napola migriranu bazu. To beleži u .env.upgrade-failed.
  • Ako je posle izlaza 6 nova verzija kasnije ipak postala spremna i zadržavate je, obrišite .env.upgrade-failed.
  • Detalji vraćanja: Backup i restore.

Ograničenja

  • Nadogradnja zaustavlja servis na vreme migracije.
  • Novu sliku ne pravi ./tb upgrade: pravite je vi (ili je povlači docker compose pull ako postoji u registru).
  • Put nazad je vraćanje iz backupa, ne obrnuta migracija.

Rešavanje problema