test_vllm.py 26.7 KB
Newer Older
1
2
3
# SPDX-FileCopyrightText: Copyright (c) 2025 NVIDIA CORPORATION & AFFILIATES. All rights reserved.
# SPDX-License-Identifier: Apache-2.0

4
import base64
5
import dataclasses
6
7
import logging
import os
8
import random
9
from dataclasses import dataclass, field
10
from typing import Optional
11
12
13

import pytest

14
15
16
17
18
from tests.serve.common import (
    WORKSPACE_DIR,
    params_with_model_mark,
    run_serve_deployment,
)
19
from tests.serve.conftest import MULTIMODAL_IMG_PATH, MULTIMODAL_IMG_URL
20
from tests.serve.lora_utils import MinioLoraConfig
21
from tests.utils.constants import DefaultPort
22
23
24
25
from tests.utils.engine_process import EngineConfig
from tests.utils.payload_builder import (
    chat_payload,
    chat_payload_default,
26
    chat_payload_with_logprobs,
27
    completion_payload_default,
28
    completion_payload_with_logprobs,
29
    metric_payload_default,
30
)
31
from tests.utils.payloads import LoraTestChatPayload, ToolCallingChatPayload
32
33
34
35
36

logger = logging.getLogger(__name__)


@dataclass
37
class VLLMConfig(EngineConfig):
38
39
    """Configuration for vLLM test scenarios"""

40
    stragglers: list[str] = field(default_factory=lambda: ["VLLM:EngineCore"])
41
42


43
vllm_dir = os.environ.get("VLLM_DIR") or os.path.join(
44
    WORKSPACE_DIR, "examples/backends/vllm"
45
)
46

47

