如何通过GitLab CI Runner在Windows远程服务器执行iisreset命令？

我懂你现在的头疼点——GitLab Runner直接在自己的机器上跑了iisreset，完全没碰着目标远程Windows服务器是吧？这很正常，因为Runner默认就是在自身所在环境执行命令的。要让命令真正跑到远程机器上，咱们得用Windows的远程管理工具来搭桥，下面给你两种实用的方案：

方案一：用PowerShell WinRM原生远程执行 #

WinRM是Windows自带的远程管理协议，稳定性和安全性都不错，推荐优先用这个：

1. 先配置目标服务器的WinRM（仅需一次）
   登录到目标Windows服务器，打开管理员权限的PowerShell，执行以下命令开启并配置WinRM：

   # 开启PowerShell远程功能
   Enable-PSRemoting -Force
   # 允许外部机器通过HTTP连接WinRM（内网环境可用，生产建议配HTTPS）
   Set-NetFirewallRule -Name "WINRM-HTTP-In-TCP" -RemoteAddress Any
   

2. 在.gitlab-ci.yml里编写远程执行脚本
   假设你的Runner是Windows环境（或者支持PowerShell的环境），可以这么写：

   stages:
     - deploy
   
   reset-remote-iis:
     stage: deploy
     tags:
       - windows-runner # 务必指定Windows类型的Runner标签
     script:
       - |
         # 定义远程服务器信息
         $remoteServer = "你的目标服务器IP/主机名"
         # 从GitLab CI变量获取账号密码（别硬写密码！）
         $securePwd = ConvertTo-SecureString "$env:REMOTE_SERVER_PWD" -AsPlainText -Force
         $cred = New-Object System.Management.Automation.PSCredential("$env:REMOTE_SERVER_USER", $securePwd)
         # 远程执行iisreset
         Invoke-Command -ComputerName $remoteServer -Credential $cred -ScriptBlock { iisreset }
   

   记得在GitLab项目的Settings > CI/CD > Variables里添加REMOTE_SERVER_USER（远程服务器管理员账号）和REMOTE_SERVER_PWD（对应密码）两个变量，勾选"Mask variable"防止密码泄露。

方案二：用PsExec轻量远程执行 #

如果你觉得WinRM配置麻烦，PsExec是Sysinternals工具集里的轻量工具，专门用来远程执行命令：

1. 准备PsExec工具
   下载PsExec到GitLab Runner所在的Windows机器上，比如放在C:\tools\PsExec.exe（可从微软官方工具集解压得到）。

2. 配置.gitlab-ci.yml

   stages:
     - deploy
   
   reset-remote-iis:
     stage: deploy
     tags:
       - windows-runner
     script:
       - |
         # 用PsExec远程执行iisreset，账号密码从CI变量取
         C:\tools\PsExec.exe \\你的目标服务器IP -u "$env:REMOTE_SERVER_USER" -p "$env:REMOTE_SERVER_PWD" iisreset
   

   同样，账号密码要存在GitLab CI变量里，别硬编码。

关键注意事项 #

• 确保GitLab Runner所在机器能ping通目标服务器，并且相关端口开放：WinRM默认用5985（HTTP）/5986（HTTPS），PsExec依赖SMB端口445，得在目标服务器防火墙里放行这些端口。
• 远程执行的账号必须拥有管理员权限，不然iisreset会因为权限不足执行失败。
• 如果你的Runner是Linux环境，也可以用winexe工具来实现类似的远程Windows命令执行，原理和PsExec差不多。

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