AiHummer
Türkmençe▾
GirmekŞahsy kabinet
v1.0.x▾
v1.2.xstablev1.1.xstablev1.0.xstable
{ }Swagger
Ulanyş/systemd we saglyk barlaglary

systemd we saglyk barlaglary

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

AiHummer myhman-oglan: ol çykarylan tarball görnüşinde işletilýär systemd, konteýnerlerde däl. Bu sahypa onuň diskte nirede ýaşaýandygyny, saglygyny nädip barlamaly we ulanyjylaryň öňüne goýmazdan ozal nämelerini gysgaltmalydygyny beýany edýär.

Root we systemd birliklerini gurnamak

Hemmesi bir gurnama kökiň aşagynda ýaşaýar, /home/.aihummer, ýaýran görnüşde bin/ etc/ share/ sidecars/ plugins/ systemd/ state/ data/ logs/. Gapynyň sazlama faýly /home/.aihummer/etc/gateway.env.

Systemd birliginiň faýllary gurnama köki aşagynda saklanylýar we symlink edildi /etc/systemd/system/, şonuň üçin gateway we her sidecar başlan, togtadylyp we barlanyp bilinýän adatky hyzmatlardyr systemctl we journalctl. Her bir sidecar öz birlikiniň aşagynda işleýär — gör Sidecarlar.

Saglyk we taýýarlyk barlaglary

Gapy iki tapawutly derwezäni öňe çykarýar:

Sazlama Uly nokat Meniň
Ýaşlyk GET /healthz Proses janly; wersiýasyny yzyna gaýtarýar
Taýarçylyk GET /readyz PostgreSQL-i barlaýar; yzyna gaýtarýar 503 eger DB işlemese

Ulanylýar /healthz “iş prosesi ýokarlanýarmy” üçin we /readyz “hakykatdanam bir hyzmat edip bilermi” üçin. Ters proksi ýa-da ýük paýlaýjy üçin, taýýarlyk barlagyny şu ýere gönükdiriň /readyz şonuň üçin maglumat bazasy bolmadyk gapy öwrülişden çykaryldy.

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 diňe bir çylşyrymly garaşylýan zatdyr. Elýeterli maglumatlar bazasyz geçelge diňe bozulan saglyk ýagdaýynda işleýär we /readyz 503 hasabat berýär.

Tutun synagy

Gurnanyňyzdan ýa-da täzeden täzeläniňizden soň, ýerleşdirişiň başdan başa dogry jogap berýändigini anyklamak üçin gurnalan çil-der testini işlediň:

deploy/host/smoke.sh

CLI bilen hyzmatlary dolandyrmak

Şu aihummer CLI gündelik operasiýalar üçin öňki gapydyr — ol ulag we gapgalar bilen meşgullanýar, sürüji däl systemctl el bilen:

aihummer up         # install / bring services up
aihummer restart    # restart the gateway
aihummer stop       # stop services
aihummer status     # show service status
aihummer logs --no-follow   # tail logs and exit (without the flag it follows; optionally: aihummer logs <unit>)
aihummer doctor     # run diagnostics

Gör CLI salgysy doly buýrug setiniň içinde, beýlekileri hem goşup backup, restore, update we uninstall.

Önümçilik uçuşyndan öňki barlag sanawy

AiHummer-i hakyky traffige açmazdan öň, şu sanawdan geçiň:

  • Baş açary goýuň. üpjün et AIHUMMER_MASTER_KEY (base64, 32 bait) şonuň üçin Gizlinlikler ammary we BYOK saklanyş wagtynda şifrlenen.
  • Korporatiw şahsyýetnamany sazlaň. OIDC, LDAP we/ýa-da SAML bilen birleşdiriň /v1/admin/* -dir goragly. Awtorizasiýa beriji bolmadyk ýagdaýynda administrasiýa ýüzüsi ösüş başlyklaryna ynanar.
  • Gelýän syrlygy goýuň. üpjün et AIHUMMER_INBOUND_SECRET şonuň üçin baglanyşyklary tassyklamak üçin /v1/inbound/*.
  • Howply gurallary berkidip goýuň. Çäklendirmek ýa-da öçürmek code_exec, çykmagy berkidiň, we kozger db_query okamak üçin diňe DSN-e.
  • TLS-i ters proksiýada bes ediň. Gapyny arkasynda proksi bolup işletdiň HTTPS-i dolandyrýar; geçelge özüniň açyk HTTP-ni berýär.

[!WARNING] OIDC/LDAP/SAML beriji sazlanmadyk ýagdaýynda, administrasiýa API-ga gaýtadan gaýdýar ösüş beýannamalaryna ynanmak. Muny ynam edilmeýän biriniň eline asla bermäň tor — ilki bilen kärhana ygtynama konfigurasiýa ediň.

Indi nire?