CLI

aral — это единый инструмент командной строки для Aral Cloud. Он управляет серверами, проектами, томами, DNS, S3-бакетами и Git-репозиториями прямо из терминала и спроектирован удобным для AI-агентов и CI благодаря машиночитаемому выводу в формате JSON.

Установка

Видеоурок

▶aral CLI — установка и вход0:35

Установите последнюю версию официальной однострочной командой:

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

Установщик определит вашу ОС и архитектуру процессора, положит бинарный файл aral в /usr/local/bin (или в ~/.local/bin, если первый каталог недоступен для записи) и напечатает итоговый путь. Проверьте, что всё работает:

aral --version

Готовые бинарные файлы для всех поддерживаемых платформ также можно скачать напрямую со страницы aralcloud.uz/cli.

TIP

Чтобы выбрать другой каталог установки, задайте переменную ARAL_INSTALL_DIR перед запуском установщика.

Аутентификация

Видеоурок

▶API-токены и права доступа0:40

Войдите с помощью email и пароля Aral Cloud. Токен сохраняется в ~/.aral/config.yaml и используется повторно при каждой команде.

aral auth login --email you@example.com --password 'ваш-пароль'

Если у вашего аккаунта несколько организаций, передайте --org_id, чтобы выбрать одну при входе. Проверьте, кто вы:

aral auth whoami

Для автоматизации (CI-пайплайны, AI-агенты) создайте долгоживущий API-токен вместо пароля:

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

Токен обязан сказать, что ему разрешено. Указывайте --scope по одному на каждую операцию либо --all, чтобы выдать всё, что может ваша учётная запись — включая удаление любого сервера, тома и базы данных в организации. Значения по умолчанию нет: если не указано ни то, ни другое, команда отклоняется, поэтому неограниченный токен появляется только тогда, когда вы его попросили.

WARNING

API-токен nex_... показывается только один раз при создании. Храните его в безопасности и передавайте через переменную окружения ARAL_TOKEN, а не коммитьте в репозиторий.

Чтобы удалить сохранённый токен:

aral auth logout

Конфигурация

Конфигурация хранится в ~/.aral/config.yaml. Эндпоинт API по умолчанию — https://aralcloud.uz. Эндпоинт, токен и формат вывода можно переопределить глобально для любой команды или через переменные окружения.

Флаг	Переменная окружения	Описание
--endpoint <url>	ARAL_ENDPOINT	Эндпоинт API (по умолчанию https://aralcloud.uz)
--token <token>	ARAL_TOKEN	Bearer-токен (JWT или API-токен nex_)
--output <table|json>, -o	ARAL_OUTPUT	Формат вывода (по умолчанию table)

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

JSON-вывод для скриптов и AI-агентов

Добавьте --output json (или -o json) к любой команде, чтобы получить машиночитаемый JSON вместо таблицы. Это рекомендуемый режим для скриптов и AI-агентов.

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

Можно также задать его один раз на всю сессию:

export ARAL_OUTPUT=json

Справочник команд

Аутентификация — aral auth

Команда	Описание
auth login	Вход по email + паролю с сохранением токена
auth whoami	Показать текущего аутентифицированного пользователя
auth token	Создать неинтерактивный API-токен (nex_...) для AI-агентов / CI; требует --scope или --all
auth logout	Удалить сохранённый токен

aral auth login --email you@example.com --password 'секрет' --org_id org_123
aral auth whoami
aral auth token --name ci --scope servers:read --expires-in-days 365
aral auth logout

Проекты — aral project

Команда	Описание
project list	Список проектов в активной организации
project use <project_id>	Переключить активный проект (токен перевыпускается под него)
project create --name <name>	Создать проект
project delete <project_id>	Удалить проект; отклоняется, пока в нём остаются ресурсы

aral project list
aral project use proj_abc123
aral project delete proj_abc123

Удаление проекта никогда не удаляет то, что в нём лежит. Проект, в котором ещё есть серверы, тома, бакеты, базы данных или что-то ещё, удалить нельзя, и ошибка называет, что именно мешает — сначала удалите или перенесите их. Проект по умолчанию удалить нельзя вовсе.

Серверы / VM — aral server

Команда	Описание
server list	Список серверов в активном проекте
server get <id>	Показать один сервер
server create	Создать сервер
server start <id>	Запустить сервер
server stop <id>	Остановить сервер
server reboot <id>	Перезагрузить сервер
server delete <id>	Удалить сервер
server ssh <id>	Вывести команду ssh для подключения к серверу
server plans	Список доступных тарифов
server regions	Список доступных регионов
server images	Список доступных ОС-образов

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... you@host"
aral server list
aral server ssh srv_123
aral server reboot srv_123
aral server delete srv_123

TIP

Сначала выполните aral server plans и aral server regions — идентификаторы тарифов берутся из каталога и со временем меняются, поэтому копируйте нужный id из этого вывода, а не придумывайте его.

TIP

--ssh-key можно повторять, чтобы добавить несколько ключей. server ssh лишь выводит команду ssh — выполните её сами или передайте через pipe.

Тома — aral volume

Команда	Описание
volume list	Список томов
volume create	Создать том
volume delete <id>	Удалить том
volume attach <id> --server-id <id>	Подключить том к серверу
volume detach <id>	Отключить том

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

Команда	Описание
dns zones	Список DNS-зон
dns add-zone --name <domain>	Создать DNS-зону
dns delete-zone <id>	Удалить DNS-зону
dns records <zone>	Список записей в зоне
dns add-record <zone>	Создать запись в зоне

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 — aral s3

Команда	Описание
s3 list	Список S3-бакетов
s3 create --name <имя>	Создать бакет (опционально --region)
s3 delete <имя>	Удалить бакет

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

Git-репозитории — aral git

Команда	Описание
git list	Список репозиториев в активном проекте
git get <name>	Показать один репозиторий
git create <name>	Создать репозиторий (опционально --description, --private)
git delete <name>	Удалить репозиторий
git clone <name>	Клонировать репозиторий в текущий каталог
git runs <name>	Показать запуски CI/CD-пайплайнов репозитория

aral git create my-app --description "Моё приложение" --private
aral git list
aral git clone my-app
aral git runs my-app
aral git delete my-app

TIP

git clone вызывает локальный git, поэтому убедитесь, что git установлен, а ваши SSH/HTTPS-учётные данные настроены.