Создание репозитория

Создание репозитория #

Выбор Git хостинга #

Все изменения по проекту следует публиковать в Git-репозитории, размещённом в облаке.

  1. Одна команда — один репозиторий на все итерации проекта
  2. Рекомендуется использовать SourceCraft или Github
    • SourceCraft — российская платформа компании Яндекс: https://sourcecraft.dev/
    • Github — американская платформа компании Microsoft: http://github.com/
  3. Репозиторий может быть публичным или приватным.

Выберите Git-хостинг и зарегистрируйтесь в нём.

Создайте пустой репозиторий.

Если у вас приватный репозиторий, то следует добавить доступ на просмотр и комментирование преподавателю:

  • SourceCraft: sergey-shambir
  • Github: sergey-shambir

Установка и настройка Git #

  1. Установите консольную утилиту Git
  2. Настройте имя и email-адрес, например:
    • git config --global user.name "Иван Иванов"
    • git config --global user.email ivan.ivanov@example.com
  3. Создайте SSH ключи
  4. Добавьте публичный SSH ключ в свой аккаунт SourceCraft или Github

Выбор шаблона #

Выберите шаблон репозитория в зависимости от языка:

ЯзыкСтекШаблон
C#C# 14, .NET 10compiler-template
C++C++23, CMakecompiler-template-cpp
GoGo 1.27, Makecompiler-template-go

Шаблоны содержат линтеры, которые нельзя удалять или отключать без согласования с преподавателем.

Клонируйте нужный шаблон по инструкции в шаблоне. Проверьте, что команды сборки работают.

Отправка в свой репозиторий #

Скопируйте Git SSH URL своего репозитория — обычно он доступен при нажатии кнопки Clone в интерфейсе Git-хостинга.

В локальном клоне шаблона в терминале удалите старый git remote и добавьте новый:

git remote remove origin
git remote add origin ssh://url-вашего-репозитория

Если репозиторий пуст, то можно просто сделать push. Иначе придётся сначала сделать pull:

# Если репозиторий пуст, то просто пушим.
git push --set-upstream origin main

# Если репозиторий не пуст, мержим ветку main и затем пушим.
git fetch origin
git merge origin/main -Xours --allow-unrelated
git push --set-upstream origin main

Доработка шаблона #

  1. Создайте новую ветку, например, iteration_1: git branch -b iteration_1
  2. Настройке .gitignore — в репозитории не должно быть посторонних файлов.
  3. В файле LICENSE укажите свои имена вместо имени преподавателя.
  4. Опишите свой проект в README.md.
  5. Дайте проекту название и аккуратно замените слово compiler на своё название в коде проекта.
  6. Выполните остальные задания первой итерации.

Чек-лист #

Проверьте себя:

  • Создан облачный репозиторий команды
  • Скопирован шаблон выбранного языка
  • Создана ветка под 1-ю итерацию
  • В репозитории задано новое название вместо “compiler”
  • В файле LICENSE указаны имена членов команды, при этом нет имени преподавателя
  • Изменения в ветке отправлены в origin

Документация и обучающие статьи #