Перейти к содержанию

Настройка Git и SSH-ключей#

Для работы с репозиторием метрик тебе нужен доступ к GitHub через SSH.

Шаг 1: Проверь наличие SSH-ключа#

Выполни команду:

ls -la ~/.ssh

Если ты видишь файлы id_rsa и id_rsa.pub (или id_ed25519 и id_ed25519.pub) — ключ уже есть, переходи к Шагу 3.

Если директория ~/.ssh пуста или не существует — переходи к Шагу 2.

Шаг 2: Создай SSH-ключ (если его нет)#

Важно: Ключ без passphrase

Trisigma CLI поддерживает только SSH-ключи без passphrase. При создании ключа обязательно оставляй поле passphrase пустым. Ключи с passphrase не будут работать с автоматическими операциями Git в CLI.

Выполни команду:

ssh-keygen -t ed25519 -C "your.email@example.com"

Что происходит: - Создается новая пара ключей (приватный + публичный) - Используется современный алгоритм ed25519 (безопаснее и быстрее RSA) - Email в параметре -C используется как комментарий для идентификации ключа

Вопросы при генерации:

  1. Enter file in which to save the key (~/.ssh/id_ed25519):

  2. Нажми Enter для сохранения в стандартную директорию

  3. Enter passphrase (empty for no passphrase):

  4. ОБЯЗАТЕЛЬНО оставь пустым — просто нажми Enter
  5. ❌ НЕ указывай passphrase — Trisigma CLI не поддерживает ключи с паролем

  6. Ключ без passphrase необходим для автоматической работы CLI с Git операциями

  7. Enter same passphrase again:

  8. Снова нажми Enter (оставь пустым)

SSH-keygen покажет путь к созданным ключам в ~/.ssh/id_ed25519 и ~/.ssh/id_ed25519.pub.

Почему без passphrase? CLI автоматически выполняет Git операции (commit, push, pull) в фоновом режиме. Passphrase требует интерактивного ввода пароля, что невозможно при автоматических операциях.

Шаг 3: Скопируй публичный ключ#

macOS#

pbcopy < ~/.ssh/id_ed25519.pub

Публичный ключ скопирован в буфер обмена! ✅

Linux#

cat ~/.ssh/id_ed25519.pub | xclip -selection clipboard

Если команда xclip не установлена:

sudo apt-get install xclip  # Ubuntu/Debian

Или просто выведи ключ на экран и скопируй вручную:

cat ~/.ssh/id_ed25519.pub

Шаг 4: Добавь ключ в GitHub#

  1. Открой настройки SSH-ключей в GitHub

  2. Нажми кнопку Add key

  3. В поле Key вставь скопированный публичный ключ

  4. Ключ должен начинаться с ssh-ed25519 или ssh-rsa

  5. Заканчиваться email-адресом или комментарием

  6. В поле Label введи понятное название, например:

  7. MacBook Pro - Work

  8. Linux Desktop

  9. Нажми Add key для сохранения

Шаг 5: Проверь доступ к GitHub#

Проверь успешную аутентификацию по SSH-ключу:

ssh -T git@github.com

Что ты должен увидеть: 

Hi username! You've successfully authenticated, but GitHub does not provide shell access.

Это сообщение подтверждает, что SSH-ключ принят и аутентификация прошла успешно! ✅

Возможные проблемы:

  1. Ничего не вывелось — ключ не добавлен в GitHub или используется неправильный ключ
  2. Permission denied (publickey) — проверь, что ключ добавлен в настройках GitHub
  3. Connection refused — проблема с сетевым доступом или неправильный порт

Для детальной диагностики используй verbose режим без grep:

ssh -T git@github.com

Рекомендуем обратиться в канал Trisigma Support Channel при возникновении проблем.

Шаг 6: Клонируй репозиторий метрик#

Если у тебя еще нет локальной копии репозитория ab-metrics:

# Перейди в директорию для проектов
cd ~/projects  # или любая другая директория

# Клонируй репозиторий
git clone git@github.com:<your-company>/<your-company>_ab_metrics.git ab-metrics

# Перейди в репозиторий
cd ab-metrics

Проверка структуры:

ls -la

Ты должен увидеть структуру репозитория:

ab-metrics/
├── sources/
├── dimensions/
├── metrics/
├── enrichments/
├── m42/
├── ab/
└── README.md

Путь к репозиторию

Запомни или запиши путь к склонированному репозиторию — он понадобится при настройке CLI!

Например: /Users/твоё_имя/projects/ab-metrics

Настройка Git-идентификации (опционально)#

Если ты еще не настраивал Git на этом компьютере, укажи свое имя и email:

git config --global user.name "Имя Фамилия"
git config --global user.email "your.email@example.com"

Эти данные будут использоваться в коммитах.

Что дальше?#

SSH-ключи настроены, репозиторий склонирован — переходи к установке CLI!

➡️ Установка Trisigma CLI | 🏠 Назад к содержанию