CLI Salgylanmasy

aihummer buýruk-setir guraly host-natiwe gurnamany dolandyrýar: ol gateway-i işe girizýär we täzeleýär (gurnamanyň özi şahsy kabinetiňizdäki şahsy gurnama baglanyşygy arkaly amala aşyrylýar), gateway systemd hyzmatyny dolandyrýar, diagnostika işledýär, ätiýaçlyk nusgalary bilen işleýär, control-plane sazlamalaryny okaýar we ýazýar, we ygtyýarnamalara gol çekýär. Bu sahypa her buýrugy sanaýar.

Buýruklar

Buýruk	Ol näme edýär
`up` / `install`	Gateway systemd hyzmatyny başlatmak (`systemctl start`). Ol hiç zat gurnamaýar — gurnama şahsy baglanyşygyňyzdaky gurnama skripti tarapyndan edilýär.
`update [--check]`	Iň soňky çykuşa täzelemek (gol barlamak + binary çalyşmak + gaýtadan başlatmak); `--check` diňe täzelemäniň bardygyny hasabat berýär.
`restart`	Gateway hyzmatyny gaýtadan başlatmak (`systemctl restart`).
`stop`	Gateway hyzmatyny saklamak (`systemctl stop`).
`logs [birlik]`	Bir systemd birliginiň žurnalyny yzarlamak (`journalctl -u`); deslapky ýagdaýda gateway birligi.
`status`	Gateway-iň taýýarlygyny soramak (`/readyz`).
`doctor`	Diagnostika işletmek (hyzmat işjeňmi + gateway taýýarmy).
`backup [kat]`	PostgreSQL ýagdaý gatlagyny `pg_dump` bilen faýla çykarmak; berilmese deslapky katalog ulanylýar.
`restore <faýl>`	PostgreSQL-i `backup` tarapyndan döredilen dump faýlyndan dikeltmek.
`uninstall [baýdaklar]`	Gurnamany aýyrmak (aşakdaky baýdaklara serediň). Root talap edýär — ony `sudo` bilen işlediň.
`set-password` / `admin-password`	Ýerli admin parolyny bellemek/döretmek (`[--login admin] [--password X]`).
`settings {set\|get\|list}`	Control-plane sazlamalaryny maglumat bazasynda okamak/ýazmak — Sazlamalar-katalog düwmeleri `gateway.env`-iň ýerine CLI-den şeýle sazlanýar.
`license {keygen\|sign\|show <token>}`	Ygtyýarnamalary dolandyrmak: açar döretmek, gol çekmek, berlen tokeni deşifrläp barlamak.
`loadtest`	Gateway-e garşy ýük synagyny işletmek.
`plugin {init\|validate\|keygen\|package\|sign\|publish}`	Plagin SDK: skafold, barlamak, açarlar, paketlemek, gol çekmek we çap etmek (hususy/jemgyýetçilik).
`version`	Wersiýany çap etmek.
`help`	Kömegi görkezmek.

`uninstall` baýdaklary

Baýdak	Täsiri
`--purge`	Maglumatlary hem aýyrmak (doly aýyrma).
`--yes`	Tassyklama soragyny ätlemek.
`--no-backup`	Aýyrmazdan öň ätiýaçlyk nusga almazlyk.
`--backup-dir <kat>`	Gurnamany aýyrmazdan öňki ätiýaçlyk nusgany bu kataloga ýazmak.

Ulanyş mysallary

Gurnamak we galdyrmak

Gurnama şahsy kabinetiňizdäki şahsy gurnama baglanyşygy arkaly amala aşyrylýar (serediň Gurnama); şondan soň CLI hyzmaty başladýar we barlaýar:

sudo aihummer up
aihummer status

Täzelemek

# Diňe täze çykuşyň bardygyny barlamak
aihummer update --check

# Täzelemäni ulanmak
sudo aihummer update

Hyzmat dolandyryşy we loglar

Buýruklar ýeke-täk gateway systemd birligine täsir edýär (AIHUMMER_SERVICE, deslapky aihummer-gateway); logs islendik systemd birligi adyny kabul edýär.

sudo aihummer restart
aihummer logs                 # gateway birliginiň žurnaly (deslapky)
aihummer logs aihummer-stt    # başga systemd birliginiň žurnaly
sudo aihummer stop

Diagnostika

aihummer doctor

Ätiýaçlyk nusga we dikeltme

backup PostgreSQL ýagdaý gatlagynyň pg_dump-yny faýla ýazýar; restore şol dump faýlyny alýar.

