cancan-microstack 0.0.1__py3-none-any.whl

cancan_microstack/services/infrasrv/router.py

@@ -0,0 +1,341 @@
+import http
+
+from linglong_web import BaseRoute
+from cancan_microstack.services.infrasrv.interface.api.service_config import (
+    get_service_config_handler,
+    insert_service_config_handler,
+    update_service_config_handler,
+    get_all_service_configs_handler,
+    delete_service_config_handler,
+)
+from cancan_microstack.services.infrasrv.interface.api.service_registry import (
+    register_service_handler,
+    deregister_service_handler,
+    get_service_instances_handler,
+)
+from cancan_microstack.services.infrasrv.interface.api.health_check_api import (
+    health_check_all_instances_handler,
+)
+from cancan_microstack.services.infrasrv.interface.api.internal import (
+    internal_trigger_config_push_handler,
+)
+from cancan_microstack.services.infrasrv.interface.api.service_logs_api import (
+    get_service_logs_handler,
+)
+from cancan_microstack.services.infrasrv.interface.api.hooks import (
+    get_hook_metrics_handler,
+    get_hook_history_handler,
+    get_hook_status_handler,
+    reset_hook_metrics_handler,
+    get_hook_performance_handler,
+)
+from cancan_microstack.services.infrasrv.interface.api.internal_operation_api import (
+    internal_create_operation_handler,
+    internal_update_operation_handler,
+    internal_get_operation_handler,
+    internal_list_operations_handler,
+    internal_check_timeouts_handler,
+)
+from cancan_microstack.services.infrasrv.interface.api.internal_instance_api import (
+    internal_create_instance_handler,
+    internal_update_instance_handler,
+    internal_delete_instance_handler,
+    internal_get_instance_handler,
+    internal_list_instances_handler,
+    internal_count_instances_handler,
+    internal_get_next_port_handler,
+    internal_update_service_replicas_handler,
+)
+from cancan_microstack.services.infrasrv.interface.api.service_management_api import (
+    start_service_handler,
+    stop_service_handler,
+    restart_service_handler,
+)
+from cancan_microstack.services.infrasrv.interface.api.workflow_api import (
+    create_workflow_handler,
+    list_workflows_handler,
+    get_workflow_handler,
+    list_runs_handler,
+    trigger_workflow_handler,
+    get_run_graph_status_handler,
+    get_node_history_handler,
+    external_callback_handler,
+    get_workflow_stats_handler,
+    update_workflow_handler,
+    delete_workflow_handler,
+    list_workflow_versions_handler,
+    rollback_workflow_handler,
+    list_engine_alerts_handler,
+    acknowledge_engine_alert_handler,
+    resolve_engine_alert_handler,
+)
+
+router_list = [
+    # Service Config routes - 配置管理接口
+    BaseRoute(
+        path="/v1/infrasrv/service_config",
+        method=http.HTTPMethod.GET,
+        handler=get_service_config_handler,
+    ),
+    BaseRoute(
+        path="/v1/infrasrv/service_configs",
+        method=http.HTTPMethod.GET,
+        handler=get_all_service_configs_handler,
+    ),
+    BaseRoute(
+        path="/v1/infrasrv/service_config",
+        method=http.HTTPMethod.POST,
+        handler=insert_service_config_handler,
+    ),
+    BaseRoute(
+        path="/v1/infrasrv/service_config",
+        method=http.HTTPMethod.PUT,
+        handler=update_service_config_handler,
+    ),
+    BaseRoute(
+        path="/v1/infrasrv/service_config",
+        method=http.HTTPMethod.DELETE,
+        handler=delete_service_config_handler,
+    ),
+
+    # Internal routes - 内部服务调用接口
+    BaseRoute(
+        path="/v1/infrasrv/internal/config/push",
+        method=http.HTTPMethod.POST,
+        handler=internal_trigger_config_push_handler,
+    ),
+
+    # Service Management routes - 服务管理接口（供 opsbffsrv 调用）
+    BaseRoute(
+        path="/v1/infrasrv/service/start",
+        method=http.HTTPMethod.POST,
+        handler=start_service_handler,
+    ),
+    BaseRoute(
+        path="/v1/infrasrv/service/stop",
+        method=http.HTTPMethod.POST,
+        handler=stop_service_handler,
+    ),
+    BaseRoute(
+        path="/v1/infrasrv/service/restart",
+        method=http.HTTPMethod.POST,
+        handler=restart_service_handler,
+    ),
+
+    # Service Registry routes - 服务间通信接口
+    BaseRoute(
+        path="/v1/infrasrv/registry/register",
+        method=http.HTTPMethod.POST,
+        handler=register_service_handler,
+    ),
+    BaseRoute(
+        path="/v1/infrasrv/registry/deregister",
+        method=http.HTTPMethod.DELETE,
+        handler=deregister_service_handler,
+    ),
+    BaseRoute(
+        path="/v1/infrasrv/registry/instances",
+        method=http.HTTPMethod.GET,
+        handler=get_service_instances_handler,
+    ),
+    BaseRoute(
+        path="/v1/infrasrv/health/check_instances",
+        method=http.HTTPMethod.POST,
+        handler=health_check_all_instances_handler,
+    ),
+
+    # Internal Operation Management routes - 操作管理内部接口（供 controllersrv 调用）
+    BaseRoute(
+        path="/v1/infrasrv/internal/operation/create",
+        method=http.HTTPMethod.POST,
+        handler=internal_create_operation_handler,
+    ),
+    BaseRoute(
+        path="/v1/infrasrv/internal/operation/update",
+        method=http.HTTPMethod.POST,
+        handler=internal_update_operation_handler,
+    ),
+    BaseRoute(
+        path="/v1/infrasrv/internal/operation/get",
+        method=http.HTTPMethod.GET,
+        handler=internal_get_operation_handler,
+    ),
+    BaseRoute(
+        path="/v1/infrasrv/internal/operation/status",
+        method=http.HTTPMethod.GET,
+        handler=internal_get_operation_handler,
+    ),
+    BaseRoute(
+        path="/v1/infrasrv/internal/operation/list",
+        method=http.HTTPMethod.GET,
+        handler=internal_list_operations_handler,
+    ),
+    BaseRoute(
+        path="/v1/infrasrv/internal/operation/check_timeouts",
+        method=http.HTTPMethod.GET,
+        handler=internal_check_timeouts_handler,
+    ),
+
+    # Internal Instance Management routes - 实例管理内部接口（供 controllersrv 调用）
+    BaseRoute(
+        path="/v1/infrasrv/internal/instance/create",
+        method=http.HTTPMethod.POST,
+        handler=internal_create_instance_handler,
+    ),
+    BaseRoute(
+        path="/v1/infrasrv/internal/instance/update",
+        method=http.HTTPMethod.POST,
+        handler=internal_update_instance_handler,
+    ),
+    BaseRoute(
+        path="/v1/infrasrv/internal/instance/delete",
+        method=http.HTTPMethod.POST,
+        handler=internal_delete_instance_handler,
+    ),
+    BaseRoute(
+        path="/v1/infrasrv/internal/instance/get",
+        method=http.HTTPMethod.GET,
+        handler=internal_get_instance_handler,
+    ),
+    BaseRoute(
+        path="/v1/infrasrv/internal/instance/list",
+        method=http.HTTPMethod.GET,
+        handler=internal_list_instances_handler,
+    ),
+    BaseRoute(
+        path="/v1/infrasrv/internal/instance/count",
+        method=http.HTTPMethod.GET,
+        handler=internal_count_instances_handler,
+    ),
+    BaseRoute(
+        path="/v1/infrasrv/internal/instance/get_next_port",
+        method=http.HTTPMethod.GET,
+        handler=internal_get_next_port_handler,
+    ),
+    BaseRoute(
+        path="/v1/infrasrv/internal/service_info/update_replicas",
+        method=http.HTTPMethod.POST,
+        handler=internal_update_service_replicas_handler,
+    ),
+
+    # Service Logs routes - 日志查询接口（供 opsbffsrv 调用）
+    BaseRoute(
+        path="/v1/infrasrv/service_logs",
+        method=http.HTTPMethod.GET,
+        handler=get_service_logs_handler,
+    ),
+
+    # Hook Monitoring routes - 钩子监控接口
+    BaseRoute(
+        path="/v1/infrasrv/hooks/metrics",
+        method=http.HTTPMethod.GET,
+        handler=get_hook_metrics_handler,
+    ),
+    BaseRoute(
+        path="/v1/infrasrv/hooks/history",
+        method=http.HTTPMethod.GET,
+        handler=get_hook_history_handler,
+    ),
+    BaseRoute(
+        path="/v1/infrasrv/hooks/status",
+        method=http.HTTPMethod.GET,
+        handler=get_hook_status_handler,
+    ),
+    BaseRoute(
+        path="/v1/infrasrv/hooks/metrics/reset",
+        method=http.HTTPMethod.POST,
+        handler=reset_hook_metrics_handler,
+    ),
+    BaseRoute(
+        path="/v1/infrasrv/hooks/metrics/reset",
+        method=http.HTTPMethod.POST,
+        handler=reset_hook_metrics_handler,
+    ),
+    BaseRoute(
+        path="/v1/infrasrv/hooks/performance",
+        method=http.HTTPMethod.GET,
+        handler=get_hook_performance_handler,
+    ),
+
+    # Workflow routes
+    BaseRoute(
+        path="/v1/infrasrv/workflows",
+        method=http.HTTPMethod.POST,
+        handler=create_workflow_handler,
+    ),
+    BaseRoute(
+        path="/v1/infrasrv/workflows",
+        method=http.HTTPMethod.GET,
+        handler=list_workflows_handler,
+    ),
+    BaseRoute(
+        path="/v1/infrasrv/workflows/stats",
+        method=http.HTTPMethod.GET,
+        handler=get_workflow_stats_handler,
+    ),
+    BaseRoute(
+        path="/v1/infrasrv/workflows/alerts",
+        method=http.HTTPMethod.GET,
+        handler=list_engine_alerts_handler,
+    ),
+    BaseRoute(
+        path="/v1/infrasrv/workflows/alerts/{alert_id}/ack",
+        method=http.HTTPMethod.POST,
+        handler=acknowledge_engine_alert_handler,
+    ),
+    BaseRoute(
+        path="/v1/infrasrv/workflows/alerts/{alert_id}/resolve",
+        method=http.HTTPMethod.POST,
+        handler=resolve_engine_alert_handler,
+    ),
+    BaseRoute(
+        path="/v1/infrasrv/workflows/{workflow_id}",
+        method=http.HTTPMethod.GET,
+        handler=get_workflow_handler,
+    ),
+    BaseRoute(
+        path="/v1/infrasrv/workflows/{workflow_id}",
+        method=http.HTTPMethod.PUT,
+        handler=update_workflow_handler,
+    ),
+    BaseRoute(
+        path="/v1/infrasrv/workflows/{workflow_id}",
+        method=http.HTTPMethod.DELETE,
+        handler=delete_workflow_handler,
+    ),
+    BaseRoute(
+        path="/v1/infrasrv/workflows/{workflow_id}/versions",
+        method=http.HTTPMethod.GET,
+        handler=list_workflow_versions_handler,
+    ),
+    BaseRoute(
+        path="/v1/infrasrv/workflows/{workflow_id}/rollback",
+        method=http.HTTPMethod.POST,
+        handler=rollback_workflow_handler,
+    ),
+    BaseRoute(
+        path="/v1/infrasrv/workflows/{workflow_id}/trigger",
+        method=http.HTTPMethod.POST,
+        handler=trigger_workflow_handler,
+    ),
+    BaseRoute(
+        path="/v1/infrasrv/runs",
+        method=http.HTTPMethod.GET,
+        handler=list_runs_handler,
+    ),
+    BaseRoute(
+        path="/v1/infrasrv/runs/{run_id}/status",
+        method=http.HTTPMethod.GET,
+        handler=get_run_graph_status_handler,
+    ),
+    BaseRoute(
+        path="/v1/infrasrv/runs/{run_id}/nodes/{node_id}/history",
+        method=http.HTTPMethod.GET,
+        handler=get_node_history_handler,
+    ),
+    BaseRoute(
+        path="/v1/infrasrv/callbacks/{node_instance_id}",
+        method=http.HTTPMethod.POST,
+        handler=external_callback_handler,
+    ),
+]

