AEM解决方案,用于由于Docker上下文存档打包错误而跳过Cloud Manager中的自定义UI测试
如果Cloud Manager跳过自定义UI测试,即使您的测试在本地运行,则生成的UI测试Docker上下文存档可能会与父目录中的所需文件一起打包,而不是与存档根目录中的所需文件打包。 验证存档结构并更新Maven程序集配置可恢复Cloud Manager中的测试检测。
描述 description
环境
Adobe Experience Manager as a Cloud Service
问题/症状
当Cloud Manager无法在生成的Docker上下文存档中检测到UI测试选择加入文件时,通常会出现此问题。
- “自定义UI测试”步骤显示一条与“已跳过UI测试”类似的消息,因为在源代码存储库中未找到测试。
- 您的Playwright、Cypress、Selenium或其他受支持的UI测试将在本地运行,但Cloud Manager中不会显示任何UI测试执行。
testing.properties文件存在于存储库中,但Cloud Manager仍会跳过测试。- 您可以通过构建UI测试模块并检查
testing.properties在生成的*-ui-test-docker-context.tar.gz文件中的存储位置来确认问题。 运行tar -tvf target/*-ui-test-docker-context.tar.gz | grep testing.properties。 如果结果显示诸如some-folder/testing.properties之类的路径而不是仅显示testing.properties路径,则存档打包不正确。 - 您还可以通过检查
testing.properties是否存储在UI测试模块的pom.xml文件旁边,并且恰好包含ui-tests.version=1来确认配置。
解决方法 resolution
请尝试以下步骤来解决问题:
- 确认管道正在为UI测试模块使用正确的Git分支。 管道应使用包含
ui.tests模块和testing.properties的分支。 在管道配置和下一个管道执行摘要中确认此操作。 - 检查UI测试模块
pom.xml文件旁边是否存在testing.properties,以及是否恰好包含ui-tests.version=1。 您应在正确模块中看到具有所需值的文件。 直接在存储库中确认此操作。 - 在本地构建UI测试模块,以便生成Docker上下文档案。 您应该会在模块
target目录中看到以-ui-test-docker-context.tar.gz结尾的文件。 确认生成的存档使用ui-test-docker-context分类器。 - 检查生成的存档,并通过运行
tar -tvf target/*-ui-test-docker-context.tar.gz | grep testing.properties检查testing.properties是否存储在存档根目录下。 您应该只看到没有父文件夹前缀的testing.properties。 如果输出显示诸如some-folder/testing.properties之类的路径,则存档打包不正确。 继续下一步骤。 - 更新
assembly-ui-test-docker-context.xml以将Docker上下文打包到存档根目录下。 确保程序集保留<includeBaseDirectory>false</includeBaseDirectory>并包含testing.properties和根级别文件,如Dockerfile和wait-for-grid.sh。 您应该看到存储在归档文件的顶级(而不是包装器目录)的所需文件。 通过重建模块并重复存档检查来确认这一点,直到testing.properties出现在根目录为止。 - 提交打包更改,将其推送到管道使用的分支,然后再次运行管道。
Custom UI Testing步骤应该运行,而不是显示跳过消息。 在管道执行详细信息中确认这一点,并检查UI测试日志是否可用。 - 如果测试现在检测到但在执行期间失败,请检查管道运行的UI测试日志,并更正测试或框架特定的错误。 Cloud Manager应会成功检测并运行测试映像。 通过检查管道显示实际的UI测试执行而不是跳过的步骤来确认这一点。
如果出现以下症状且疑难解答步骤生成以下结果,请将票证提交到Adobe支持:存档在根目录下显示testing.properties,管道使用了正确的分支,并且Cloud Manager仍报告未找到UI测试。
在联系支持时包含存档列表、assembly-ui-test-docker-context.xml文件、UI测试模块pom.xml和管道执行URL。
recommendation-more-help
experience-cloud-kcs-help-kbarticles