[CI]Split GPU jobs by cards_* and reject hand-written SKU marks (#6650)

Signed-off-by: wangyu <410167048@qq.com>
Signed-off-by: [Your Name] <your.email@example.com>
This commit is contained in:
wangyu authored and GitHub committed 2026-08-29 18:42:33 +08:00
1 parent c50b7de167
commit e338f0ece3
31 files changed
+896 -402

No files matched your search

+101 -37
View File
@@ -1,52 +1,45 @@
#!/usr/bin/env python3
# SPDX-License-Identifier: Apache-2.0
# SPDX-FileCopyrightText: Copyright contributors to the vLLM project
# SPDX-FileCopyrightText: Copyright contributors to the vLLM-Omni project
"""Run a pre-commit hook that fails if test files are modified or added
that (probably) never run in the CI. For now, this means that every tests file
needs to have a CI level marker (e.g., core_model, advanced_model, full_model,
local_model, slow, etc) and hardware mark / helper so that we ensure mutated
tests will actually be selected as long as there are pytest commands pointing
at the right paths.
SKU markers (``H100``, ``L4``, … tagged ``[hardware-resource]`` in
``pyproject.toml``) must be applied via ``hardware_test(`` / ``hardware_marks(``
so ``cards_{n}`` is attached. Direct ``pytest.mark.H100`` is rejected.
Platform names allowed as ``pytest.mark.cpu`` / ``cuda`` come from
``get_supported_platforms()`` (``[hardware-platform]`` in ``pyproject.toml``).
CI level names come from ``get_level_markers()`` (``[ci-level]``).
"""
from __future__ import annotations
import importlib.util
import os
import re
import sys
from functools import lru_cache
from pathlib import Path
from types import ModuleType
# CI level markers
LEVEL_MARKERS = ("core_model", "advanced_model", "full_model", "local_model", "slow")
# Hardware markers. These are platforms and resources that CI filters on.
# NOTE: If new hardware marks are added to pyproject.toml etc, we need
# to add them here as well.
HARDWARE_MARKERS = (
"cpu",
"gpu",
"cuda",
"rocm",
"xpu",
"npu",
"musa",
"H100",
"L4",
"MI325",
"B60",
"S5000",
"A2",
"A3",
)
# Helpers from tests/helpers/mark.py that auto-apply hardware marks.
# Helpers from tests/helpers/mark.py that auto-apply hardware + cards_* marks.
HARDWARE_HELPERS = ("hardware_test", "hardware_marks")
# The helper implementation is the only file allowed to write pytest.mark.<SKU>.
_ALLOWED_DIRECT_SKU_FILES = frozenset({"tests/helpers/mark.py"})
# Match mark.X since we could also do `from pytest import mark`.
# \b prevents matching prefixes (e.g., mark.slow vs mark.slow_test).
LEVEL_RE = re.compile(r"mark\.(?:" + "|".join(LEVEL_MARKERS) + r")\b")
HARDWARE_RE = re.compile(r"mark\.(?:" + "|".join(HARDWARE_MARKERS) + r")\b")
HELPER_RE = re.compile(r"(?:" + "|".join(HARDWARE_HELPERS) + r")\s*\(")
MISSING_LEVEL_MARKER = "Level"
MISSING_HARDWARE_MARKER = "Hardware"
DIRECT_SKU_MARKER = "Direct SKU"
# Check if a file is located under tests/ and matches test_<something>.py
# or <something>_test.py, since pytest technically collects on both.
@@ -54,9 +47,68 @@ MISSING_HARDWARE_MARKER = "Hardware"
TEST_FILE_RE = re.compile(r"^tests/(?:.*/)?(?:test_[^/]*\.py$|[^/]*_test\.py$)")
def _normalize_path(path: str) -> str:
return path.replace("\\", "/")
def _repo_root() -> Path:
return Path(__file__).resolve().parents[2]
@lru_cache(maxsize=1)
def _mark_module() -> ModuleType:
"""Load ``mark.py`` by file path (no pytest/vllm; skip helpers ``__init__``)."""
path = _repo_root() / "tests" / "helpers" / "mark.py"
spec = importlib.util.spec_from_file_location("_vllm_omni_mark", path)
if spec is None or spec.loader is None:
raise ImportError(f"Cannot load mark helpers from {path}")
module = importlib.util.module_from_spec(spec)
spec.loader.exec_module(module)
return module
def _mark_name_re(names: tuple[str, ...]) -> re.Pattern[str]:
if not names:
return re.compile(r"(?!)")
return re.compile(r"mark\.(?:" + "|".join(re.escape(n) for n in names) + r")\b")
@lru_cache(maxsize=1)
def level_markers() -> tuple[str, ...]:
"""CI level names tagged ``[ci-level]`` (``core_model``, ``slow``, …)."""
return tuple(sorted(_mark_module().get_level_markers()))
@lru_cache(maxsize=1)
def platform_markers() -> tuple[str, ...]:
"""Names tests may apply as ``pytest.mark.cpu`` / ``cuda`` (not SKUs)."""
return tuple(sorted(_mark_module().get_supported_platforms()))
@lru_cache(maxsize=1)
def sku_markers() -> tuple[str, ...]:
"""SKU marker names tagged ``[hardware-resource]`` in ``pyproject.toml``."""
return tuple(sorted(_mark_module().get_hardware_mark_list()))
@lru_cache(maxsize=1)
def _level_re() -> re.Pattern[str]:
return _mark_name_re(level_markers())
@lru_cache(maxsize=1)
def _platform_re() -> re.Pattern[str]:
return _mark_name_re(platform_markers())
@lru_cache(maxsize=1)
def _sku_mark_re() -> re.Pattern[str]:
return _mark_name_re(sku_markers())
def is_test_file(path: str) -> bool:
"""Determine whether or not a path is pointing at a test file or not."""
return bool(TEST_FILE_RE.match(path))
return bool(TEST_FILE_RE.match(_normalize_path(path)))
def read_test_file(path: str) -> str | None:
@@ -69,22 +121,31 @@ def read_test_file(path: str) -> str | None:
def has_level_marker(contents: str) -> bool:
"""Check if file contents contain at least one CI level marker."""
return bool(LEVEL_RE.search(contents))
return bool(_level_re().search(contents))
def has_hardware_marker(contents: str) -> bool:
"""Check if file contents contain any hardware marker or helpers."""
return bool(HARDWARE_RE.search(contents) or HELPER_RE.search(contents))
"""Check if file contents contain a platform marker or hardware helper."""
return bool(_platform_re().search(contents) or HELPER_RE.search(contents))
def has_direct_sku_marker(path: str, contents: str) -> bool:
"""True when a test applies ``pytest.mark.<SKU>`` instead of the helpers."""
if _normalize_path(path) in _ALLOWED_DIRECT_SKU_FILES:
return False
return bool(_sku_mark_re().search(contents))
def get_files_missing_markers(
staged_files: list[str],
) -> dict[str, list[str]]:
"""Return a dict mapping file path to list of missing marker types."""
"""Return a dict mapping file path to list of missing / invalid marker types."""
results: dict[str, list[str]] = {}
for path in staged_files:
if is_test_file(path) and (contents := read_test_file(path)) is not None:
missing = []
if has_direct_sku_marker(path, contents):
missing.append(DIRECT_SKU_MARKER)
if not has_level_marker(contents):
missing.append(MISSING_LEVEL_MARKER)
if not has_hardware_marker(contents):
@@ -99,14 +160,17 @@ if __name__ == "__main__":
if missing:
file_lines = "\n".join(f" - {path} [{' and '.join(problems)}]" for path, problems in missing.items())
sku = ", ".join(sku_markers())
print(
"\033[91merror:\033[0m test files are missing pytest marks "
"required for Buildkite CI collection.\n\n"
f"Level marks, e.g.: {', '.join(LEVEL_MARKERS[:4])}\n"
f"Hardware marks, e.g.: {', '.join(HARDWARE_MARKERS[:4])}, ...\n"
f" or helpers: {', '.join(HARDWARE_HELPERS)}\n\n"
"required for Buildkite CI collection, or apply SKU marks directly.\n\n"
f"Level marks, e.g.: {', '.join(level_markers()[:4])}\n"
f"Hardware marks, e.g.: {', '.join(platform_markers()[:4])}, ...\n"
f" or helpers: {', '.join(HARDWARE_HELPERS)}\n"
f"Do not write pytest.mark.<SKU> ({sku}). "
"Use hardware_test(...) / hardware_marks(...) so cards_* is attached.\n\n"
"The following files are missing marks:\n"
f"{file_lines}\n\n"
"To skip: SKIP=check-test-ci-coverage git commit ..."
"To skip: SKIP=check-mark git commit ..."
)
sys.exit(1)