Искусственный интеллект в тестировании. Часть 1

Интеграция облачной версии платформы ТестОпс с GitHub Actions позволяет автоматизировать запуск тестов и сбор результатов в единой системе. В этом руководстве мы пошагово настраиваем трёхстороннюю связку: результаты запуска GitHub Actions отправляются в TMS ТестОпс, из ТестОпс можно инициировать запуски workflow на GitHub, а с помощью MCP обеспечивается интеллектуальная интеграция и автоматизация процессов между всеми системами. В статье рассматриваем требования к окружению, генерацию необходимых токенов, изменение конфигурации рабочего процесса, настройку параметров окружения и возможные ошибки.

Подготовка окружения​

Требования к окружению​

Создание тестового локального проекта​

mkdir ~/workspace/<project-name>
cd ~/workspace/<project-name>

git init

npm init -y # флаг `-y` = «ответить “yes” на все вопросы»

npm i --save-dev jest jest-allure2-reporter

npm i --save-dev jest @shelex/jest-allure2-reporter

"scripts": {
  "test": "jest --reporters=\"default\" --reporters=\"@shelex/jest-allure2-reporter\" --outputDirectory=allure-results"
}

// hello.test.js
describe('Пример самого простого теста', () => {
  it('всегда проходит', () => {
    expect(true).toBe(true);
  });
});

npm test

Настройка репозитория на GitHub​

Создание и настройка удалённого репозитория​

ssh-keygen -t ed25519 -C "[email protected]"
    eval "$(ssh-agent -s)"
    ssh-add ~/.ssh/id_ed25519
    cat ~/.ssh/id_ed25519.pub

<div class="ql-code-block" data-language="plain">    git remote add origin [email protected]:`&lt;login&gt;`/`&lt;repo&gt;`.git</div><div class="ql-code-block" data-language="plain">    git add .</div><div class="ql-code-block" data-language="plain">    git commit -m "Первый тест"</div><div class="ql-code-block" data-language="plain">    git branch -M main</div><div class="ql-code-block" data-language="plain">    git push -u origin main</div>git remote add origin [email protected]:`<login>`/`<repo>`.git

git add .

git commit -m "Первый тест"

git branch -M main

git push -u origin mainhttps://qatools.ru/images/blog/guide-cursormcp+github+testops-pt1/screenshot-3.png

Генерация токенов​

Cоздание GitHub Personal Access Token (PAT)​

Получение API‑токена в ТестОпс​

Настройка GitHub Actions​

Создание и настройка рабочего процесса (workflow) для CI/CD через интеграцию allurectl​

cd ~/workspace/<project-name> # Указываем имя для папки проекта

mkdir -p .github/workflows
nano .github/workflows/tests.yml # откроется редактор nano. Можно заменить на любой редактор (Cursor, VS Code).

🔦 Примечание: В разделе, описывающем событие workflow_dispatch, нужно задать два специальных параметра запуска: ALLURE_JOB_RUN_ID и ALLURE_USERNAME. Эти параметры служебные – они заполняются системой ТестОпс при запуске из интерфейса. Если их не добавить, запуск рабочего процесса из ТестОпс будет невозможен и выйдет ошибка 422. О том, как с ними работать, рассказываем в разделе про параметризацию окружения.

name: Test & Report            # имя рабочего процесса видно во вкладке Actions

# Когда запускать
on:
  push:                         # каждое изменение кода
  workflow_dispatch:            # запуск «по кнопке» (нужен для ТестОпс)
    inputs:
      ALLURE_JOB_RUN_ID:
        description: ":)"       # служебные поля ТестОпс, оставляем
      ALLURE_USERNAME:
        description: ":)"

# Переменные окружения
env:
  ALLURE_ENDPOINT: https://testing.qatools.cloud
  ALLURE_PROJECT_ID: 7 # ← важно заменить на реальный ID проекта
  ALLURE_RESULTS: allure-results
  ALLURE_TOKEN: ${{ secrets.ALLURE_TOKEN }}

jobs:
  test:
    runs-on: ubuntu-latest # можно указать любую версию ОС

    steps:
      - name: Check Allure Token
        run: |
          if [ -z "$ALLURE_TOKEN" ]; then
            echo "ALLURE_TOKEN secret is missing"
            exit 1
          fi

      - name: Клонируем код
        uses: actions/checkout@v3

      - name: Ставим Node
        uses: actions/setup-node@v3
        with:
          node-version: 18

      - name: Ставим зависимости
        run: npm ci

      - name: Ставим allurectl
        uses: allure-framework/setup-allurectl@v1
        with:
          allure-endpoint: ${{ env.ALLURE_ENDPOINT }}
          allure-token: ${{ env.ALLURE_TOKEN }}
          allure-project-id: ${{ env.ALLURE_PROJECT_ID }}

      - name: Запускаем тесты
        run: allurectl watch -- npm test

Добавление токена из ТестОпс в секреты репозитория GitHub​

git add .github/workflows/tests.yml
git commit -m "CI: добавлен workflow Jest + Allure"
git push

Проверка GitHub Actions​

Подключение GitHub-интеграции в проекте ТестОпс​

Параметризация и управление окружением​

Объявление входных параметров в рабочем процессе​

env:
  TESTS_BROWSER: ${{ github.event.inputs.TESTS_BROWSER }}
  PRODUCT_VERSION: ${{ github.event.inputs.PRODUCT_VERSION }}

Создание глобальных переменных окружения в ТестОпс​

Сопоставление параметров рабочего процесса с переменными в проекте​

Добавление параметров к джобе в ТестОпс​

💡 Совет: Следует задавать одинаковые значения по умолчанию параметров и в GitHub (в YAML inputs default) и в ТестОпс. Это обеспечит единообразие – при запуске, инициированном с любой стороны, по умолчанию будет одно и то же окружение. Конечно, при запуске есть возможность изменить эти значения вручную.

Запуск рабочего процесса с нужными параметрами из ТестОпс​

Автогенерация тест-кейсов из CI​

Возможные ошибки и отладка интеграции​

Ошибки при подключении интеграции​

HTTP 422 при запуске из ТестОпс​

Нет результатов тестов в ТестОпс​

Статус сборки не отобразился или не обновляется​

Некорректные данные тестов​

Если проблема не поддаётся выявлению, стоит заглянуть в раздел Устранение неполадок официальной документации ТестОпс. В случае интеграции с облачной версией следует обратиться в техническую поддержку. Специалисты помогут разобраться и найти решение.

Коротко о главном​