AiHummer
Аԥсшәа▾
Аиалаҵара
v1.0.x▾
v1.0.xstable
{ }Swagger
Аэксплуатациа/systemd насгьы агәабзиара агәаҭарақәа

systemd насгьы агәабзиара агәаҭарақәа

v1.0.x · ирҿыцуп 2026-06-26

AiHummer — host-native: уи иршеит аrelease tarball ҳасабла systemd аҵаҟа, контеинерқәа рҿы акәымкәа. Абри адаҟьа аҿы иарбоуп диск аҿы ишҟоу, ишагәаҭату агәабзиара, насгьы иарбан иблоктәу зегь ауаа рахьтә аалырԥшаанӡа.

Ишьҭара ахы & systemd аиҿартәырақәа

Зегь иҟоуп акы ишьҭара ахы аҵаҟа, /home/.aihummer, иршьашьоу bin/ etc/ share/ sidecars/ plugins/ systemd/ state/ data/ logs/ ала. The gateway аконфиг файл — /home/.aihummer/etc/gateway.env.

systemd аиҿартәыра файлқәа ишьҭара ахы аҵаҟа иааӡоит насгьы /etc/systemd/system/ ахь симлинкхоуп, убри аҟынтә the gateway насгьы sidecar-к зегьы маншәалоу аусурақәоуп, systemctl насгьы journalctl рыла иауршо, иаацарго, иабаро. Sidecar-к зегьы хазтәи аиҿартәыра аҵаҟа иршеит — ахәаԥш Sidecars.

Агәабзиареи аазырхиареи зондтә

The gateway ҩ-зондк хазхазтәи аарԥшуеит:

Зонд Эндпоинт Иаанаго
Аԥсра GET /healthz Апроцесс псуп; аверсиа иҭыхуеит
Аазырхиара GET /readyz PostgreSQL агәаҭоит; 503 иҭыхуеит абаза лаханахар

/healthz ихәархьа “апроцесс ыҟоума” рзы насгьы /readyz “аиҿцәажәара ауеима” рзы. Иарвырс прокси мамзар load balancer ашьҭахь, аазырхиара агәаҭара /readyz ахь иарбаа, убри аҟынтә абаза змам gateway аротациа аҟынтә ианхалоит.

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 — акы хьаас хадоу. Иауршо абаза ыҟамкәа the gateway деградациахаз агәабзиара-мацара аамҭа аҿы иауеит насгьы /readyz 503 аарԥшуеит.

Smoke test

Ишьҭара мамзар аиашьа ашьҭахь, бундлдоу smoke test иауршы адеплоимент аеихсыӡ-аихсыӡтәи иашоуп ҳәа агәаҭаразы:

deploy/host/smoke.sh

CLI ала аусурақәа реилазаара

The aihummer CLI — ашьҭыбжьахьтә аусурақәа рзы аԥхьатәи аашә — уи the gateway насгьы 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

Ахәаԥш CLI азгәаҭа адҵақәа зегьы рзы, уахьынтәгьы backup, restore, update насгьы uninstall.

Апродукциа аԥхьатәи чеклист

AiHummer аиашоу атрафик ахь иаарԥшааанӡа, абри ахьӡынҵа ала иуус:

  • Master key ишьҭ. Иҭ AIHUMMER_MASTER_KEY (base64, 32 баит) убри аҟынтә амаӡақәа авалт насгьы BYOK иршифрахоит.
  • Аусура авторизациа аиҿкаа. Иадҳәал OIDC, LDAP насгьы/мамзар SAML убри аҟынтә /v1/admin/* ихьчоуп. Авторизациа издатель ыҟамкәа админ аус девелопмент загаловокқәа ригәырҳалоит.
  • Иҭагалоу амаӡа ишьҭ. Иҭ AIHUMMER_INBOUND_SECRET убри аҟынтә аканалқәа /v1/inbound/* ахь авторизациахоит.
  • Ашәарҭоу аусхәырҩақәа реихсыӡ. Иршәырҭ мамзар иаҿыхы code_exec, иршәырҭ аеграсс, насгьы db_query иантабарга-мацара DSN ахь иарбаа.
  • TLS иарвырс прокси аҿы аанкыл. The gateway иршеит прокси ашьҭахь, уи HTTPS еилазаауеит; the gateway уаргьы иуа-имариоу HTTP аус ауеит.

[!WARNING] OIDC/LDAP/SAML издатель аиҿкаамкәа, админ API девелопмент загаловокқәа ригәырҳалара ахь ииасуеит. Уи ахаҭ ииашамоу аnetwork ахь иаамырԥшын — аусура авторизациа раԥхьа аиҿкаа.

Анаҩс аҿы