为什么我的 Azure WebJobs "settings.job" 文件被忽略了?

Why is my Azure WebJobs "settings.job" file being ignored?

无论出于何种原因停止或重新启动 Azure WebJobs 时,在终止主机控制台进程之前都有 5 秒的默认宽限期。显然,可以通过在 WebJob 发布到 Azure 时包含一个 "settings.job" 文件来增加此时间段,如 explained here。不幸的是,我无法让它在我的网站上运行,并且关闭时间是 总是 5 秒,尽管这是一个连续的 WebJob,发布到设置为 "Always On".

根据 link 中的示例代码,我的 Program.cs 如下所示:

class Program
{
    static void Main()
    {
        var host = new JobHost();
        host.RunAndBlock();
    }
}

我的Functions.cs看起来像这样:

public class Functions
{
    public static async Task ProcessQueueMessageAsync(
        [QueueTrigger("testq")] string message, TextWriter log,
        CancellationToken cancellationToken)
    {
        Console.WriteLine("Function started.");
        try
        {
            await Task.Delay(TimeSpan.FromMinutes(10), cancellationToken);
        }
        catch (TaskCanceledException)
        {
            Shutdown().Wait();
        }
        Console.WriteLine("Function completed succesfully.");
    }

    private static async Task Shutdown()
    {
        Console.WriteLine("Function has been cancelled. Performing cleanup ...");
        await Task.Delay(TimeSpan.FromSeconds(30));
        Console.WriteLine("Function was cancelled and has terminated gracefully.");
    }
}

我已将 settings.job 文件添加到项目中,并在 Visual Studio 的属性中将其设置为 "Copy always"。文件内容如下:

{ "stopping_wait_time": 60 }

WebJob 随网站发布。通过使用 Kudu 工具并转到调试控制台,我可以验证 "settings.job" 文件是否被复制到与 WebJob 主机可执行文件相同的位置:

但是,如果我查看 link https://xxx.scm.azurewebsites.net/api/continuouswebjobs,返回的 JSON 根本不包含任何设置:

{
    "status":"Stopped",
    "detailed_status":"f9e13c - Stopped\r\n",
    "log_url":"https://...",
    "name":"WebJobTest",
    "run_command":"WebJobTest.exe",
    "url":"https://...",
    "extra_info_url":"https://...",
    "type":"continuous",
    "error":null,
    "using_sdk":true,
    "settings":{
    }
}

因此,当我从 Azure 门户停止 WebJob 时,我最终会在日志中看到类似这样的内容:

[04/18/2016 12:53:12 > f9e13c: SYS INFO] Run script 'WebJobTest.exe' with script host - 'WindowsScriptHost'
[04/18/2016 12:53:12 > f9e13c: SYS INFO] Status changed to Running
[04/18/2016 12:53:13 > f9e13c: INFO] Found the following functions:
[04/18/2016 12:53:13 > f9e13c: INFO] WebJobTest.Functions.ProcessQueueMessageAsync
[04/18/2016 12:53:13 > f9e13c: INFO] Job host started
[04/18/2016 13:01:58 > f9e13c: INFO] Executing: 'Functions.ProcessQueueMessageAsync' - Reason: 'New queue message detected on 'testq'.'
[04/18/2016 13:01:58 > f9e13c: INFO] Function started.
[04/18/2016 13:02:47 > f9e13c: SYS INFO] Status changed to Disabling
[04/18/2016 13:02:53 > f9e13c: SYS INFO] Detected WebJob file/s were updated, refreshing WebJob
[04/18/2016 13:02:53 > f9e13c: SYS INFO] Status changed to Stopping
[04/18/2016 13:02:53 > f9e13c: INFO] Function has been cancelled. Performing cleanup ...
[04/18/2016 13:02:58 > f9e13c: ERR ] Thread was being aborted.
[04/18/2016 13:02:58 > f9e13c: SYS INFO] WebJob process was aborted
[04/18/2016 13:02:58 > f9e13c: SYS INFO] Status changed to Stopped

注意 "Status changed to Stopping" 和 "Thread was being aborted" 之间的标准 5 秒间隔。

为什么 "settings.job" 文件被忽略了?

问题是您的 settings.job 文件有 组 UTF-8 BOM,这是非常不寻常的,会导致解析器失效。

具体的开头顺序如下(使用十六进制编辑器查看):EF BB BF EF BB BF。通常,UTF-8 BOM 只是 EF BB BF.

您使用的是什么编辑器造成的?

无论如何,一旦你修复了它,它应该可以正常工作。