Jaunināšana bez dīkstāves

Noteikumi ir docs/architecture/23-ops.md 7. sadaļā un docs/architecture/07-data.md 4.1. sadaļā. Šī ir kārtība.

Garantija, kas to padara drošu

Versija R darbojas pareizi pret shēmu R un shēmu R mīnus viens. Katra shēmas izmaiņa ir sadalīta paplašinājumā, pārejā un sašaurinājumā:

1. Paplašinājums: pievieno jaunu kolonnu, tabulu vai indeksu. Vecais kods to ignorē.
2. Pāreja vismaz vienu versiju: jaunais kods raksta abas formas un lasa jauno; atsākams darbs aizpilda vecās rindas.
3. Sašaurinājums: izmet veco formu vēlākā versijā, atsevišķi.

Tāpēc katrā plūstoša jauninājuma brīdī vecie un jaunie procesi var dalīties ar vienu datubāzi. Atgriešanas migrāciju nav: migrācija, kas pirms stundas nometa kolonnu, nevar atdot rindas, kas tajā stundā tika ierakstītas.

CI darbs schema-compat pārbauda garantiju katrai versijai, palaist iepriekšējās versijas testus pret jauno shēmu.

Pirms sākat

1. Izlasiet piezīmes par versiju. Versija, kurai vajadīgs uzturēšanas logs, to norāda ar prognozi; ne vairāk kā viena uz versiju.
2. Palaidiet atjaunošanas mācību vai apstipriniet, ka tā šai versijai izdevās zaļa (backup-restore.md). Neizdevusies mācība bloķē jaunināšanu.
3. Ņemiet bāzes dublējumu: docker compose -f docker/compose.yaml --profile backup run --rm backup.

Docker Compose, viens serveris

export QUIRE_RELEASE=2026.10.0            # or set it in docker/.env
docker compose -f docker/compose.yaml pull   # or build
docker compose -f docker/compose.yaml run --rm migrate
docker compose -f docker/compose.yaml up -d --no-deps web content collab
docker compose -f docker/compose.yaml up -d --no-deps worker scheduler

Secība ir apzināta:

1. Vispirms migrē, kamēr vecā versija apkalpo trafiku. Paplašinājuma migrācijas tai ir neredzamas.
2. Pēc tam tīmekļa slānis. Saņemot SIGTERM, katra web procesa /readyz pārslēdzas uz draining, 30 sekunžu laikā pabeidz pārtrauktos pieprasījumus, aizver straumes ar atkārtotas savienošanās mājienu un iziet. stop_grace_period ir 40 sekundes, lai Compose nekad nepārtrauktu veselīgu iztukšošanu.
3. Visbeidzot Workers, lai jaunākā notikuma forma tiktu izveidota pirms jaunākā patērētāja to gaida. Workers uzreiz pārstāj vilkt un saņem 120 sekundes; darbs, ko nevar pabeigt, tiek atkal vilkts citur, kas ir droši, jo katrs darbs ir idempotents. Plānotājs vadību nodod nākamajā tiksē.

Uz viena servera Compose aizvieto katru konteineru pēc kārtas, tāpēc katram pakalpojumam ir īss pārtraukums. Lai pārtraukuma nebūtu vispār, palaidiet tīmekļa slāni kā divus konteinerus aiz sava starpniekservera (pārklājuma fails, kas pievieno otro web pakalpojumu bez publicēta porta) un izveidojiet tos pa vienam, gaidot, kamēr katrs ziņo par veselību, pirms sākat nākamo.

Vairāki serveri vai orķestrators

Izmantojiet to pašu secību: migrējiet vienreiz no viena darba, pēc tam velciet tīmekļa slāni ar surge one un unavailable zero, pēc tam darbinīkus. Gatavības probe norādiet uz /readyz, bet dzīvotnes probe — uz /healthz.

Ar atsevišķām nomnieku datubāzēm solis migrate dara abus: vispirms migrē kontroldatubāzi, pēc katru datubāzi, kas uzskaitīta ops.tenant_database, pa vienai, katra zem sava slēdzenes. Kļūda vienā nomnieku datubāzē neaptur pārējās. Kad katra datubāze ir gatava, tā salīdzina migrāciju žurnālus un iziet ar nenulles kodu, ja vien katra datubāze nav piemērojusi tieši tās pašas migrācijas, ko kontroldatubāze, nosaucot katru, kas atpaliek vai ir priekšā. Tā pati komanda katrā datubāzē uzstāda rindu tabulas, jo darbinīks patērē piesaistītā nomnieka darbus tur, kur tie tika ierakstīti.

bun apps/worker/src/migrate.ts   # what the Compose step runs
bun run db:migrate:all                            # the same, from a checkout

Katru atsevišķo datubāzi sasniedz caur nosaukumu, zem kura tā ir reģistrēta. Datubāze, kas reģistrēta kā env:QUIRE_DB_NORTHWIND_URL, vajag:

Reģistrēta datubāze bez _MIGRATOR savienojuma tiek ziņota kā kļūda, nekad netiek izlaista. Tīmekļa slāni var sākt velt, tiklīdz kontroldatubāze ir gatava. Nomnieku datubāze, kas stundu atpaliek, brīdina; dienu atpaliekot — izsauc.

pgvector

No migrācijas 0264 pamatojuma korpuss izmanto pgvector HNSW indeksu, ja serverī ir paplašinājums; Compose postgres pakalpojums ir uzbūvēts ar to (docker/postgres.Dockerfile). Pirmā migrate pēc attēlu maiņas izveido paplašinājumu caur superlietotāja sagatavošanu, un pēc tam 0264 pievieno ģenerētu vektoru kolonnu un uzbūvē indeksu. Kolonnas pievienošana reizi pārraksta app.ai_chunk zem ekskluzīvas slēdzenes, tāpēc pamatojuma pieprasījumi to gaida; nekas cits šo tabulu neaiztiec.

Serverī bez pgvector 0264 reģistrē paziņojumu un neko nemaina, un meklēšana paliek precīza. Ar pgvector, kas vecāks par 0.8, kolonna un indekss tiek uzbūvēti, bet meklēšana paliek precīza, līdz paplašinājums tiek jaunināts (alter extension vector update), jo filtrētiem HNSW skenējumiem vajag 0.8 iteratīvos skenējumus. Lai to vēlāk ieslēgtu serverī, kurā tā nav, uzstādiet paplašinājumu, vēlreiz palaidiet sagatavošanu (vai create extension vector kā superlietotājs), pēc tam kā quire_migrator:

set maintenance_work_mem = '1GB';  -- the HNSW build is much faster in memory
select ops.ai_chunk_enable_vector_index();

Tā ir idempota un atgriež enabled vai unavailable. Palaidiet to arī katrā atsevišķajā nomnieku datubāzē.

Atgriešana

Atgriešana ar kodu vienmēr ir pieejama: iestatiet QUIRE_RELEASE uz iepriekšējo birku un vēlreiz up -d. Tas darbojas, jo shēma versijas robežās abi virzieni ir saderīga.

Atgriešana ar shēmu netiek piedāvāta. Kas nevar tikt atsaukts un kā no tā atgūties:

Tāpēc sašaurinājuma migrācija nāk atsevišķi: atjaunošanai tad ir tīra robeža.

Jauninājuma pārbaude

docker compose -f docker/compose.yaml ps           # every service healthy
curl -fsS http://localhost:8080/readyz             # ready, and what is configured
docker compose -f docker/compose.yaml logs migrate # the migrations applied