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

4
5
6
7
8
9
10
11
"""
Test Execution Times (Last Run: 2025-12-09):
- test_request_cancellation_vllm_aggregated: ~55s (gpu_1)
- test_request_cancellation_vllm_decode_cancel: ~53s (gpu_2)
- test_request_cancellation_vllm_prefill_cancel: ~53s (gpu_2)
- Total: 161.65s (0:02:41)
"""

12
import json
13
14
15
16
17
18
import logging
import os
import shutil

import pytest

19
20
from tests.fault_tolerance.cancellation.utils import (
    DynamoFrontendProcess,
21
22
23
    poll_for_pattern,
    read_streaming_responses,
    send_cancellable_request,
24
)
Alec's avatar
Alec committed
25
from tests.utils.constants import FAULT_TOLERANCE_MODEL_NAME
26
from tests.utils.managed_process import ManagedProcess
27
from tests.utils.payloads import check_health_generate, check_models_api
28
from tests.utils.port_utils import allocate_port, deallocate_port
29
30
31

logger = logging.getLogger(__name__)

32
pytestmark = [
33
    pytest.mark.fault_tolerance,
34
35
36
37
    pytest.mark.vllm,
    pytest.mark.gpu_1,
    pytest.mark.e2e,
    pytest.mark.model(FAULT_TOLERANCE_MODEL_NAME),
38
    pytest.mark.post_merge,  # post_merge to pinpoint failure commit
39
    pytest.mark.parametrize("request_plane", ["nats", "tcp"], indirect=True),
40
41
]

42
43
44
45

class DynamoWorkerProcess(ManagedProcess):
    """Process manager for Dynamo worker with vLLM backend"""

46
47
48
49
50
51
52
53
54
55
56
    def __init__(
        self,
        request,
        frontend_port: int,
        is_prefill: bool = False,
    ):
        # Allocate system port for this worker
        system_port = allocate_port(9100)
        self.system_port = system_port
        self.frontend_port = frontend_port

57
58
59
60
61
        command = [
            "python3",
            "-m",
            "dynamo.vllm",
            "--model",
Alec's avatar
Alec committed
62
            FAULT_TOLERANCE_MODEL_NAME,
63
64
65
66
            "--enforce-eager",
            "--gpu-memory-utilization",
            "0.45",
            "--max-model-len",
67
            "16384",
68
69
        ]

70
        # Configure health check based on worker type
71
        if is_prefill:
72
            # Prefill workers check their own status endpoint
73
            command.append("--is-prefill-worker")
74
75
76
            health_check_urls = [
                (f"http://localhost:{system_port}/health", self.is_ready)
            ]
77
78
79
80
        else:
            # Decode workers should also check their own status endpoint first,
            # then verify the frontend sees the model
            health_check_urls = [
81
82
83
                (f"http://localhost:{system_port}/health", self.is_ready),
                (f"http://localhost:{frontend_port}/v1/models", check_models_api),
                (f"http://localhost:{frontend_port}/health", check_health_generate),
84
            ]
85

86
        # Set environment variables
87
        env = os.environ.copy()
88
89
        env["DYN_REQUEST_PLANE"] = request.getfixturevalue("request_plane")

90
        env["DYN_LOG"] = "debug"
91
92
93
94
95
        # Disable canary health check - these tests expect full control over requests
        # sent to the workers where canary health check intermittently sends dummy
        # requests to workers interfering with the test process which may cause
        # intermittent failures
        env["DYN_HEALTH_CHECK_ENABLED"] = "false"
96
        env["DYN_SYSTEM_USE_ENDPOINT_HEALTH_STATUS"] = '["generate"]'
97
98
        env["DYN_SYSTEM_PORT"] = str(system_port)
        env["DYN_HTTP_PORT"] = str(frontend_port)
99

100
        # Set KV events config and NIXL side channel port only for prefill worker
101
102
        # to avoid conflicts with decode worker
        if is_prefill:
103
104
105
106
107
108
109
110
111
112
113
114
115
            command.extend(
                [
                    "--kv-events-config",
                    json.dumps(
                        {
                            "publisher": "zmq",
                            "topic": "kv-events",
                            "endpoint": "tcp://*:20082",
                            "enable_kv_cache_events": True,
                        }
                    ),
                ]
            )
