Инструкция рассчитана на человека, который уже слышал про Git, но ни разу не заводил репозиторий на российской площадке. Всё, что нужно, — браузер и установленный Git. Вся работа с самим сервисом идёт на сайте, поэтому система на компьютере значения не имеет: шаги одинаковы для Windows, macOS и Linux.
Создайте аккаунт
Откройте сайт GitVerse и нажмите кнопку регистрации. Доступны два пути: обычная регистрация по адресу электронной почты с паролем и вход через Сбер ID, если он у вас уже есть. Первый вариант удобнее для рабочей почты, второй — когда не хочется придумывать ещё один пароль.
После регистрации подтвердите адрес по письму: без этого часть действий, например приглашение коллег, будет недоступна. Затем зайдите в настройки профиля и укажите имя, по которому вас узнают в обсуждениях, — безликий ник в рабочем проекте только мешает.
Создайте первый репозиторий
Нажмите кнопку создания нового репозитория и заполните три вещи: имя латиницей без пробелов, короткое описание и видимость. Закрытый репозиторий видят только вы и те, кого пригласите; открытый доступен всем, и его находит поиск.
- Файл README — поставьте галочку, чтобы он создался сразу. В него пишут, что это за проект, как его запустить и к кому идти с вопросами.
- Лицензия — нужна открытым проектам: без неё формально никто не имеет права пользоваться вашим кодом.
- Файл игнорирования — список того, что не должно попадать в репозиторий: папки сборки, локальные настройки, файлы с паролями.
Настройте Git на компьютере
Если Git ещё не установлен, поставьте его с официального сайта проекта. Затем представьтесь системе: имя и почта из этих команд попадут в каждый ваш коммит, и по ним коллеги поймут, кто автор изменения.
git config --global user.name "Ivan Ivanov"
git config --global user.email "ivan@example.com"
Почту лучше указать ту же, что в аккаунте GitVerse, — тогда коммиты свяжутся с вашим профилем и в истории появится аватар.
Добавьте SSH-ключ
SSH-ключ избавляет от ввода пароля при каждой отправке кода. Создайте пару ключей в терминале или в приложении Git Bash на Windows:
ssh-keygen -t ed25519 -C "ivan@example.com"
Программа спросит, куда сохранить файл и нужен ли пароль на сам ключ, — согласитесь с местом по умолчанию и задайте пароль, если компьютером пользуется кто-то ещё. Затем откройте созданный файл с расширением .pub, скопируйте всю строку целиком и вставьте её в настройках профиля на сайте, в разделе про SSH-ключи.
Отправьте проект на GitVerse
Откройте страницу созданного репозитория и скопируйте его адрес для SSH — он показан на видном месте вместе с подсказками. Дальше перейдите в терминале в папку с проектом и выполните команды, подставив скопированный адрес вместо подсказки в угловых скобках:
git init
git add .
git commit -m "Первый коммит"
git branch -M main
git remote add origin <адрес репозитория>
git push -u origin main
Обновите страницу репозитория в браузере: файлы и история коммитов должны появиться. Если проект уже лежит на другом git-сервисе, этот шаг можно пропустить и воспользоваться импортом — на сайте есть отдельная кнопка, которая переносит репозиторий по ссылке вместе с историей.
Пригласите коллег и защитите главную ветку
В настройках репозитория найдите раздел про участников и добавьте людей по их именам в сервисе или по почте. Роли выдавайте по делу: тому, кто только смотрит код и пишет замечания, права на запись не нужны.
В том же разделе настроек включите защиту главной ветки. Тогда никто, включая вас, не сможет записать в неё напрямую, а изменения будут попадать только через запрос на слияние. Это самая полезная настройка для командной работы: она не даёт случайно сломать рабочую версию проекта.
Работайте через запросы на слияние
Дальше порядок всегда один. Для каждой задачи вы создаёте отдельную ветку, делаете в ней правки, отправляете их на сервер и открываете запрос на слияние. Коллега смотрит изменения построчно, оставляет замечания у нужных строк и ставит одобрение. После этого ветка сливается в главную, а запрос закрывается вместе со связанной задачей.
Готово: аккаунт настроен, код лежит на российской площадке, отправляется без пароля, а командная работа идёт через проверку изменений.
Если что-то пошло не так
При отправке кода пишет, что доступ запрещён
Чаще всего ключ не добавлен или добавлен не тот файл. Проверьте, что в профиле лежит содержимое файла с расширением .pub целиком, одной строкой, и что вы используете именно SSH-адрес репозитория, а не адрес для браузера.
Коммиты не связываются с моим профилем
Почта в настройках Git на компьютере отличается от почты в аккаунте. Посмотрите текущее значение командой git config —global user.email и укажите тот же адрес, что в профиле на сайте.
Отправка отклонена, просят сначала получить изменения
Значит, в репозитории уже есть коммиты, которых нет у вас, — например файл README, созданный при заведении репозитория. Выполните git pull с объединением историй, разберитесь с конфликтами, если они появятся, и повторите отправку.
В репозиторий попал файл с паролем
Сразу смените сам пароль или токен: считайте, что он больше не секрет. Затем уберите файл из проекта, добавьте его в список игнорируемых и, если репозиторий открытый, попросите поддержку помочь с очисткой истории.
Комментарии · 0
Комментариев пока нет — задайте вопрос первым.