헤드리스 Linux CI에서 D3D11/D3D12 그래픽 테스트 워크플로우

CI 테스트를 위한 크로스 플랫폼 그래픽 툴체인

r/ClaudeAI의 한 개발자가 GPU 하드웨어 없이 Linux CI 러너에서 Windows 그래픽 코드를 테스트하는 워크플로우를 상세히 설명했습니다. 이 접근법은 특정 툴체인을 사용하여 Direct3D 애플리케이션을 완전히 소프트웨어로 컴파일하고 실행합니다.

툴체인 스택

이 워크플로우는 다음 파이프라인을 따릅니다:

D3D11/D3D12 코드와 #ifdef _WIN32 지시문이 포함된 C++ 소스
→ MinGW-w64 (Linux에서 Windows .exe로 크로스 컴파일)
→ Wine (Linux에서 .exe 실행)
→ DXVK / VKD3D-Proton (D3D → Vulkan 변환)
→ Lavapipe (CPU에서 소프트웨어 Vulkan)
→ llvmpipe (CPU 래스터라이제이션)
→ 프레임버퍼 출력 (GPU 필요 없음)

각 레이어의 역할

MinGW-w64 — Linux에서 네이티브 Windows PE 바이너리(.exe)를 생성하는 GCC 기반 크로스 컴파일러
Wine — 런타임에 Windows 시스템 호출과 Win32 API 호출을 Linux 동등 기능으로 변환
DXVK — D3D11 API 호출을 Vulkan 호출로 변환 (Steam Proton이 사용하는 동일 기술)
VKD3D-Proton — 동일한 개념이지만 D3D12 → Vulkan 변환
Lavapipe — Mesa의 소프트웨어 Vulkan ICD — CPU에서 완전히 실행되는 전체 Vulkan 드라이버
llvmpipe — Lavapipe가 위임하는 기본 Mesa 소프트웨어 래스터라이저

핵심 통찰

이것은 에뮬레이션이나 모킹이 아닙니다. C++ 코드는 실제 Windows에서 MSVC가 컴파일하는 것과 정확히 동일한 _WIN32 코드 경로입니다. MinGW는 단지 동일한 ABI를 대상으로 합니다. Wine + DXVK는 실제 D3D11/D3D12 API 표면을 제공합니다. Lavapipe는 실제 Vulkan 드라이버입니다 — 단지 GPU 대신 CPU에서 실행될 뿐입니다. 테스트가 이 스택을 통과할 때, 실제 Windows 그래픽 초기화 경로를 실행하며 스텁이 아닙니다.

설치 요구사항

개발자는 세 가지 패키지만 필요하다고 명시합니다:

sudo apt-get install mingw-w64 wine64 mesa-vulkan-drivers

이는 GitHub Actions 러너와 저렴한 VPS 인스턴스를 포함한 모든 Linux 시스템에서 작동합니다.

더 넓은 워크플로우 맥락

개발자는 전적으로 휴대폰에서 코딩하며, 모든 변경사항을 GitHub에 커밋하여 CI Actions가 컴파일, 테스트하고 결과를 보고합니다. 검증 파이프라인에는 여러 컴파일러, 샌드박스(ASan, UBSan, TSan, MSan), 정적 분석기 및 약 2,000개의 단위 테스트가 포함됩니다. Claude가 코드를 작성하고 푸시하면 CI가 문제를 발견합니다. 다른 CI 파이프라인 구성 요소(GCC, Clang, MSVC, 다섯 가지 샌드박스 구성, clang-tidy, clang-format, 커버리지 보고서)와 결합되어 수동 검토 전에 대부분의 문제를 발견합니다.

📖 전체 소스 읽기: r/ClaudeAI