Uuenduspoliitika

v1.2.x · uuendatud 2026-08-04

Stabiilsus on tootepõhimõte, mitte järelemõtlemine. AiHummer järgib seda SemVer, kehtib edukindlad andmebaasi migratsioonid automaatselt, ja võib isevärskendus CDN-ist — nii on uuendused rutiinsed, mitte riskantsed.

Versioonihaldus (SemVer)

Väljaanded järgivad semantilist versioonimist. Versiooni teatatakse /healthz ja poolt aihummer version, nii et saate alati täpselt kinnitada, mis töötab enne ja pärast uuendust.

Migratsioonid on ettevaatlikud ja automaatsed

Käivitusel rakendab värav automaatselt ootel olevaid andmebaasi migratsioone. Kaks omadust hoiavad selle ohutuna:

Eesmine-turvaline. Migreeringud on kirjutatud nii, et uuem binaarfail töötab vastu skeemile, kuhu see migreerub, mis teeb automaatse rakendamise ja järjestikuste uuenduste ohutuks.
Ühe rakendaja kaudu nõustamislukku. Migratsioonid töötavad all PostgreSQL nõuandeline lukustus, nii et kui mitu väravat alustavad korraga, rakendab neid ainult üks ja ülejäänud ootavad — kunagi mitte topeltmigratsiooni.

[!NOTE] Migratsioonid toimuvad alati omaniku andmebaasi grupil. Piiratud RLS roll (AIHUMMER_DB_APP_URL) on mõeldud liikluse teenindamiseks, mitte skeemi muutmiseks.

Uuendamine

Uued versioonid tõmmatakse tarnija väljalasete CDN-ist. Tavapärane viis uuendada on üks käsk serveris:

aihummer update --check   # ainult teatada, kas uuem versioon on olemas
aihummer update           # laadida alla ja rakendada

--check ei kirjuta midagi ja seetõttu ei vaja root-õigusi. Rakendamine ise kirjutab paigalduse juurkataloogi ümber ja taaskäivitab teenuse, seega käivitatakse see sudo abil.

Oodatav tulemus: --check trükib praeguse ja saadaoleva versiooni ning lõpetab töö, midagi muutmata. aihummer update laadib artefakti alla, kontrollib selle sha256 kontrollsummat ja cosign-allkirja, vahetab binaari ning taaskäivitab teenuse — pärast seda näitab aihummer version uut versiooni. Kui kontroll ei klapi, katkeb uuendus enne faili vahetamist: töötav versioon jääb puutumata.

[!NOTE] Automaatse uuendamise lülitab sisse tarnija, mitte teie. Automaatse uuendamise režiim ja ajakava kuuluvad väljalaske hooldusesse ning määratakse tarnija allkirjastatud korraldusega. Vastavaid lüliteid ei ole ei veebiliideses ega aihummer settings all, ja gateway.env faili kirjutatud automaatse uuendamise muutujaid värav ei loe — kui te neid seal näete, ei mõjuta need midagi. Oma ajakava järgi uuendamiseks kasutage ülaltoodud käsku aihummer update.

Tagasipööramine

Mida saab tagasi pöörata — punkt haaval:

Binaar — saab tagastada eelmisele versioonile (varasemate väljalasete artefaktid jäävad CDN-i; paigaldage vajalik versioon uuesti).
Andmebaasi skeem — migratsioonid on edasisuunas turvalised, seega eelmine binaar töötab uuema skeemiga; eraldi skeemi tagasipööramist ei ole.
Pluginad — versioone hallatakse iga paigalduse kohta eraldi; vajaduse korral taastage plugina eelmine versioon kataloogist.
Seadistus — uuendus seda ei muuda; vajaduse korral taastatakse varukoopiast.

Nullseisakuga juurutused

AiHummer on loodud uuendamiseks ilma seisakuta:

Käivita 2+ väravat proksimise taga. Veeretage neid ükshaaval; valmisolekuuuring (/readyz) hoiab taaskäivituvat sõlme rotatsioonist välja, kuni see teenindab.
Ajastaja on ühejuhtimeline. Taustaprogrammide ajastamine valib ühe juhi PostgreSQL nõuandva lukustuse kaudu, nii et mitme värava käivitamine ei dubleeri plaaniline töö
Tarne on idempotentne. Usaldusväärne kohaletoimetamine ja idempotentsuse võtmed tähendavad vastust ei saadeta kunagi kaks korda pärast taaskäivitust, mis on see, mis muudab selle kerivaks taaskäivitage oma väravate kaudu turvaliselt.

Kuhu järgmine

Katsetused, mis juhivad järjestikust taaskäivitust: systemd ja tervisekontrollid.
Varundage enne suurt uuendust: Varukoopiad ja katastroofi taastamine.
Vaadake juurutamist: Jälgitavus.