Файл: Система управления версиями git и российский сервис хранения исходного кода gitflic.pdf
ВУЗ: Не указан
Категория: Не указан
Дисциплина: Не указана
Добавлен: 06.12.2023
Просмотров: 205
Скачиваний: 7
ВНИМАНИЕ! Если данный файл нарушает Ваши авторские права, то обязательно сообщите нам.
118
3.3.2. Создание нового репозитория
В верхнем меню щёлкните мышкой по знаку плюс и выберите «Новый проект». Заполните форму создания проекта. Обратите внимание на поле
URL. Оно состоит из двух частей: фиксированной и редактируемой. Фикси- рованная часть задаёт сетевой путь к папке с проектами пользователя. Ре- дактируемая часть позволяет задать имя вложенной папки, в которой будет храниться создаваемый проект. Запомните полный путь, он пригодится для подключения к проекту локального репозитория.
Переключатель «Публичный проект»/«Приватный проект» позволяет вы- брать уровень доступа к создаваемому проекту. Публичный проект будет виден всем посетителям сайта GitFlic, даже не зарегистрированным. Приватный про- ект будет доступен только пользователю, создавшему его (хозяин проекта) и тем пользователям, кому хозяин проекта предоставит доступ.
После заполнения полей нажмите кнопку «Создать проект». Откро- ется страница вновь созданного проекта. До добавления файлов в проект на этой странице будет находиться подробная информация, содержащая ко- манды git, позволяющие подключить к проекту локальный репозиторий. На странице приводятся следующие группы команд.
Глобальные настройки Git. Эти команды необходимо выполнить один раз, после установки git на компьютер. git config --global user.name "MyName" git config --global user.email
MyMail@MyServer.com
Клонирование удалённого репозитория (проекта) на локальный компьютер. При клонировании ав-
томатически создаётся новая директория, имя которой совпадает с именем проекта.
git clone https://gitflic.ru/project/MyName/testovyj-proekt.git cd testovyj-proekt touch README.md git add README.md git commit -m "add README" git push -u origin master
Преобразовать существующую директорию в репозиторий git и копирование в неё проекта.
cd existing_folder git init git remote add origin https://gitflic.ru/project/abulychev/testovyj-proekt.git git add git commit -m "Initial commit" git push -u origin master
Переименовать удалённый репозиторий и скопировать его на локальный компьютер.
cd existing_folder
119 git remote rename origin old-origin git remote add origin https://gitflic.ru/project/abulychev/testovyj-proekt.git git push -u origin –all git push -u origin –tags
3.3.3. Управление проектом
При выборе проекта открывается обзорная страница, на которой нахо- дятся:
− описание проекта;
− адрес сайта проекта;
− используемый язык программирования;
− содержание приложенного README-файла.
Для управления состоянием проекта предназначены кнопки «Наблю- дать», «Форк», «Избранное».
Кнопка «Наблюдать» используется для управления потоком уведом- лений. При её нажатии появляется выпадающее меню, в котором возможно выбрать режим для получения уведомлений:
− получать все уведомления;
− получать только уведомления, в которых упоминается пользователь;
− не получать уведомления.
Кнопка «Форк» позволяет создать новую ветку, используя текущий проект в качестве начальной точки.
Кнопка «Избранное» позволяет добавить проект в список избран- ных. Статус «Избранное» учитывается при использовании фильтра «Из- бранное» на странице «Проекты».
В верхней части окна проекта расположено дополнительное горизон- тальное меню, включающее пункты:
− Файлы – обзор файлов проекта.
− Проблемы – создание и управление задачами, возникающими в ходе выполнения проекта.
− Запросы на слияние – список запросов на слияние веток проекта и инструменты для управления слияниями.
− Коммиты – список выполненных коммитов.
− Ветки – список веток проекта.
120
− Теги – список тегов, используемых в проекте.
− Релизы – информация о выпущенных релизах.
− Статистика – статистические данные о проекте.
− Настройки – управление настройками проекта.
Ветки проекта выбираются в выпадающем меню над списком файлов
(рисунок 3.9). После выбора ветки можно просмотреть загруженные файлы проекта.
Рисунок 3.9 – Выбор ветки проекта
Копирование кода проекта (рисунок 3.10). Чтобы скопировать код проекта, откройте меню «Код» (расположено на зелёной плашке). Выберите вариант авторизации. Авторизация, при копировании проекта, может про- изводиться по протоколу HTTPS или по протоколу SSH.
Рисунок 3.10 – Копирование кода проекта
121
Рисунок 3.11 – Создание проблемы
1 ... 4 5 6 7 8 9 10 11 12
«Проблемы». На вкладке «Проблемы» (рисунок 3.11) находятся опи- сания текущих задач, выполняемых в ходе проекта. В проблемах описыва- ются ошибки, которые необходимо исправить, и задачи, которые необходимо выполнить для исправления/улучшения проекта. У проблем имеются статусы выполнения. По статусам проблемы делятся на «Новые», «В работе», «Закры- тые», «Завершённые». Предусмотрена возможность включения фильтра для выбора проблем на основании их статуса. На предпросмотре для проблемы ука- заны: статус; дата последнего обновления; имя пользователя, который послед- ним взаимодействовал с проблемой; тег проблемы.
Для создания новой «Проблемы» щёлкните мышкой по кнопке «Со- здать проблему». На странице создания проблемы укажите заголовок и опи- сание проблемы. В правой части формы укажите начальный статус про- блемы, назначьте ответственных (их можно выбрать из списка членов ко- манды или компании) и присвойте проблеме лейбл (релиз, фикс, ошибка, фича). После заполнения всех полей нажмите «Создать». Новая проблема отобразится в списке.
Запросы на слияние. На странице запросов на слияние находится список созданных запросов и кнопка для создания новых. В списке отобра- жён статус созданных запросов, также можно открыть запрос для просмотра изменений. После открытия запроса появятся кнопки, используя которые, возможно выполнить следующие действия:
− обсудить запрос на слияние в дискуссиях;
− просмотреть вкладку с коммитами, которые входят в данный запрос;
− просмотреть вкладку, которая наглядно отображает изменения в файлах.
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). Меню управления подпиской находится на странице проекта.
Нажмите на кнопку «Наблюдать». Откроется меню, в котором можно выбрать нужный тип подписки:
− все уведомления (подписка «Вся активность»);
134
− только уведомления, в которых упоминается пользователь, уста- навливающий данный тип подписки;
− отключить все уведомления, относящиеся к проекту.
Рисунок 3.22 – Управление подписками
1 ... 4 5 6 7 8 9 10 11 12
Для создания новой «Проблемы» щёлкните мышкой по кнопке «Со- здать проблему». На странице создания проблемы укажите заголовок и опи- сание проблемы. В правой части формы укажите начальный статус про- блемы, назначьте ответственных (их можно выбрать из списка членов ко- манды или компании) и присвойте проблеме лейбл (релиз, фикс, ошибка, фича). После заполнения всех полей нажмите «Создать». Новая проблема отобразится в списке.
Запросы на слияние. На странице запросов на слияние находится список созданных запросов и кнопка для создания новых. В списке отобра- жён статус созданных запросов, также можно открыть запрос для просмотра изменений. После открытия запроса появятся кнопки, используя которые, возможно выполнить следующие действия:
− обсудить запрос на слияние в дискуссиях;
− просмотреть вкладку с коммитами, которые входят в данный запрос;
− просмотреть вкладку, которая наглядно отображает изменения в файлах.
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). Меню управления подпиской находится на странице проекта.
Нажмите на кнопку «Наблюдать». Откроется меню, в котором можно выбрать нужный тип подписки:
− все уведомления (подписка «Вся активность»);
134
− только уведомления, в которых упоминается пользователь, уста- навливающий данный тип подписки;
− отключить все уведомления, относящиеся к проекту.
Рисунок 3.22 – Управление подписками
1 ... 4 5 6 7 8 9 10 11 12
3.3.13. Создание README для профиля
Пользователь может поделиться информацией о себе и своём проекте, создав README для своего профиля. README будет показан в верхней ча- сти страницы профиля пользователя.
Пользователь сам решает, какую информацию включать в README, ему дан полный контроль над тем, как он будет представлен на GitFlic. Ниже приведены несколько примеров информации, которую посетители могут найти интересной, забавной или полезной в вашем профиле README.
−
Раздел «Обо мне», в котором описывается ваша работа и интересы.
−
Проекты, которыми вы гордитесь.
README профиля пользователя будет отображён при условии со- блюдения следующих требований:
−
Пользователь создал репозиторий с именем, совпадающим с име- нем пользователя Gitflic.
−
Репозиторий публичный.
−
Репозиторий содержит файл с именем README.md в корне.
−
Файл README.md не пустой.
Для создания 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) могут управлять доступом участников компании к проектам.
Для создания новой компании откройте меню создания (знак плюс в