CLI

aral — Aral Cloud uchun yagona buyruq qatori (command-line) vositasi. U serverlar, loyihalar, volume’lar, DNS, S3 bucket’lar va Git repozitoriylarini terminaldan boshqaradi hamda mashina o‘qiy oladigan JSON chiqishi tufayli AI-agent va CI uchun qulay qilib ishlab chiqilgan.

O‘rnatish

Video qo‘llanma

▶aral CLI — oʻrnatish va kirish0:35

Eng so‘nggi versiyani rasmiy bir qatorli buyruq bilan o‘rnating:

curl -fsSL https://aralcloud.uz/dl/install | sh

O‘rnatuvchi operatsion tizim va protsessor arxitekturangizni aniqlaydi, aral binary faylini /usr/local/bin ga joylaydi (agar u yozish uchun ochiq bo‘lmasa, ~/.local/bin ga) va qayerga o‘rnatganini ko‘rsatadi. Ishlayotganini tekshiring:

aral --version

Barcha qo‘llab-quvvatlanadigan platformalar uchun tayyor binary fayllarni aralcloud.uz/cli sahifasidan to‘g‘ridan-to‘g‘ri yuklab olsa ham bo‘ladi.

TIP

Boshqa katalogga o‘rnatmoqchi bo‘lsangiz, buyruqni ishga tushirishdan oldin ARAL_INSTALL_DIR o‘zgaruvchisini belgilang.

Autentifikatsiya

Video qo‘llanma

▶API tokenlar va ruxsatlar0:40

Aral Cloud email va parolingiz bilan tizimga kiring. Token ~/.aral/config.yaml faylida saqlanadi va keyingi har bir buyruqda qayta ishlatiladi.

aral auth login --email siz@example.com --password 'parolingiz'

Agar hisobingizda bir nechta tashkilot bo‘lsa, kirishda bittasini tanlash uchun --org_id ni uzating. Kim ekanligingizni tasdiqlash uchun:

aral auth whoami

Avtomatlashtirish (CI pipeline’lar, AI agentlar) uchun parol o‘rniga uzoq muddatli API token yarating:

aral auth token --name ci --scope servers:read --scope servers:write --expires-in-days 90

Token nima qila olishini aytishi shart. Har bir operatsiya uchun --scope bering yoki hisobingiz qila oladigan hamma narsani berish uchun --all — bunga tashkilotdagi har bir server, volume va ma’lumotlar bazasini o‘chirish ham kiradi. Standart qiymat yo‘q: ikkalasi ham berilmasa, buyruq rad etiladi — ya’ni cheklanmagan token faqat siz so‘raganingizda paydo bo‘ladi.

WARNING

nex_... API token faqat yaratilgan paytda bir marta ko‘rsatiladi. Uni xavfsiz saqlang va repozitoriyga joylash o‘rniga ARAL_TOKEN muhit o‘zgaruvchisi orqali uzating.

Saqlangan tokenni tozalash uchun:

aral auth logout

Sozlash

Sozlamalar ~/.aral/config.yaml faylida turadi. Standart API endpoint — https://aralcloud.uz. Endpoint, token va chiqish formatini istalgan buyruqda global tarzda yoki muhit o‘zgaruvchilari orqali o‘zgartirishingiz mumkin.

