如何在GitHub Actions与Docker中运行ASP.NET Core+Playwright UI测试？

核心问题解答 #

完全可以通过单个Dockerfile多阶段构建实现完整流程，没必要拆成三步。这种模式和React+Cypress的单镜像测试逻辑一致，能在推送生产镜像前完成UI测试，提前揪出应用问题。

用单Dockerfile方案的合理性在于：借助Docker多阶段构建特性，在同一个镜像构建流程里完成应用编译、启动、UI测试，既避免了CI环境的依赖混乱，又能保证测试环境和最终运行环境一致，完全匹配你的需求。

1. 多阶段Dockerfile示例 #

# 阶段1：编译ASP.NET Core应用与Playwright测试项目
FROM mcr.microsoft.com/dotnet/sdk:8.0 AS build
WORKDIR /src

# 先复制项目文件，利用Docker缓存加速依赖恢复
COPY ["YourApp/YourApp.csproj", "YourApp/"]
COPY ["YourApp.Tests.UI/YourApp.Tests.UI.csproj", "YourApp.Tests.UI/"]
RUN dotnet restore "YourApp/YourApp.csproj"
RUN dotnet restore "YourApp.Tests.UI/YourApp.Tests.UI.csproj"

# 复制所有代码并构建发布版本
COPY . .
WORKDIR "/src/YourApp"
RUN dotnet build -c Release -o /app/build

WORKDIR "/src/YourApp.Tests.UI"
RUN dotnet build -c Release -o /app/tests-build

# 阶段2：运行应用并执行Playwright测试
FROM mcr.microsoft.com/dotnet/aspnet:8.0 AS test-runner
WORKDIR /app

# 复制编译好的应用与测试文件
COPY --from=build /app/build .
COPY --from=build /app/tests-build ./tests

# 安装Playwright依赖（Linux环境必需）
RUN apt-get update && apt-get install -y --no-install-recommends \
    libnss3 libatk-bridge2.0-0 libdrm-dev libxkbcommon-dev libgbm-dev libasound-dev libatspi2.0-0 libxshmfence-dev

# 安装Playwright CLI与浏览器
RUN dotnet tool install --global Microsoft.Playwright.CLI
ENV PATH="$PATH:/root/.dotnet/tools"
RUN playwright install --with-deps chromium

# 编写启动脚本：后台启动应用，等待就绪后执行测试
RUN echo '#!/bin/bash' > start-test.sh && \
    # 后台启动应用
    echo 'dotnet YourApp.dll &' >> start-test.sh && \
    # 循环检测健康端点（建议给应用加健康检查接口）
    echo 'until curl -s http://localhost:5000/health; do sleep 1; done' >> start-test.sh && \
    # 执行Playwright测试
    echo 'dotnet tests/YourApp.Tests.UI.dll' >> start-test.sh && \
    chmod +x start-test.sh

# 执行测试流程
CMD ["./start-test.sh"]

2. GitHub Actions工作流示例 #

name: 构建&UI测试&推送镜像

on:
  push:
    branches: [ main ]
  pull_request:
    branches: [ main ]

jobs:
  build-and-test:
    runs-on: ubuntu-latest
    steps:
      - name: 拉取代码
        uses: actions/checkout@v4

      - name: 构建测试镜像并执行UI测试
        run: |
          docker build -t app-ui-test .
          docker run app-ui-test

      # 只有测试通过后，才构建生产镜像并推送
      - name: 构建生产镜像
        if: success()
        run: |
          docker build --target build -t your-registry/your-app:${{ github.sha }} .
          echo ${{ secrets.DOCKER_REGISTRY_TOKEN }} | docker login your-registry -u your-username --password-stdin
          docker push your-registry/your-app:${{ github.sha }}

      # 测试失败时上传测试报告
      - name: 上传Playwright测试报告
        if: failure()
        run: |
          # 从容器中复制报告文件
          CONTAINER_ID=$(docker ps -q --filter ancestor=app-ui-test)
          docker cp $CONTAINER_ID:/app/tests/playwright-report ./playwright-report
        uses: actions/upload-artifact@v4
        with:
          name: playwright-test-report
          path: ./playwright-report

关键注意点与建议 #

• 应用启动等待优化：不要用固定sleep，建议给ASP.NET Core应用添加健康检查端点（比如/health），用curl循环检测的方式等待应用完全就绪，避免因启动慢导致测试失败。
• 测试环境配置：如果应用需要测试环境的配置（比如测试数据库连接），可以在Dockerfile中用ENV设置，或者在docker run时通过-e参数传递。
• 资源限制：GitHub Actions的虚拟机资源有限，运行Playwright时可以给Docker容器加资源限制，比如docker run --memory=2g app-ui-test，避免内存不足崩溃。
• 镜像缓存优化：把Dockerfile中不变的步骤（比如安装依赖、Playwright）放在前面，这样可以复用Docker缓存，加快构建速度。
• 测试报告可视化：在Playwright测试命令中添加--reporter html参数生成HTML报告，失败时通过GitHub Actions的artifact功能上传，方便查看测试失败详情。

内容的提问来源于stack exchange，提问作者Michael Freidgeim