48
# vLLM test configurations
49
# NOTE: pytest.mark.gpu_1 tests take ~5.5 minutes total to run sequentially (with models pre-cached)
50
51
52
53
# TODO: Now that these tests use dynamic ports, optimize the runtime by bin-packing and running
# multiple engine deployments in parallel (while keeping GPU contention under control). This may
# require annotating each config with approximate GPU RAM usage so a future collector/launcher can
# bin-pack safely.
54
55
56
vllm_configs = {
    "aggregated": VLLMConfig(
        name="aggregated",
57
        directory=vllm_dir,
58
        script_name="agg.sh",
59
60
61
        marks=[
            pytest.mark.gpu_1,
            pytest.mark.pre_merge,
62
            pytest.mark.timeout(300),  # 3x measured time (43s) + download time (150s)
63
        ],
64
        model="Qwen/Qwen3-0.6B",
65
66
67
        request_payloads=[
            chat_payload_default(),
            completion_payload_default(),
68
69
70
71
72
73
74
75
76
77
78
            chat_payload(
                "Can you write me a song?",
                repeat_count=1,
                expected_response=["song"],
                temperature=0.0,
                max_tokens=32,
                extra_body={
                    "stop": ["song"],
                    "include_stop_str_in_output": True,
                },
            ),
79
            metric_payload_default(min_num_requests=6, backend="vllm"),
80
        ],
81
    ),
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
    "aggregated_logprobs": VLLMConfig(
        name="aggregated_logprobs",
        directory=vllm_dir,
        script_name="agg.sh",
        marks=[pytest.mark.gpu_1],
        model="Qwen/Qwen3-0.6B",
        request_payloads=[
            chat_payload_with_logprobs(
                repeat_count=2,
                expected_response=["AI", "knock", "joke"],
                max_tokens=30,
                temperature=0.0,
                top_logprobs=3,
            ),
            completion_payload_with_logprobs(
                repeat_count=2,
                expected_response=["AI", "knock", "joke"],
                max_tokens=30,
                temperature=0.0,
                logprobs=5,
            ),
        ],
    ),
105
106
107
108
    "aggregated_lmcache": VLLMConfig(
        name="aggregated_lmcache",
        directory=vllm_dir,
        script_name="agg_lmcache.sh",
109
110
111
        marks=[
            pytest.mark.gpu_1,
            pytest.mark.pre_merge,
112
            pytest.mark.timeout(360),  # 3x estimated time (70s) + download time (150s)
113
        ],
114
115
116
117
118
119
120
121
        model="Qwen/Qwen3-0.6B",
        request_payloads=[
            chat_payload_default(),
            completion_payload_default(),
            metric_payload_default(min_num_requests=6, backend="vllm"),
            metric_payload_default(min_num_requests=6, backend="lmcache"),
        ],
    ),
122
123
124
125
    "aggregated_lmcache_multiproc": VLLMConfig(
        name="aggregated_lmcache_multiproc",
        directory=vllm_dir,
        script_name="agg_lmcache_multiproc.sh",
126
127
        marks=[
            pytest.mark.gpu_1,
128
            pytest.mark.timeout(360),  # 3x estimated time (70s) + download time (150s)
129
        ],
130
131
132
133
134
135
136
137
138
139
140
        model="Qwen/Qwen3-0.6B",
        env={
            "PROMETHEUS_MULTIPROC_DIR": f"/tmp/prometheus_multiproc_test_{os.getpid()}_{random.randint(0, 10000)}"
        },
        request_payloads=[
            chat_payload_default(),
            completion_payload_default(),
            metric_payload_default(min_num_requests=6, backend="vllm"),
            metric_payload_default(min_num_requests=6, backend="lmcache"),
        ],
    ),
141
142
143
144
    "agg-request-plane-tcp": VLLMConfig(
        name="agg-request-plane-tcp",
        directory=vllm_dir,
        script_name="agg_request_planes.sh",
145
146
147
        marks=[
            pytest.mark.gpu_1,
            pytest.mark.pre_merge,
148
            pytest.mark.timeout(300),  # 3x measured time (43s) + download time (150s)
149
        ],
150
151
152
153
154
155
156
157
158
159
160
        model="Qwen/Qwen3-0.6B",
        script_args=["--tcp"],
        request_payloads=[
            chat_payload_default(),
            completion_payload_default(),
        ],
    ),
    "agg-request-plane-http": VLLMConfig(
        name="agg-request-plane-http",
        directory=vllm_dir,
        script_name="agg_request_planes.sh",
161
162
163
        marks=[
            pytest.mark.gpu_1,
            pytest.mark.pre_merge,
164
            pytest.mark.timeout(300),  # 3x measured time (43s) + download time (150s)
165
        ],
166
167
168
169
170
171
172
        model="Qwen/Qwen3-0.6B",
        script_args=["--http"],
        request_payloads=[
            chat_payload_default(),
            completion_payload_default(),
        ],
    ),
173
174
    "agg-router": VLLMConfig(
        name="agg-router",
175
        directory=vllm_dir,
176
        script_name="agg_router.sh",
177
        marks=[pytest.mark.gpu_2, pytest.mark.post_merge],
178
        model="Qwen/Qwen3-0.6B",
179
180
181
        request_payloads=[
            chat_payload_default(
                expected_log=[
182
                    r"ZMQ listener .* received batch with \d+ events \(seq=\d+(?:, [^)]*)?\)",
183
                    r"Event processor for worker_id \d+ processing event: Stored\(",
Yan Ru Pei's avatar
Yan Ru Pei committed
184
                    r"Selected worker: worker_id=\d+ dp_rank=.*?, logit: ",
185
186
187
188
189
190
                ]
            )
        ],
        env={
            "DYN_LOG": "dynamo_llm::kv_router::publisher=trace,dynamo_llm::kv_router::scheduler=info",
        },
191
    ),
192
193
    "disaggregated": VLLMConfig(
        name="disaggregated",
194
        directory=vllm_dir,
195
        script_name="disagg.sh",
196
        marks=[pytest.mark.gpu_2, pytest.mark.post_merge],
197
        model="Qwen/Qwen3-0.6B",
198
199
200
201
        request_payloads=[
            chat_payload_default(),
            completion_payload_default(),
        ],
202
    ),
203
204
    "deepep": VLLMConfig(
        name="deepep",
205
        directory=vllm_dir,
206
        script_name="dsr1_dep.sh",
207
208
209
210
        marks=[
            pytest.mark.gpu_2,
            pytest.mark.vllm,
            pytest.mark.h100,
211
            pytest.mark.nightly,
212
        ],
213
        model="deepseek-ai/DeepSeek-V2-Lite",
214
        script_args=[
215
216
217
218
219
220
221
222
223
            "--model",
            "deepseek-ai/DeepSeek-V2-Lite",
            "--num-nodes",
            "1",
            "--node-rank",
            "0",
            "--gpus-per-node",
            "2",
        ],
224
        timeout=700,
225
        request_payloads=[
226
227
            chat_payload_default(),
            completion_payload_default(),
228
        ],
229
    ),
230
231
    "multimodal_agg_llava_epd": VLLMConfig(
        name="multimodal_agg_llava_epd",
232
        directory=vllm_dir,
233
        script_name="agg_multimodal_epd.sh",
234
        marks=[pytest.mark.gpu_2, pytest.mark.nightly],
235
        model="llava-hf/llava-1.5-7b-hf",
236
237
238
239
        script_args=["--model", "llava-hf/llava-1.5-7b-hf"],
        request_payloads=[
            chat_payload(
                [
240
241
242
243
                    {
                        "type": "text",
                        "text": "What colors are in the following image? Respond only with the colors.",
                    },
244
245
                    {
                        "type": "image_url",
246
                        "image_url": {"url": MULTIMODAL_IMG_URL},
247
248
249
                    },
                ],
                repeat_count=1,
250
                expected_response=["purple"],
251
                temperature=0.0,
252
                max_tokens=100,
253
254
            )
        ],
255
    ),
256
257
258
259
    "multimodal_agg_qwen_epd": VLLMConfig(
        name="multimodal_agg_qwen_epd",
        directory=vllm_dir,
        script_name="agg_multimodal_epd.sh",
260
        marks=[pytest.mark.gpu_2, pytest.mark.nightly],
261
262
263
264
265
266
267
        model="Qwen/Qwen2.5-VL-7B-Instruct",
        delayed_start=0,
        script_args=["--model", "Qwen/Qwen2.5-VL-7B-Instruct"],
        timeout=360,
        request_payloads=[
            chat_payload(
                [
268
269
270
271
                    {
                        "type": "text",
                        "text": "What colors are in the following image? Respond only with the colors.",
                    },
272
273
                    {
                        "type": "image_url",
274
                        "image_url": {"url": MULTIMODAL_IMG_URL},
275
276
277
                    },
                ],
                repeat_count=1,
278
279
                expected_response=["purple"],
                max_tokens=100,
280
281
282
            )
        ],
    ),
283
284
    "multimodal_agg_qwen": VLLMConfig(
        name="multimodal_agg_qwen",
285
286
        directory=vllm_dir,
        script_name="agg_multimodal.sh",
287
        marks=[pytest.mark.gpu_2, pytest.mark.nightly],
288
        model="Qwen/Qwen2.5-VL-7B-Instruct",
289
        script_args=["--model", "Qwen/Qwen2.5-VL-7B-Instruct"],
290
        delayed_start=0,
291
        timeout=360,
292
293
294
295
        request_payloads=[
            chat_payload(
                [
                    {
296
297
                        "type": "text",
                        "text": "What colors are in the following image? Respond only with the colors.",
298
                    },
299
300
                    {
                        "type": "image_url",
301
                        "image_url": {"url": MULTIMODAL_IMG_URL},
302
303
304
                    },
                ],
                repeat_count=1,
305
306
                expected_response=["purple"],
                max_tokens=100,
307
            ),
308
        ],
309
    ),
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
    "multimodal_agg_llava": VLLMConfig(
        name="multimodal_agg_llava",
        directory=vllm_dir,
        script_name="agg_multimodal.sh",
        marks=[
            pytest.mark.gpu_2,
            # https://github.com/ai-dynamo/dynamo/issues/4501
            pytest.mark.xfail(strict=False),
        ],
        model="llava-hf/llava-1.5-7b-hf",
        script_args=["--model", "llava-hf/llava-1.5-7b-hf"],
        delayed_start=0,
        timeout=360,
        request_payloads=[
            # HTTP URL test
            chat_payload(
                [
                    {"type": "text", "text": "What is in this image?"},
                    {
                        "type": "image_url",
                        "image_url": {
                            "url": "http://images.cocodataset.org/test2017/000000155781.jpg"
                        },
                    },
                ],
                repeat_count=1,
                expected_response=["bus"],
                temperature=0.0,
            ),
            # String content test - verifies string → array conversion for multimodal templates
            chat_payload_default(
                repeat_count=1,
                expected_response=[],  # Just validate no error
            ),
        ],
    ),
346
    # TODO: Update this test case when we have video multimodal support in vllm official components
347
348
    "multimodal_video_agg": VLLMConfig(
        name="multimodal_video_agg",
349
        directory=os.path.join(WORKSPACE_DIR, "examples/multimodal"),
350
        script_name="video_agg.sh",
351
        marks=[pytest.mark.gpu_2, pytest.mark.nightly],
352
353
        model="llava-hf/LLaVA-NeXT-Video-7B-hf",
        delayed_start=0,
354
        script_args=["--model", "llava-hf/LLaVA-NeXT-Video-7B-hf"],
355
        timeout=360,
356
357
358
359
360
361
362
363
364
365
366
367
368
        request_payloads=[
            chat_payload(
                [
                    {"type": "text", "text": "Describe the video in detail"},
                    {
                        "type": "video_url",
                        "video_url": {
                            "url": "https://storage.googleapis.com/gtv-videos-bucket/sample/BigBuckBunny.mp4"
                        },
                    },
                ],
                repeat_count=1,
                expected_response=["rabbit"],
369
                temperature=0.7,
370
371
            )
        ],
372
    ),
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
    "multimodal_audio_agg": VLLMConfig(
        name="multimodal_audio_agg",
        directory="/workspace/examples/multimodal",
        script_name="audio_agg.sh",
        marks=[pytest.mark.gpu_2],
        model="Qwen/Qwen2-Audio-7B-Instruct",
        delayed_start=0,
        script_args=["--model", "Qwen/Qwen2-Audio-7B-Instruct"],
        timeout=500,
        request_payloads=[
            chat_payload(
                [
                    {"type": "text", "text": "What is recited in the audio?"},
                    {
                        "type": "audio_url",
                        "audio_url": {
                            "url": "https://raw.githubusercontent.com/yuekaizhang/Triton-ASR-Client/main/datasets/mini_en/wav/1221-135766-0002.wav"
                        },
                    },
                ],
                repeat_count=1,
                expected_response=[
                    "The original content of this audio is:'yet these thoughts affected Hester Pynne less with hope than apprehension.'"
                ],
                temperature=0.8,
            )
        ],
    ),
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
    "aggregated_toolcalling": VLLMConfig(
        name="aggregated_toolcalling",
        directory=vllm_dir,
        script_name="agg_multimodal.sh",
        marks=[pytest.mark.gpu_2, pytest.mark.multimodal],
        model="Qwen/Qwen3-VL-30B-A3B-Instruct-FP8",
        script_args=[
            "--model",
            "Qwen/Qwen3-VL-30B-A3B-Instruct-FP8",
            "--max-model-len",
            "10000",
            "--dyn-tool-call-parser",
            "hermes",
        ],
        delayed_start=0,
        timeout=600,
        request_payloads=[
            ToolCallingChatPayload(
                body={
                    "messages": [
                        {
                            "role": "user",
                            "content": [
                                {
                                    "type": "text",
                                    "text": "Describe what you see in this image in detail.",
                                },
                                {
                                    "type": "image_url",
                                    "image_url": {"url": MULTIMODAL_IMG_URL},
                                },
                            ],
                        }
                    ],
                    "tools": [
                        {
                            "type": "function",
                            "function": {
                                "name": "describe_image",
                                "description": "Provides detailed description of objects and scenes in an image",
                                "parameters": {
                                    "type": "object",
                                    "properties": {
                                        "objects": {
                                            "type": "array",
                                            "items": {"type": "string"},
                                            "description": "List of objects detected in the image",
                                        },
                                        "scene": {
                                            "type": "string",
                                            "description": "Overall scene description",
                                        },
                                    },
                                    "required": ["objects", "scene"],
                                },
                            },
                        }
                    ],
                    "tool_choice": "auto",
                    "max_tokens": 1024,
                },
                repeat_count=1,
                expected_response=["purple"],  # Validate image understanding
                expected_log=[],
                expected_tool_name="describe_image",  # Validate tool call happened
            )
        ],
    ),
469
470
471
    # TODO: Enable this test case when we have 4 GPUs runners.
    # "multimodal_disagg": VLLMConfig(
    #     name="multimodal_disagg",
472
    #     directory=os.path.join(WORKSPACE_DIR, "examples/multimodal"),
473
474
475
476
    #     script_name="disagg.sh",
    #     marks=[pytest.mark.gpu_4, pytest.mark.vllm],
    #     model="llava-hf/llava-1.5-7b-hf",
    #     delayed_start=45,
477
    #     script_args=["--model", "llava-hf/llava-1.5-7b-hf"],
478
    # ),
479
480
481
482
    "completions_only": VLLMConfig(
        name="completions_only",
        directory=vllm_dir,
        script_name="agg.sh",
483
484
        marks=[
            pytest.mark.gpu_1,
485
486
487
            pytest.mark.timeout(
                420
            ),  # 3x estimated time (60s) + download time (240s) for 7B model
488
        ],
489
490
491
492
493
494
495
496
497
498
499
        model="deepseek-ai/deepseek-llm-7b-base",
        script_args=[
            "--model",
            "deepseek-ai/deepseek-llm-7b-base",
            "--dyn-endpoint-types",
            "completions",
        ],
        request_payloads=[
            completion_payload_default(),
        ],
    ),
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
    "guided_decoding_json": VLLMConfig(
        name="guided_decoding_json",
        directory=vllm_dir,
        script_name="agg.sh",
        marks=[pytest.mark.gpu_1, pytest.mark.pre_merge],
        model="Qwen/Qwen3-0.6B",
        request_payloads=[
            chat_payload(
                "Generate a person with name and age",
                repeat_count=1,
                expected_response=['"name"', '"age"'],
                temperature=0.0,
                max_tokens=100,
                extra_body={
                    "guided_json": {
                        "type": "object",
                        "properties": {
                            "name": {"type": "string"},
                            "age": {"type": "integer"},
                        },
                        "required": ["name", "age"],
                    }
                },
            )
        ],
    ),
    "guided_decoding_regex": VLLMConfig(
        name="guided_decoding_regex",
        directory=vllm_dir,
        script_name="agg.sh",
        marks=[pytest.mark.gpu_1, pytest.mark.pre_merge],
        model="Qwen/Qwen3-0.6B",
        request_payloads=[
            chat_payload(
                "Generate a color name (red, blue, or green)",
                repeat_count=1,
                expected_response=["red", "blue", "green"],
                temperature=0.0,
                max_tokens=20,
                extra_body={"guided_regex": r"(red|blue|green)"},
            )
        ],
    ),
    "guided_decoding_choice": VLLMConfig(
        name="guided_decoding_choice",
        directory=vllm_dir,
        script_name="agg.sh",
        marks=[pytest.mark.gpu_1, pytest.mark.pre_merge],
        model="Qwen/Qwen3-0.6B",
        request_payloads=[
            chat_payload(
                "Generate a color name (red, blue, or green)",
                repeat_count=1,
                expected_response=["red", "blue", "green"],
                temperature=0.0,
                max_tokens=20,
                extra_body={"guided_choice": ["red", "blue", "green"]},
            )
        ],
    ),
560
561
562
}