116
117
118
            env[
                "VLLM_NIXL_SIDE_CHANNEL_PORT"
            ] = "5601"  # TODO: use dynamic port allocation
119

120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
        # Set log directory based on worker type
        worker_type = "prefill_worker" if is_prefill else "worker"
        log_dir = f"{request.node.name}_{worker_type}"

        # Clean up any existing log directory from previous runs
        try:
            shutil.rmtree(log_dir)
            logger.info(f"Cleaned up existing log directory: {log_dir}")
        except FileNotFoundError:
            # Directory doesn't exist, which is fine
            pass

        super().__init__(
            command=command,
            env=env,
135
            health_check_urls=health_check_urls,
136
137
            timeout=300,
            display_output=True,
138
            terminate_all_matching_process_names=False,
139
140
141
142
143
144
145
            # Ensure any orphaned vLLM engine cores or child helpers are cleaned up
            stragglers=[
                "VLLM::EngineCore",
            ],
            straggler_commands=[
                "-m dynamo.vllm",
            ],
146
147
148
149
150
151
152
153
154
            log_dir=log_dir,
        )

        self.is_prefill = is_prefill

    def get_pid(self):
        """Get the PID of the worker process"""
        return self.proc.pid if self.proc else None

155
156
157
158
159
160
161
162
163
164
    def __exit__(self, exc_type, exc_val, exc_tb):
        """Release allocated port when worker exits."""
        try:
            # system_port is always allocated in __init__
            deallocate_port(self.system_port)
        except Exception as e:
            logging.warning(f"Failed to release vLLM worker port: {e}")

        return super().__exit__(exc_type, exc_val, exc_tb)

165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
    def is_ready(self, response) -> bool:
        """Check the health of the worker process"""
        try:
            data = response.json()
            if data.get("status") == "ready":
                worker_type = "Prefill worker" if self.is_prefill else "Worker"
                logger.info(f"{worker_type} status is ready")
                return True
            worker_type = "Prefill worker" if self.is_prefill else "Worker"
            logger.warning(f"{worker_type} status is not ready: {data.get('status')}")
        except ValueError:
            worker_type = "Prefill worker" if self.is_prefill else "Worker"
            logger.warning(f"{worker_type} health response is not valid JSON")
        return False


181
@pytest.mark.timeout(110)  # 3x average
182
183
184
def test_request_cancellation_vllm_aggregated(
    request, runtime_services_dynamic_ports, predownload_models
):
185
    """
186
    End-to-end test for request cancellation functionality in aggregated mode.
187
188
189

    This test verifies that when a request is cancelled by the client,
    the system properly handles the cancellation and cleans up resources
190
    on the worker side in aggregated (single worker) mode. Tests three scenarios:
191
192
193
    1. Completion request
    2. Chat completion request (non-streaming)
    3. Chat completion request (streaming)
194
195
196
197
198

    Timing (Last Run: 2025-12-09): ~55s total
    - Engine initialization: ~15s
    - Testing 3 scenarios: ~38s (~12s each)
    - Teardown: ~2s
199
200
    """

201
    # Step 1: Start the frontend (allocates its own frontend_port)
202
203
204
    with DynamoFrontendProcess(request) as frontend:
        logger.info("Frontend started successfully")

205
206
        # Step 2: Start a single worker (allocates its own system_port)
        with DynamoWorkerProcess(request, frontend.frontend_port) as worker:
207
208
            logger.info(f"Worker PID: {worker.get_pid()}")

209
            # Step 3: Test request cancellation with polling approach
210
211
212
213
214
215
216
217
218
219
220
            frontend_log_offset, worker_log_offset = 0, 0

            test_scenarios = [
                ("completion", "Completion request cancellation"),
                ("chat_completion", "Chat completion request cancellation"),
                (
                    "chat_completion_stream",
                    "Chat completion stream request cancellation",
                ),
            ]

221
            for request_type, description in test_scenarios:
222
223
                logger.info(f"Testing {description.lower()}...")

224
                # Send the request (non-blocking)
225
226
227
                cancellable_req = send_cancellable_request(
                    frontend.frontend_port, request_type
                )
228

229
                # Poll for "Decode Request ID" pattern (vLLM v2 pattern)
230
231
                request_id, worker_log_offset = poll_for_pattern(
                    process=worker,
232
                    pattern="Decode Request ID: ",
233
234
                    log_offset=worker_log_offset,
                    match_type="contains",
235
                )
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256

                # For streaming, read 5 responses before cancelling
                if request_type == "chat_completion_stream":
                    read_streaming_responses(cancellable_req, expected_count=5)

                # Now cancel the request
                cancellable_req.cancel()
                logger.info(f"Cancelled request ID: {request_id}")

                # Poll for "Aborted Request ID" with matching ID
                _, worker_log_offset = poll_for_pattern(
                    process=worker,
                    pattern=f"Aborted Request ID: {request_id}",
                    log_offset=worker_log_offset,
                )

                # Verify frontend log has kill message
                _, frontend_log_offset = poll_for_pattern(
                    process=frontend,
                    pattern="issued control message Kill to sender",
                    log_offset=frontend_log_offset,
257
258
259
260
261
                )

                logger.info(f"{description} detected successfully")


262
@pytest.mark.timeout(150)  # 3x average
263
def test_request_cancellation_vllm_decode_cancel(
264
    request, runtime_services_dynamic_ports, set_ucx_tls_no_mm, predownload_models
Alec's avatar
Alec committed
265
):
266
    """
267
    End-to-end test for request cancellation during decode phase.
268

269
    This test verifies that when a request is cancelled by the client during the decode phase,
270
271
    the system properly handles the cancellation and cleans up resources
    on the decode worker side in a disaggregated setup.
272
273
274
275
276

    Timing (Last Run: 2025-12-09): ~53s total (requires 2 GPUs)
    - Engine initialization: ~23s (decode + prefill workers)
    - Testing stream cancellation during decode: ~28s
    - Teardown: ~2s
277
278
    """

279
    # Step 1: Start the frontend (allocates its own frontend_port)
280
281
282
    with DynamoFrontendProcess(request) as frontend:
        logger.info("Frontend started successfully")

283
284
285
286
        # Step 2: Start the prefill worker (allocates its own system_port)
        with DynamoWorkerProcess(
            request, frontend.frontend_port, is_prefill=True
        ) as prefill_worker:
287
288
            logger.info(f"Prefill Worker PID: {prefill_worker.get_pid()}")

289
290
291
292
            # Step 3: Start the decode worker (allocates its own system_port)
            with DynamoWorkerProcess(
                request, frontend.frontend_port, is_prefill=False
            ) as decode_worker:
293
294
                logger.info(f"Decode Worker PID: {decode_worker.get_pid()}")

295
                # Step 4: Test request cancellation for streaming scenario
296
                logger.info(
297
298
299
300
                    "Testing chat completion stream request cancellation in decode worker (decode phase)..."
                )

                # Send streaming request (non-blocking)
301
302
303
                cancellable_req = send_cancellable_request(
                    frontend.frontend_port, "chat_completion_stream"
                )
304

305
                # Poll for "Decode Request ID" pattern in decode worker (vLLM v2 pattern)
306
307
                request_id, decode_log_offset = poll_for_pattern(
                    process=decode_worker,
308
                    pattern="Decode Request ID: ",
309
310
311
                    match_type="contains",
                )

312
                # Verify same request ID reached prefill worker (as "Prefill Request ID")
313
314
                _, prefill_log_offset = poll_for_pattern(
                    process=prefill_worker,
315
                    pattern=f"Prefill Request ID: {request_id}",
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
                )

                # Read 5 streaming responses (decode phase)
                read_streaming_responses(cancellable_req, expected_count=5)

                # Now cancel the request
                cancellable_req.cancel()
                logger.info(f"Cancelled request ID: {request_id}")

                # Poll for "Aborted Request ID" in decode worker
                _, decode_log_offset = poll_for_pattern(
                    process=decode_worker,
                    pattern=f"Aborted Request ID: {request_id}",
                    log_offset=decode_log_offset,
                )

                # Verify frontend log has kill message
                _, frontend_log_offset = poll_for_pattern(
                    process=frontend,
                    pattern="issued control message Kill to sender",
336
337
338
                )

                logger.info(
339
                    "Chat completion stream cancellation in decode phase detected successfully"
340
341
342
                )


