Провалившийся прогон CI не должен быть первым сигналом о неправильной настройке.
Прежде чем подключать TestSprite к CI, запустите testsprite doctor. Он проверяет, что ваш API-ключ, доступ к сети и версия CLI настроены правильно, — так что глупая проблема настройки не маскируется под реальный сбой теста.
Встроено в тот же CLI, которым вы уже пользуетесь
Проверьте свой API-ключ
testsprite doctor подтверждает, что ваш TESTSPRITE_API_KEY задан и действителен, прежде чем задача CI потратит первый прогон на ошибку аутентификации.
Проверьте доступ к сети и прокси
Корпоративные прокси и закрытые раннеры CI могут молча блокировать исходящие запросы. Doctor подтверждает, что CLI реально может достучаться до TestSprite, прежде чем вы узнаете об этом посреди пайплайна.
Подтвердите версию своего CLI
Несовпадение версии между установленной и той, которую ожидает ваш пайплайн, может привести к сбоям, похожим на баг продукта. Doctor отмечает это заранее.
Запускайте где угодно
Одна и та же проверка — настраиваете ли вы всё локально, подключаете новую задачу CI или разбираетесь, почему пайплайн коллеги не проходит аутентификацию.
$ testsprite doctor Checking environment... ✓ API key found and valid ✓ Network access to TestSprite confirmed ✓ CLI version up to date → environment looks good, ready to run tests $ testsprite doctor Checking environment... ✗ TESTSPRITE_API_KEY not set ✗ Network request blocked — check proxy configuration → fix these before running testsprite test run
Не позволяйте CI отлаживать вашу конфигурацию за вас
Пайплайн, который падает, даже не добравшись до ваших тестов, ничего не тестирует — он просто громко падает. Запуск testsprite doctor первым превращает вопрос «почему CI только что упал» в двухсекундный ответ.
Создано для подключения TestSprite к CI
Запускайте перед подключением CI
Добавьте testsprite doctor как первый шаг в пайплайне — сразу после установки, перед testsprite setup и любым реальным прогоном тестов.
Работает в связке с testsprite setup
Используйте testsprite setup --from-env --yes --agent <name>, чтобы настроить учётные данные неинтерактивно, а затем запустите doctor, чтобы подтвердить, что они реально работают.
Бесплатно и с открытым исходным кодом
npm install -g @testsprite/testsprite-cli даёт вам CLI. Он распространяется по лицензии Apache-2.0, так что ничто не мешает первой проверке.
Машиночитаемый вывод
Передайте --output json, чтобы получить результаты в формате, который ваш пайплайн может разобрать и обработать автоматически.
Нам доверяют компании по всему миру
"TestSprite предлагает богатую генерацию тест-кейсов, четкую структуру и легко читаемый код. Он также поддерживает простую онлайн-отладку с возможностью быстрого расширения путем генерации новых тест-кейсов."
"Автоматизация TestSprite помогает нам сократить огромное количество ручной работы. Разработчики могут легко обнаруживать и устранять ошибки на более ранних этапах процесса разработки."
Часто задаваемые вопросы
Что именно проверяет testsprite doctor?
Он проверяет, что ваш API-ключ задан и действителен, что CLI может достучаться до TestSprite через вашу сеть — включая работу через прокси, — и что установленная версия CLI актуальна.
Когда его нужно запускать?
Сразу после установки CLI и снова как первый шаг в любом новом пайплайне CI — перед testsprite setup или реальным прогоном тестов, чтобы проблема конфигурации падала быстро, а не посреди пайплайна.
Чем это отличается от простого запуска теста и наблюдения за тем, что сломается?
Провалившийся прогон теста из-за отсутствующего API-ключа или заблокированного сетевого запроса выглядит идентично реальному сбою продукта, пока вы не разберётесь. Doctor отделяет «ваша настройка сломана» от «ваш продукт сломан», прежде чем вы потратите прогон не на то.
Работает ли это в CI или только локально?
И там, и там — это одна и та же команда в обоих случаях. Запустите её локально во время настройки, а затем снова как шаг CI, чтобы проблема с прокси или учётными данными в окружении пайплайна не проскользнула незамеченной.
Что если она отметит проблему?
Она укажет, что именно не так — отсутствующий TESTSPRITE_API_KEY, заблокированный сетевой путь или устаревшая версия CLI, — так что вы сможете исправить именно эту проблему, а не отлаживать прогон теста, у которого никогда не было шанса начаться.