Настройка репозитория

Настройка репозитория

Для перехода в настройки репозитория на странице репозитория в левой боковой панеле выберите вкладку Settings.

Изменение общих сведений о репозитории

При необходимости измените базовые сведения о репозитории на вкладке Basic:

• в поле Repository name измените название репозитория;
• для лучшей идентификации репозитория в веб-интерфейсе настройте или загрузите иконку репозитория. Иконка будет отображаться в списке репозиториев и на странице репозитория;
• в поле Repository URL есть возможность изменить URL-адрес репозитория. После изменения адреса не забудьте внести изменения в настройки git;
• в поле Description описание репозитория;
• в поле Select language выберите язык разработки исходного кода, размещённого в репозитории;
• в поле Status из раскрывающегося списка выберите статус репозитория.

Для применения изменений нажмите кнопку SAVE.

Настройка функций репозитория

В настройках репозитория на вкладке Functions вы можете настроить:

• в поле Edit online включите (или выключите) редактирования файлов репозитория в веб-интерфейсе;
• в поле PR submission message verification включите (или выключите) верификацию запросов на слияние;
• в поле PR cooperation включите (или выключите) функцию совместной работы в запросах на слияние;
• в поле PR forced review включите (или выключите) проверку запросов на слияние;
• в поле Read-only function включите (или выключите) функцию защиты файлов от изменения. При включённой функции появляется возможность управлять защитой файлов от изменений;
• в поле Watermark включите (или выключите) отображение имени пользователя и e-mail в веб-интерфейсе репозитория для защиты от снимков экрана;
• в поле Issue enabled включите (или выключите) функцию управления задачами в репозитории.
• в поле Wiki enabled включите (или выключите) функцию управления модулем wiki в репозитории.

Для применения изменений нажмите кнопку SAVE.

Настройка коммитов

В настройках репозитория на вкладке Push Settings настройте правила проверки коммитов:

• в поле Commit email verification включите (или выключите) проверку электронной почты подписи коммитов;
• в поле Force push включите (или выключите) возможность принудительной отправки изменений в репозиторий;
• в поле Commit message verification включите (или выключите) проверку описания коммита. При включённой функции сообщение коммита должно содержать идентификатор задачи из Gitlife Team;
• в поле File suffix limit настройте маску для файлов, которые не должны быть отправлены в репозиторий.
• в поле Maximum file size настройте максимальный размер отдельного файла в репозитории.

В разделе Change Request Push Review Rules настройте правила слияния.

Настройка ветвлений

Настройте правила ветвления для репозитория на вкладке Branch Settings:

• в поле Default branch settings выберите ветку по умолчанию для репозитория;
• в поле Allow new branch включите (или выключите) возможность создавать новые ветки для пользователей с правами совместной работы;
• в поле Enable branch prefix включите (или выключите) префиксы веток для стандартизации их наменования;
• в поле Branch number limit настройте количество веток в репозитории.

Настройка ветки по умолчанию

Если в вашем репозитории более одной ветки, то вы можете настроить ветку по умолчанию.

При создании и инициации репозитория в веб-интерфейсе Gitlife Code создает репозиторий с одной ветвью master, которая становится веткой по умолчанию. Ветка по умолчанию — это ветка, которую Gitlife Code выводит по умолчанию при переходе в репозиторий в веб-интерфейсе. При клонировании репозитория Git извлекает именно ветку по умолчанию. Если при добавлении изменений в репозиторий не указана ветка, то будет использоваться ветка по умолчанию.

Чтобы изменить ветку по умолчанию:

1. На странице репозитория перейдите на вкладку Settings чтобы перейти в настройки репозитория.
2. В левой панели выберите вкладку Branch settings.
3. В поле Default branch settings укажите новую ветку по умолчанию.
4. Нажмите кнопку Update.

Ветка по умолчанию изменена.

Настройка правил защиты веток

В разделе Branch protection rules настройте правила защиты веток.

Чтобы создать новое правило защиты веток:

1. Перейдите на страницу репозитория.
2. В левой панели откройте вкладку Settings.
3. На открывшейся странице в левой панели перейдите на вкладку Branch settings.
4. В разделе Branch protection rules нажмите на кнопку + New.
5. В поле Set matching rules задайте название одной ветки, либо укажите шаблон имени с помощью синтаксиса fnmatch. Например, чтобы защитить все ветки, содержащие слово release, можно указать шаблон release.
6. В поле Push code members укажите пользователей, которые смогут добавлять изменения в ветку.
7. В поле Merger pull request members укажите пользователей, которые смогут объединять изменения в запросах на слияние с целевой веткой.
8. В поле Review members укажите пользователей, с правами утверждения или отклонения запроса на слияние.
9. Укажите количество успешных ревью для возможности слияния запроса с целовой веткой.
10. При необходимости включите повторную проверку запроса на слияние при добавлении новых коммитов.
11. Нажмите кнопку Save для применения настроек.

Настройка правил скрытия веток

В разделе Branch protection rules настройте правила защиты веток.

Чтобы создать новое правило защиты веток:

1. Перейдите на страницу репозитория.
2. В левой панели откройте вкладку Settings.
3. На открывшейся странице в левой панели перейдите на вкладку Branch settings.
4. В разделе Hide Branch rules нажмите на кнопку + New.
5. В поле Branches укажите ветки, на которые будет распространяться правило.
6. В поле Role members укажите пользователей, которые будут видеть данные ветки.
7. Нажмите кнопку Save для применения настроек.

Настройка защиты файлов от изменения

