Система ТестОпс хранит артефакты (результаты тестов, вложения и т.д.) в файловой системе или в S3-совместимом хранилище. Понимание структуры этих папок поможет вам эффективно управлять данными и проводить их очистку.
Примечание: В самых последних версиях ТестОпс v5 для оптимизации работы с Amazon S3 была введена папка-шард shard_XXX, что повышает производительность. Она не нужна для других S3-совместимых решений.
Важное предупреждение об очистке папок!
Ручное удаление может привести к проблемам с целостностью данных. ТестОпс хранит ссылки на все вложения в своей базе данных, и если вы удалите файл напрямую, ссылка на него в проекте останется, но сам файл будет отсутствовать. Это приведет к ошибке 404 Not Found при попытке открыть вложение.
Особенно это касается папок(Для очистки данных в этих каталогах всегда используйте интерфейс ТестОпс или API):
tc (вложения тест-кейсов)
ss (вложения общих шагов)
tr (результаты тестов)
tfr (результаты фикстур)
Какие папки можно чистить вручную(Эти папки используются для временных файлов. Вы можете безопасно удалять их содержимое вручную, так как эти файлы не связаны напрямую с результатами тестов):
imp (импорт)
exp (экспорт)
Описание основных папок-хранилищ:
- upl (upload) - эта папка временное хранилище для файлов, которые только что были загружены в ТестОпс. После того как файлы обработаны, они перемещаются в соответствующие папки, а каталог upl очищается и удаляется.
- atc (attachment candidate) - в этот временный каталог перемещаются файлы из upl, которые система распознала как потенциальные вложения, но ещё не обработала. После привязки к результатам теста (tr) или фикстуры (tfr), файлы перемещаются в эти папки. Важно: содержимое каталога atc и сам каталог удаляются после закрытия запуска.
- tr (test result) - здесь хранятся вложения, связанные с результатами тестов. Файлы агрегируются в подпапки по 1000 штук, что оптимизирует производительность. Очистка этих папок происходит только для закрытых запусков и регламентируется правилами очистки, настроенными в системе.
- tfr (test fixture result) - этот каталог предназначен для вложений фикстур. Как и в случае с tr, файлы агрегируются аналогичным образом. Очистка также выполняется только для закрытых запусков согласно правилам очистки.
- tc (test case) - эта папка хранит вложения, которые привязаны непосредственно к тест-кейсам. Крайне важно: система никогда не удаляет файлы из этого каталога автоматически. Если вложения из tc отсутствуют, это указывает на их ручное удаление администратором или пользователем.
- ss (shared steps)-этот каталог хранит вложения, привязанные к общим шагам. Как и в случае с tc, файлы из этой папки не удаляются автоматически системой.
- imp (import) - используется для хранения CSV-файлов, загруженных для импорта тест-кейсов. Автоматической очистки не предусмотрено, поэтому файлы необходимо удалять вручную через пользовательский интерфейс или с помощью API.
- exp (export) - в этом каталоге хранятся файлы, сгенерированные при экспорте данных, например, списков тест-кейсов или запусков в форматах CSV или PDF. Как и в случае с imp, автоматической очистки нет, и файлы нужно удалять вручную или через API.