cancan_microstack/services/opsbffsrv/__init__.py

@@ -0,0 +1,4 @@
+"""opsbffsrv namespace bootstrap (override aware)."""
+from cancan_microstack.runtime.overrides import extend_service_package
+
+__path__ = extend_service_package("opsbffsrv", __name__, __path__)  # type: ignore[name-defined]

cancan_microstack/services/opsbffsrv/application/async_operation_app.py

@@ -0,0 +1,150 @@
+"""
+异步操作管理应用层 / Asynchronous Operation Management Application Layer
+
+职责 / Responsibilities:
+1. 生成 operation_id / Generate operation_id
+2. 构造服务管理请求 / Construct service management request
+3. 调用 infrasrv 统一服务管理接口 / Call infrasrv unified service management interface
+4. 返回操作响应 / Return operation response
+
+重构说明 / Refactoring Notes:
+- 移除直接调用 controllersrv 的逻辑 / Removed direct controllersrv calls
+- 所有服务管理操作统一通过 infrasrv / All service management operations go through infrasrv
+- infrasrv 负责操作记录管理和 controllersrv 调用 / infrasrv handles operation records and controllersrv calls
+"""
+from typing import (
+    Optional,
+    Dict,
+    Any,
+)
+from nanoid import generate
+
+from linglong_web.utils import logger
+from cancan_microstack.services.opsbffsrv.infrastructure.api.infrasrv_api import InfraSrvApi
+from cancan_microstack.public.schemas.infra.service_management import (
+    ServiceManagementRequest,
+    ServiceManagementAPIResponse,
+)
+from cancan_microstack.public.const.operation_consts import (
+    OperationType,
+    OperationStatus,
+    InitiatedBy,
+    InitiatedFrom,
+)
+from cancan_microstack.public.schemas.opsbffsrv.async_ops import AsyncOperationResponse
+
+
+class AsyncOperationApp:
+    """
+    异步操作管理应用层 / Asynchronous Operation Management Application Layer
+    
+    简化后的职责：构造请求 → 调用 infrasrv → 返回响应
+    Simplified responsibility: Construct request → Call infrasrv → Return response
+    """
+
+    def __init__(self):
+        # 移除 controllersrv_api，只保留 infrasrv_api / Remove controllersrv_api, keep only infrasrv_api
+        self.infrasrv_api = InfraSrvApi()
+
+    async def submit_operation(
+            self,
+            operation_type: OperationType,
+            service_name: str,
+            operation_params: Dict[str, Any],
+            initiated_by: InitiatedBy = InitiatedBy.OPSBFFSRV,
+            initiated_from: InitiatedFrom = InitiatedFrom.FRONTEND
+    ) -> AsyncOperationResponse:
+        """
+        提交异步操作（统一通过 infrasrv）/ Submit asynchronous operation (unified through infrasrv)
+
+        1. 生成 operation_id / Generate operation_id
+        2. 构造 ServiceManagementRequest / Construct ServiceManagementRequest
+        3. 调用 infrasrv 统一服务管理接口 / Call infrasrv unified service management interface
+        4. infrasrv 内部完成：创建记录 → 调用 controllersrv → 更新状态 / infrasrv internally: Create record → Call controllersrv → Update status
+        5. 返回响应 / Return response
+        
+        Args:
+            operation_type: 操作类型 / Operation type
+            service_name: 服务名称 / Service name
+            operation_params: 操作参数 / Operation parameters
+            initiated_by: 操作发起者 / Operation initiator
+            initiated_from: 发起来源 / Initiation source
+        
+        Returns:
+            异步操作响应 / Asynchronous operation response
+        """
+        # 步骤 1: 生成 operation_id / Step 1: Generate operation_id
+        operation_id = f"op_{operation_type.value}_{generate(size=12)}"
+        full_service_name = service_name if service_name.endswith('.service') else f"{service_name}.service"
+
+        logger.info(
+            f"[AsyncOperationApp] Submitting operation: "
+            f"operation_id={operation_id}, "
+            f"type={operation_type.value}, "
+            f"service={full_service_name}"
+        )
+
+        # 步骤 2: 构造服务管理请求 / Step 2: Construct service management request
+        request = ServiceManagementRequest(
+            operation_id=operation_id,
+            service_name=full_service_name,
+            operation_type=operation_type,
+            operation_params=operation_params,
+            initiated_by=initiated_by,
+            initiated_from=initiated_from
+        )
+
+        # 步骤 3: 调用 infrasrv（根据操作类型分派）/ Step 3: Call infrasrv (dispatch by operation type)
+        # 此时如果失败会抛出异常 / If failed, exception will be raised
+        api_response = await self._call_infrasrv(operation_type, request)
+
+        # 步骤 4: 处理 infrasrv 响应 / Step 4: Handle infrasrv response
+        # 成功获得响应 / Successfully got response
+        # 将字符串状态转换为 OperationStatus 枚举 / Convert string status to OperationStatus enum
+        try:
+            status = OperationStatus(api_response.status)
+        except ValueError:
+            status = OperationStatus.PENDING
+
+        logger.info(
+            f"[AsyncOperationApp] Operation {operation_id} submitted successfully, status: {status.value}")
+
+        return AsyncOperationResponse(
+            operation_id=api_response.operation_id,
+            status=status,
+            message=api_response.message or f"Operation submitted: {operation_type.value} {full_service_name}",
+            service_name=api_response.service_name
+        )
+
+    async def _call_infrasrv(
+            self,
+            operation_type: OperationType,
+            request: ServiceManagementRequest
+    ) -> 'ServiceManagementAPIResponse':
+        """
+        调用 infrasrv 执行服务管理操作 / Call infrasrv to execute service management operation
+        
+        根据操作类型分派到不同的 infrasrv API / Dispatch to different infrasrv APIs based on operation type
+        
+        Args:
+            operation_type: 操作类型 / Operation type
+            request: 服务管理请求 / Service management request
+        
+        Returns:
+            ServiceManagementAPIResponse
+        """
+        logger.info(
+            f"[AsyncOperationApp → infrasrv] Calling infrasrv for {operation_type.value} operation: {request.operation_id}"
+        )
+
+        if operation_type == OperationType.START:
+            return await self.infrasrv_api.start_service(request)
+
+        elif operation_type == OperationType.STOP:
+            return await self.infrasrv_api.stop_service(request)
+
+        elif operation_type == OperationType.RESTART:
+            return await self.infrasrv_api.restart_service(request)
+
+        else:
+            raise ValueError(f"Unsupported operation type: {operation_type}")