Система управления версиями Git. Система управления версиями git и российский сервис хранения исходного кода gitflic
 Скачать 3.56 Mb.
|
|
3.3.13. Создание README для профиля Пользователь может поделиться информацией о себе и своём проекте, создав README для своего профиля. README будет показан в верхней ча- сти страницы профиля пользователя. Пользователь сам решает, какую информацию включать в README, ему дан полный контроль над тем, как он будет представлен на GitFlic. Ниже приведены несколько примеров информации, которую посетители могут найти интересной, забавной или полезной в вашем профиле README. − Раздел «Обо мне», в котором описывается ваша работа и интересы. − Проекты, которыми вы гордитесь. README профиля пользователя будет отображён при условии со- блюдения следующих требований: − Пользователь создал репозиторий с именем, совпадающим с име- нем пользователя Gitflic. − Репозиторий публичный. − Репозиторий содержит файл с именем README.md в корне. − Файл README.md не пустой. Для создания README для профиля выполните следующие действия: − В правом верхнем углу любой страницы нажмите «+» и создайте новый проект. 135 − В разделе «Название проекта» введите имя проекта, соответствую- щее вашему имени пользователя GitFlic. Например, если ваше имя пользо- вателя “gitflicuser”, имя проекта (репозитория) должно быть “gitflicuser”. − По желанию, добавьте описание вашего проекта. − Отметьте чекбокс «Публичный проект» и нажмите кнопку «Создать проект». − Выполните клонирование репозитория или создайте подключение к удалённому репозиторию. − Создайте в корневой папке локального репозитория файл README.md с необходимым текстом. Используйте Markdown при необхо- димости. − Добавьте README.md в индекс и создайте новый коммит. Выпол- ните операцию push для сохранения изменений в удалённом репозитории. Если все шаги выполнены верно, README будет отображён в вашем профиле на вкладке «Обзор». 3.3.14. README для организации Пользователь может поделиться информацией о том, как взаимодей- ствовать с организацией, для которой он выполняет проект (рисунок 3.23). Для этого необходимо создать README профиля организации. Gitflic пока- зывает README профиля вашей организации на вкладке «Обзор». Пользователь сам выбирает, какую информацию включать в README. Рисунок 3.23 – Профиль организации с заполненным README Вот несколько примеров информации, которая может оказаться полезной. − Раздел «Об организации», описывающий вашу организацию. 136 − Руководство для получения помощи в организации, контакты орга- низации. Для создания README организации необходимо выполнить следую- щие действия: − Создайте публичный проект, который будет иметь название, совпа- дающее с названием вашей организации в Gitflic. Подробнее о создании проектов можно прочитать в разделе 3.3.9. − Выполните операцию клонирования или создайте удалённое под- ключение к существующему репозиторию. − В корне локального репозитория создайте файл README.md и за- полните его по своему усмотрению. При необходимости используйте Markdown. − Добавьте README.md в индекс и создайте коммит. Выполните операцию push для сохранения изменений в удалённом репозитории. Если все шаги выполнены верно, README вашей организации будет отображён на вкладке «Обзор компании». 3.3.15. Создание команды разработчиков Команды – это группа пользователей, которые объединены общими целями и/или задачами в совместном проекте. Для создания новой команды откройте меню создания (знак плюс в верхней части рабочей страницы GitFlic) и выберите пункт «Новая ко- манда». Откроется форма для ввода данных о команде (рисунок 3.24). За- полните поля формы. Выберете для новой команды уникальное название и укажите приватность. Рисунок 3.24 – Создание команды разработчиков 137 Для добавления участников в команду выполните следующие дей- ствия: − В левом вертикальном меню выберите пункт «Команды». На от- крывшейся странице перейдите на вкладку «Обзор команды». Если вы обладаете правами владельца или администратора, найдите пользователя, которого необходимо добавить (воспользуйтесь полем по- иска). Укажите роль участника в команде, определяющую права доступа. После приглашения нового пользователя в команду ему на почту придёт приглашение. Пользователь должен подтвердить своё согласие на вступле- ние в команду путём перехода по ссылке из приглашения. Возможные роли членов команды: − Гость – пользователь сможет только просматривать проекты ко- манды, вложенные задачи и запросы на слияние. Такая роль подойдёт ауди- торам. − Доносчик – пользователь сможет создавать задачи по проектам ко- манды. Такая роль подойдёт тестировщикам или менеджерам команды. − Разработчик – пользователь сможет полноценно управлять проек- тами и выполнять команды git. − Администратор – пользователь сможет редактировать настройки команды. Данную роль следует назначать с осторожностью. Удаление членов команды осуществляется на вкладке со списком участников команды. Внимание! В сервисе существует ограничение на количество участников ко- манды для бесплатных тарифов. Лимит составляет 5 пользователей в рамках од- ной команды/проекта. После превышения лимита предлагается создать компа- нию и перейти на платный тариф. 3.3.16. Создание компании Компания – это обобщённая учётная запись, в которой собраны поль- зователи и команды, ведущие совместную работу над проектами. Админи- страторы и владелец (пользователь GitFlic) могут управлять доступом участников компании к проектам. Для создания новой компании откройте меню создания (знак плюс в 138 верхней части рабочей страницы GitFlic) и выберите пункт «Новая компа- ния». Откроется форма создания новой компании. Необходимо заполнить поля формы, указав базовую информацию: название, описание и тип при- ватности. URL компании заполняется автоматически на основании назва- ния, но его, при желании, можно изменить. 3.3.17. Добавление сотрудников Приглашать пользователей в компанию можно напрямую или через команды разработчиков. Для добавления пользователей перейдите на стра- ницу «Компании», выбрав одноимённый пункт в левом вертикальном меню. Выберите компанию и пройдите на вкладку «Сотрудники компании». Вы- берите пользователя GitFlic через поле поиска и назначьте ему роль. Нажмите «Добавить». Новый сотрудник появится в списке сотрудников. Для добавления команды к компании создайте новую команду (см. п. 3.3.15). Владельцем команды укажите вашу компанию. После создания ко- манды добавьте в число участников пользователей GitFlic согласно проце- дуре, описанной в п. 3.3.15. Удаление сотрудников из компании или команды внутри компании доступно только пользователям с правами администратора компании. Для удаления откройте список участников компании, выбрав вкладку «Сотруд- ники компании» (рисунок 3.25). Напротив имени пользователя нажмите кнопку «Удалить». Если в компании существуют команды, то сотрудников можно удалять из команды. Стоит учитывать, что удалённый пользователь потеряет доступ к проектам компании, но у него могут остаться локальные копии проектов, с которыми он работал. Сотрудник компании с правами администратора может вносить изме- нения в профиль компании. Для этого на странице компании выберите из дополнительного горизонтального меню пункт «Настройки». Откроется страница профиля компании, на которой доступны изменения в названии, описании, контактном телефоне, адресе электронной почты и ссылки на сайт компании. Также есть возможность изменить URL. Помните, что после смены URL старый адрес будет недоступен, также он будет свободен для всех остальных пользователей GitFlic. В дополнение, администратор компа- нии может изменить видимость компании. 139 Рисунок 3.25 – Удаление сотрудника компании Просмотр публичных компаний доступен всем авторизованным поль- зователям. Имеется возможность просмотреть информацию о компании, публичные проекты, список пользователей и команд. Контрольные вопросы 1. Опишите принципы клонирования внешнего репозитория в среде программирования PyCharm. 2. Опишите особенности выполнения команды commit в среде про- граммирования PyCharm. 3. Опишите способы клонирования репозитория в среде программи- рования Visual Studio 4. Опишите инструмент, предназначенный для создания и использо- вания графической схемы репозитория в среде программирования Visual Studio. 5. Что такое учебный портал GitFlic? 6. Опишите процесс взаимодействия преподавателя и студента в ходе выполнения заданий на учебном портале GitFlic. 7. Как работает инструмент «наблюдать» в среде GitFlic? 8. Опишите процесс обработки запроса на слияние в среде GitFlic. 140 ЗАКЛЮЧЕНИЕ В основу любого технологического инструмента заложена идея, поз- воляющая в той или иной мере облегчить труд некоторого круга професси- оналов. Система управления версиями не является исключением. В её ос- нове лежит идея систематизации хранения истории развития программного продукта. В первой главе настоящего пособия представлена историческая ретроспектива, показывающая путь, который прошли системы управления версиями, начиная с набора упорядоченных файлов и заканчивая сложными структурами данных. Последние основаны на хранении разностных текстов и систематизации связанной информации на основании деревьев и линейных упорядоченных списков. Изложенный материал позволяет проследить развитие концепций организации систем управления версиями, понять современное со- стояние этого инструмента и увидеть перспективы его развития. Любой профессионал должен досконально знать свой рабочий ин- струмент. Не только основные приёмы его использования, но и детали внут- реннего устройства. Целью второй главы является раскрытие глубинного устройства и структуры одной из наиболее популярных систем управления версиями, каковой, несомненно, является Git. Описание правил перемеще- ния файлов программного проекта между внутренними хранилищами Git нацелено на создание у читателя целостного представления о структуре ра- бочих каталогов репозитория. Детальное рассмотрение операций с ветвями проекта позволяет понять концепцию одновременной отработки множества идей и решений в рамках одного проекта. Владение инструментарием со- здания, переключения и слияния ветвей даёт возможность управлять проек- том любой сложности, не запутаться в хитросплетениях множества одно- временно решаемых задач. Вернуться к проверенному решению из аварий- ной ситуации, опубликовать предыдущую версию без прекращения работы над новым релизом, устранить конфликты в текстах частей проекта. Всё это и многое другое доступно при глубоком понимании организации локальных и удалённых репозиториев Git. После изучения теории необходимо переходить к практике. В третьей главе учебного пособия рассмотрены приёмы практического использования 141 Git. На примерах сред программирования PyCharm и Visual Studio рассмот- рены приёмы организации работы с репозиторием непосредственно в среде программирования. Объединение преимуществ среды программирования и системы управления версиями делает работу программиста более продук- тивной, а его взаимодействие с коллегами удобным и необременительным по времени. В результате группы программистов, разделённых географиче- ски, могут работать не менее эффективно, чем их коллеги, находящиеся в пределах одного офиса. Вторая тема, затронутая в практической части настоящего учебного пособия, касается учебного портала GitFlic. GitFlic возник на стыке двух технологий: инструмента для организации удалённого учебного процесса и системы управления версиями Git. Учебная часть GitFlic обеспечивает со- здание модели учебного процесса в высшем учебном заведении. Позволяет описывать не только административную организацию факультетов и ка- федр, но и структуру лекций и практических занятий. Git, в рамках учебного портала GitFlic, обеспечивает хранение истории учебных проектов, выпол- няемых студентами. Преподавателям предоставляется возможность ознако- миться со всеми этапами работы их учеников, указать на неточности и по- мочь найти правильное решение. 142 БИБЛИОГРАФИЧЕСКИЙ СПИСОК 1. Прокопюк, А. Тонкости благополучного git-merge. Сентябрь 2013 г. / А. Прокопюк. – URL: https://habr.com/ru/post/195674/ (дата обраще- ния: 20.05.2022). – Текст: электронный. 2. Chacon, S. Pro Git / S. Chacon, B. Straub. – Apress, 2014. – 496 p. 3. GitFlic. 2022. – URL: https://www.gitflic.ru/ (дата обращения: 25.05.2022). – Текст: электронный. 4. GNU. 28 December 2015 г. CVS – Concurrent Versions System v1.11.23. – URL: https://www.gnu.org/software/trans-coord/manual/cvs/ html_node/ (дата обращения: 20.05.2022). – Текст: электронный. 5. Nguyen, T.-T. GNU RCS 5.10.1. January 2022 г. / T.-T. Nguyen. – URL: https://www.gnu.org/software/rcs/manual/rcs.html (дата обращения: 20.05.2022). – Текст: электронный. 6. Oracle Corporation. Chapter 5 SCCS Source Code Control System. 2010. – URL: https://docs.oracle.com/cd/E19504-01/802-5880/6i9k05dhp/in- dex.html (дата обращения: 20.05.2022). – Текст: электронный. 7. Pilato, C. Michael. Version Control with Subversion / C. Michael Pi- lato. – 2nd Edition. – O'Reilly Media, Inc, 2008. – 407 p. 8. Schilling, J.E. An Introduction to the Source Code Control System / J.E. Schilling. – Berkeley: University of California at Berkeley, 2020. 143 УЧЕБНОЕ ИЗДАНИЕ Булычев Андрей Александрович СИСТЕМА УПРАВЛЕНИЯ ВЕРСИЯМИ GIT И РОССИЙСКИЙ СЕРВИС ХРАНЕНИЯ ИСХОДНОГО КОДА GITFLIC УЧЕБНОЕ ПОСОБИЕ Редактор Демиденко В.К. Корректор Демиденко В.К. Компьютерная верстка Луговая С.А. Электронное издание. Подписано в тираж 09.11.2022 г. Печ. л. 9. Усл.-печ. л. 8,37. Уч.-изд. л. 5,39. Объем 2,3 Мб. Тираж – 500 (первый завод – 30) экз. Заказ № Отпечатано в ООО «Минэлла Трэйд», 115419, Россия, Москва, ул. Орджоникидзе, д. 9, корп. 2, пом. 5, тел.: 8 (495) 730-41-88. Макет подготовлен в редакционно-издательском отделе ЧОУВО «Московский университет им. С.Ю. Витте», 115432, Россия, Москва, 2-й Кожуховский проезд, д. 12, стр. 1, тел.: 8(495) 783-68-48, доб. 53-53. |