Истифодабарӣ / Сиёсати навсозӣ
Сиёсати навсозӣ v1.0.x · навсозӣ шуд 2026-08-04 ⧉ Нусхабардорӣ ҳамчун Markdown ✓ Нусхабардорӣ шуд
Пойдорӣ принсипи маҳсулот аст, на фикре пас аз он. AiHummer пайравӣ мекунад Намуди Ниқобӣ Версия , татбиқ мешавад гузаришҳои бехатари пойгоҳи додаҳоро ба таври худкор , ва метавонад худнавсозӣ аз CDN — бинобар ин навсозӣҳо одатананд ва на хатарнок.
Нусхаҳо (SemVer)
Нашрияҳо ба Версияи Семантикӣ мувофиқат мекунанд. Версия аз ҷониби /healthz ва бо aihummer versionпас шумо ҳамеша метавонед дақиқ тасдиқ кунед, ки чӣ пеш аз навсозӣ ва пас аз он идома дорад.
Муҳоҷират бехатар ва худкор аст
Дар оғози кор, дарвоза ба таври худкор гузаришҳои пойгоҳи додаҳои мунтазирро татбиқ мекунад. Ду хусусият инро бехатар нигоҳ медоранд:
Пешпардохт-беопас. Муҳлатгузориҳо чунин навишта мешаванд, ки бинарии нав бар зидди
шемае, ки он ба он муҳоҷират мекунад, ки ҳамин чиз аст, ки татбиқи худкор ва навсозии пайваста бехатарро таъмин мекунад.
Фармоишгар якка тавассути қулфи машваратӣ. Муҳоҷиратҳо таҳти як PostgreSQL
қулфи машваратӣ пас вақте чанд роҳвози гуногун ҳамзамон оғоз мешаванд, танҳо яке аз онҳо татбиқ мешавад
ва боқимонда интизор мешаванд — ҳеҷ гоҳ муҳоҷират дукарата нест.
[!NOTE]
Ҷойивазкуниҳо ҳамеша дар ҳавзаи додаҳои соҳиб иҷро мешаванд. Нақши маҳдудшудаи RLS
(AIHUMMER_DB_APP_URL) барои хизматрасонии трафик аст, на барои тағйироти схема.
Навсозӣ
Версияҳои нав аз CDN-и релизии вендор гирифта мешаванд. Роҳи муқаррарии навсозӣ —
як фармон дар сервер:
aihummer update --check # танҳо хабар медиҳад, ки оё версияи навтар ҳаст
aihummer update # зеркашӣ ва татбиқ мекунад
--check чизеро тағйир намедиҳад ва барои ҳамин root талаб намекунад . Худи
татбиқ решаи насбшударо иваз мекунад ва хидматро бозоғоз мекунад, бинобар ин
тавассути sudo иҷро мешавад.
Натиҷаи интизорӣ: --check версияи ҷорӣ ва версияи дастрасро чоп мекунад ва
бе ягон тағйирот ба анҷом мерасад. aihummer update артефактро зеркашӣ мекунад,
маблағи назоратии sha256 ва имзои cosign-и онро месанҷад, файли бинариро иваз
мекунад ва хидматро бозоғоз мекунад — пас аз он aihummer version версияи навро
нишон медиҳад. Агар санҷиш нашуда бошад, навсозӣ пеш аз ивази файл қатъ
мешавад: версияи корӣ дастнорас мемонад.
[!NOTE]
Навсозии худкорро вендор фаъол мекунад, на шумо. Реҷа ва ҷадвали навсозии
худкор ба хизматрасонии нашр дохиланд ва бо дастури имзошудаи вендор муайян
карда мешаванд. Калидҳои дахлдор на дар веб-интерфейс ҳастанд, на дар
aihummer settings; тағйирёбандаҳои навсозии худкор, ки дар gateway.env
навишта шудаанд, аз ҷониби дарвоза хонда намешаванд — агар шумо онҳоро дар
он ҷо бинед, онҳо ба чизе таъсир намерасонанд. Барои навсозӣ аз рӯи ҷадвали
худ фармони боло aihummer update-ро истифода баред.
Бозгашт
Чӣ ба ҳолати пештара бармегардад — алоҳида-алоҳида:
Файли бинарӣ — метавон ба версияи пештара баргардонд (артефактҳои нашрҳои
пештара дар CDN мемонанд; версияи лозимиро дубора насб кунед).
Схемаи пойгоҳи додаҳо — муҳоҷиратҳо пешрави бехатаранд, бинобар ин файли
бинарии пештара бо схемаи нав кор мекунад; бозгашти алоҳидаи схема нест.
Плагинҳо — версияҳо барои ҳар насб алоҳида идора мешаванд; дар сурати
зарурат версияи пештараи плагинро аз каталог баргардонед.
Танзимот — ҳангоми навсозӣ тағйир намеёбад; дар сурати зарурат аз нусхаи
эҳтиётӣ барқарор карда мешавад.
Насбҳо бо сифр вақти хомӯшӣ
AiHummer барои навсозӣ без аз кор мондани система сохта шудааст:
Ду ё зиёда дарвозаро пас аз прокси идора кунед. Онҳоро як ба як печонед; санҷиши омодагӣ
(/readyz) як нодро то он даме ки хизмат расонад, аз гардиш хориҷ нигоҳ медорад.
Тақвимсоз як раҳбар дорад. Барномаҳои замина як раҳбари ягона интихоб мекунанд
тавассути қулфи машваратии PostgreSQL, бинобар ин иҷрои якчанд дарвоза нусхабардорӣ намекунад
корҳои барномарезишуда
Таҳвил такроршаванда аст. Расонидани боэътимод бо калидҳои идемпотентӣ маънои онро дорад
Ҷавоб ҳеҷ гоҳ ду маротиба пас аз аз нав оғоз кардан фиристода намешавад, ки ин чиз аст, ки онро болораванда месозад
Аз нав оғоз кунед тавассути дарвозаҳои худ ба таври бехатар.
Баъд ба куҷо
← Қаблӣ
Нусхаҳои эҳтиётӣ ва барқарорсозии офат
Баъдӣ →
Намояндагӣ
Пойдорӣ принсипи маҳсулот аст, на фикре пас аз он. AiHummer пайравӣ мекунад **Намуди Ниқобӣ Версия**, татбиқ мешавад **гузаришҳои бехатари пойгоҳи додаҳоро ба таври худкор**, ва метавонад **худнавсозӣ** аз CDN — бинобар ин навсозӣҳо одатананд ва на хатарнок.
## Нусхаҳо (SemVer)
Нашрияҳо ба Версияи Семантикӣ мувофиқат мекунанд. Версия аз ҷониби `/healthz` ва бо `aihummer version`пас шумо ҳамеша метавонед дақиқ тасдиқ кунед, ки чӣ пеш аз навсозӣ ва пас аз он идома дорад.
## Муҳоҷират бехатар ва худкор аст
Дар оғози кор, дарвоза ба таври худкор гузаришҳои пойгоҳи додаҳои мунтазирро татбиқ мекунад. Ду хусусият инро бехатар нигоҳ медоранд:
- **Пешпардохт-беопас.** Муҳлатгузориҳо чунин навишта мешаванд, ки бинарии нав бар зидди
шемае, ки он ба он муҳоҷират мекунад, ки ҳамин чиз аст, ки татбиқи худкор ва навсозии пайваста бехатарро таъмин мекунад.
- **Фармоишгар якка тавассути қулфи машваратӣ.** Муҳоҷиратҳо таҳти як **PostgreSQL
қулфи машваратӣ**пас вақте чанд роҳвози гуногун ҳамзамон оғоз мешаванд, танҳо яке аз онҳо татбиқ мешавад
ва боқимонда интизор мешаванд — ҳеҷ гоҳ муҳоҷират дукарата нест.
> [!NOTE]
> Ҷойивазкуниҳо ҳамеша дар ҳавзаи додаҳои соҳиб иҷро мешаванд. Нақши маҳдудшудаи RLS
> (`AIHUMMER_DB_APP_URL`) барои хизматрасонии трафик аст, на барои тағйироти схема.
## Навсозӣ
Версияҳои нав аз CDN-и релизии вендор гирифта мешаванд. Роҳи муқаррарии навсозӣ —
як фармон дар сервер:
```bash
aihummer update --check # танҳо хабар медиҳад, ки оё версияи навтар ҳаст
aihummer update # зеркашӣ ва татбиқ мекунад
```
`--check` чизеро тағйир намедиҳад ва барои ҳамин **root талаб намекунад**. Худи
татбиқ решаи насбшударо иваз мекунад ва хидматро бозоғоз мекунад, бинобар ин
тавассути `sudo` иҷро мешавад.
**Натиҷаи интизорӣ:** `--check` версияи ҷорӣ ва версияи дастрасро чоп мекунад ва
бе ягон тағйирот ба анҷом мерасад. `aihummer update` артефактро зеркашӣ мекунад,
маблағи назоратии sha256 ва имзои cosign-и онро месанҷад, файли бинариро иваз
мекунад ва хидматро бозоғоз мекунад — пас аз он `aihummer version` версияи навро
нишон медиҳад. Агар санҷиш нашуда бошад, навсозӣ **пеш аз** ивази файл қатъ
мешавад: версияи корӣ дастнорас мемонад.
> [!NOTE]
> **Навсозии худкорро вендор фаъол мекунад, на шумо.** Реҷа ва ҷадвали навсозии
> худкор ба хизматрасонии нашр дохиланд ва бо дастури имзошудаи вендор муайян
> карда мешаванд. Калидҳои дахлдор на дар веб-интерфейс ҳастанд, на дар
> `aihummer settings`; тағйирёбандаҳои навсозии худкор, ки дар `gateway.env`
> навишта шудаанд, аз ҷониби дарвоза **хонда намешаванд** — агар шумо онҳоро дар
> он ҷо бинед, онҳо ба чизе таъсир намерасонанд. Барои навсозӣ аз рӯи ҷадвали
> худ фармони боло `aihummer update`-ро истифода баред.
### Бозгашт
Чӣ ба ҳолати пештара бармегардад — алоҳида-алоҳида:
- **Файли бинарӣ** — метавон ба версияи пештара баргардонд (артефактҳои нашрҳои
пештара дар CDN мемонанд; версияи лозимиро дубора насб кунед).
- **Схемаи пойгоҳи додаҳо** — муҳоҷиратҳо пешрави бехатаранд, бинобар ин файли
бинарии пештара бо схемаи нав кор мекунад; бозгашти алоҳидаи схема нест.
- **Плагинҳо** — версияҳо барои ҳар насб алоҳида идора мешаванд; дар сурати
зарурат версияи пештараи плагинро аз каталог баргардонед.
- **Танзимот** — ҳангоми навсозӣ тағйир намеёбад; дар сурати зарурат аз нусхаи
эҳтиётӣ барқарор карда мешавад.
## Насбҳо бо сифр вақти хомӯшӣ
AiHummer барои навсозӣ без аз кор мондани система сохта шудааст:
- **Ду ё зиёда дарвозаро пас аз прокси идора кунед.** Онҳоро як ба як печонед; санҷиши омодагӣ
(`/readyz`) як нодро то он даме ки хизмат расонад, аз гардиш хориҷ нигоҳ медорад.
- **Тақвимсоз як раҳбар дорад.** Барномаҳои замина як раҳбари ягона интихоб мекунанд
тавассути қулфи машваратии PostgreSQL, бинобар ин иҷрои якчанд дарвоза нусхабардорӣ намекунад
корҳои барномарезишуда
- **Таҳвил такроршаванда аст.** Расонидани боэътимод бо калидҳои идемпотентӣ маънои онро дорад
Ҷавоб ҳеҷ гоҳ ду маротиба пас аз аз нав оғоз кардан фиристода намешавад, ки ин чиз аст, ки онро болораванда месозад
Аз нав оғоз кунед тавассути дарвозаҳои худ ба таври бехатар.
## Баъд ба куҷо
- Пробаҳо, ки оғоз кардани бозгаштро тавассути қулф пешниҳод мекунанд:
[systemd ва санҷишҳои саломатӣ](/tg/v1.0/operations/systemd-health).
- Пеш аз навсозии асосӣ эҳтиётӣ нусхабардорӣ кунед:
[Нусхаҳои эҳтиётӣ ва барқарорсозии офат](/tg/v1.0/operations/backups-dr).
- Назари ба баровардан:
[Намояндагӣ](/tg/v1.0/operations/observability).