Консольный клиент

tatnet — клиент публичного API из терминала: виртуальные машины, приложения, DNS, S3, управляемые базы. Всё, для чего есть команда, доступно и прямым вызовом API — см. «Прямой вызов API».

Установка

Самый короткий путь — без установки вовсе:

npx tatnet@latest --help

Другие способы:

# постоянная установка через npm
npm install -g tatnet

# Go
go install github.com/tatnet-ru/tatnet-cli/cmd/tatnet@latest

Готовые сборки под Linux, macOS и Windows (а также .deb и .rpm) лежат в релизах на GitHub.

:::tip Что именно вы ставите Пакет в npm — это шим и бинарник под вашу платформу, собранный публичным рабочим процессом из открытого репозитория. Происхождение проверяется:

npm audit signatures

:::

Ключ доступа

Ключ создаётся в панели — min.tatnet.ru/api-keys. У ключа своя область (весь аккаунт или выбранные проекты) и свой набор прав, и он никогда не может больше, чем можете вы.

tatnet auth login          # спросит ключ и сохранит в профиль
tatnet auth status         # покажет аккаунт и что ключу разрешено

Разово ключ можно передать переменной окружения — так удобнее в CI:

export TATNET_API_KEY=tn_live_…

:::warning Пустой список — не всегда «ничего нет» Списки в публичном API фильтруются политикой ключа: если ключу не разрешено видеть ресурс, приходит пустой список, а не отказ. Поэтому «ничего не найдено» и «нет прав» выглядят одинаково — проверить, что именно, можно командой tatnet auth status. :::

Профили

Несколько аккаунтов или адресов живут в одном конфиге (~/.config/tatnet/config.yaml, права 0600):

tatnet profile list
tatnet profile use рабочий
tatnet --profile личный vm list

Проект по умолчанию

Большинство ресурсов живёт в проекте. Его можно задать флагом -p, переменной TATNET_PROJECT или сохранить в профиль:

tatnet profile set-project мой-проект