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

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

Если вы уже настроили интеграцию с 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-сертификат, поставьте галочку напротив Disable certificate validation.

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

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

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

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

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

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

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

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

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

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

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

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

Добавление ссылок на задачи

После настройки интеграции с GitLab вы можете добавлять ссылки на задачи в ваши тест-кейсы и запуски.

Чтобы связать тест-кейс с задачей GitLab:

1. Перейдите в раздел Тест-кейсы.
2. Откройте тест-кейс, который вы хотите связать с задачей, и нажмите на значок карандаша в правой части страницы, напротив Связанные задачи из баг-трекера.
3. В появившемся окне нажмите + Добавить.
4. В поле Баг-трекер выберите вашу интеграцию с GitLab Issues.
5. В поле Ключ выберите задачу, с которой хотите связать тест-кейс.
6. Нажмите Отправить.

Чтобы связать запуск с задачей GitLab:

1. Перейдите в раздел Запуски.
2. Нажмите ⋯ справа от запуска, который вы хотите связать с задачей, и выберите Изменить.
3. В открывшемся окне нажмите + Добавить в разделе Связанные задачи из баг-трекера.
4. В поле Баг-трекер выберите вашу интеграцию с GitLab Issues.
5. В поле Ключ выберите задачу, с которой хотите связать запуск.
6. Нажмите Отправить.