mirror of
https://github.com/GNS3/gns3-server.git
synced 2026-11-19 20:55:14 +02:00
By default uvicorn waits for open connections forever. A long-lived streaming response keeps the server waiting after Ctrl+C. One common case is the MCP Streamable HTTP transport: the client opens a standalone GET request and the server answers with an SSE stream (not the old SSE transport). A second Ctrl+C sets force_exit. Uvicorn then skips the lifespan shutdown, so project and controller cleanup does not run. Add timeout_graceful_shutdown. After the timeout uvicorn cancels the remaining tasks and runs the lifespan shutdown. Also make the four notification WebSocket handlers stop when app.state.exiting is set. The HTTP stream handlers already do this.
140 lines
5.5 KiB
Python
140 lines
5.5 KiB
Python
#
|
|
# Copyright (C) 2026 GNS3 Technologies Inc.
|
|
#
|
|
# This program is free software: you can redistribute it and/or modify
|
|
# it under the terms of the GNU General Public License as published by
|
|
# the Free Software Foundation, either version 3 of the License, or
|
|
# (at your option) any later version.
|
|
#
|
|
# This program is distributed in the hope that it will be useful,
|
|
# but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
# GNU General Public License for more details.
|
|
#
|
|
# You should have received a copy of the GNU General Public License
|
|
# along with this program. If not, see <http://www.gnu.org/licenses/>.
|
|
|
|
import asyncio
|
|
import json
|
|
import uuid
|
|
from types import SimpleNamespace
|
|
from unittest.mock import AsyncMock, MagicMock
|
|
|
|
import pytest
|
|
from fastapi import FastAPI
|
|
from pydantic import ValidationError
|
|
|
|
from gns3server import schemas
|
|
from gns3server.api.routes.controller.controller import controller_ws_notifications
|
|
from gns3server.api.routes.controller.projects import (
|
|
project_marker_ws_notifications,
|
|
project_ws_notifications,
|
|
)
|
|
from gns3server.utils.notification_queue import NotificationQueue
|
|
|
|
STREAM_PATHS = ["/v3/notifications", "/v3/projects/{project_id}/notifications"]
|
|
|
|
|
|
class TestNotificationOpenAPI:
|
|
def test_notification_schema_in_spec(self, app: FastAPI) -> None:
|
|
|
|
spec = app.openapi()
|
|
schema = spec["components"]["schemas"]["Notification"]
|
|
assert set(schema["required"]) == {"action", "event"}
|
|
assert {"action", "event", "project_id", "compute_id"} <= set(schema["properties"])
|
|
action_schema = spec["components"]["schemas"]["NotificationAction"]
|
|
assert {"ping", "node.created", "node.updated", "link.created", "marker.match"} <= set(action_schema["enum"])
|
|
|
|
@pytest.mark.parametrize("path", STREAM_PATHS)
|
|
def test_stream_responses_reference_schema(self, app: FastAPI, path: str) -> None:
|
|
|
|
content = app.openapi()["paths"][path]["get"]["responses"]["200"]["content"]
|
|
assert list(content) == ["application/x-ndjson"]
|
|
assert content["application/x-ndjson"]["schema"] == {"$ref": "#/components/schemas/Notification"}
|
|
|
|
|
|
class TestNotificationSchema:
|
|
def test_ping(self) -> None:
|
|
|
|
message = {
|
|
"action": "ping",
|
|
"event": {"cpu_usage_percent": 1.5, "memory_usage_percent": 40.0, "disk_usage_percent": 10.0},
|
|
}
|
|
notification = schemas.Notification.model_validate(message)
|
|
assert notification.action == schemas.NotificationAction.ping
|
|
|
|
def test_unknown_action(self) -> None:
|
|
|
|
with pytest.raises(ValidationError):
|
|
schemas.Notification.model_validate({"action": "unknown.action", "event": {}})
|
|
|
|
def test_optional_ids(self) -> None:
|
|
|
|
project_id = str(uuid.uuid4())
|
|
notification = schemas.Notification.model_validate(
|
|
{"action": "log.info", "event": {"message": "hello"}, "project_id": project_id, "compute_id": "local"}
|
|
)
|
|
assert str(notification.project_id) == project_id
|
|
assert notification.compute_id == "local"
|
|
|
|
def test_generic_event(self) -> None:
|
|
|
|
notification = schemas.Notification.model_validate(
|
|
{"action": "template.deleted", "event": {"template_id": str(uuid.uuid4())}}
|
|
)
|
|
assert notification.action == schemas.NotificationAction.template_deleted
|
|
|
|
@pytest.mark.asyncio
|
|
async def test_queue_message_matches_schema(self) -> None:
|
|
|
|
queue = NotificationQueue()
|
|
queue.put_nowait(("log.warning", {"message": "disk space is low"}, {"compute_id": "local"}))
|
|
await queue.get_json(5)
|
|
message = json.loads(await queue.get_json(5))
|
|
notification = schemas.Notification.model_validate(message)
|
|
assert notification.action == schemas.NotificationAction.log_warning
|
|
assert notification.compute_id == "local"
|
|
|
|
|
|
def _fake_websocket(app: FastAPI) -> MagicMock:
|
|
|
|
websocket = MagicMock()
|
|
websocket.app = app
|
|
websocket.client = SimpleNamespace(host="127.0.0.1", port=1000)
|
|
websocket.send_text = AsyncMock()
|
|
return websocket
|
|
|
|
|
|
class TestNotificationWebSocketShutdown:
|
|
"""Notification WebSockets must stop when the server is shutting down.
|
|
|
|
Otherwise uvicorn has to wait for them during graceful shutdown.
|
|
"""
|
|
|
|
@pytest.mark.asyncio
|
|
async def test_controller_ws_stops_when_app_is_exiting(self, app: FastAPI, monkeypatch) -> None:
|
|
|
|
monkeypatch.setattr(app.state, "exiting", True)
|
|
websocket = _fake_websocket(app)
|
|
await asyncio.wait_for(controller_ws_notifications(websocket, current_user=MagicMock()), timeout=1)
|
|
websocket.send_text.assert_not_awaited()
|
|
|
|
@pytest.mark.asyncio
|
|
async def test_project_ws_stops_when_app_is_exiting(self, app: FastAPI, project, monkeypatch) -> None:
|
|
|
|
project.auto_close = False
|
|
monkeypatch.setattr(app.state, "exiting", True)
|
|
websocket = _fake_websocket(app)
|
|
await asyncio.wait_for(project_ws_notifications(project.id, websocket, current_user=MagicMock()), timeout=1)
|
|
websocket.send_text.assert_not_awaited()
|
|
|
|
@pytest.mark.asyncio
|
|
async def test_marker_ws_stops_when_app_is_exiting(self, app: FastAPI, project, monkeypatch) -> None:
|
|
|
|
monkeypatch.setattr(app.state, "exiting", True)
|
|
websocket = _fake_websocket(app)
|
|
await asyncio.wait_for(
|
|
project_marker_ws_notifications(project.id, websocket, current_user=MagicMock()), timeout=1
|
|
)
|
|
websocket.send_text.assert_not_awaited()
|