Alec's avatar
Alec committed
563
@pytest.fixture(params=params_with_model_mark(vllm_configs))
564
565
566
567
568
def vllm_config_test(request):
    """Fixture that provides different vLLM test configurations"""
    return vllm_configs[request.param]


569
@pytest.mark.vllm
570
@pytest.mark.e2e
571
@pytest.mark.nightly
Alec's avatar
Alec committed
572
def test_serve_deployment(
573
574
575
576
577
578
    vllm_config_test,
    request,
    runtime_services_dynamic_ports,
    dynamo_dynamic_ports,
    predownload_models,
    image_server,
Alec's avatar
Alec committed
579
):
580
581
582
    """
    Test dynamo serve deployments with different graph configurations.
    """
583
584
585
586
    config = dataclasses.replace(
        vllm_config_test, frontend_port=dynamo_dynamic_ports.frontend_port
    )
    run_serve_deployment(config, request, ports=dynamo_dynamic_ports)
587
588
589
590
591


@pytest.mark.vllm
@pytest.mark.e2e
@pytest.mark.gpu_2
592
593
594
595
@pytest.mark.timeout(360)  # Match VLLMConfig.timeout for this multimodal deployment
def test_multimodal_b64(
    request, runtime_services_dynamic_ports, dynamo_dynamic_ports, predownload_models
):
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
    """
    Test multimodal inference with base64 url passthrough.

    This test is separate because it loads the required image at runtime
    (not collection time), ensuring it only fails when actually executed.
    """
    # Load B64 image at test execution time
    with open(MULTIMODAL_IMG_PATH, "rb") as f:
        b64_img = base64.b64encode(f.read()).decode()

    # Create payload with B64 image
    b64_payload = chat_payload(
        [
            {
                "type": "text",
                "text": "What colors are in the following image? Respond only with the colors.",
            },
            {
                "type": "image_url",
                "image_url": {"url": f"data:image/png;base64,{b64_img}"},
            },
        ],
        repeat_count=1,
        expected_response=["purple"],
        max_tokens=100,
    )

    # Create test config
    config = VLLMConfig(
        name="test_multimodal_b64",
        directory=vllm_dir,
        script_name="agg_multimodal.sh",
        marks=[],  # markers at function-level
        model="Qwen/Qwen2.5-VL-7B-Instruct",
        script_args=["--model", "Qwen/Qwen2.5-VL-7B-Instruct"],
        delayed_start=0,
        timeout=360,
        request_payloads=[b64_payload],
    )

