From 1d3d77e8c9032e7b9edab079c3717ba49abad836 Mon Sep 17 00:00:00 2001
From: Robear Selwans <robear.selwans@outlook.com>
Date: Sat, 2 May 2026 18:41:59 +0300
Subject: [PATCH] Add Mesa Vulkan drivers to CI image

---
 ci/Dockerfile      | 1 +
 ci/README.md       | 1 +
 ci/USE_CI_IMAGE.md | 3 ++-
 3 files changed, 4 insertions(+), 1 deletion(-)

diff --git a/ci/Dockerfile b/ci/Dockerfile
index 6b80031..1240711 100644
--- a/ci/Dockerfile
+++ b/ci/Dockerfile
@@ -44,6 +44,7 @@ RUN set -eux; \
       libvulkan-dev \
       vulkan-tools \
       vulkan-validationlayers \
+      mesa-vulkan-drivers \
       glslang-tools \
       spirv-tools \
       spirv-headers; \
diff --git a/ci/README.md b/ci/README.md
index 594bb8a..c5dd4fe 100644
--- a/ci/README.md
+++ b/ci/README.md
@@ -13,6 +13,7 @@ It includes:
 - Ninja
 - Python 3 + pip + venv
 - Vulkan development packages/tools
+- Mesa Vulkan software/runtime drivers
 - Git/build-essential/pkg-config
 - Node/runtime pieces inherited from the act Ubuntu image, so JavaScript actions like `actions/checkout` keep working
 
diff --git a/ci/USE_CI_IMAGE.md b/ci/USE_CI_IMAGE.md
index da5628e..d73bed0 100644
--- a/ci/USE_CI_IMAGE.md
+++ b/ci/USE_CI_IMAGE.md
@@ -30,6 +30,7 @@ It includes:
 - Ninja
 - Python 3 / pip / venv
 - Vulkan development packages/tools
+- Mesa Vulkan software/runtime drivers
 - `build-essential`
 - `pkg-config`
 - Git
@@ -491,7 +492,7 @@ Expected results:
 - `clang` should be version 22.
 - `meson` should print a version.
 - `ninja` should print a version.
-- `vulkaninfo --summary` may fail if the CI machine has no GPU/display/runtime Vulkan driver. That is usually okay for compile-only CI as long as Vulkan headers/tools are installed.
+- `vulkaninfo --summary` should usually find Mesa's software Vulkan driver. It may still fail on unusual container/runner setups; that is okay for compile-only CI as long as Vulkan headers/tools are installed.
 
 Exit: