Manager ManagerХранилище

Author: Manager Manager Displayed: 15949
Created: 13/06/2016 Updated: 02/08/2020
Version: 14
Tags: git, svn, repository
MoreLess

Как использовать хранилище

Что такое хранилище SCM
Как настроить глобальные настройки хранилища
Как активировать хранилище в проекте
Настроить автоматическое обновление хранилища

Если у вас есть репозиторий, который вы хотите использовать в Easy Redmine, вот как его подключить.

 

Что такое хранилище SCM

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

По мере того, как команды проектируют, разрабатывают и внедряют программное обеспечение, несколько версий одного и того же программного обеспечения обычно размещаются на разных сайтах, а разработчики программного обеспечения одновременно работают над обновлениями. Ошибки или функции программного обеспечения часто присутствуют только в определенных версиях (из-за исправления некоторых проблем и появления других по мере развития программы). Следовательно, для обнаружения и исправления ошибок жизненно важно иметь возможность извлекать и запускать разные версии программного обеспечения, чтобы определить, в какой версии возникла проблема. Также может быть необходимо разрабатывать две версии программного обеспечения одновременно (например, когда в одной версии исправлены ошибки, но нет новых функций (ветвь), в то время как в другой версии работают над новыми функциями (магистраль).

На самом простом уровне разработчики могут просто сохранить несколько копий разных версий программы и соответствующим образом пометить их. Этот простой подход использовался во многих крупных программных проектах. Хотя этот метод может работать, он неэффективен, так как необходимо сохранить много почти идентичных копий программы. Это требует большой самодисциплины со стороны разработчиков и часто приводит к ошибкам. Поскольку база кода одна и та же, она также требует предоставления разрешения на чтение-запись-выполнение ряду разработчиков, и это увеличивает нагрузку на кого-то, управляющего разрешениями, чтобы база кода не была скомпрометирована, что добавляет больше сложности. Следовательно, были разработаны системы для автоматизации некоторых или всех процессов контроля версий. Это гарантирует, что большинство этапов управления версиями скрыто за кулисами.

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

 

Как настроить глобальные настройки хранилища

Чтобы получить доступ к глобальным настройкам репозитория, перейдите в меню Дополнительно> Администрирование> Настройки> Хранилище. Параметры настройки следующие:

  • Включен SCM - выберите, какой SCM вы хотите включить. В списке отображаются все поддерживаемые клиенты репозитория и их статусы (зеленый значок = установлен; красный значок = не установлен). Справа находится информация о версиях установленных. Всегда проверяйте, установлен ли на сервере клиент репозитория, прежде чем пытаться его настроить.
  • Выборка автоматически фиксируется - если эта опция активирована, приложение автоматически получает новые ревизии, когда пользователь обращается к хранилищу.
  • Включить WS для управления репозиторием - этот параметр необходимо активировать, если вы хотите, чтобы репозитории автоматически извлекали ревизии из исходного репозитория. Вам также необходимо включить соответствующий веб-сервис в исходном репозитории - смотрите пункт ниже.
  • Ссылки на ключевые слова - определите ссылки на ключевые слова для задач в сообщениях фиксации. Используйте ссылочные ключевые слова, чтобы связать редакции с задачами в Easy Redmine.
  • Фиксация ключевых слов - определите фиксацию ключевых слов для задач в сообщениях фиксации. Фиксированные ключевые слова позволяют изменять статус задачи или ход выполнения, используя определенные ключевые слова в сообщениях о фиксации
  • Уполномочен - определите, какой из них будет применен к задаче, если в сообщении о фиксации используется фиксирующее слово.
  • Прикладные задачи - определение статуса задачи, если в сообщении о фиксации используется фиксирующее слово.
  • % Готово - укажите, какой процент выполненных заданий применяется к задаче, если в сообщении о фиксации используется фиксирующее слово.
  • Разрешить ссылаться на задачи всех других проектов и фиксировать их как встроенные - позволяет использовать GIT для прямой ссылки или закрытия задач только путем записи правильного ключевого слова и идентификатора задачи в сообщение фиксации. Работает кросс-проект.
  • Включить регистрацию времени - активация этой опции включает регистрацию времени для задачи через сообщение фиксации.
  • Активность за зарегистрированное время - определите активность за зарегистрированное время. Это действие используется для регистрации времени с помощью коммита.

Не забудьте сохранить изменения, нажав зеленую кнопку «Сохранить».

Примечание: Команды SCM можно настроить в файле config / configuration.yml. Пожалуйста, перезапустите приложение после редактирования.

Image20200627025710_1.png

 

Как активировать хранилище в проекте

Прежде чем вы сможете начать использовать репозиторий, вы должны включить соответствующий модуль в конкретном проекте. Для этого перейдите в Настройки проекта> Модули> установите флажок Хранилище> Сохранить настройки. Сразу после сохранения в верхнем меню проекта появляется вкладка Хранилище.

Image20200627025711_2.png

Нажмите на вкладку Хранилище, и откроется следующая форма. Здесь вы можете настроить глобальные настройки по умолчанию для получения сообщений о фиксации для этого конкретного проекта. Если оставить без изменений, применяются глобальные настройки. Чтобы создать новый репозиторий, нажмите на соответствующую кнопку в верхней части.

Image20200627025711_3.png

При создании хранилища параметры настройки меняются в зависимости от выбранного вами типа хранилища SCM. На следующем экране выберите тип хранилища SCM (например, Subversion, Darcs, Mercurial, CVS, Bazaar, Git), проверьте, является ли он основным хранилищ, вашим собственным идентификатором, URL-адресом репозитория, путем к хранилищу (при необходимости). ), кодировка пути (если требуется), логин и пароль к хранилищу (если требуется) и другие детали. Узнайте у своего поставщика хранилища SCM, как заполнять соответствующие поля, если вы не знаете. Когда закончите, нажмите на кнопку «Создать» ниже, чтобы создать хранилище.