636
637
638
639
    config = dataclasses.replace(
        config, frontend_port=dynamo_dynamic_ports.frontend_port
    )
    run_serve_deployment(config, request, ports=dynamo_dynamic_ports)
640
641
642
643
644
645
646
647
648


# LoRA Test Directory
lora_dir = os.path.join(vllm_dir, "launch/lora")


def lora_chat_payload(
    lora_name: str,
    s3_uri: str,
649
    system_port: int = DefaultPort.SYSTEM1.value,
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
    repeat_count: int = 2,
    expected_response: Optional[list] = None,
    expected_log: Optional[list] = None,
    max_tokens: int = 100,
    temperature: float = 0.0,
) -> LoraTestChatPayload:
    """Create a LoRA-enabled chat payload for testing"""
    return LoraTestChatPayload(
        body={
            "model": lora_name,
            "messages": [
                {
                    "role": "user",
                    "content": "What is deep learning? Answer in one sentence.",
                }
            ],
            "max_tokens": max_tokens,
            "temperature": temperature,
            "stream": False,
        },
        lora_name=lora_name,
        s3_uri=s3_uri,
        system_port=system_port,
        repeat_count=repeat_count,
        expected_response=expected_response
        or ["learning", "neural", "network", "AI", "model"],
        expected_log=expected_log or [],
    )


