CLI Трекера
Используйте CLI ytracker, чтобы работать с задачами Трекера из терминала.
Установить CLI и войти в Трекер
ytracker — консольная утилита для работы с Трекером. С ее помощью можно создавать и открывать задачи, читать комментарии, вложения и чеклисты, менять статус и искать задачи из терминала. Утилита работает без Node.js и npm.
Чтобы установить CLI Трекера в macOS или Linux с glibc, выполните команду:
curl -fsSL https://storage.yandexcloud.net/ytracker-cli/install.sh | sh
ytracker --version --json
Чтобы установить CLI Трекера в Windows x64, выполните команду в PowerShell:
irm https://storage.yandexcloud.net/ytracker-cli/install.ps1 | iex
ytracker --version --json
Установщик проверяет контрольную сумму загруженного файла. В macOS и Linux утилита устанавливается в каталог пользователя. В Windows установщик добавляет каталог утилиты в пользовательскую переменную Path.
Для входа понадобится идентификатор организации. Его можно скопировать на странице Администрирование → Организации.
Выполните команду и подтвердите вход на странице, которую откроет утилита:
ytracker auth login --method browser --organization-id <organization_id>
Чтобы проверить авторизацию, выполните команду:
ytracker whoami --json
Работать с задачами и API в CLI
С помощью CLI можно просматривать, искать, создавать и изменять задачи. Например:
- просмотреть задачу вместе с комментариями, вложениями и чеклистом —
ytracker TEAM-42; - найти задачу по тексту —
ytracker issue search --text "форма логина"; - создать задачу —
ytracker issue create --summary "Добавить проверку" --queue TEAM --type task; - изменить задачу —
ytracker issue update TEAM-42 --priority critical --assignee me.
Чтобы посмотреть все команды, выполните ytracker --help. Для справки по группе команд укажите ее название, например ytracker issue --help.
Команды для работы с задачами подходят для автоматизации и не задают интерактивных вопросов. При перенаправлении вывода утилита возвращает валидный JSON в стандартный поток вывода, а диагностические сообщения — в стандартный поток ошибок.
Перед изменением данных добавьте к команде параметр --dry-run. Утилита выведет план HTTP-запросов и не отправит их.
Значения по умолчанию для новых задач можно хранить в файле .tracker.toml в репозитории.
Чтобы отправить прямой запрос к Public API, используйте команду ytracker api. Например:
ytracker api GET issues/TEAM-42
Команда ytracker api использует ту же авторизацию, что и другие команды, и возвращает ответ API вместе со статусом и заголовками.