Быстрый старт
В этом руководстве описаны основные шаги для начала работы с образовательным пространством GitVerse Lab. Вы узнаете, как создать свой первый учебный модуль, подготовить шаблон репозитория и сформировать задание для участников.
Создание модуля
Модуль — это основное рабочее пространство, в котором будут группироваться ваши задания и список участников.
Для создания нового модуля выполните следующие действия:
- Нажмите на аватар вашего профиля в правом верхнем углу экрана и перейдите в раздел GitVerse Lab.
- Нажмите кнопку + Новый модуль.
- Выберите организацию, от лица которой будет вестись работа с учебными материалами.
- Введите понятное название для модуля и нажмите кнопку Создать модуль.
- Укажите желаемый уровень приватности.
Info
Если у вас еще нет собственной организации, вы можете создать ее прямо на этом этапе. Для этого выберите блок «Новая организация» и укажите ее название, настройки публичности и расширенные права администратора.
Подготовка репозитория для задания
Для создания задания платформе требуется репозиторий-шаблон. На его основе для каждого участника или команды будет автоматически создаваться персональная копия (форк). В таком репозитории обычно размещаются стартовые информационные материалы, инструкции или исходный код, с которым предстоит работать.
Чтобы подготовить репозиторий-шаблон, выполните следующие шаги:
- Откройте меню профиля (правый верхний угол) и перейдите в раздел Мои репозитории.
- Нажмите кнопку Создать репозиторий и введите его название.
- Обязательно отметьте чекбокс Сделать репозиторий шаблоном.
- Выберите уровень приватности (публичный или приватный).
- Отметьте чекбокс Добавить файл README, чтобы система сразу инициализировала репозиторий базовым файлом.
Tip
При создании вы также можете сразу добавить описание проекта и файл
.gitignore. Кроме того, на этом же экране доступна удобная функция импорта готового репозитория из GitHub, GitLab, Gitea или других внешних Git-сервисов.
Создание задания
После подготовки модуля и шаблона репозитория вы можете сформировать саму задачу и разослать приглашения участникам.
Порядок создания задания:
- Перейдите в созданный модуль GitVerse Lab и нажмите кнопку Новое задание.
- Введите название и выберите уровень приватности. Приватные задания видны только администраторам организации и приглашенным участникам, а публичные доступны для просмотра всем пользователям платформы.
- Выберите тип выполнения задачи. В индивидуальном задании каждый участник работает в своем форке самостоятельно. В групповом — участники объединяются в команды (вы можете ограничить количество команд и размер каждой из них).
- Установите дедлайн (срок сдачи) задания. Если вы включите опцию «Жесткий дедлайн», после наступления указанного времени участники потеряют возможность вносить изменения в свои репозитории. Этот шаг не является обязательным, параметры можно изменить позже.
- Выберите ранее созданный репозиторий-шаблон в соответствующем поле и нажмите Создать задание.
- Настройте доступные инструменты (CI/CD для запуска автопроверок, «Задачи» для ведения трекера, «Вики» для документации) и установите правила защиты веток, чтобы запретить принудительную отправку изменений (
force push). - Нажмите Сохранить, а затем Пропустить на шаге настройки автоматических тестов (эту конфигурацию можно будет выполнить позже).
- Нажмите Копировать ссылку-приглашение и отправьте ее вашей аудитории для начала работы.
Что дальше?
Поздравляем! Вы успешно настроили образовательное пространство GitVerse Lab. У вас уже есть активный модуль, готовое задание и связанный с ним репозиторий-шаблон.
Теперь вы можете перейти к следующим этапам настройки учебного процесса:
- ознакомьтесь с тем, как настроить автоматические проверки кода;
- узнайте, как импортировать списки участников для массового добавления на курс.