Создание репозитория #
Выбор Git хостинга #
Все изменения по проекту следует публиковать в Git-репозитории, размещённом в облаке.
- Одна команда — один репозиторий на все итерации проекта
- Рекомендуется использовать SourceCraft или Github
- SourceCraft — российская платформа компании Яндекс: https://sourcecraft.dev/
- Github — американская платформа компании Microsoft: http://github.com/
- Репозиторий может быть публичным или приватным.
Выберите Git-хостинг и зарегистрируйтесь в нём.
Создайте пустой репозиторий.
Если у вас приватный репозиторий, то следует добавить доступ на просмотр и комментирование преподавателю:
- SourceCraft:
sergey-shambir - Github:
sergey-shambir
Установка и настройка Git #
- Установите консольную утилиту Git
- Windows: https://gitforwindows.org/
- Ubuntu/Debian:
sudo apt install git
- Настройте имя и email-адрес, например:
git config --global user.name "Иван Иванов"git config --global user.email ivan.ivanov@example.com
- Создайте SSH ключи
- Добавьте публичный SSH ключ в свой аккаунт SourceCraft или Github
Выбор шаблона #
Выберите шаблон репозитория в зависимости от языка:
| Язык | Стек | Шаблон |
|---|---|---|
| C# | C# 14, .NET 10 | compiler-template |
| C++ | C++23, CMake | compiler-template-cpp |
| Go | Go 1.27, Make | compiler-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
Доработка шаблона #
- Создайте новую ветку, например,
iteration_1:git branch -b iteration_1 - Настройке
.gitignore— в репозитории не должно быть посторонних файлов. - В файле
LICENSEукажите свои имена вместо имени преподавателя. - Опишите свой проект в
README.md. - Дайте проекту название и аккуратно замените слово
compilerна своё название в коде проекта. - Выполните остальные задания первой итерации.
Чек-лист #
Проверьте себя:
- Создан облачный репозиторий команды
- Скопирован шаблон выбранного языка
- Создана ветка под 1-ю итерацию
- В репозитории задано новое название вместо “compiler”
- В файле
LICENSEуказаны имена членов команды, при этом нет имени преподавателя - Изменения в ветке отправлены в origin