CLI-ի ուղեցույց

sudo aihummer up
aihummer status

# Only check whether a newer release exists
aihummer update --check

# Apply the update
sudo aihummer update

sudo aihummer restart
aihummer logs                 # the gateway unit's journal (default; follows)
aihummer logs --no-follow     # print the tail of the journal and exit
aihummer logs aihummer-stt    # another systemd unit's journal
sudo aihummer stop

aihummer doctor

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

sudo aihummer set-password --login admin

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

aihummer license keygen                # generate a signing key
aihummer license sign                  # sign a license
aihummer license show <token>          # decode + verify a token

aihummer loadtest

aihummer plugin init <kind>            # scaffold a manifest (connector|service|openapi|mcp)
aihummer plugin validate manifest.json # validate a manifest against the contract
aihummer plugin keygen                 # ed25519 author key (.key + .pub)
aihummer plugin package ./my-plugin    # build a tarball + .sha256
aihummer plugin sign --key author.key --manifest ./my-plugin/manifest.json my-plugin-1.0.0.tar.gz

# Publish privately to your instance (public publishing is done in the portal — "My plugins")
aihummer plugin publish --private --instance https://host --token <admin> my-plugin-1.0.0.tar.gz

Այս `aihummer` կոմանդային տողի գործիքը կառավարում է հյուրընկալված համակարգի տեղադրումը․ այն սկսում և թարմացնում է անցակետը (տեղադրումը կատարվում է ձեր հաշվի պորտալից տեղակայման անձնական հղման միջոցով), վերահսկում է անցակետի systemd ծառայությունը, իրականացնում է դիագնոստիկա, մշակում է պահուստային կրկնօրինակիցները, կարդում և գրառում է կառավարիչի պատվանդանի կարգավորումներն, ինչպես նաև ստորագրում է լիցենզիաները: Այս էջը նշում է բոլոր հրամանները: ## Թիմեր | Թիմ | Ի՞նչ է սա անում | |---|---| | `up` / `install` | Սկսել gateway systemd ծառայությունը (`systemctl start`). Նա ոչինչ չի տեղադրում — տեղադրումը կատարվում է ձեր անձնական հղման միջոցով տեղադրման սկրիպտի օգնությամբ. | | `update [--check]` | Թարմացրեք վերջին տարբերակին (ստուգեք ստորագրությունը + փոխարինեք բինար ֆայլը + վերագործարկեք); `--check` միակ ասում է, թե արդյոք արդիականացում հասանելի է: | | `restart` | Վերագործարկեք անցակետի ծառայությունը (`systemctl restart`). | | `stop` | Կանգնեցրեք անցակետի ծառայությունը (`systemctl stop`). | | `logs [unit] [--no-follow]` | Մեկ systemd միավորման գրանցամատյանի դիտում (`journalctl -u`); ըստ կանխորոշման՝ գեյթվեյի միավորը. `--no-follow`-ը տպում է գրանցամատյանի վերջին տողերը և ավարտվում; առանց դրա հրամանը շարունակում է հետևել: | | `status` | Տեղակայման ընդհանուր պատկերը, ծառայությունների վիճակը և գեյթվեի պատրաստությունը (`/readyz`)։ **Բաղադրիչներ** բաժինը հայտնում է ընտրովի սայդքար միավորների վիճակը (որոնում, զննարկիչ, խոսքից տեքստ, տեքստից խոսք, վիդեո). երբ `systemctl`-ը հասանելի չէ, այն ազնվորեն ասում է, որ վիճակն անհայտ է, ոչ թե «տեղադրված չէ»: | | `doctor` | Ախտորոշում երեք վճիռով՝ ամեն ինչ լավ է, աշխատում է նախազգուշացումներով (N), կամ խնդիրներ են գտնվել: Node.js-ի և նավատորմի գրանցման նյութի ստուգումները նախազգուշացումներ են, ոչ թե ձախողումներ: | | `backup [dir]` | `pg_dump` PostgreSQL պետության հարթությունը ֆայլի մեջ; երբ այն բացակայում է, օգտագործվում է կանխադրված ֆոլդերը։ | | `restore <file>` | Վերականգնել PostgreSQL-ը ստեղծված դամբման ֆայլից `backup`. | | `uninstall [flags]` | Հեռացրեք տեղման (տարբերակները տես նշված ստորեւ): Հարկավոր է root — գործարկեք սա `sudo`. | | `set-password` / `admin-password` | Ստեղադրել/ստեղծել տեղական ադմինիստրատորի գաղտնաբառ (`[--login admin] [--password X]`). | | `settings {set\|get\|list}` | Կոնտրոլային հարթության կարգավորումների ընթերցումն ու գրումը տվյալների շտեմարանում — ահա թե ինչպես են կարգավորվում կարգավորումների ֆայլի տարրերը հրամանային տողից փոխարեն `gateway.env`. | | `license {keygen\|sign\|show <token>}` | Կառավարել լիցենզիաներն՝ ստեղծել բանալի, ստորագրել, վերծանել և ստուգել տրված տոքենը։ | | `loadtest` | Սկսեք բեռնավորման թեստը զանգվածային անցակետում։ | | `plugin {init\|validate\|keygen\|package\|sign\|publish}` | SDK հավելվածի հավելակ: շրջանակի ստեղծում, ստուգում, բանալիներ, փաթեթավորում, ստորագրում և հրապարակում. | | `version` | Ցուցադրել վերսիան։ | | `help` | Ցուցադրել օգնություն։ | ### `uninstall` դրոշներ | Կենդանագ | ԱԿԸ | |---|---| | `--purge` | Իսկապես հեռացրեք տվյալները (ամբողջական հեռացում): | | `--yes` | Այլացնել հաստատման հարցումը։ | | `--no-backup` | Մի պահեք բեկ ապագա նախքան ջնջելը: | | `--backup-dir <dir>` | Արտահանելիս այս թղթապանակում կատարեք կրկնօրինակում։ | ## Օգտագործման օրինակներ ### Տեղադրել և սկսել Տեղադրումը կատարվում է անձնական հղումով ձեր հաշիվից տեղադրման համար (տ նայեք։ [Տեղադրում](/hy/v1.0/getting-started/installation)); դրանից հետո սկսվում է CLI-ն և ստուգում է ծառայությունը: ```bash sudo aihummer up aihummer status ``` ### Թարմացնել ```bash # Only check whether a newer release exists aihummer update --check # Apply the update sudo aihummer update ``` ### Ծառայության կառավարում և ամսագրեր Կոմանդաները ազդում են միավորական համակարգման սարքի վրա՝ gateway systemd (`AIHUMMER_SERVICE`, ըստ լռության `aihummer-gateway`); `logs` ընդունում է systemd-ի ցանկացած միավորի անուն: ```bash sudo aihummer restart aihummer logs # the gateway unit's journal (default; follows) aihummer logs --no-follow # print the tail of the journal and exit aihummer logs aihummer-stt # another systemd unit's journal sudo aihummer stop ``` ### Վերլուծություն ```bash aihummer doctor ``` ### Պահուստային պատճենավորում և վերականգնում `backup` կառավարում է `pg_dump` PostgreSQL բազայի վիճակները ֆայլում; `restore` վերցնում է այս դամբ-կոնպետը։ ```bash aihummer backup /var/backups/aihummer aihummer restore /var/backups/aihummer/aihummer-2026-07-05.sql ``` > [!TIP] > Postgres-ը ճշմարտության աղբյուրն է, բայց ձեր `AIHUMMER_MASTER_KEY` և կաթիլ > փոքրիկը պետք է առանձին պատճենահանվել՝ առանց գլխավոր բանալիի, կոդավորված > գաղտնիքները հնարավոր չէ վերականգնել։ ### Նշեք ադմինիստրատորի գաղտնը Խումբը ընդունում է `[--login admin] [--password X]` և կարիքները `AIHUMMER_DATABASE_URL` — սովորաբար ընտրվում է զրոյից `gateway.env` համակարգի օգտագործողի անունով տեղադրումը զանգահարելիս կամ միջոցով `sudo`. ```bash sudo aihummer set-password --login admin ``` ### Կառավարման հարթույթի կարգավորումներ `settings` կարդում և գրանցում է Settings կարգաբլիկի պարամետրերը անմիջապես տվյալների շտեմարանում՝ նույն պահոցը, որը խմբագրում է վեբ-միջերեսի ադմինիստրատորը (Կառավարում → Պարամետրեր): Ահա թե ինչպես են կարգաբլիկի պարամետրերը կարգավորվում CLI-ի միջոցով: `gateway.env` մենք նրանց համար արժեքները անտեսում ենք։ ```bash aihummer settings set AIHUMMER_STT_URL http://127.0.0.1:8001 aihummer settings get AIHUMMER_STT_URL aihummer settings list ``` `settings list` ցուցադրում է միայն օգտատիրոջ համար եկած ցանկագրի բանալիները (համակարգային և ներքին բանալիները թաքնված են); յուրաքանչյուր բանալի նշված է իր աղբյուրով — `[db]` ձեր կողմից սահմանված արժեքների համար, `[unset]` կամ հակառակ դեպքում՝ զանգվածային կատալոգի կանխորոշված կարգավորումների հետ։ ### Լիցենզիաներ `license show` պահանջում է `<token>` արգումենտ և `AIHUMMER_LICENSE_PUBKEY` փոփոխականը՝ այն դեկոդավորում է և ստուգում **նշյալ** տոկենը — այն չի ցուցադրում պատճենի ընթացիկ լիցենզիան։ ```bash aihummer license keygen # generate a signing key aihummer license sign # sign a license aihummer license show <token> # decode + verify a token ``` ### Բեռնավորվածության թեստավորում ```bash aihummer loadtest ``` ### Պլագիններ ```bash aihummer plugin init <kind> # scaffold a manifest (connector|service|openapi|mcp) aihummer plugin validate manifest.json # validate a manifest against the contract aihummer plugin keygen # ed25519 author key (.key + .pub) aihummer plugin package ./my-plugin # build a tarball + .sha256 aihummer plugin sign --key author.key --manifest ./my-plugin/manifest.json my-plugin-1.0.0.tar.gz # Publish privately to your instance (public publishing is done in the portal — "My plugins") aihummer plugin publish --private --instance https://host --token <admin> my-plugin-1.0.0.tar.gz ``` Համակարգչային SDK-ի ամբողջական տարբերակի և ընդհանուր կատալոգում հրապարակման համար («Իմ պլագինները» պորտալից) տես՝ [Պլագինների զարգացման բազա](/hy/v1.0/marketplace/sdk) և [Պլագինի հրապարակում](/hy/v1.0/marketplace/publishing). > [!WARNING] > `uninstall` պահանջվում են root իրավունքներ՝ մեկնարկ `sudo aihummer uninstall`. Եվ > `sudo aihummer uninstall --purge --yes` ջնջում է տվյալները և բաց է թողնում > Հաստատող հաղորդագրություն — նախ համոզվեք, որ ձեր մոտ գոյություն ունի ստուգված պահուստային համեմատացում: ## Այրող միջավայր Փոփոխականներ `aihummer` ինքնին գործիքը կարդում է: | Փոփոխական | Նպատակ | |---|---| | `AIHUMMER_SERVICE` | Systemd դարպասի միավորի անունը (նույնն է ըստ լռության) `aihummer-gateway`) — նպատակ `up`/`restart`/`stop`/`logs`. | | `AIHUMMER_GATEWAY_URL` | Վավերացման URL `status`/`doctor`/`loadtest` (պահենք որպես լռելյայն) `http://127.0.0.1:8780`). | | `AIHUMMER_DATABASE_URL` | Postgres DSN — պահանջվում է `backup`/`restore`/`set-password`/`settings`. | | `AIHUMMER_LANG` | CLI-ի ելքի և օգնության լեզուն՝ `ru` (լռելյայն) կամ `en`: | Ծանրամասն թիմերին պետք է root (`systemctl`) — գործարկել դրանք՝ `sudo`. ## Որտեղից հետո - Պահենք օրինակն՝ [Շրջակա միջավայրի փոփոխականներ](/hy/v1.0/reference/env-vars). - Նշեք, թե ինչ գործիքներ կարող է օգտագործել գործակալը։ [Պահարան գործիքների](/hy/v1.0/reference/tools-catalog).