Bayroq (flag)	Muhit o‘zgaruvchisi	Tavsif
--endpoint <url>	ARAL_ENDPOINT	API endpoint (standart https://aralcloud.uz)
--token <token>	ARAL_TOKEN	Bearer token (JWT yoki nex_ API token)
--output <table|json>, -o	ARAL_OUTPUT	Chiqish formati (standart table)

export ARAL_TOKEN=nex_xxxxxxxxxxxx
export ARAL_ENDPOINT=https://aralcloud.uz
aral server list

Skriptlar va AI agentlar uchun JSON chiqish

Jadval o‘rniga mashina o‘qiy oladigan JSON olish uchun istalgan buyruqqa --output json (yoki -o json) qo‘shing. Bu skript va AI agentlar uchun tavsiya etiladigan rejim.

aral server list --output json
aral -o json auth whoami

Uni butun sessiya uchun bir marta ham o‘rnatishingiz mumkin:

export ARAL_OUTPUT=json

Buyruqlar ma’lumotnomasi

Autentifikatsiya — aral auth

Buyruq	Tavsif
auth login	Email + parol bilan kirish va tokenni saqlash
auth whoami	Joriy autentifikatsiya qilingan foydalanuvchini ko‘rsatish
auth token	AI agent / CI uchun interaktiv bo‘lmagan API token (nex_...) yaratish; --scope yoki --all talab qilinadi
auth logout	Saqlangan tokenni o‘chirish

aral auth login --email siz@example.com --password 'parol' --org_id org_123
aral auth whoami
aral auth token --name ci --scope servers:read --expires-in-days 365
aral auth logout

Loyihalar — aral project

Buyruq	Tavsif
project list	Faol tashkilotdagi loyihalarni ro‘yxatlash
project use <project_id>	Faol loyihani almashtirish (token o‘sha loyihaga qayta moslanadi)
project create --name <name>	Loyiha yaratish
project delete <project_id>	Loyihani o‘chirish; ichida resurs qolgan bo‘lsa rad etiladi

aral project list
aral project use proj_abc123
aral project delete proj_abc123

Loyihani o‘chirish uning ichidagini hech qachon o‘chirmaydi. Ichida server, volume, bucket, ma’lumotlar bazasi yoki boshqa resurs qolgan loyiha rad etiladi va xatolik nima to‘sib turganini aytadi — avval o‘shalarni o‘chiring yoki ko‘chiring. Standart loyihani umuman o‘chirib bo‘lmaydi.

Serverlar / VM’lar — aral server

Buyruq	Tavsif
server list	Faol loyihadagi serverlarni ro‘yxatlash
server get <id>	Bitta serverni ko‘rsatish
server create	Server yaratish
server start <id>	Serverni ishga tushirish
server stop <id>	Serverni to‘xtatish
server reboot <id>	Serverni qayta yuklash
server delete <id>	Serverni o‘chirish
server ssh <id>	Serverga ulanish uchun ssh buyrug‘ini chop etish
server plans	Mavjud tariflarni ro‘yxatlash
server regions	Mavjud regionlarni ro‘yxatlash
server images	Mavjud OS image’larni ro‘yxatlash

aral server plans
aral server regions
aral server create \
  --name web-1 \
  --plan-id <plan-id> \
  --region hel1 \
  --os-image ubuntu-24.04 \
  --ssh-key "ssh-ed25519 AAAA... siz@host"
aral server list
aral server ssh srv_123
aral server reboot srv_123
aral server delete srv_123

TIP

Avval aral server plans va aral server regions ni ishga tushiring — plan id’lari katalog qiymatlari bo‘lib, vaqt o‘tishi bilan o‘zgaradi, shuning uchun kerakli id’ni taxmin qilmasdan o‘sha ro‘yxatdan nusxa oling.

TIP

Bir nechta kalit qo‘shish uchun --ssh-key ni takrorlash mumkin. server ssh faqat ssh buyrug‘ini chop etadi — uni o‘zingiz ishlatasiz yoki pipe qilasiz.

Volume’lar — aral volume

Buyruq	Tavsif
volume list	Volume’larni ro‘yxatlash
volume create	Volume yaratish
volume delete <id>	Volume’ni o‘chirish
volume attach <id> --server-id <id>	Volume’ni serverga ulash
volume detach <id>	Volume’ni uzish

aral volume create --name data --size 50 --region hel1
aral volume attach vol_123 --server-id srv_123
aral volume detach vol_123
aral volume delete vol_123

DNS — aral dns

Buyruq	Tavsif
dns zones	DNS zonalarini ro‘yxatlash
dns add-zone --name <domain>	DNS zona yaratish
dns delete-zone <id>	DNS zonani o‘chirish
dns records <zone>	Zonadagi yozuvlarni ro‘yxatlash
dns add-record <zone>	Zonada yozuv yaratish

aral dns add-zone --name example.com
aral dns zones
aral dns add-record example.com --name www --type A --content 203.0.113.10
aral dns records example.com

S3 obyekt xotira — aral s3

Buyruq	Tavsif
s3 list	S3 bucket’larni ro‘yxatlash
s3 create --name <nom>	Bucket yaratish (ixtiyoriy --region)
s3 delete <nom>	Bucket’ni o‘chirish

aral s3 create --name my-bucket --region hel1
aral s3 list
aral s3 delete my-bucket

Git repozitoriylari — aral git

Buyruq	Tavsif
git list	Faol loyihadagi repozitoriylarni ro‘yxatlash
git get <name>	Bitta repozitoriyni ko‘rsatish
git create <name>	Repozitoriy yaratish (ixtiyoriy --description, --private)
git delete <name>	Repozitoriyni o‘chirish
git clone <name>	Repozitoriyni joriy katalogga klonlash
git runs <name>	Repozitoriyning CI/CD pipeline ishlashlarini ko‘rsatish

aral git create my-app --description "Mening ilovam" --private
aral git list
aral git clone my-app
aral git runs my-app
aral git delete my-app

TIP

git clone lokal git ni chaqiradi, shuning uchun git o‘rnatilgan va SSH/HTTPS hisob ma’lumotlaringiz sozlangan bo‘lishiga ishonch hosil qiling.