Add graceful SCUM stop, restart, and version update flow
SCUM 停止/重启/更新以前只有“结束进程”这一条路，插件没有声明任何优雅关闭方式，
平台也没有把停止后重新启动串起来。现在插件声明自己的关闭脚本，run 先执行它，
平台在停止或更新成功后再自动拉起服务。
run:
- lifecycle stop 支持插件声明的 gracefulStop（可执行文件、参数、环境、超时、
fallback=report|terminate）；关闭命令超时且声明 report 时任务失败，不再默默杀进程。
- 新增 steam.update 依赖探针：调用 steamcmd +app_info_print 获取公开分支 buildid，
与本地 steamapps/appmanifest_<appid>.acf 的 buildid 比较，输出
installed/latest/update=yes|no|unknown。
platform:
- 新增 POST /api/v1/server-instances/{id}/restart 与 /update。
- restart 派发插件 stop 动作（走优雅关闭），终态成功后入队 start 作业。
- update 派发插件 install 动作；插件在更新前必须先优雅关闭 SCUM，关闭失败直接拒绝
SteamCMD 更新，成功后平台再拉起服务。
- 依赖检查输入带上插件声明的服务器安装根目录，供 steam.update 读取 appmanifest。
plugin (SCUM server plugin 0.1.16):
- bin/scum-stop.cmd：解析已声明的可执行文件路径，定位同路径正在运行的 SCUMServer.exe，
通过本地 RCON 公告并发送关闭命令，等待进程自行退出；不再使用 taskkill。
- bin/scum-rcon.ps1：插件自有的 Source RCON 客户端，从 UE4SS mod config.ini 读取
密码/端口，密钥不离开本机。
- actions/stop.json 声明 gracefulStop；actions/install.json 更新前先执行同一关闭脚本。
platform_web:
- 服务器详情新增“重启”按钮和“SCUM 版本更新”面板；点“检查更新”查询公开分支版本，
只有检测到更新时“更新版本”按钮才会置为可用并高亮，点击后先确认再派发更新任务。
This commit is contained in:
npc0-hue
@@ -1,4 +1,4 @@
|
||||
import { ChevronRight, Download, Eye, FileText, Folder, MoonStar, PackageOpen, Pencil, RefreshCw, Save, Search, Settings2, ShieldCheck, Sparkles, Square, Terminal, Upload, UserRoundMinus, UserRoundPlus, WandSparkles, X } from "lucide-react";
|
||||
import { ChevronRight, Download, Eye, FileText, Folder, MoonStar, PackageOpen, Pencil, RefreshCw, RotateCcw, Save, Search, Settings2, ShieldCheck, Sparkles, Square, Terminal, Upload, UserRoundMinus, UserRoundPlus, WandSparkles, X } from "lucide-react";
|
||||
import { type ChangeEvent, type FormEvent, useCallback, useEffect, useMemo, useRef, useState } from "react";
|
||||
|
||||
import { platformApiClient } from "../api/client";
|
||||
@@ -19,9 +19,10 @@ import type {
|
||||
import { ConfirmDialog } from "../components/OperationControls";
|
||||
import { ServerManagementTerminalDrawer } from "../components/ServerManagementTerminalDrawer";
|
||||
import { ServerConfigEditor } from "../components/ServerConfigEditor";
|
||||
import { ServerGameUpdatePanel } from "../components/ServerGameUpdatePanel";
|
||||
import { EmptyState, ErrorState, LoadingState, ResultBadge } from "../components/StateViews";
|
||||
import type { PageComponentProps } from "../contracts/page";
|
||||
import { canStartServer, canStopServer, runtimeObservationFreshness, serverMetadataFormFromInstance, type ServerMetadataFormState } from "../contracts/serverManagement";
|
||||
import { canRestartServer, canStartServer, canStopServer, runtimeObservationFreshness, serverMetadataFormFromInstance, type ServerMetadataFormState } from "../contracts/serverManagement";
|
||||
import {
|
||||
serverDetailSections,
|
||||
type ConfigDiffView,
|
||||
@@ -129,26 +130,32 @@ export function ServerDetailPage(props: PageComponentProps) {
|
||||
setSection(`plugin:${defaultPluginPage.key}`);
|
||||
}, [defaultPluginPage, params.routeKey, section]);
|
||||
|
||||
function requestLifecycle(current: ServerInstanceResponse, action: "start" | "stop") {
|
||||
function requestLifecycle(current: ServerInstanceResponse, action: "start" | "stop" | "restart") {
|
||||
const intent = action === "start" ? "启动服务器" : action === "stop" ? "停止服务器" : "重启服务器";
|
||||
setConfirm({
|
||||
title: action === "start" ? "启动服务器" : "停止服务器",
|
||||
title: action === "start" ? "启动服务器" : action === "stop" ? "停止服务器" : "重启服务器",
|
||||
description:
|
||||
action === "start"
|
||||
? `确认启动服务器 ${current.name}（${current.id}）？`
|
||||
: `停止服务器 ${current.name}（${current.id}）会断开所有在线玩家，确认继续？`,
|
||||
: action === "stop"
|
||||
? `停止服务器 ${current.name}（${current.id}）会断开所有在线玩家，确认继续？`
|
||||
: `重启服务器 ${current.name}（${current.id}）会先按插件声明优雅关闭 SCUM 服务，停止成功后自动重新启动；在线玩家会被断开。`,
|
||||
danger: action === "stop",
|
||||
run: async () => {
|
||||
const operationId = operations.begin({
|
||||
intent: action === "start" ? "启动服务器" : "停止服务器",
|
||||
intent,
|
||||
targetKind: "server",
|
||||
targetId: current.id,
|
||||
requester: session.displayName
|
||||
});
|
||||
try {
|
||||
const request = serverLifecycleCommandRequest(current, action);
|
||||
const result =
|
||||
action === "start"
|
||||
? await platformApiClient.startServerInstance(current.id, serverLifecycleCommandRequest(current, "start"))
|
||||
: await platformApiClient.stopServerInstance(current.id, serverLifecycleCommandRequest(current, "stop"));
|
||||
? await platformApiClient.startServerInstance(current.id, request)
|
||||
: action === "stop"
|
||||
? await platformApiClient.stopServerInstance(current.id, request)
|
||||
: await platformApiClient.restartServerInstance(current.id, request);
|
||||
operations.succeed(operationId, `任务 ${result.job.id}（${result.job.capability}）已派发`, result.job);
|
||||
await refresh();
|
||||
} catch (error) {
|
||||
@@ -231,6 +238,15 @@ export function ServerDetailPage(props: PageComponentProps) {
|
||||
<Square size={15} />
|
||||
<span>停止</span>
|
||||
</button>
|
||||
<button
|
||||
type="button"
|
||||
className="icon-command"
|
||||
disabled={!canManageServers || !canRestartServer(instance.data.state) || operations.isPending(instance.data.id, "重启服务器")}
|
||||
onClick={() => requestLifecycle(instance.data, "restart")}
|
||||
>
|
||||
<RotateCcw size={15} />
|
||||
<span>重启</span>
|
||||
</button>
|
||||
<span className={cx("status-pill", detailFreshness === "fresh" ? statusClass(instance.data.state) : "status-disabled")}>{detailStateText}</span>
|
||||
</div>
|
||||
</div>
|
||||
@@ -249,6 +265,15 @@ export function ServerDetailPage(props: PageComponentProps) {
|
||||
/>
|
||||
)}
|
||||
{section === "manage" && <ServerAdministratorsSection instance={instance.data} session={session} onChanged={(next) => setInstance({ status: "ready", data: next })} />}
|
||||
{section === "manage" && (
|
||||
<ServerGameUpdatePanel
|
||||
instance={instance.data}
|
||||
session={session}
|
||||
operations={operations}
|
||||
canManage={canManageServers}
|
||||
onChanged={() => void refreshOperationalState()}
|
||||
/>
|
||||
)}
|
||||
{section === "files" && <ServerFilesSection instance={instance.data} session={session} operations={operations} />}
|
||||
{section === "llm" && <LlmSection serverId={serverId} instance={instance.data} session={session} operations={operations} />}
|
||||
<ServerManagementTerminalDrawer open={terminalOpen} serverId={instance.data.id} serverName={instance.data.name} onClose={() => setTerminalOpen(false)} />
|
||||
|
||||
Reference in New Issue
Block a user