AiHummer
Türkmençe▾
Gir
v1.0.x▾
v1.0.xstable
{ }Swagger
Ulanyş/systemd & saglyk barlaglary

systemd & saglyk barlaglary

v1.0.x · täzelendi 2026-06-26

AiHummer host-native-dir: ol konteýnerlerde däl-de, systemd astynda işleýän çykarylyş tarbol hökmünde ýerleşdirilýär. Bu sahypa onuň diskde nirede ýaşaýandygyny, saglygyny nädip barlamalydygyny we ony ulanyjylaryň öňünde goýmazdan öň nämäni gulplamalydygyny öz içine alýar.

Gurnama köki & systemd birlikleri

Hemme zat ýeke-täk gurnama köküniň, /home/.aihummer-iň astynda ýaşaýar, bin/ etc/ share/ sidecars/ plugins/ systemd/ state/ data/ logs/ görnüşinde ýerleşdirilen. Geýtweý konfig faýly /home/.aihummer/etc/gateway.env.

systemd birlik faýllary gurnama köküniň astynda saklanýar we /etc/systemd/system/-e simwoliki baglanyşdyrylýar, şeýdip geýtweý we her sidecar systemctl we journalctl bilen başladyp, saklap we gözden geçirip boljak adaty hyzmatlardyr. Her sidecar öz birligi astynda işleýär — Sidecars-a serediň.

Saglyk & taýýarlyk probalary

Geýtweý iki tapawutly proba açýar:

Proba Endpoint Manysy
Janlylyk GET /healthz Proses janly; wersiýany gaýtarýar
Taýýarlyk GET /readyz PostgreSQL-i barlaýar; DB işlemän bolsa 503 gaýtarýar

“Proses işleýärmi” üçin /healthz-i we “ol hakykatdanam gezegi hyzmat edip bilermi” üçin /readyz-i ulanyň. Tersine proksiniň ýa-da ýük deňagramlaýjynyň aňyrsynda, taýýarlyk barlagyny /readyz-e ugrukdyryň, şeýdip maglumatlar bazasy ýok geýtweý rotasiýadan çykarylýar.

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 ýeke-täk gaty garaşlylykdyr. Ýetip bolýan maglumatlar bazasy bolmasa geýtweý peseldilen diňe-saglyk režiminde işleýär we /readyz 503 habar berýär.

Smoke testi

Gurnamadan ýa-da täzelenişden soň, ýerleşdirmäniň ujundan-uja dogry jogap berýändigini tassyklamak üçin jemlenen smoke testini işlediň:

deploy/host/smoke.sh

Hyzmatlary CLI bilen dolandyrmak

aihummer CLI gündelik operasiýalaryň öň gapysydyr — ol systemctl-i el bilen sürmegiň ýerine geýtweýi we sidecarlary dolandyrýar:

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 we uninstall goşmak bilen doly buýruk toplumy üçin CLI salgylanmasyna serediň.

Önümçilik öň-uçuş kontrol-spisogy

AiHummer-i hakyky trafige açmazdan öň, bu spisogyň üstünde işläň:

  • Master açary belläň. AIHUMMER_MASTER_KEY (base64, 32 baýt) beriň, şeýdip syrlar ammary we BYOK dynç ýagdaýda şifrlenýär.
  • Kärhana awtentifikasiýasyny düzüň. OIDC, LDAP we/ýa-da SAML-y birikdiriň, şeýdip /v1/admin/* goralýar. Awtentifikasiýa beriji bolmasa admin üsti ösüş header-lerine ynanýar.
  • Gelýän syry belläň. AIHUMMER_INBOUND_SECRET beriň, şeýdip konnektorlar /v1/inbound/*-e awtentifikasiýa edýär.
  • Howply gurallary gulplaň. code_exec-i çäklendiriň ýa-da öçüriň, egress-i berkidiň we db_query-i diňe-okalýan DSN-e gerimläň.
  • TLS-i tersine prokside tamamlaň. Geýtweýi HTTPS-i işleýän proksiniň aňyrsynda işlediň; geýtweýiň özi ýönekeý HTTP hyzmat edýär.

[!WARNING] OIDC/LDAP/SAML beriji düzülmedik bolsa, admin API ösüş header-lerine ynanmaga gaýdyp gelýär. Beýle instansy hiç haçan ynamsyz tora açmaň — ilki kärhana awtentifikasiýasyny düzüň.

Indiki nirä