AiHummer
Тоҷикӣ▾
Даромадан
v1.0.x▾
v1.0.xstable
{ }Swagger
Истифодабарӣ/systemd ва санҷишҳои саломатӣ

systemd ва санҷишҳои саломатӣ

v1.0.x · навсозӣ шуд 2026-06-26

AiHummer мизбон-нативӣ аст: он ҳамчун як архиви релизи tarball, ки дар зери systemd кор мекунад, ҷойгир мешавад, на дар контейнерҳо. Ин саҳифа фаро мегирад, ки он дар диск дар куҷо қарор дорад, чӣ гуна саломатии онро санҷидан ва чиро пеш аз он ки онро дар назди корбарон гузоред, бояд маҳкам кард.

Решаи насб ва воҳидҳои systemd

Ҳама чиз дар зери як решаи ягонаи насб, /home/.aihummer, ҷойгир аст, ки ба bin/ etc/ share/ sidecars/ plugins/ systemd/ state/ data/ logs/ тақсим шудааст. Файли конфигуратсияи шлюз /home/.aihummer/etc/gateway.env аст.

Файлҳои воҳиди systemd дар зери решаи насб нигоҳ дошта мешаванд ва ба /etc/systemd/system/ симлинк карда мешаванд, бинобар ин шлюз ва ҳар sidecar хидматҳои оддие мебошанд, ки шумо метавонед бо systemctl ва journalctl оғоз кунед, манъ кунед ва тафтиш кунед. Ҳар sidecar дар зери воҳиди худаш кор мекунад — ба Sidecar-ҳо нигаред.

Зондҳои саломатӣ ва омодагӣ

Шлюз ду зонди алоҳидаро намоиш медиҳад:

Зонд Нуқтаи интиҳоӣ Маъно
Зиндагӣ GET /healthz Раванд зинда аст; версияро бармегардонад
Омодагӣ GET /readyz PostgreSQL-ро тафтиш мекунад; 503 бармегардонад агар пойгоҳи додаҳо хомӯш бошад

/healthz-ро барои “оё раванд кор мекунад” ва /readyz-ро барои “оё он воқеан метавонад як даврро хидмат кунад” истифода баред. Дар паси проксии баръакс ё мувозинатсози бор, санҷиши омодагиро ба /readyz равона кунед, то шлюзе, ки пойгоҳи додаҳо надорад, аз гардиш бароварда шавад.

curl -fsS http://127.0.0.1:8780/healthz   # 200 + version
curl -fsS http://127.0.0.1:8780/readyz    # 200 ready, 503 if Postgres is unreachable

[!NOTE] PostgreSQL ягона вобастагии сахт аст. Бе пойгоҳи додаҳои дастрас шлюз дар реҷаи кам шудаи танҳо-саломатӣ кор мекунад ва /readyz 503 хабар медиҳад.

Санҷиши smoke

Пас аз насб ё навсозӣ, санҷиши smoke-и ҳамроҳбударо иҷро кунед, то тасдиқ кунед, ки ҷойгиркунӣ аз ибтидо то интиҳо дуруст ҷавоб медиҳад:

deploy/host/smoke.sh

Идоракунии хидматҳо бо CLI

CLI-и aihummer дари асосӣ барои амалиётҳои ҳаррӯза аст — он шлюз ва sidecar-ҳоро идора мекунад, на ин ки systemctl-ро бо даст идора кунад:

aihummer up         # install / bring services up
aihummer restart    # restart the gateway
aihummer stop       # stop services
aihummer status     # show service status
aihummer logs       # tail logs (optionally: aihummer logs <svc>)
aihummer doctor     # run diagnostics

Барои маҷмӯи пурраи фармонҳо, аз ҷумла backup, restore, update ва uninstall, ба Маълумотномаи CLI нигаред.

Рӯйхати санҷиши пеш аз парвоз дар истеҳсолот

Пеш аз он ки AiHummer-ро ба трафики воқеӣ кушоед, аз ин рӯйхат гузаред:

  • Калиди асосиро танзим кунед. AIHUMMER_MASTER_KEY-ро (base64, 32 байт) пешниҳод кунед, то ҳазинаи махфиятҳо ва BYOK дар ҳолати истироҳат рамзгузорӣ шаванд.
  • Аутентификатсияи корхонавиро танзим кунед. OIDC, LDAP ва/ё SAML-ро симкашӣ кунед, то /v1/admin/* муҳофизат карда шавад. Бе як содиркунандаи аутентификатсия рӯи маъмурӣ ба сарлавҳаҳои таҳия эътимод мекунад.
  • Махфияти даромадиро танзим кунед. AIHUMMER_INBOUND_SECRET-ро пешниҳод кунед, то пайвасткунандаҳо ба /v1/inbound/* аутентификатсия шаванд.
  • Абзорҳои хатарнокро маҳкам кунед. code_exec-ро маҳдуд ё ғайрифаъол кунед, баромадро (egress) сахттар кунед ва db_query-ро ба як DSN-и танҳо-хониш доирабандӣ кунед.
  • TLS-ро дар проксии баръакс хотима диҳед. Шлюзро дар паси проксие, ки HTTPS-ро коркард мекунад, иҷро кунед; худи шлюз HTTP-и оддиро хидмат мекунад.

[!WARNING] Бе як содиркунандаи OIDC/LDAP/SAML-и танзимшуда, API-и маъмурӣ ба эътимод ба сарлавҳаҳои таҳия бармегардад. Ҳаргиз чунин нусхаро ба як шабакаи беэътимод накушоед — аввал аутентификатсияи корхонавиро танзим кунед.

Минбаъд ба куҷо