Интеграция с таск-трекером GitLab

В этой инструкции описывается, как настроить интеграцию с таск-трекером GitLab (GitLab Issues), чтобы иметь возможность добавлять ссылки на задачи в тест-кейсы и запуски в ТестОпс (см. Ссылки на задачи из таск-трекеров).

Если вам нужно настроить интеграцию с GitLab CI для запуска тестов и получения результатов тестов, см. инструкцию Интеграция с GitLab.

Примечание

Чтобы настроить или удалить интеграцию в ТестОпс, вы должны иметь доступ к разделам:

• Администрирование — необходимы права администратора инстанса;
• Настройки в конкретном проекте — необходима роль владельца этого проекта.

Если вы уже настроили интеграцию с GitLab CI для вашего инстанса GitLab, единственное, что вам нужно сделать, чтобы связывать тест-кейсы с задачами GitLab, это добавить ID проектов GitLab в вашу текущую интеграцию (см. раздел Включите интеграцию для проекта ТестОпс).

Настройка интеграции

Чтобы настроить интеграцию с таск-трекером GitLab:

1. Создайте токен доступа в GitLab.

2. На уровне инстанса ТестОпс добавьте интеграцию с GitLab, указав:

   • название интеграции;
   • URL-адрес GitLab.

3. На уровне инстанса или проекта ТестОпс включите добавленную интеграцию для проекта, указав созданный токен доступа из GitLab.

1. Создайте токен доступа в GitLab

1. В GitLab нажмите на ваш аватар и выберите Preferences.

2. В меню слева нажмите Access Tokens.

3. Нажмите Add new token в правой части страницы.

4. Заполните поля:

   • Token name — название, которое поможет вам распознать токен (например, Токен для ТестОпс).
   • Expiration date — срок действия токена (любая дата в пределах года с текущей даты). После указанной даты интеграция перестанет работать. Чтобы возобновить ее работу, вам нужно будет создать новый токен.

5. Поставьте галочки api и read_api в разделе Select scopes.

6. Нажмите Create personal access token. После обновления страницы вы должны увидеть созданный токен.

7. Нажмите иконку копирования под Your new personal access token, чтобы скопировать токен в буфер обмена.

   Cохраните токен в безопасном месте, он понадобится для настройки интеграции в проекте ТестОпс.

Вы также можете использовать токен доступа проекта вместо личного токена доступа, но в этом случае интеграция будет ограничена одним проектом.

2. Добавьте интеграцию с GitLab в ТестОпс

1. Перейдите в ваш инстанс ТестОпс.

2. Перейдите в раздел Администрирование → Интеграции.

3. Нажмите + Добавить интеграцию в правом верхнем углу.

4. В списке доступных интеграций выберите GitLab.

5. Заполните поля:

   • Название — название, которое поможет вам распознать интеграцию, например, GitLab production.
   • Endpoint — URL-адрес вашего инстанса GitLab, например, https://gitlab.example.com/.

6. Если ваш инстанс GitLab использует самоподписанный SSL-сертификат, поставьте галочку напротив Отключить проверку сертификата.

7. Нажмите Добавить интеграцию.

3. Включите интеграцию для проекта ТестОпс

Чтобы включить интеграцию в нужном проекте ТестОпс воспользуйтесь одним из двух способов ниже:

1. Перейдите в раздел Администрирование → Интеграции.

2. В списке настроенных интеграций найдите и откройте вашу интеграцию с GitLab.

3. Перейдите на вкладку Проекты.

4. Нажмите + справа от поля поиска.

5. В выпадающем списке Проект выберите нужный проект.

6. В разделе Настройки добавьте ID проектов GitLab, которые вы хотите использовать.

   Чтобы найти ID проекта, откройте проект в GitLab и перейдите в Settings → General

7. В разделе Секрет введите токен доступа GitLab, который вы сохранили на шаге 1.

8. Нажмите Добавить интеграцию, чтобы сохранить настройки.

Удаление интеграции

Вы можете удалить интеграцию с GitLab двумя способами — на уровне всего инстанса ТестОпс или на уровне отдельного проекта.

Важно

Последствия удаления интеграции:

• Удаление на уровне инстанса — все связи с задачами GitLab, которые относятся к интеграции, будут удалены из сущностей ТестОпс. Это действие необратимо — восстановить удалённые ссылки будет невозможно.

• Удаление на уровне проекта — все связи с задачами GitLab, которые относятся к интеграции, будут сохранены в сущностях ТестОпс, но вы не сможете создавать новые связи для этого проекта.

Чтобы удалить интеграцию на уровне инстанса ТестОпс, предварительно удалите ее из проектов, в которых она используется.

1. Перейдите в раздел Администрирование → Интеграции.
2. В списке настроенных интеграций найдите и откройте вашу интеграцию с GitLab.
3. На вкладке Конфигурация нажмите Удалить интеграцию.
4. Нажмите Удалить.