@pytest.mark.vllm
@pytest.mark.e2e
@pytest.mark.gpu_1
@pytest.mark.model("Qwen/Qwen3-0.6B")
@pytest.mark.timeout(600)
@pytest.mark.nightly
def test_lora_aggregated(
687
688
689
690
691
    request,
    runtime_services_dynamic_ports,
    predownload_models,
    minio_lora_service,
    dynamo_dynamic_ports,
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
):
    """
    Test LoRA inference with aggregated vLLM deployment.

    This test:
    1. Uses MinIO fixture to provide S3-compatible storage with uploaded LoRA
    2. Starts vLLM with LoRA support enabled
    3. Loads the LoRA adapter via system API
    4. Runs inference with the LoRA model
    """
    minio_config: MinioLoraConfig = minio_lora_service

    # Create payload that loads LoRA and tests inference
    lora_payload = lora_chat_payload(
        lora_name=minio_config.lora_name,
        s3_uri=minio_config.get_s3_uri(),
708
        system_port=DefaultPort.SYSTEM1.value,
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
        repeat_count=2,
    )

    # Create test config with MinIO environment variables
    config = VLLMConfig(
        name="test_lora_aggregated",
        directory=vllm_dir,
        script_name="lora/agg_lora.sh",
        marks=[],  # markers at function-level
        model="Qwen/Qwen3-0.6B",
        timeout=600,
        env=minio_config.get_env_vars(),
        request_payloads=[lora_payload],
    )

