npc0-hue
05f5a97ba9
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 版本更新”面板；点“检查更新”查询公开分支版本，
只有检测到更新时“更新版本”按钮才会置为可用并高亮，点击后先确认再派发更新任务。
86 lines
3.8 KiB
Batchfile
Executable File
86 lines
3.8 KiB
Batchfile
Executable File
@echo off
|
|
setlocal EnableExtensions EnableDelayedExpansion
|
|
|
|
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 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:/=\%"
|
|
set "SERVER_INSTALL_DIR_STEAM=%SERVER_INSTALL_DIR_WINDOWS:\=/%"
|
|
if "%SERVER_STEAMCMD_DIR%"=="" call :default_steamcmd_dir
|
|
set "SERVER_STEAMCMD_DIR_WINDOWS=%SERVER_STEAMCMD_DIR:/=\%"
|
|
if "%SERVER_STEAMCMD_MAX_ATTEMPTS%"=="" set "SERVER_STEAMCMD_MAX_ATTEMPTS=3"
|
|
if "%SERVER_STEAMCMD_RETRY_SECONDS%"=="" set "SERVER_STEAMCMD_RETRY_SECONDS=30"
|
|
|
|
set "STEAMCMD_DIR=%SERVER_STEAMCMD_DIR_WINDOWS%"
|
|
set "STEAMCMD_EXE=%STEAMCMD_DIR%\steamcmd.exe"
|
|
set "SCUM_EXE_MARKER=%SERVER_ROOT_WINDOWS%\.scum-exe-path"
|
|
|
|
if not exist "%SERVER_ROOT_WINDOWS%" mkdir "%SERVER_ROOT_WINDOWS%"
|
|
if not exist "%STEAMCMD_DIR%" mkdir "%STEAMCMD_DIR%"
|
|
if not exist "%SERVER_INSTALL_DIR_WINDOWS%" mkdir "%SERVER_INSTALL_DIR_WINDOWS%"
|
|
if /I "%STEAMCMD_DIR%"=="%SERVER_INSTALL_DIR_WINDOWS%" exit /b 3
|
|
|
|
if not exist "%STEAMCMD_EXE%" (
|
|
powershell -NoProfile -ExecutionPolicy Bypass -Command "[Net.ServicePointManager]::SecurityProtocol=[Net.SecurityProtocolType]::Tls12; $zip=Join-Path $env:STEAMCMD_DIR 'steamcmd.zip'; Invoke-WebRequest -Uri 'https://steamcdn-a.akamaihd.net/client/installer/steamcmd.zip' -OutFile $zip; Expand-Archive -Path $zip -DestinationPath $env:STEAMCMD_DIR -Force; Remove-Item $zip -Force"
|
|
if errorlevel 1 exit /b 1
|
|
)
|
|
|
|
call :stop_running_scum
|
|
if errorlevel 1 exit /b 1
|
|
|
|
pushd "%STEAMCMD_DIR%"
|
|
set "SCUM_STEAMCMD_RESULT=1"
|
|
for /L %%A in (1,1,%SERVER_STEAMCMD_MAX_ATTEMPTS%) do (
|
|
"%STEAMCMD_EXE%" %SERVER_STEAMCMD_INSTALL_DIR_ARG% "%SERVER_INSTALL_DIR_STEAM%" %SERVER_STEAMCMD_UPDATE_ARGS%
|
|
set "SCUM_STEAMCMD_RESULT=!ERRORLEVEL!"
|
|
if "!SCUM_STEAMCMD_RESULT!"=="0" goto steamcmd_done
|
|
if not "%%A"=="%SERVER_STEAMCMD_MAX_ATTEMPTS%" timeout /T %SERVER_STEAMCMD_RETRY_SECONDS% /NOBREAK >nul
|
|
)
|
|
:steamcmd_done
|
|
popd
|
|
if not "%SCUM_STEAMCMD_RESULT%"=="0" exit /b %SCUM_STEAMCMD_RESULT%
|
|
|
|
call :resolve_scum_exe
|
|
if not exist "%SCUM_EXE%" exit /b 2
|
|
>"%SCUM_EXE_MARKER%" echo(%SCUM_EXE%
|
|
exit /b 0
|
|
|
|
:resolve_scum_exe
|
|
set "SCUM_EXE=%SERVER_ROOT_WINDOWS%\%SERVER_EXECUTABLE_REF:/=\%"
|
|
if exist "%SCUM_EXE%" exit /b 0
|
|
set "SCUM_EXE=%SERVER_INSTALL_DIR_WINDOWS%\%SERVER_EXECUTABLE_REF:/=\%"
|
|
if exist "%SCUM_EXE%" exit /b 0
|
|
set "SCUM_EXE=%SERVER_ROOT_WINDOWS%\steamcmd\steamapps\common\SCUM Server\%SERVER_EXECUTABLE_REF:/=\%"
|
|
if exist "%SCUM_EXE%" exit /b 0
|
|
set "SCUM_EXE=%SERVER_ROOT_WINDOWS%\SCUM Server\%SERVER_EXECUTABLE_REF:/=\%"
|
|
exit /b 0
|
|
|
|
: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"
|
|
if "%SERVER_ROOT_DRIVE%"=="" (
|
|
set "SERVER_STEAMCMD_DIR=%SERVER_ROOT_WINDOWS%-steamcmd"
|
|
) else (
|
|
set "SERVER_STEAMCMD_DIR=%SERVER_ROOT_DRIVE%\steamcmd"
|
|
)
|
|
exit /b 0
|