CLI տեղեկատու

sudo aihummer up
aihummer status

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

# Apply the update
aihummer update

aihummer restart
aihummer logs                 # all services
aihummer logs gateway         # one service
aihummer stop

aihummer doctor

aihummer backup /var/backups/aihummer
aihummer restore /var/backups/aihummer/backup-2026-06-26.tar

aihummer set-password

aihummer settings set AIHUMMER_STT_URL http://localhost: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          # show the current license

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) or publicly (PR to the catalog)
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

`aihummer` հրամանատողի գործիքը կառավարում է host-native տեղադրումը. այն գործարկում և թարմացնում է gateway-ը (բուն տեղադրումը կատարվում է անձնական գրասենյակի տեղադրման անձնական հղումով), կառավարում systemd ծառայությունները, գործարկում ախտորոշումներ, մշակում պահուստավորումներ, կարդում և գրում control-plane կարգավորումները և ստորագրում լիցենզիաներ։ Այս էջը թվարկում է յուրաքանչյուր հրաման։ ## Հրամաններ | Հրաման | Ինչ է անում | |---|---| | `up` / `install` | Գործարկել gateway-ի systemd ծառայությունը (`systemctl start`)։ Ոչինչ չի տեղադրում — տեղադրումը կատարում է անձնական հղումով ստացվող տեղադրման սկրիպտը։ | | `update [--check]` | Թարմացնել մինչև վերջին թողարկում; `--check`-ը միայն հաղորդում է՝ արդյոք թարմացում հասանելի է։ | | `restart` | Վերագործարկել ծառայությունները։ | | `stop` | Կանգնեցնել ծառայությունները։ | | `logs [svc]` | Հետևել լոգերին; փոխանցեք ծառայության անունը զտելու համար։ | | `status` | Ցույց տալ ծառայության կարգավիճակը։ | | `doctor` | Գործարկել ախտորոշումներ / առողջության ստուգումներ։ | | `backup [dir]` | Ստեղծել պահուստ (ընտրովի՝ թիրախային գրացուցակում)։ | | `restore <file>` | Վերականգնել պահուստի ֆայլից։ | | `uninstall [flags]` | Հեռացնել տեղադրումը (տես ստորև բերված դրոշները)։ Պահանջում է root — գործարկեք `sudo`-ով։ | | `set-password` / `admin-password` | Սահմանել տեղական admin-ի գաղտնաբառը։ | | `settings {set\|get\|list}` | Կարդալ/գրել control-plane կարգավորումները տվյալների բազայում — այսպես են Կարգավորումների կատալոգի ստեղները սահմանվում CLI-ից `gateway.env`-ի փոխարեն։ | | `license {keygen\|sign\|show}` | Կառավարել լիցենզիաները (գեներացնել բանալի, ստորագրել, ցույց տալ)։ | | `loadtest` | Գործարկել բեռնվածքի թեստ gateway-ի դեմ։ | | `plugin {init\|validate\|keygen\|package\|sign\|publish}` | Plugin 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 aihummer update ``` ### Ծառայության կառավարում և լոգեր ```bash aihummer restart aihummer logs # all services aihummer logs gateway # one service aihummer stop ``` ### Ախտորոշում ```bash aihummer doctor ``` ### Պահուստավորում և վերականգնում ```bash aihummer backup /var/backups/aihummer aihummer restore /var/backups/aihummer/backup-2026-06-26.tar ``` > [!TIP] > Postgres-ը ճշմարտության աղբյուրն է, բայց ձեր `AIHUMMER_MASTER_KEY`-ը և blob > գրացուցակը պետք է առանձին պահուստավորվեն — առանց master key-ի, գաղտնագրված > գաղտնիքները չեն կարող վերականգնվել։ ### Սահմանել admin-ի գաղտնաբառը ```bash aihummer set-password ``` ### Կարգավորումներ ```bash aihummer settings set AIHUMMER_STT_URL http://localhost:8001 aihummer settings get AIHUMMER_STT_URL aihummer settings list ``` `settings list`-ը ցույց է տալիս Կատալոգի միայն օգտատիրական ստեղները (համակարգային և ծառայողական ստեղները թաքցված են); յուրաքանչյուր ստեղնի մոտ նշված է աղբյուրը — `[db]`՝ ձեր սահմանած արժեքների համար, և `[unset]`՝ լռելյայն արժեքով։ ### Լիցենզիաներ ```bash aihummer license keygen # generate a signing key aihummer license sign # sign a license aihummer license show # show the current license ``` ### Բեռնվածքի թեստ ```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) or publicly (PR to the catalog) 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 ``` Ամբողջական SDK-ի և երկու հրապարակման ռեժիմների համար տես [Plugin SDK](/hy/v1.0/marketplace/sdk) և [Փլագինի հրապարակում](/hy/v1.0/marketplace/publishing)։ > [!WARNING] > `uninstall`-ը պահանջում է root. գործարկեք `sudo aihummer uninstall`։ Իսկ > `sudo aihummer uninstall --purge --yes`-ը հեռացնում է տվյալները և բաց է թողնում > հաստատման հարցումը — նախ համոզվեք, որ ունեք ստուգված պահուստ։ ## Ուր հաջորդը - Կարգավորեք, թե ինչ է տեղադրում CLI-ն՝ [Միջավայրի փոփոխականներ](/hy/v1.0/reference/env-vars)։ - Որոշեք, թե ինչ գործիքներ կարող է օգտագործել ագենտը՝ [Գործիքների կատալոգ](/hy/v1.0/reference/tools-catalog)։