./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.
Pre nadogradnje
- Pročitajte
CHANGELOG.mdnovog 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
.envimaTB_BACKUP_KEY. Nadogradnja bez njega staje, jer prvo pravi backup. - Migracija može da zaključa tabelu: planirajte prozor.
app,workeribackupsu tokom nadogradnje ionako zaustavljeni.
Nadogradite
1
Stavite fajlove novog izdanja u direktorijum i napravite sliku
2
Proverite TB_BACKUP_KEY
3
Pokrenite nadogradnju
./tb upgrade redom:
- Pravi backup (greška staje nadogradnju sa izlazom 4 i ništa ne menja).
- Koristi sliku ako postoji lokalno, inače pokušava
docker compose pull(neuspeh staje sa izlazom 1). - Zaustavlja
app,workeribackup. - Pokreće
migratesa novom slikom. - Kopira env fajl u
.env.bak-<stara verzija>i upisujeTB_IMAGE_TAG=<verzija>. - Pokreće
app,workeribackup. - Čeka
/readyz(TB_READY_WAITsekundi, podrazumevano 120).
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
restorestojisudo: folderi sa backupom pripadaju root-u, a bez root-a./tb restorene vidi fajl i javlja da ne postoji. ZadržiteTB_COMPOSE_PROJECT=... TB_ENV_FILE=...iz ispisanog reda poslesudo. - Dok vraćanje nije završeno,
./tb upgradeodbija 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čidocker compose pullako postoji u registru). - Put nazad je vraćanje iz backupa, ne obrnuta migracija.