aihummer backup /var/backups/aihummer
aihummer restore /var/backups/aihummer/aihummer-2026-07-05.sql

[!TIP] Postgres hakykatyň çeşmesidir, ýöne siziň AIHUMMER_MASTER_KEY-ňiz we blob katalogyňyz aýratyn ätiýaçlanmalydyr — master açarsyz, şifrlenen syrlar dikeldilip bilinmez.

Admin parolyny bellemek

Buýruk [--login admin] [--password X] kabul edýär we AIHUMMER_DATABASE_URL-i talap edýär — adatça gurnama ulanyjysy hökmünde ýa-da sudo arkaly işledilende gateway.env-den alynýar.

sudo aihummer set-password --login admin

Control-plane sazlamalary

settings Sazlamalar-katalog düwmelerini göni maglumat bazasynda okaýar we ýazýar — bu web admin UI-niň (Dolandyryş → Sazlamalar) redaktirleýän şol bir ammar. Katalog düwmeleri CLI-den şeýle sazlanýar: olar üçin gateway.env bahalary äsgerilmeýär.

aihummer settings set AIHUMMER_STT_URL http://127.0.0.1:8001
aihummer settings get AIHUMMER_STT_URL
aihummer settings list

settings list diňe ulanyja görünýän katalog açarlaryny görkezýär (ulgam we içki açarlar gizlin); her açar öz çeşmesi bilen bellikli — siz bellän bahalar üçin [db], bolmasa katalogyň default bahasy bilen [unset].

Ygtyýarnamalar

license show <token> argumentini we AIHUMMER_LICENSE_PUBKEY üýtgeýjisini talap edýär: ol berlen tokeni deşifrleýär we barlaýar — ol nusganyň häzirki ygtyýarnamasyny görkezmeýär.

aihummer license keygen                # gol çekiş açaryny döretmek
aihummer license sign                  # ygtyýarnama gol çekmek
aihummer license show <token>          # tokeni deşifrläp barlamak

Ýük synagy

aihummer loadtest

Plaginler

aihummer plugin init <kind>            # manifest skafoldy (connector|service|openapi|mcp)
aihummer plugin validate manifest.json # manifesti şertnama garşy barlamak
aihummer plugin keygen                 # ed25519 awtor açary (.key + .pub)
aihummer plugin package ./my-plugin    # tarball + .sha256 gurmak
aihummer plugin sign --key author.key --manifest ./my-plugin/manifest.json my-plugin-1.0.0.tar.gz

# Çap etmek: hususy (instansyňyza) ýa-da köpçülikleýin (kataloga PR)
aihummer plugin publish --private --instance https://host --token <admin> my-plugin-1.0.0.tar.gz
aihummer plugin publish --public --dir ./my-plugin --key author.key \
  --artifact-url https://you.example/my-plugin-1.0.0.tar.gz --publisher you \
  --description "..." --icon https://you.example/icon.svg

Doly SDK we iki çap etme režimi üçin serediň Plagin SDK we Plagini çap etmek.

[!WARNING] uninstall root talap edýär: sudo aihummer uninstall işlediň. We sudo aihummer uninstall --purge --yes maglumatlary aýyrýar we tassyklama soragyny ätleýär — ilki bilen barlanan ätiýaçlyk nusgaňyzyň bardygyna göz ýetiriň.

Gurşaw

aihummer guralynyň özüniň okaýan üýtgeýjileri:

Üýtgeýji	Maksat
`AIHUMMER_SERVICE`	Gateway systemd birliginiň ady (deslapky `aihummer-gateway`) — `up`/`restart`/`stop`/`logs` üçin nyşana.
`AIHUMMER_GATEWAY_URL`	`status`/`doctor`/`loadtest` üçin gateway URL-i (deslapky `http://127.0.0.1:8780`).
`AIHUMMER_DATABASE_URL`	Postgres DSN — `backup`/`restore`/`set-password`/`settings` üçin talap edilýär.
`AIHUMMER_REPO`	`update` üçin reliz repozitoriýasy (hiç `AIHUMMER_DOWNLOAD_BASE_URL` CDN sazlanmadyk bolsa ätiýaçlyk).

Buýruklaryň köpüsi root talap edýär (systemctl) — olary sudo bilen işlediň.

Indiki nirä

Instansy sazlaň: Gurşaw üýtgeýjileri.
Agentiň haýsy gurallary ulanyp biljekdigini kesgitläň: Gurallar katalogy.