ВАЖНО: Большинство серверов Git требуют авторизации с использованием ключа или базовой аутентификации http. Если вы предпочитаете авторизацию ключа, мы предоставим вам открытый ключ по запросу, который вы можете просто добавить в свой GitLab / GitHub. Таким образом, вместо http (s): // user: password@url/repo.git он будет иметь вид http (s): // user: repoclienttoken@url/repo.git

Вот так выглядит форма для создания Git-хранилища.

Image20200627025711_4.png

Вот так выглядит форма для создания хранилища Subversion.

Image20200627025711_5.png

Когда один или несколько репозиториев созданы, вы можете найти их список на странице хранилища проекта, как показано ниже.

Image20200627025711_6.png

Справа от списка вы можете найти несколько вариантов:

  • Пользователи - выберите или обновите пользователя Redmine, сопоставленного каждому имени пользователя, найденному в журнале хранилища. Пользователи с одинаковым именем пользователя и электронной почтой Redmine и репозитория автоматически сопоставляются.
  • Редактировать - редактировать настройки хранилища
  • Удалить - удалить репозиторий

Ниже вы можете увидеть пример настройки пользователей.

Image20200627025711_7.png

Если все настроено правильно, вы сможете увидеть файлы из хранилища в Easy Redmine, как показано в примере ниже.

Image20200627025711_8.png

 

Настроить автоматическое обновление хранилища

Клиент репозитория и Easy Redmine - это два разных приложения. Новые коммиты в ваш репозиторий не отражаются в Easy Redmine, если они не получены приложением. Вам нужно настроить веб-крючки на вашем хранилище (GitHub, GitLab, TortoiseSVN, ...) с информацией о вашем экземпляре Easy Redmine.

  1. Зайдите в администрирование >> настройки >> хранилища
  2. Включить WS для управления хранилищем
  3. Создать ключ API

Image20200627025711_9.png

  1. Сохранить
  2. Перейти к вашему клиенту репозитория
  3. Добавить веб-крючок

Допустим, ваш сайт easyredmine.company.com

Для GIT - https://easyredmine.company.com/sys/git_fetcher

или https://easyredmine.company.com/sys/git_fetcher?key=[API_key]&fetch_all=1 =>, чтобы получить все хранилища во всех проектах

или https://easyredmine.company.com/sys/git_fetcher?key=[API_key]&project_id=1234&fetch_all=1 => чтобы получить все репозитории с идентификатором проекта = 1234

- параметр "project_id =" должен содержать идентификатор проекта (автоматический номер в базе данных), а не идентификатор проекта (пользовательский текст), которые представляют собой два разных данных

- в зависимости от настроек клиента может потребоваться один URL или ключ в другом поле

Для SVN - https://easyredmine.company.com/sys/fetch_changesets

или https://easyredmine.company.com/sys/fetch_changesets?key=[API_key]

С пункта 5 все зависит от клиента хранилища и не связано с настройками Easy Redmine. Это то, что вы должны проверить после чистой установки или обновления с Redmine.

Add picture from clipboard