一、概述
一直以来,我都在追求以最简单的方式写程序。这里的最简单是指利用强大的工具。
这种想法主要来源于三年前我服务过的一个客户。他们的IT经理就一直在部门内部强调“你所想到的,别人都想已经想到而且做到了,学会寻找比学会创造更加重要。”这种话虽略显极端,但在程序这个领域里却有着重要意义。像很多知名的开源软件,都是无数人智慧的结晶。扯远了~
本文写作的目的是,记录一种最简单开发 Windows 服务的方式– Topshelf 。使用前先下载依赖文件: Topshelf.dll Topshelf.4.2.0.zip 或者直接通过 Nuget 安装:Install-Package Topshelf
Topshelf 官方网站:http://topshelf-project.com/
Topshelf 文档地址:https://topshelf.readthedocs.io/en/latest/index.html
二、程序实例
C# 直接创建控制台项目,覆盖 Program.cs 文件为如下代码:
using System;
using System.Timers;
using Topshelf;
namespace TopshelfDemo
{
public class TownCrier
{
readonly Timer _timer;
public TownCrier()
{
_timer = new Timer(1000) { AutoReset = true };//1秒执行一次
_timer.Elapsed += (sender, eventArgs) => Console.WriteLine("It is {0} and all is well", DateTime.Now);
}
public void Start() { _timer.Start(); }
public void Stop() { _timer.Stop(); }
}
public class Program
{
public static void Main()
{
var rc = HostFactory.Run(x =>
{
x.Service<TownCrier>(s =>
{
s.ConstructUsing(name => new TownCrier());
s.WhenStarted(tc => tc.Start());
s.WhenStopped(tc => tc.Stop());
});
x.RunAsLocalSystem(); //服务器使用内置账户运行
x.SetDescription("Sample Topshelf Host");//服务的描述信息
x.SetDisplayName("Stuff");//服务的显示名称
x.SetServiceName("Stuff");//服务的名称(最好不要包含空格或者有空格属性的字符)。Windows 服务名称不能重复。
//x.SetInstanceName("MyService");//实例名称:主要用于命令行部署多实例时进行区分。效果是:Stuff$MyService
});
var exitCode = (int)Convert.ChangeType(rc, rc.GetTypeCode());
Environment.ExitCode = exitCode;
}
}
}
这段代码就是 Topshelf 官网文档中的实例代码。
直接启用运行,效果如下。每秒输出一条语句。到这里实现输出的字符串的 Windows 服务程序就开发完成了。
下面看如何安装、运行、停止和卸载服务。
1. 程序安装:
假设运行程序存放到以下路径:
用管理员方式打开命令行窗口,在 exe 所在路径下执行:TopshelfDemo.exe install 安装服务。
在服务窗口中可以查看到安装完成的服务。
命令行窗口中会涉及到的命令(以程序 server.exe 举例,自行替换):
- 安装服务 server.exe install
- 启动服务 server.exe start
- 停止服务 server.exe stop
- 卸载服务 server.exe uninstall
2. 注意事项
这里要注意:必须使用管理员方式运行命令行窗口!!否则会提示错误信息:The Stuff service can only be installed as an administrator
到这里为止,开发及安装 Windows 服务已经完成了!下面介绍写自定义设置,可看可不看。
三、Topshelf 自定义项说明
1. 服务的启动模式
可以指定多种服务的启动模式,这些选项只在服务安装后有效。
HostFactory.New(x =>
{
x.StartAutomatically(); // 服务自动启动
x.StartAutomaticallyDelayed(); // 服务自动启动(延时启动) -- 需要 .NET 4.0 或以上版本
x.StartManually(); // 手动启动服务
x.Disabled(); // 服务禁用状态
});
2. 指定服务运行的身份
HostFactory.New(x =>
{
x.RunAs("username", "password");//使用指定用户名和密码运行服务,用户名中包含域:domain\username 或者 username@suffix.com
//x.RunAsPrompt();//安装服务时,提示输入用户名和密码用于启动服务
//x.RunAsNetworkService();//使用内置的 NETWORK_SERVICE 账户运行服务
//x.RunAsLocalSystem();//使用本地系统账户运行
//x.RunAsLocalService();//使用本地服务账户运行
});
3. 自定义安装或卸载时执行的动作
这些操作允许在服务安装或卸载的过程中执行用户指定的方法。这里需要特别注意,一定是服务安装或卸载时有效!方法中可以使用服务的实例名称、服务名称等。
HostFactory.New(x =>
{
x.BeforeInstall(settings => { ... });//安装服务前执行
x.AfterInstall(settings => { ... });//安装服务后执行
x.BeforeUninstall(() => { ... });//卸载服务前执行
x.AfterUninstall(() => { ... });//卸载服务后执行
});
4. 指定依赖的服务
可以指定服务依赖项,以便在依赖服务启动之前不会启动服务。这是由 windows 服务控制管理器管理的,而不是由 Topshelf 本身管理的。
HostFactory.New(x =>
{
x.DependsOn("SomeOtherService");
});
//对于知名的服务,有很多内置的扩展方法,包括:
HostFactory.New(x =>
{
x.DependsOnMsmq(); // Microsoft Message Queueing
x.DependsOnMsSql(); // Microsoft SQL Server
x.DependsOnEventLog(); // Windows Event Log
x.DependsOnIis(); // Internet Information Server
});
5. 支持服务管理器暂停、继续、关闭等
HostFactory.New(x =>
{
x.EnablePauseAndContinue();//允许服务控制管理器向服务传递暂停和继续命令
x.EnableShutdown();//允许服务控制管理器快速关闭服务
x.OnException(ex =>
{
//此功能为服务运行时引发的异常提供回调。此回调不是处理程序,也不会影响 Topshelf 已经提供的默认异常处理程序
//它旨在为触发外部操作如异常记录等
});
});
6. 服务恢复选项
HostFactory.New(x =>
{
x.EnableServiceRecovery(r =>
{
//恢复操作按指定的顺序执行,上一个操作运行后执行下一个操作
//可以执行多少个操作是有限制的 (基于操作系统),通常是 2-3 个操作。
r.RestartComputer(5, "message");
r.RestartService(1); // 1分钟后重启服务
//因为最多执行3个操作,最后一个将会执行后续所有的失败
r.RunProgram(7, "ping google.com");// 运行程序,例如 notepad.exe
r.SetResetPeriod(1); // 将重置间隔设置为一天
});
});