Перейти к основному содержимому

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

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

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

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

ls -la ~/.ssh

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

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

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

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

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

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

Что происходит:

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

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

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

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

  2. Enter passphrase (empty for no passphrase):

    1. ОБЯЗАТЕЛЬНО оставь пустым. просто нажми Enter
    2. ❌ НЕ указывай passphrase. Trisigma CLI не поддерживает ключи с паролем
    3. Ключ без passphrase необходим для автоматической работы CLI с Git операциями

  3. Enter same passphrase again:

    1. Снова нажми 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 вставь скопированный публичный ключ

    1. Ключ должен начинаться с ssh-ed25519 или ssh-rsa
    2. Заканчиваться email-адресом или комментарием

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

    1. MacBook Pro - Work
    2. Linux Desktop

  5. Нажми 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:

# Перейди в директорию для проектов \{#pereydi-v-direktoriyu-dlya-proektov}
cd ~/projects  # или любая другая директория

# Клонируй репозиторий \{#kloniruy-repozitoriy}
git clone git@github.com:&lt;your-company&gt;/&lt;your-company&gt;_ab_metrics.git ab-metrics

# Перейди в репозиторий \{#pereydi-v-repozitoriy}
cd ab-metrics

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

ls -la

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

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

!!! warning "Путь к репозиторию" Запомни или запиши путь к склонированному репозиторию. он понадобится при настройке 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 | Назад к содержанию