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

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

Примечание

Чтобы настроить или удалить любую интеграцию ТестОпс с внешней системой, необходима глобальная роль «Администратор» в инстансе ТестОпс и, как правило, права администратора инстанса внешней системы.

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

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

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

1. Создайте токен доступа в GitLab.
2. Подключите интеграцию с GitLab на уровне инстанса ТестОпс.
3. Добавьте настроенное подключение к GitLab в проект ТестОпс.

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

1. В GitLab нажмите на ваш аватар и перейдите в раздел Preferences.

2. В сайдбаре слева перейдите в раздел Access Tokens.

3. Если форма создания токена не появилась, над списком токенов нажмите Add new token.

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

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

5. В секции Select scopes поставьте галочки напротив api и read_api.

6. Нажмите Create token.

   После обновления страницы вы должны увидеть созданный токен.

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

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

Совет

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

2. Подключите интеграцию с GitLab на уровне инстанса ТестОпс

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

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

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

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

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

   • Название подключения — введите название, которое поможет вам распознать интеграцию (например, GitLab production).

   • Endpoint — введите URL-адрес вашего инстанса GitLab (например, https://gitlab.example.com/).

   • Тип учетных данных — нажмите на выпадающий список и выберите тип учетных данных GitLab, который будет поддерживать интеграция:

     • Все (глобальные и проектные) — интеграция может работать как с глобальными, так и с проектными учетными данными;
     • Только глобальные — интеграция может работать только с глобальными учетными данными;
     • Только проектные — интеграция может работать только с проектными учетными данными.

     Примечание

     Подробнее о поддерживаемых типах учетных данных см. Интеграции с внешними системами → Глобальные и проектные учетные данные

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

7. В секции Проекты из GitLab добавьте проекты GitLab, задачи из которых вы планируете использовать:

   1. Нажмите + Добавить.

   2. В поле ID проекта введите ID проекта GitLab.

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

8. Если интеграция может работать с глобальными учетными данными GitLab, в секции Глобальные учетные данные введите токен доступа GitLab, который вы сохранили на шаге 1.

9. Нажмите Добавить подключение.

3. Добавьте настроенное подключение к GitLab в проект ТестОпс

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

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

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

3. В списке настроенных подключений найдите и откройте ваше подключение к GitLab.

4. Нажмите Добавить в проект.

5. В списке доступных проектов выберите нужный проект ТестОпс.

6. Если интеграция может работать и с глобальными, и с проектными учетными данными GitLab, в поле Тип учетных данных нажмите на выпадающий список и выберите вариант, который будет использоваться в проекте:

   • Проектные — использовать проектные учетные данные для подключения к GitLab;
   • Глобальные — использовать глобальные учетные данные для подключения к GitLab.

7. Если интеграция будет работать с проектными учетными данными GitLab, в секции Проектные учетные данные введите токен доступа GitLab, который вы сохранили на шаге 1.

8. Нажмите Добавить в проект.

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

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

Важно

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

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

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

Во время удаления интеграции с таск-трекером GitLab также будет удалена интеграция с CI-системой GitLab. Подробнее о последствиях см. Интеграция с CI-системой GitLab → Удаление интеграции.

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

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

3. В списке настроенных подключений найдите ваше подключение к GitLab и убедитесь, что оно не используется в проектах ТестОпс.

   Если интеграция подключена к проектам, удалите ее из них. Для этого откройте карточку подключения к GitLab и напротив названия каждого проекта нажмите ⋯ → Удалить из проекта → Да, удалить.

4. Напротив нужного подключения к GitLab нажмите ⋯ → Удалить → Да, удалить.