Система управления версиями Git. Система управления версиями git и российский сервис хранения исходного кода gitflic
![]()
|
Для создания новой «Проблемы» щёлкните мышкой по кнопке «Со- здать проблему». На странице создания проблемы укажите заголовок и опи- сание проблемы. В правой части формы укажите начальный статус про- блемы, назначьте ответственных (их можно выбрать из списка членов ко- манды или компании) и присвойте проблеме лейбл (релиз, фикс, ошибка, фича). После заполнения всех полей нажмите «Создать». Новая проблема отобразится в списке. Запросы на слияние. На странице запросов на слияние находится список созданных запросов и кнопка для создания новых. В списке отобра- жён статус созданных запросов, также можно открыть запрос для просмотра изменений. После открытия запроса появятся кнопки, используя которые, возможно выполнить следующие действия: − обсудить запрос на слияние в дискуссиях; − просмотреть вкладку с коммитами, которые входят в данный запрос; − просмотреть вкладку, которая наглядно отображает изменения в файлах. 122 Для создания нового запроса на слияние в выпадающем меню выбе- рите ветку, которую собираетесь слить, и нажмите кнопку «Создать». На стра- нице создания выберите ветку, с которой будет происходить слияние. Укажите название и описание для запроса на слияние, укажите ответственных пользова- телей, рецензентов, которые будут подавать свой голос за принятие или откло- нение запроса на слияние. Также можете указать лейблы к запросу на слияние. После заполнения всех полей нажмите кнопку «Создать». Для принятия запроса на слияние внизу страницы нажмите «Слить» (рисунок 3.12). Чтобы отклонить запрос на слияние или закрыть его, на кнопке рядом со «Слить» нажмите стрелку и выберите необходимый вариант. Рисунок 3.12 – Подтверждение слияния веток Коммиты. На вкладке коммиты (рисунок 3.13) находится история всех коммитов проекта. Для просмотра коммитов, относящихся к одной ветке, переключите ветку в выпадающем меню. Нажмите на интересующий вас коммит для просмотра изменений, зафиксированных в этом коммите. Рисунок 3.13 – Список коммитов 1 123 Ветки. На вкладке ветки находится информация обо всех созданных ветках и их текущем статусе. На странице отображена информация о стан- дартной ветке, рабочей, активной, а также все заброшенные ветки, которые ранее были использованы в работе с проектом. 3.3.4. Администрирование и просмотр публичных проектов 3.3.4.1. Клонирование репозитория Клонирование репозитория выполняется с использованием команд меню «Код» (расположено на зелёной плашке). Выберите протокол подклю- чения (HTTPS или SSH) и выполните команду клонирования для создания локальной копии. При использовании протокола ssh необходимо произвести дополнительную настройку аккаунта, добавив SSH ключ в меню Настройки/Ключи. 3.3.4.2. Избранное Добавить проект в избранное можно, нажав кнопку «Избранное» (ри- сунок 3.14) в горизонтальном меню на вкладке проекта. После добавления проекта в избранное он будет доступен на вкладке с избранными проектами на главной странице личного кабинета пользователя GitFlic. Для удаления проекта из списка избранных повторно нажмите на кнопку «Избранное». Список избранных проектов является непубличным и доступен только поль- зователю, создавшему его. Рисунок 3.14 – Добавление проекта в избранное 124 3.3.4.3. Переименование проекта Для переименования проекта откройте страницу настроек проекта. При переименовании существуют два сценария действий: 1. В поле с именем необходимо изменить название проекта. При этом в поле внутри жёлтой зоны настроек изменится его веб-адрес. Изменения произойдут в переменной части адреса. Поменяется транслитическое напи- сание в соответствии с новым названием. 2. Чтобы изменить только URL репозитория, в поле внутри жёлтой зоны настроек укажите желаемое название переменной части адреса. После нажатия кнопки «Переименовать» прежний URL репозитория будет недоступен. Все внешние ссылки на проект будет необходимо заме- нить на новый адрес. ВНИМАНИЕ! Не меняйте URL репозитория, если не уверены в своих действиях и не осознаете всех возможных последствий. 3.3.5. Видимость проекта Возможно изменить видимость проекта, сделав его публичным или приватным. Для изменения откройте страницу с настройками, опуститесь к красной зоне и нажмите «Изменить видимость» напротив надписи «Изме- нить видимость репозитория» (рисунок 3.15). Рисунок 3.15 – Изменение видимости проекта 125 Укажите необходимую опцию (публичный/приватный) и напишите контрольную фразу для подтверждения действия, затем нажмите кнопку «Сохранить». 3.3.6. Передача репозитория другому владельцу Для передачи репозитория перейдите в настройки к красной зоне. От- кройте меню передачи, нажав кнопку «Передать». Укажите, кому хотите пе- редать репозиторий (у вас должны быть права на создание проектов в ко- манде или компании, которой вы передаёте проект). 3.3.7. Добавление пользователей в проект Добавление пользователей в проект происходит на странице настроек проекта. На этой странице предусмотрено правое вертикальное меню. В этом меню выберите «Управление доступом». Произойдёт переключение на страницу «Участники проекта». Выберите вкладку «Пригласить пользова- теля». Укажите имя пользователя и дайте ему роль в проекте (пользователь должен быть зарегистрирован на сайте GitFlic). На бесплатном тарифе вы можете добавить только 4 новых участников. Для добавления большего ко- личества участников проекта необходимо перейти на платный тариф. 3.3.8. Просмотр списка публичных проектов Для того чтобы перейти к списку публичных проектов, в нижнем меню выберите пункт «хранилище кода». На экране появится список всех публичных проектов, созданных на сайте GitFlic. На сайте реализован поиск по списку публичных проектов. Поле по- иска находится в верхнем, горизонтальном меню. Для поиска по названию введите в поле часть названия проекта и нажмите на кнопку с увеличитель- ным стеклом. Произойдёт переход на страницу с результатами поиска. В правой, верхней части страницы результатов находится таблица со стати- стикой распределения проектов по языкам программирования. Эта таблица является интерактивной. Для уточнения поиска воспользуйтесь фильтром по языкам программирования, выбрав соответствующую строчку таблицы. Чтобы найти конкретный проект, введите в поле поиска полное, макси- мально точное название проекта. 126 Авторизованный пользователь может просматривать в разделе с про- ектами все публичные проекты пользователей, личные проекты, проекты, отмеченные как избранные, и проекты, в которых пользователь принимает участие (проекты других пользователей или компаний, в которые был при- глашен другими пользователями сервиса). 3.3.9. Создание нового проекта и управление настройками 3.3.9.1. Создание проекта В верхнем меню откройте пункт, обозначенный знаком плюс (рисунок 3.16), выберите команду «Новый проект». Откроется страница создания но- вого проекта, на которой расположена форма создания проекта. Заполните форму и нажмите кнопку «Создать проект». Владельцем проекта устанавливается текущий активный пользова- тель. Для смены владельца проекта нажмите на выпадающее меню и выбе- рите нужного владельца для создаваемого проекта. Владельцем проекта мо- жет быть как пользователь, так и команда или компания. В меню выбора владельца будут отображены все доступные на данный момент команды и компании, в которые текущий пользователь может добавлять проекты. Рисунок 3.16 – Создание нового проекта В поле «Название проекта» введите желаемое название проекта. Укажите, если требуется, язык программирования для проекта из вы- падающего меню. По умолчанию установлен Markdown. 127 Вы можете указать свой URL для проекта, если вам не подходит авто- матический вариант названия. Поле с описанием является необязательным. Если присутствует, то со- держит краткое описание проекта. После заполнения поля с описанием следует выбрать настройку при- ватности вашего проекта. Возможные варианты: − «Публичный», проект будет доступен для всех в интернете. − «Приватный» проект доступен только автору и пользователям, ко- торым автор явно предоставил доступ. После заполнения всех полей нажмите «Создать проект». 3.3.9.2. Изменение настроек проекта Процедура изменения настроек проекта подробно описана в разделе 3.3.4. В текущем разделе приводятся только краткие сведения. Для изменений настроек проекта выберите пункт «Настройки» допол- нительного горизонтального меню. Откроется страница настроек проекта, на которой можно изменить параметры, указанные при создании проекта. Внимание! Доступ к настройкам проекта имеет только владелец, либо назначенный администратор. На странице настроек можно изменить URL проекта. Нужно иметь в виду, что старый адрес после сохранения перестанет работать. Внимание! Не изменяйте адрес проекта, если не уверены в послед- ствиях. Чтобы изменить видимость проекта, нажмите на указанную кнопку. В открывшемся окне измените параметр видимости проекта и введите кон- трольную строку для подтверждения действия (её можно скопировать и вставить). Передача проекта происходит аналогично процессу смены видимости и требует ввода фразы для подтверждения действия, однако, для передачи 128 проекта новый владелец должен подтвердить действие передачи, в против- ном случае проект останется связанным с текущим профилем. Для добавления новых участников проекта откройте вкладку настройки/управление доступом (рисунок 3.17). Для поиска пользователя, которого вы собираетесь добавить, нажмите на поле «Пользователь», откро- ется выпадающее меню поиска. Начните вводить имя пользователя или имя профиля, поиск начнётся после ввода не менее 3 символов. После выбора пользователя укажите роль для нового участника вашего проекта. Для уда- ления пользователей из списка участников напротив имени пользователя нажмите на кнопку «Удаление». Рисунок 3.17 – Добавление пользователя 3.3.9.3. Настройка основных веток проекта Для настройки веток по умолчанию выберите пункт «Ветки» из пра- вого вертикального меню на вкладке «Настройки» (рисунок 3.18). Рисунок 3.18 – Настройка веток проекта 129 Можно настроить значения по умолчанию для следующих веток про- екта: − «Стандартная ветка проекта» – ветка, которая будет отображена при просмотре проекта; − «Рабочая ветка проекта» – ветка, в которую по умолчанию будут загружаться изменения, если не указана какая-либо другая ветка. 3.3.10. Работа с аккаунтом В настоящем разделе описываются действия с аккаунтом пользова- теля, такие как создание, заполнение профиля, изменение и т.п. 3.3.10.1. Профиль пользователя Профиль пользователя (рисунок 3.19) содержит личную информацию о пользователе GitFlic. Пользователь сам решает, какую информацию вклю- чать в свой профиль, чтобы гости и другие пользователи имели представле- ние о нём на GitFlic. Рисунок 3.19 – Создание профиля пользователя Поле для ввода имени и фамилии находится на главной странице настроек профиля. Биография – краткая, деловая характеристика пользователя. Привет- ствуется описание опыта работы, списка компаний, в которых пользователь работал, профессиональных навыков, уровня образования. Если у пользователя есть персональный сайт, можно указать его URL. Вместо URL возможно разместить ссылку на аккаунты в социальных сетях. 130 Имеется возможность указать название компании, в которой пользо- ватель работает или которую представляет. Незаменимым атрибутом профиля является аватар. Добавьте изобра- жение, чтобы профиль стал уникальным и узнаваемым. Приветствуются как личные фото, так и изображения, характеризующие личность пользователя. Для добавления фото нажмите кнопку «Обзор». Появится стандартное окно выбора файла. Выберите файл с необходимым изображением. Текущее имя можно изменить в любой момент на любое свободное. Если желаемое имя занято, то рекомендуется использовать альтернативное написание, например, с использованием чисел. Если пользователь обнару- жил неправомерное использование своего имени (имени компании), следует подать в службу поддержки жалобу по поводу неправомерного использова- ния товарного знака. 3.3.10.2. Настройка аккаунта Перейдите на главную страницу своей учётной записи, кликнув мыш- кой на своём логине в левом верхнем углу экрана. На главной странице нажмите кнопку «Редактировать профиль». Из правого вертикального меню выберите пункт «Аккаунт». Откроется стра- ница редактирования данных аккаунта, на которой можно выполнить сле- дующие действия. Изменить логин GitFlic на любой свободный (рисунок 3.20). Следует учитывать, что после сохранения нового логина предыдущий URL проекта станет недоступен, так как он будет изменён в соответствии с новым именем профиля (имя профиля является частью URL проекта). Рисунок 3.20 – Смена логина пользователя 131 Включение двухфакторной аутентификации. Двухфакторная аутентификация позволяет защитить аккаунт при помощи генерации вре- менных секретных кодов. Для подключения аутентификации потребуется использование мобильного телефона. Настроить аутентификацию по SSH-ключу. В GitFlic есть возмож- ность подключить аутентификацию по публичному SSH-ключу. Следую- щая процедура используется для проверки наличия SSH-ключа и создания нового SSH-ключа (при необходимости). Для того чтобы убедиться в отсутствии SSH-ключа, на локальном компьютере выполните следующие команды в командной строке операци- онной системы: cd /.ssh ls Найдите в списке файл с именем id_dsa или id_rsa и одноименный файл с расширением .pub. Файл с расширением .pub – это публичный ключ, а второй файл – приватный ключ. Если указанные файлы отсутствуют (или отсутствует директория .ssh),то у пользователя нет SSH-ключа. Для созда- ния SSH-ключа используются команды: cd / ssh-keygen -o Если на экране появился следующий текст, значит всё сделано верно, и ключ был создан. Generating public/private rsa key pair. Enter file in which to save the key (/home/gitflic_user/.ssh/id_rsa): Created directory '/home/gitflic_user/.ssh'. Enter passphrase (empty for no passphrase): Enter same passphrase again: Your identification has been saved in /home/gitflic_user/.ssh/id_rsa. Your public key has been saved in /home/gitflic_user/.ssh/id_rsa.pub. The key fingerprint is: d0:82:24:8e:d7:f1:bb:xx:yy:zz:96:93:49:da:9b:e3 gitflic_user@gitflic.ru Следующий шаг – получение публичного SSH-ключа из файла. От- кройте файл с публичным ключом (расширение pub) в текстовом редакторе и полностью скопируйте содержимое. На странице профиля выберите пункт «Ключ» из правого вертикального меню. Появится вкладка «SSH-ключи». Вставьте публичный ключ в соответ- ствующее поле, введите название ключа (произвольное). Если хотите, чтобы ключ был бессрочным, не заполняйте поле «Дата окончания действия». Изменение пароля. Имеется возможность в любой момент заменить 132 текущий пароль на новый. Для этого выполните следующие действия. Вы- берите пункт «Пароль» из правого вертикального меню на вкладке «Про- филь». Появится форма для смены пароля. Укажите старый пароль, введите новый, повторите ввод нового пароля и нажмите кнопку «Сохранить». Из- менить пароль можно также при входе в систему. Для этого нажмите кнопку «Забыли пароль». Рекомендуем не использовать одни и те же пароли на раз- личных сайтах. Добавьте несколько чисел или ассоциацию с сайтом, это по- высит надёжность. Для завершения работы с «Профилем» нажмите кнопку «Сохранить» внизу экрана. 3.3.11. Авторизация и регистрация Вход в систему GitFlic осуществляется при помощи почты и пароля. Также возможно использовать опцию продления сессии авторизации, для этого поставьте галочку напротив «Запомнить меня». Если пользователь забыл пароль, который указывал при регистрации, то возможно воспользоваться функцией восстановления пароля. Для этого нажмите кнопку «Забыли пароль». В появившемся окне ввода почты ука- жите e-mail, который был использован при регистрации, и нажмите «Отпра- вить письмо». В указанный почтовый ящик придёт письмо с инструкцией для создания нового пароля. Рисунок 3.21 – Регистрация нового пользователя 133 Для регистрации нового пользователя GitFlic на странице регистрации (рисунок 3.21) укажите почтовый адрес и пароль (пароль создаёт пользова- тель). Ознакомьтесь с Пользовательским соглашением и Политикой конфи- денциальности. Поставьте галочку, подтверждающую ваше согласие с до- кументами, и нажмите «Зарегистрироваться». В указанный почтовый ящик будет отправлено письмо с подтверждением. Перейдите по вложенной в письмо ссылке для активации профиля. 3.3.12. Уведомления В сервисе GitFlic реализована система внутренних уведомлений для пользователей. Пользователи уведомляются об изменениях в проектах, при- глашениях к дискуссии и прочих действиях внутри сервиса GitFlic. На стра- ницу с уведомлениями можно попасть, нажав на кнопку «Уведомления» в левом вертикальном меню, либо на кнопку «колокольчик» в верхнем, гори- зонтальном меню. На странице «Уведомления» отображены все уведомления, которые направлены пользователю. Они расположены в хронологическом порядке от новых к старым. Уведомлениям можно присвоить статусы: − прочитанные; − сохранённые. На вкладке «Прочитанные» отображены уведомления, которые поль- зователь отметил как прочитанные. Пользователь имеет возможность сохранить для себя важные уведом- ления, нажав на кнопку «Сохранить» напротив уведомления. Такие уведом- ления будут отображаться на вкладке «Сохранённые». GitFlic позволяет управлять потоком уведомлений с помощью «Под- писки» (рисунок 3.22). Меню управления подпиской находится на странице проекта. Нажмите на кнопку «Наблюдать». Откроется меню, в котором можно выбрать нужный тип подписки: − все уведомления (подписка «Вся активность»); |