724
725
726
727
728
729
730
731
732
    config = dataclasses.replace(
        config, frontend_port=dynamo_dynamic_ports.frontend_port
    )
    run_serve_deployment(
        config,
        request,
        ports=dynamo_dynamic_ports,
        extra_env=minio_config.get_env_vars(),
    )
733
734
735
736
737
738
739
740
741


@pytest.mark.vllm
@pytest.mark.e2e
@pytest.mark.gpu_2
@pytest.mark.model("Qwen/Qwen3-0.6B")
@pytest.mark.timeout(600)
@pytest.mark.nightly
def test_lora_aggregated_router(
742
743
744
745
746
    request,
    runtime_services_dynamic_ports,
    predownload_models,
    minio_lora_service,
    dynamo_dynamic_ports,
747
748
749
750
751
752
753
754
755
756
757
758
759
):
    """
    Test LoRA inference with aggregated vLLM deployment using KV router.

    This test:
    1. Uses MinIO fixture to provide S3-compatible storage with uploaded LoRA
    2. Starts multiple vLLM workers with LoRA support and KV router
    3. Loads the LoRA adapter on both workers via system API
    4. Runs inference with the LoRA model, verifying KV cache routing
    """
    minio_config: MinioLoraConfig = minio_lora_service

    # Create payloads that load LoRA on both workers and test inference
