UI测试

UI测试是在Docker图像中打包的基于Selenium的测试，以允许在语言和框架（如Java和Maven、Node和WebDriver.io，或任何基于Selenium构建的其他框架和技术）中进行广泛的选择。 Docker图像可以使用标准工具创建，但在执行时必须遵守某些约定。 运行Docker映像时，将自动设置Selenium服务器。 下面描述的运行时约定允许您的测试代码访问Selenium服务器和测试中的AEM实例。

构建UI测试

UI测试是使用Maven项目生成的Docker生成上下文构建的。 Cloud Manager使用Docker构建上下文生成包含实际UI测试的Docker图像。 总之，Maven项目会生成Docker生成上下文，Docker生成上下文描述如何创建包含UI测试的Docker图像。

本节介绍将UI测试项目添加到存储库所需的步骤。 如果您时间仓促或对编程语言没有特殊要求，AEM Project Archetype可以为您生成UI测试项目。

生成Docker生成上下文

要生成Docker构建上下文，您需要一个Maven模块，以：

• 生成一个存档，其中包含Dockerfile和使用测试构建Docker映像所需的所有其他文件。
• 使用ui-test-docker-context类元标记存档。

实现此目的的最简单方法是配置Maven Assembly Plugin以创建Docker构建上下文存档并为其分配正确的分类器。

您可以使用不同的技术和框架构建UI测试，但本节假定您的项目布局方式类似于以下内容。

├── Dockerfile
├── assembly-ui-test-docker-context.xml
├── pom.xml
├── test-module
│   ├── package.json
│   ├── index.js
│   └── wdio.conf.js
└── wait-for-grid.sh

pom.xml文件负责Maven内部版本。 向Maven Assembly插件添加执行，如下所示。

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-assembly-plugin</artifactId>
    <configuration>
        <descriptors>
            <descriptor>${project.basedir}/assembly-ui-test-docker-context.xml</descriptor>
        </descriptors>
        <tarLongFileMode>gnu</tarLongFileMode>
    </configuration>
    <executions>
        <execution>
            <id>make-assembly</id>
            <phase>package</phase>
            <goals>
                <goal>single</goal>
            </goals>
        </execution>
    </executions>
</plugin>

此执行将指示Maven Assembly Plugin根据assembly-ui-test-docker-context.xml中包含的说明创建存档，该说明在插件的术语中称为“程序集描述符”。 程序集描述符将列表所有必须属于存档的文件。

<assembly>
    <id>ui-test-docker-context</id>
    <includeBaseDirectory>false</includeBaseDirectory>
    <formats>
        <format>tar.gz</format>
    </formats>
    <fileSets>
        <fileSet>
            <directory>${basedir}</directory>
            <includes>
                <include>Dockerfile</include>
                <include>wait-for-grid.sh</include>
            </includes>
        </fileSet>
        <fileSet>
            <directory>${basedir}/test-module</directory>
            <excludes>
                <exclude>node/**</exclude>
                <exclude>node_modules/**</exclude>
                <exclude>reports/**</exclude>
            </excludes>
        </fileSet>
    </fileSets>
</assembly>

程序集描述符指示插件创建类型为.tar.gz的归档文件，并将ui-test-docker-context类元赋给它。 此外，它还列表了必须包含在存档中的文件：

• Dockerfile，用于构建Docker映像的必填项。
• wait-for-grid.sh脚本，其用途如下所述。
• 实际UI测试，由test-module文件夹中的Node.js项目实现。

程序集描述符还排除在本地运行UI测试时可能生成的某些文件。 这保证了较小的存档和更快的构建。

包含Docker构建上下文的存档会由Cloud Manager自动拾取，这将在其部署管道期间生成包含测试的Docker映像。 最终，Cloud Manager将运行Docker映像，以针对您的应用程序执行UI测试。

编写UI测试

本节介绍包含您的UI测试的Docker图像必须遵循的惯例。 Docker图像是基于上一节所述的Docker构建上下文构建的。

环境变量

以下环境变量将在运行时传递到Docker图像。

等待Selenium就绪

在测试开始之前，Docker映像有责任确保Selenium服务器处于运行状态。 等待Selenium服务是一个分两步的过程：

1. 从SELENIUM_BASE_URL环境变量中读取Selenium服务的URL。
2. 定期轮询到由Selenium API公开的状态端点。

一旦Selenius的状态端点以正向响应进行回答，测试最终可以开始。

生成测试报告

Docker图像必须以JUnit XML格式生成测试报告，并将其保存在环境变量REPORTS_PATH指定的路径中。 JUnit XML格式是一种广泛的格式，用于报告测试结果。 如果Docker映像使用Java和Maven，则Maven Surefire Plugin和Maven Failsafe Plugin。 如果Docker图像是使用其他编程语言或测试运行程序实现的，请查阅所选工具的文档以了解如何生成JUnit XML报告。

上传文件(#upload-files)

测试有时必须将文件上载到测试中的应用程序。 为了保持Selenium相对于测试的部署保持灵活，无法直接将资产上传到Selenium。 而上传文件将执行一些中间步骤：

1. 在UPLOAD_URL环境变量指定的URL上传文件。 上传必须在包含多部件表单的一个POST请求中执行。 多部件表单必须具有单个文件字段。 这等效于curl -X POST ${UPLOAD_URL} -F "data=@file.txt"。 请查阅Docker图像中使用的编程语言的文档和库，了解如何执行此类HTTP请求。
2. 如果上载成功，则请求返回类型为text/plain的200 OK响应。 响应的内容是不透明的文件句柄。 可以使用此句柄代替<input>元素中的文件路径来测试应用程序中的文件上载。