На вкладке Read-only file settings выводится список файлов, защищённых от изменений. Здесь можно выключить защиту файлов от изменений для отдельных файлов.

Что включить защиту от записи отдельного файла в репозитории:

1. Перейдите на страницу репозитория.
2. В левой панели откройте вкладку Settings.
3. На открывшейся странице в левой панели перейдите на вкладку Repository.
4. В поле Read-only function установите чек-бокс Enable file/directory read-only function.
5. Нажмите кнопку Save для применения настроек.
6. Вернитесь на страницу репозитория.
7. Выберите ветку в которой хотите защитить файл.
8. Перейдите в папку где содержится файл для которого необходимо установить защиту от записи.
9. В списке фалов найдите нужный файл, нажмите правую кнопку мыши для открытия контекстного меню.
10. В контекстном меню выберите и нажмите пункт Marked as read-only.

У файла появится иконка замка, которая обозначает что в файл нельзя внести изменения.

Настройка защиты тегов

Настройте пользователей, которые имеют право управления тегами, подходящими под определённый шаблон. При создании или редактировании правила в поле Set matching rules укажите маску для соответсвия тегам Git, например, v* или *-release. В поле Tag management members укажите группы или отдельных пользователей.

Управление тегами запросов на слияние

INFO

Данные теги не имеют отношения к тегам git-репозитория. В этом разделе настраиваются только теги запросов на слияние.

1. Перейдите на страницу репозитория.
2. В левой панели откройте вкладку Settings.
3. На открывшейся странице в левой панели перейдите на вкладку Pull Request Settings.
4. В поле Pull Request title template задайте шаблон заголовка, который будет использоваться по умолчанию при создании запроса на слияние. В шаблоне можно использовать переменные:
   1. %{source_branch} – начальная ветка
   2. %{target_branch} – ветка назначения
   3. %{creator} – инициатор запроса
5. В поле Pull Request description template** задайте шаблон описания, который будет использоваться по умолчанию при создании запроса на слияние. В шаблоне можно использовать переменные:
   1. %{source_branch} – начальная ветка
   2. %{target_branch} – ветка назначения
   3. %{creator} – инициатор запроса
6. В поле Merge commit message template задайте шаблон cообщения коммита, которое будет использоваться при успешном слиянии. В шаблоне можно использовать переменные:
   1. %{id} – ID запроса на слияние
   2. %{title} – название запроса на слияние
   3. %{source_branch} – начальная ветка
   4. %{target_branch} – ветка назначения
   5. %{creator} – инициатор запроса
   6. %{reviewers} – список проверяющих, перечисленных через запятые
   7. %{approvers} – список согласующих, перечисленных через запятые
   8. %{acceptor} – имя пользователя, принявшего запрос на слияние
   9. %{url} – ссылка на спрницу запроса на слияние
7. В поле Squash submit message template задайте шаблон cообщения squash - коммита, которое будет использоваться при успешном слиянии. В шаблоне можно использовать переменные:
   1. %{id} – ID запроса на слияние
   2. %{title} – название запроса на слияние
   3. %{source_branch} – начальная ветка
   4. %{target_branch} – ветка назначения
   5. %{creator} – инициатор запроса
   6. %{reviewers} – список проверяющих, перечисленных через запятые
   7. %{approvers} – список согласующих, перечисленных через запятые
   8. %{acceptor} – имя пользователя, принявшего запрос на слияние
   9. %{url} – ссылка на спрницу запроса на слияние
8. Нажмите кнопку Save для применения настроек

Отображение репозитория

1. Перейдите на страницу репозитория.
2. В левой панели откройте раздел Settings.
3. На открывшейся странице в левой панели откройте раздел Functions.
4. Пролистайте область просмотра до блока Visibility.
5. Нажмите кнопку Adjust.
6. Выберите тип отображения репозитория:
   1. приватный – виден только членам репозитория
   2. открытый – виден всем пользователям системы

Сборщик мусора репозитория

1. Перейдите на страницу репозитория.
2. В левой панели откройте раздел Settings.
3. На открывшейся странице в левой панели откройте раздел Functions.
4. Пролистайте область просмотра до блока Repository GC.
5. Нажмите кнопку GC.

Перенос репозитория

1. В левой панели откройте раздел Settings.
2. На открывшейся странице в левой панели откройте раздел Functions.
3. Пролистайте область просмотра до блока Repository transfer.
4. Укажите адрес, куда нужно перенести репозиторий
5. Нажмите кнопку Transfer.

Очистка репозитория

DANGER

После очистки репозитория вы не сможете восстановить данные! Эта операция очистит код репозитория и запросы на слияние, но не очистит настройки репозитория.

Чтобы очистить репозиторий:

1. Перейдите на страницу репозитория.
2. В левой панели откройте раздел Settings.
3. На открывшейся странице в левой панели откройте раздел Functions.
4. Пролистайте область просмотра до блока Clear Repository.
5. Нажмите кнопку Clear.

Репозиторий будет очищен от содержимого. Настройки репозитория не будут затронуты.

Удаление репозитория

DANGER

После удаления репозитория вы не сможете его восстановить! Эта операция удалит репозиторий и все данные в нём.

Чтобы удалить репозиторий:

1. Перейдите на страницу репозитория.
2. В левой панели откройте раздел Settings.
3. На открывшейся странице в левой панели откройте раздел Functions.
4. Пролистайте область просмотра до блока Delete Repository.
5. Нажмите кнопку Delete.

Репозиторий будет удалён из рабочего пространства.