760
    # Worker 1 (DefaultPort.SYSTEM1)
761
762
763
    lora_payload_worker1 = lora_chat_payload(
        lora_name=minio_config.lora_name,
        s3_uri=minio_config.get_s3_uri(),
764
        system_port=DefaultPort.SYSTEM1.value,
765
766
767
        repeat_count=1,
    )

768
    # Worker 2 (DefaultPort.SYSTEM2)
769
770
771
    lora_payload_worker2 = lora_chat_payload(
        lora_name=minio_config.lora_name,
        s3_uri=minio_config.get_s3_uri(),
772
        system_port=DefaultPort.SYSTEM2.value,
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
        repeat_count=1,
    )

    # Additional inference payload to test routing (LoRA already loaded)
    inference_payload = chat_payload(
        content="Explain machine learning in simple terms.",
        repeat_count=2,
        expected_response=["learn", "data", "algorithm", "model", "pattern"],
        max_tokens=150,
        temperature=0.0,
    ).with_model(minio_config.lora_name)

    # Add env vars including PYTHONHASHSEED for deterministic KV event IDs
    env_vars = minio_config.get_env_vars()
    env_vars["PYTHONHASHSEED"] = "0"

    # Create test config with MinIO environment variables
    config = VLLMConfig(
        name="test_lora_aggregated_router",
        directory=vllm_dir,
        script_name="lora/agg_lora_router.sh",
        marks=[],  # markers at function-level
        model="Qwen/Qwen3-0.6B",
        timeout=600,
        env=env_vars,
        request_payloads=[
            lora_payload_worker1,
            lora_payload_worker2,
            inference_payload,
        ],
    )

805
806
807
808
809
810
    config = dataclasses.replace(
        config, frontend_port=dynamo_dynamic_ports.frontend_port
    )
    run_serve_deployment(
        config, request, ports=dynamo_dynamic_ports, extra_env=env_vars
    )