在 Docker Linux 容器中运行的后台服务类不会正常关闭

Question

我创建了一个继承自Microsoft.Extensions.Hosting.BackgroundService的worker服务，然后通过Visual Studio debugger将其部署到Windows机器上的docker linux容器中。我在取消令牌时发生的代码上放置了一个断点。IsCancelRequest是真的。 然后我向容器发出"docker stop --time=30"，永远不会命中断点，30 秒后调试器强制停止。

我还尝试重写 StopAsync 方法并在那里放置一个断点，但也不会调用它。 我正在运行.net core 3，最新版本的docker桌面。 我已经确认启动异步被调用。

这是我的程序文件。

public class Program
{
public static void Main(string[] args)
{
CreateHostBuilder(args).Build().Run();
}

public static IHostBuilder CreateHostBuilder(string[] args) =>
Host.CreateDefaultBuilder(args)
.ConfigureAppConfiguration((hostingContext, config) =>
{
var builder = new ConfigurationBuilder().SetBasePath(Directory.GetCurrentDirectory())
.AddEnvironmentVariables().Build();
})
.ConfigureServices((hostContext, services) => { services.AddHostedService<Worker>();    });
}

如果有人知道我错过了什么，或者有一个尊重停止的非网络服务器服务的工作示例，我将不胜感激。

添加我的工作人员的样子：

using System;
using System.Threading;
using System.Threading.Tasks;
using Microsoft.Extensions.Configuration;
using Microsoft.Extensions.Hosting;
using Microsoft.Extensions.Logging;
namespace MyWorker
{
public class Worker : BackgroundService
{    
public Worker(ILogger<Worker> logger, IConfiguration configs)
{
}
public override Task StopAsync(CancellationToken cancellationToken)
{
return base.StopAsync(cancellationToken);   
}
public override Task StartAsync(CancellationToken cancellationToken)
{ 
return base.StartAsync(cancellationToken);
}

protected override async Task ExecuteAsync(CancellationToken cancellationToken)
{
try
{
await DoWork(cancellationToken); //While loop that checks token in here
}
catch (Exception ex)
{
throw;
}
}
}
}

Answer 1

要收听 Ctrl+C、SIGINT 和 SIGTERM，您需要通过 UseConsoleLifetime(( 或 RunConsoleAsync 添加控制台生命周期支持，例如

：

public static async Task Main(string[] args)
{
CreateHostBuilder(args).Build().RunConsoleAsync();
}

或

public static void Main(string[] args)
{
CreateHostBuilder(args).UseConsoleLifetime().Build().Run();
}

如果关机时间超过"关机超时"中设置的超时时间，则会记录警告。

工作原理

了解主机生存期的工作原理有助于排查延迟问题。

如果你检查源代码，RunConsoleAsync 只不过是对UseConsoleLifetime().Build().RunAsync();的调用

内部 ConsoleLifetime 类为Cancel和ProcessExit事件添加事件侦听器：

AppDomain.CurrentDomain.ProcessExit += OnProcessExit;
Console.CancelKeyPress += OnCancelKeyPress;

Ctrl+C 只会阻止对主机的停止请求：

private void OnCancelKeyPress(object sender, ConsoleCancelEventArgs e)
{
e.Cancel = true;
ApplicationLifetime.StopApplication();
}

另一方面，如果关闭时间超过HostOptions中指定的超时时间，则ProcessExit处理程序将发出警告。ShutdownTimeout ：

private void OnProcessExit(object sender, EventArgs e)
{
ApplicationLifetime.StopApplication();
if(!_shutdownBlock.WaitOne(HostOptions.ShutdownTimeout))
{
Logger.LogInformation("Waiting for the host to be disposed. Ensure all 'IHost' instances are wrapped in 'using' blocks.");
}
_shutdownBlock.WaitOne();
// On Linux if the shutdown is triggered by SIGTERM then that's signaled with the 143 exit code.
// Suppress that since we shut down gracefully. https://github.com/aspnet/AspNetCore/issues/6526
System.Environment.ExitCode = 0;
}

Answer 2

4天后，我终于想通了，问题不在于代码或码头工人，问题在于Visual Studio调试器。如果您在VS2019中按播放来运行代码，它将不尊重SIGTERM。如果您通过手动 docker run 命令运行，您将看到您的代码响应 DOCKER STOP 命令。

可能有一种方法可以让它最终工作，但我还没有找到它。

Answer 3

为我增加关机超时工作。谢谢Panagiotis分享MS Docs。

Host.CreateDefaultBuilder(args)
.ConfigureServices((hostContext, services) =>
{
services.Configure<HostOptions>(option =>
{
option.ShutdownTimeout = System.TimeSpan.FromSeconds(20);
});
});