Вы находитесь на странице: 1из 8

Использование сервиса

git.asi.ru
Краткая инструкция

В целях автоматизации проведения конкурса цифровых решений World AI&DATA


Challenge АНО «АСИ» развернули портал поддержки разработки решений для
задач на базе GitLab1, расположенного по адресу https://git.asi.ru .

Раздел задач конкурса World AI&DATA Challenge расположен по адресу


https://git.asi.ru/tasks/world-ai-and-data-challenge . В разделе собраны все задачи
конкурса, которые прошли экспертное голосование и признаны готовыми к
использованию в разработке решений в качестве постановок.

1 Одно из наиболее распространённых решений для поддержки коллективной разработки —


https://about.gitlab.com
Каждая задача представляет собой проект, в рамках которого опубликованы
данные задачи со спецификациями и её описание. В качестве примера можно
рассмотреть постановку по распознаванию азбуки Брайля: https://git.asi.ru/tasks/
world-ai-and-data-challenge/braille-text-optical-recognition .

Кроме описания задачи, в проекте задачи могут быть размещены файлы с


данными2 в тех случаях, когда их невозможно получить их открытых источников,

либо приведены ссылки для скачивания или получения иным образом .

2 Некоторые файлы представляют собой многотомные архивы, которые в названии файлов имеют в качестве
суффикса индекс тома, например, Student_Book_20200129T145202Z.zip.001. В таких случаях скачивать
необходимо все файлы и распаковывать их совместно.
Задачи, признанные членами экспертного жюри как международными, имеют
описания на двух языках.

Остальные задачи конкурса оформлены аналогичным образом.

Регламент работы с порталом git.asi.ru


Прежде, чем преступить к работе с порталом
https://git.asi.ru, на нём необходимо
зарегистрироваться. Сделать это можно двумя
способами:

• Регистрация при помощи сервиса Leader-ID


(рекомендуется)рекомендуется)

• Регистрация обычным способом при помощи


закладки Register на странице
https://git.asi.ru/users/sign_in

Второй вариант является предпочтительным, так


как он не требует заполнения формы, если Вы уже
зарегистрированы на портале https://leader-id.ru .
Если нет, Вам следует пройти регистрацию3.

В зависимости от выбранного способа после


регистрации Вам может прийти уведомление на
электронную почту, указанную при заполнении
формы. Необходимо выполнить присланные в нём
инструкции, чтобы портал активировал учётную
запись.

После регистрации портал приглашает начать работу:

В основе работы с порталом лежит регламент GitLab Flow4, который хорошо


известен разработчикам по всему миру. Мы планируем и рекомендуем вам
придерживаться его принципов. Дополнительно к нему прилагаем инструкцию по
использованию git в разработке проектов:

 https://tproger.ru/translations/beginner-git-cheatsheet/
Каждое решение или проект 2-го этапа конкурса World AI&DATA Challenge,
подаваемый на оценку жюри, должен иметь открытый режим доступа.

3 Использование действующего электронного адреса обязательно, так как с его помощью происходит
активация учётных записей на портале.
4 Подробнее — здесь: https://docs.gitlab.com/ee/topics/gitlab_flow.html ,
https://habr.com/ru/company/softmart/blog/316686/ .
Для индивидуальных участников конкурса мы предлагаем создавать приватный
проект в своём рабочем пространстве (рекомендуется)кнопка «Create a project»), а командам
будет удобнее создать рабочую группу (рекомендуется)кнопка «Create a group»), в рамках
которой будут работать члены команды.

Для защиты результатов вашей интеллектуальной деятельности до


момента передачи решения на голосование проект должен находиться в
личном пространстве индивидуального участника или приватной группе
команды.

После этого проекты и группы команд будут перенесены в раздел «Решения


конкурса → World AI&DATA Challenge», расположенный по адресу https://git.asi.ru/
solutions/world-ai-and-data-challenge .

