Работа с Quality Gates Manager

1. Получите доступ в пространство в QGM;
2. После получения доступа перейдите в QGM.

Создание проекта в QGM

Создание пространства в QGM

Получение доступа в пространство в QGM

Сообщение о проблеме

Раздел "Пространства"

Увеличить

1. Вкладка Проекты. Содержит список всех проектов данного пространства. Позволяет редактировать список проектов в составе пространства, а также хранит список url-дистрибутивов в Nexus по каждому проекту.
   Основные элементы интерфейса вкладки:
   • Название проекта. При нажатии на название проекта происходит переход к списку url-дистрибутивов в Nexus;
   • Ключ проекта. В Nexus-терминологии это связка GroupId и ArtifactId (без версии);
   • Кнопка. Точечное редактирование данных конкретного проекта;
   • Ссылка. Дает возможность отредактировать название пространства, а также удалить или добавить проекты.
2. Вкладка Роли. Содержит список пользователей в разрезе ролей. Позволяет предоставлять доступ пространству в рамках выбранной роли.
   Основная функции вкладки: предоставление пользователю доступа в пространство.
   Основные элементы интерфейса вкладки:
   • Администратор. Возможен множественный выбор пользователей;
   • Пользователь пространства. Возможен множественный выбор пользователей.
3. Вкладка Quality Gates. Содержит список всех актуальных флагов QG для пространства и его проектов. Позволяет добавлять, удалять и редактировать список и описание актуальных флагов.
   Основная функция вкладки — создание нового кастомного флага Quality Gates.
   Основные элементы интерфейса вкладки:
   • Название Quality Gates. Название флагов (обязательных, рекомендованных, а также кастомных флагов команд);
   • Публичный. Кастомные флаги QG доступны для использования только для тех пространств, для которых они созданы. Если установлен признак публичности, это значит, что сторонние проекты (вне данного пространства) смогут только считать его. Если признак снят, то у сторонних проектов не будет доступа на считывание флага;
   • Пространство. Наименование пространства, для которого применяется QG;
   • Кнопка. Точечное редактирование данных конкретного флага.
4. Вкладка Флаги. Содержит информацию по всем поступившим флагам QG всех проектов текущего пространства.
   Основные элементы интерфейса вкладки:
   • Проект. Название проекта;
   • Версия. Версия дистрибутива, по которому проставлен флаг;
   • QG. Название флага QG;
   • Статус. Статус флага QG;
   • Пользователь. ТУЗ, от имени которой проставлен флаг;
   • Дата. Дата и время проставления флага в формате DD.MM.YYYY и hh:mm:ss соответственно;
   • Индекс. Индекс флага;
   • Источник. Источник флага;
   • Содержимое. Содержимое флага.

Создание пространства

1. Перейдите в одноименный раздел QGM и нажмите кнопку Создать пространство.
2. В появившемся окне укажите название пространства и добавьте необходимые проекты из уже существующих.
3. Нажмите кнопку Сохранить.

Предоставление пользователю доступа в пространство

• Администратор — может просматривать и вносить изменения в пространство, а также проекты входящие в него;
• Пользователь пространства — может только просматривать информацию по пространства без возможности внесения изменений.

1. Перейдите в необходимое пространство из списка.
2. Перейдите во вкладку Роли.
3. Назначьте Администраторов и Пользователей в пространстве.
4. В соответствующих полях введите ФИО пользователя и его логин.
5. Установите необходимые параметры.
6. Нажмите кнопку Сохранить.

Создание нового кастомного флага Quality Gates

1. Перейдите во вкладку QG и нажмите кнопку Создать QG.
2. В открывшемся окне заполните поля:
   • Название Quality Gate — краткое уникальное наименование флага;
   • Публичный — кастомные флаги QG доступны для использования только для тех пространств, для которых они созданы. Если установлен признак публичности, это значит, что сторонние проекты (вне данного пространства) смогут только считать его. Если признак снят, то у сторонних проектов не будет доступа на считывание флага;
   • Статусы — статусы, которые может принимать флаг. По умолчанию поле заполнено значениями OK и ERR. Вы можете удалить их, указав иные статусы;
   • Пространство — для которого применяется QG. Поле не доступно для правок;
   • Описание — для удобства последующей работы опишите суть проверок данного QG.
3. Нажмите кнопку Сохранить.

Раздел "Пользователи и права"

Создание роли пользователю

1. В левом боковом меню перейдите в раздел Пользователи и права → Роли, далее нажмите кнопку Создать роль.
2. Заполните следующие поля:
   • Название - укажите название роли;
   • Описание - кратко опишите функции, которые будет выполнять данная роль;
   • Область видимости - определите уровень/зону действия прав (варианты: QGM, пространства, проекты);
   • Пространства/Проекты - выберите проект/пространство, в рамках которых будут действовать права;
   • Права - выберите перечень прав для данной роли. Поддерживается множественный выбор.
3. Нажмите кнопку Сохранить.

Назначение роли пользователю

• Администратор — может просматривать и вносить изменения в пространство, а также проекты, входящие в него;
• Пользователь пространства — может только просматривать информацию пространства без возможности внесения изменений.

1. В списке выберите необходимое пространство.
2. Перейдите во вкладку Роли.
3. Выберите созданную ранее роль и укажите актуальную для нее учетную запись: в соответствующих полях введите ФИО пользователя или его логин, далее выберите все необходимые параметры и нажмите кнопку Сохранить.

Раздел "Флаги"

Увеличить

Увеличить

Раздел "Проекты"

• Название проекта - При нажатии на название проекта происходит переход к списку url-дистрибутивов в Nexus. Например, если проект был создан автоматически в момент публикации флага, название заимствуется по ключу проекта;
• Ключ проекта — в Nexus-терминологии связка GroupId и ArtifactId (без версии);
• CI (КЭ) — id КЭ системы;
• Система — название системы;
• Трайб — название трайба, к которому относится система;
• Пространство — пространство, в которое включен данный проект;
• Кнопка — вызов окна с полями для заполнения данных о новом создаваемом проекте.

Создание и редактирование проекта

1. Перейдите в одноименный раздел QGM и нажмите кнопку Создать проект.
2. Заполните следующие поля:
   • Название проекта — название нового проекта. Обязательное поле;
   • Ключ проекта — ссылка на проектную область в Nexus. Обязательное поле;
   • Пространство — пространство, в которое включен данный проект. Выбор пространства производится из списка. Привязку пространства можно осуществить позднее при редактировании проекта;
   • CI (КЭ) — id КЭ системы;
   • Система — название системы;
   • Трайб — название трайба, к которому относится система.
3. Нажмите кнопку Сохранить.

Предоставлению пользователю доступа к проекту

1. В левом боковом меню перейдите в раздел Пользователи и права → Назначенные права и нажмите кнопку Добавить запись;
2. В появившемся окне:
   • выберите проект, к которому будет предоставлен доступ;
   • выберите права. Для обычного пользователя актуальны права просмотра и редактирования проекта;
   • выберите пользователя.
3. Нажмите кнопку Сохранить.