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:
@@ -5,7 +5,7 @@ if "%SERVER_ROOT%"=="" set "SERVER_ROOT=C:\scumserver"
|
||||
set "SERVER_ROOT_WINDOWS=%SERVER_ROOT:/=\%"
|
||||
if "%SERVER_STEAM_APP_ID%"=="" set "SERVER_STEAM_APP_ID=3792580"
|
||||
if "%SERVER_STEAMCMD_INSTALL_DIR_ARG%"=="" set "SERVER_STEAMCMD_INSTALL_DIR_ARG=+force_install_dir"
|
||||
if "%SERVER_STEAMCMD_UPDATE_ARGS%"=="" set "SERVER_STEAMCMD_UPDATE_ARGS=+login anonymous +app_update 3792580 +quit"
|
||||
if "%SERVER_STEAMCMD_UPDATE_ARGS%"=="" set "SERVER_STEAMCMD_UPDATE_ARGS=+login anonymous +app_update 3792580 validate +quit"
|
||||
if "%SERVER_EXECUTABLE_REF%"=="" set "SERVER_EXECUTABLE_REF=SCUM\Binaries\Win64\SCUMServer.exe"
|
||||
if "%SERVER_INSTALL_DIR%"=="" set "SERVER_INSTALL_DIR=%SERVER_ROOT_WINDOWS%"
|
||||
set "SERVER_INSTALL_DIR_WINDOWS=%SERVER_INSTALL_DIR:/=\%"
|
||||
@@ -29,8 +29,7 @@ if not exist "%STEAMCMD_EXE%" (
|
||||
if errorlevel 1 exit /b 1
|
||||
)
|
||||
|
||||
call :resolve_scum_exe
|
||||
if exist "%SCUM_EXE%" call :stop_matching_scum
|
||||
call :stop_running_scum
|
||||
if errorlevel 1 exit /b 1
|
||||
|
||||
pushd "%STEAMCMD_DIR%"
|
||||
@@ -60,10 +59,21 @@ if exist "%SCUM_EXE%" exit /b 0
|
||||
set "SCUM_EXE=%SERVER_ROOT_WINDOWS%\SCUM Server\%SERVER_EXECUTABLE_REF:/=\%"
|
||||
exit /b 0
|
||||
|
||||
:stop_matching_scum
|
||||
if "%SCUM_EXE%"=="" exit /b 0
|
||||
powershell -NoProfile -ExecutionPolicy Bypass -Command "$target=[IO.Path]::GetFullPath($env:SCUM_EXE); Get-CimInstance Win32_Process -Filter \"name='SCUMServer.exe'\" | Where-Object { $_.ExecutablePath -and ([IO.Path]::GetFullPath($_.ExecutablePath) -ieq $target) } | ForEach-Object { Stop-Process -Id $_.ProcessId -Force }"
|
||||
exit /b %ERRORLEVEL%
|
||||
:stop_running_scum
|
||||
rem SteamCMD must never replace server files underneath a running process.
|
||||
rem The plugin-owned stop script asks the running SCUM server to shut down and
|
||||
rem waits for it to exit, so an update cannot silently kill a live server.
|
||||
set "SCUM_STOP_SCRIPT=%~dp0scum-stop.cmd"
|
||||
if not exist "%SCUM_STOP_SCRIPT%" (
|
||||
echo [scum-install-update] Missing plugin stop script: %SCUM_STOP_SCRIPT%
|
||||
exit /b 4
|
||||
)
|
||||
call "%SCUM_STOP_SCRIPT%"
|
||||
if errorlevel 1 (
|
||||
echo [scum-install-update] SCUM server did not shut down gracefully; refusing to update server files.
|
||||
exit /b 5
|
||||
)
|
||||
exit /b 0
|
||||
|
||||
:default_steamcmd_dir
|
||||
for %%I in ("%SERVER_ROOT_WINDOWS%") do set "SERVER_ROOT_DRIVE=%%~dI"
|
||||
|
||||
Reference in New Issue
Block a user