如何在Jenkins流水线中启动进程且不阻塞后续步骤？

核心问题 #

当前Jenkins流水线会等待MyBot.exe进程结束才执行下一步，原因是PowerShell默认同步等待启动的进程完成。要让进程在整个构建期间后台运行，需修改进程启动方式，让PowerShell脚本启动进程后立即返回，不等待其终止。

解决方案：修改PowerShell脚本启动逻辑 #

将直接调用exe的方式改为用Start-Process异步启动，同时可选重定向输出日志以便排查问题：

修改后的PS1脚本 #

param (
    [Parameter(Mandatory)] [string] $BuildId,
    [Parameter()]  [string] $BuildNumber,
    [Parameter()]  [string] $BuildVCSBranch
)

# 拼接exe路径和启动参数
$exePath = Join-Path -Path $PSScriptRoot -ChildPath "MyBot.exe"
$processArgs = @(
    "-MyBot",
    "-BuildID", $BuildID,
    "-BuildNumber", $BuildNumber,
    "-BuildVCSBranch", $BuildVCSBranch
)

# 异步启动进程，不等待结束，重定向输出到临时目录日志文件
Start-Process -FilePath $exePath `
    -ArgumentList $processArgs `
    -NoNewWindow `
    -RedirectStandardOutput "$env:TEMP\MyBot_$BuildId.log" `
    -RedirectStandardError "$env:TEMP\MyBot_$BuildId.err.log" `
    -PassThru

# 验证进程是否成功启动（可选，确保启动失败时抛出错误）
$runningProcess = Get-Process -Name "MyBot" -ErrorAction SilentlyContinue | Where-Object { $_.CommandLine -match $BuildId }
if (-not $runningProcess) {
    throw "Failed to start MyBot.exe with BuildID $BuildId"
}

改动说明 #

• Start-Process会异步启动目标进程，PowerShell脚本执行后立即返回，不会阻塞Jenkins流水线
• -NoNewWindow避免弹出新命令行窗口，适配Jenkins无头运行环境
• 重定向输出到日志文件，方便后续排查进程运行中的问题
• 增加进程启动验证，确保exe启动失败时Jenkins能捕获错误并终止构建

可选：直接在Jenkins Pipeline中调整启动命令 #

如果不想修改PS1脚本，也可以直接在Jenkins的PowerShell步骤中实现异步启动：

stage ('Start process') {
    steps {
        script {
            powershell """
                try {
                    \$exePath = Join-Path -Path ${WORKSPACE}\\Scripts -ChildPath "MyBot.exe"
                    \$args = @(
                        "-MyBot",
                        "-BuildID", ${env.BUILD_NUMBER},
                        "-BuildNumber", ${env.BUILD_NUMBER},
                        "-BuildVCSBranch", "${GIT_BRANCH}"
                    )
                    Start-Process -FilePath \$exePath -ArgumentList \$args -NoNewWindow -RedirectStandardOutput "\$env:TEMP\\MyBot_${env.BUILD_NUMBER}.log" -RedirectStandardError "\$env:TEMP\\MyBot_${env.BUILD_NUMBER}.err.log"
                    # 验证启动状态
                    if (-not (Get-Process -Name "MyBot" -ErrorAction SilentlyContinue | Where-Object { \$_.CommandLine -match ${env.BUILD_NUMBER} })) {
                        throw "MyBot.exe failed to start"
                    }
                } catch {
                    Write-Error \$_ 
                    exit 1
                }
            """
        }
    }
}

注意事项 #

• Jenkins构建结束后，后台启动的MyBot.exe会被自动终止（属于Jenkins子进程），符合"整个构建期间保持运行"的需求
• 确保Jenkins代理有足够权限启动目标exe，且exe路径配置正确

内容的提问来源于stack exchange，提问作者lukemols