343
@pytest.mark.timeout(150)  # 3x average
344
def test_request_cancellation_vllm_prefill_cancel(
345
    request, runtime_services_dynamic_ports, set_ucx_tls_no_mm, predownload_models
346
):
347
    """
348
    End-to-end test for request cancellation during prefill phase.
349

350
    This test verifies that when a request is cancelled by the client during the prefill phase,
351
352
    the system properly handles the cancellation and cleans up resources
    on both the decode and prefill workers in a disaggregated setup.
353
354
355
356
357

    Timing (Last Run: 2025-12-09): ~53s total (requires 2 GPUs)
    - Engine initialization: ~23s (decode + prefill workers)
    - Testing cancellation during prefill: ~28s
    - Teardown: ~2s
358
    """
359

360
    # Step 1: Start the frontend (allocates its own frontend_port)
361
362
363
    with DynamoFrontendProcess(request) as frontend:
        logger.info("Frontend started successfully")

364
365
366
367
        # Step 2: Start the prefill worker (allocates its own system_port)
        with DynamoWorkerProcess(
            request, frontend.frontend_port, is_prefill=True
        ) as prefill_worker:
368
369
            logger.info(f"Prefill Worker PID: {prefill_worker.get_pid()}")

370
371
372
373
            # Step 3: Start the decode worker (allocates its own system_port)
            with DynamoWorkerProcess(
                request, frontend.frontend_port, is_prefill=False
            ) as decode_worker:
374
375
                logger.info(f"Decode Worker PID: {decode_worker.get_pid()}")

376
377
378
                # Step 4: Test request cancellation during prefill phase
                # Note: With the new architecture, prefill routing happens in the frontend,
                # so the request goes directly to the prefill worker first
379
                logger.info(
380
                    "Testing completion request cancellation during prefill phase..."
381
382
                )

383
384
                # Send request with long prompt (non-blocking)
                cancellable_req = send_cancellable_request(
385
                    frontend.frontend_port, "completion", use_long_prompt=True
386
                )
387

388
389
390
                # Poll for "Prefill Request ID" pattern in prefill worker (vLLM v2 pattern)
                # With new architecture, prefill is routed by frontend's internal router
                request_id, prefill_log_offset = poll_for_pattern(
391
                    process=prefill_worker,
392
393
                    pattern="Prefill Request ID: ",
                    match_type="contains",
394
395
396
397
                )

                # Cancel during prefill phase
                cancellable_req.cancel()
398
                logger.info(f"Cancelled request ID: {request_id} during prefill")
399

400
                # Poll for "Aborted Prefill Request ID" in prefill worker (where cancellation happens)
401
402
403
404
405
406
407
408
409
410
411
412
                _, prefill_log_offset = poll_for_pattern(
                    process=prefill_worker,
                    pattern=f"Aborted Prefill Request ID: {request_id}",
                    log_offset=prefill_log_offset,
                )

                # Verify frontend log has kill message
                _, frontend_log_offset = poll_for_pattern(
                    process=frontend,
                    pattern="issued control message Kill to sender",
                )

413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
                # Verify decode worker never received the request
                pattern = "Request ID: "
                try:
                    _, decode_log_offset = poll_for_pattern(
                        process=decode_worker,
                        pattern=pattern,
                        max_wait_ms=10,
                        match_type="contains",
                    )
                    pytest.fail(
                        "Decode worker received request cancelled during prefill phase"
                    )
                except AssertionError as e:
                    assert str(e).startswith(
                        f"Failed to find '{pattern}' pattern after 2 iterations "
                    ), f"Unexpected error: {e}"

430
                logger.info(
431
                    "Completion request cancellation during prefill phase detected successfully"
432
                )