Создание рабочих групп для команд


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

Владелец группы может добавить проект зарегистрированных пользователей, для


чего должен ввести несколько первых букв имени каждого из участников и
выбрать им роль.
Чаще всего, речь будет идти о роли Developer, но, если команда большая, можно
выбрать дополнительного управляющего репозиторием (рекомендуется)Maintainer).

Все проекты команды должны быть размещены в созданной группе.

Создание проектов для решения задач


Как уже указывалось ранее, решения задач конкурса должны размещаться либо в
персональных разделах авторов (рекомендуется)для индивидуальных участников), либо в
группах команд:

1. Выберите5 группу для размещения проекта.


2. Сверьте файл README.md создаваемого проекта с описанием в примере
(рекомендуется)https://git.asi.ru/tasks/example-project).

3. Установите «галочку» чтобы файл README.md был сформирован при


создании проекта.

5 Возможность предоставляется для владельцев рабочих групп, которыми, как правило, являются лидеры
команд.
Каждый создаваемый проект должен быть приватным, а наименование
проекта должно включать идентификатор задачи и её краткий заголовок.

Обращаем Ваше внимание — структура описания README.md должна


быть повторена в точности даже если в разделе нечего написать (в этих
случаях пишите фразу «Раздел не требует дополнительной
информции»).

Порядок подключения к репозиторию


Интегрированная среда разработки, используемая Вами, должна использовать
один из двух вариантов ссылок:

• Для подключения по HTTPS: https://git.asi.ru/<Идентификатор


группы/участника>/<Project slug>.git

• Для SSH: git.asi.ru:<Идентификатор группы/участника>/<Project slug>.git

Система попросит Вас ввести имя пользователя и пароль.


Инструкция для подключения с помощью командной
строки
Глобальные настройки
git config --global user.name "<Ваше ФИО>"

git config --global user.email "<Ваша электронная почта>"

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


git clone git.asi.ru:<Идентификатор группы/участника>/<Project slug>.git

или

git clone https://git.asi.ru/<Идентификатор группы/участника>/<Project slug>.git

cd <Project slug>

touch README.md

git add README.md

git commit -m "add README"

git push -u origin master

Подключение существующей папки


cd <Путь к существующей папаки>

git init

git remote add origin git.asi.ru:<Идентификатор группы/участника>/<Project


slug>.git

или

git remote add origin https://git.asi.ru/<Идентификатор


группы/участника>/<Project slug>.git

git add .

git commit -m "Initial commit"

git push -u origin master

Подключение существующего репозитория Git


cd <Путь к существующей папаки>

git remote rename origin old-origin

git remote add origin git.asi.ru:<Идентификатор группы/участника>/<Project


slug>.git

или

git remote add origin https://git.asi.ru/<Идентификатор


группы/участника>/<Project slug>.git

git push -u origin --all


git push -u origin --tags

Порядок передачи проектов на голосование


жюри конкурса
По завершении этапа конкурса каждый проект будет рассмотрен по формальному
набору критериев:

1. Итоговый результат проекта (рекомендуется)исходные коды, ресурсы, данные,


документация и презентация) находится в ветке master.

2. Описание проекта в файле README.md соответствует шаблону.


3. Презентация проекта составлена и её структура соответствует образцу.
4. Выполнение сценария подготовки среды выполнения проекта приводит к
успешному её развёртыванию.

5. Выполнение сценария сборки проекта приводит к успешной сборке


проекта.

6. Инструкции, приведённые в разделе «Примеры использования»,


исполнимы, а результаты выполнения соответствуют приведённому
описанию.

Проекты, не удовлетворяющие указанным выше критериям переноситься в группу


экспертного жюри конкурса6 и, следовательно, передаваться на голосование не
будут.

6 «Решения конкурса → World AI&DATA Challenge» по адресу https://git.asi.ru/solutions/world-ai-and-data-


challenge .