Implement buildserver shutdown command.

This commit implements the `buildserver shutdown` command that can be used to
shutdown MSBuild, VB/C# compiler, and Razor build servers.

By default, all three build servers are shut down.  Options can be passed to
shut down a subset of the build servers.

Fixes #8185.

Author: Peter Huene

src/Microsoft.DotNet.Cli.Utils/CommandResolution/MSBuildProject.cs

@@ -114,7 +114,7 @@ public MSBuildProject(
         {
             _projectRoot = msBuildExePath;
 
-            var globalProperties = new Dictionary<string, string>()
+            var globalProperties = new Dictionary<string, string>(StringComparer.OrdinalIgnoreCase)
             {
                { "MSBuildExtensionsPath", Path.GetDirectoryName(msBuildExePath) }
             };

src/Microsoft.DotNet.InternalAbstractions/DirectoryWrapper.cs

@@ -19,6 +19,11 @@ public ITemporaryDirectory CreateTemporaryDirectory()
             return new TemporaryDirectory();
         }
 
+        public IEnumerable<string> EnumerateFiles(string path, string searchPattern)
+        {
+            return Directory.EnumerateFiles(path, searchPattern);
+        }
+
         public IEnumerable<string> EnumerateFileSystemEntries(string path)
         {
             return Directory.EnumerateFileSystemEntries(path);

src/Microsoft.DotNet.InternalAbstractions/IDirectory.cs

@@ -11,6 +11,8 @@ internal interface IDirectory
 
         ITemporaryDirectory CreateTemporaryDirectory();
 
+        IEnumerable<string> EnumerateFiles(string path, string searchPattern);
+
         IEnumerable<string> EnumerateFileSystemEntries(string path);
 
         IEnumerable<string> EnumerateFileSystemEntries(string path, string searchPattern);

src/dotnet/BuildServer/IBuildServerManager.cs

@@ -0,0 +1,15 @@
+// Copyright (c) .NET Foundation and contributors. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+
+using System;
+using System.Threading.Tasks;
+
+namespace Microsoft.DotNet.BuildServer
+{
+    internal interface IBuildServerManager
+    {
+        string ServerName { get; }
+
+        Task<Result> ShutdownServerAsync();
+    }
+}

src/dotnet/BuildServer/IRazorAssemblyResolver.cs

@@ -0,0 +1,14 @@
+// Copyright (c) .NET Foundation and contributors. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+
+using System;
+using System.Collections.Generic;
+using Microsoft.Extensions.EnvironmentAbstractions;
+
+namespace Microsoft.DotNet.BuildServer
+{
+    internal interface IRazorAssemblyResolver
+    {
+        IEnumerable<FilePath> EnumerateRazorToolAssemblies();
+    }
+}

src/dotnet/BuildServer/LocalizableStrings.resx

@@ -0,0 +1,132 @@
+<?xml version="1.0" encoding="utf-8"?>
+<root>
+  <!-- 
+    Microsoft ResX Schema 
+    
+    Version 2.0
+    
+    The primary goals of this format is to allow a simple XML format 
+    that is mostly human readable. The generation and parsing of the 
+    various data types are done through the TypeConverter classes 
+    associated with the data types.
+    
+    Example:
+    
+    ... ado.net/XML headers & schema ...
+    <resheader name="resmimetype">text/microsoft-resx</resheader>
+    <resheader name="version">2.0</resheader>
+    <resheader name="reader">System.Resources.ResXResourceReader, System.Windows.Forms, ...</resheader>
+    <resheader name="writer">System.Resources.ResXResourceWriter, System.Windows.Forms, ...</resheader>
+    <data name="Name1"><value>this is my long string</value><comment>this is a comment</comment></data>
+    <data name="Color1" type="System.Drawing.Color, System.Drawing">Blue</data>
+    <data name="Bitmap1" mimetype="application/x-microsoft.net.object.binary.base64">
+        <value>[base64 mime encoded serialized .NET Framework object]</value>
+    </data>
+    <data name="Icon1" type="System.Drawing.Icon, System.Drawing" mimetype="application/x-microsoft.net.object.bytearray.base64">
+        <value>[base64 mime encoded string representing a byte array form of the .NET Framework object]</value>
+        <comment>This is a comment</comment>
+    </data>
+                
+    There are any number of "resheader" rows that contain simple 
+    name/value pairs.
+    
+    Each data row contains a name, and value. The row also contains a 
+    type or mimetype. Type corresponds to a .NET class that support 
+    text/value conversion through the TypeConverter architecture. 
+    Classes that don't support this are serialized and stored with the 
+    mimetype set.
+    
+    The mimetype is used for serialized objects, and tells the 
+    ResXResourceReader how to depersist the object. This is currently not 
+    extensible. For a given mimetype the value must be set accordingly:
+    
+    Note - application/x-microsoft.net.object.binary.base64 is the format 
+    that the ResXResourceWriter will generate, however the reader can 
+    read any of the formats listed below.
+    
+    mimetype: application/x-microsoft.net.object.binary.base64
+    value   : The object must be serialized with 
+            : System.Runtime.Serialization.Formatters.Binary.BinaryFormatter
+            : and then encoded with base64 encoding.
+    
+    mimetype: application/x-microsoft.net.object.soap.base64
+    value   : The object must be serialized with 
+            : System.Runtime.Serialization.Formatters.Soap.SoapFormatter
+            : and then encoded with base64 encoding.
+
+    mimetype: application/x-microsoft.net.object.bytearray.base64
+    value   : The object must be serialized into a byte array 
+            : using a System.ComponentModel.TypeConverter
+            : and then encoded with base64 encoding.
+    -->
+  <xsd:schema id="root" xmlns="" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:msdata="urn:schemas-microsoft-com:xml-msdata">
+    <xsd:import namespace="http://www.w3.org/XML/1998/namespace" />
+    <xsd:element name="root" msdata:IsDataSet="true">
+      <xsd:complexType>
+        <xsd:choice maxOccurs="unbounded">
+          <xsd:element name="metadata">
+            <xsd:complexType>
+              <xsd:sequence>
+                <xsd:element name="value" type="xsd:string" minOccurs="0" />
+              </xsd:sequence>
+              <xsd:attribute name="name" use="required" type="xsd:string" />
+              <xsd:attribute name="type" type="xsd:string" />
+              <xsd:attribute name="mimetype" type="xsd:string" />
+              <xsd:attribute ref="xml:space" />
+            </xsd:complexType>
+          </xsd:element>
+          <xsd:element name="assembly">
+            <xsd:complexType>
+              <xsd:attribute name="alias" type="xsd:string" />
+              <xsd:attribute name="name" type="xsd:string" />
+            </xsd:complexType>
+          </xsd:element>
+          <xsd:element name="data">
+            <xsd:complexType>
+              <xsd:sequence>
+                <xsd:element name="value" type="xsd:string" minOccurs="0" msdata:Ordinal="1" />
+                <xsd:element name="comment" type="xsd:string" minOccurs="0" msdata:Ordinal="2" />
+              </xsd:sequence>
+              <xsd:attribute name="name" type="xsd:string" use="required" msdata:Ordinal="1" />
+              <xsd:attribute name="type" type="xsd:string" msdata:Ordinal="3" />
+              <xsd:attribute name="mimetype" type="xsd:string" msdata:Ordinal="4" />
+              <xsd:attribute ref="xml:space" />
+            </xsd:complexType>
+          </xsd:element>
+          <xsd:element name="resheader">
+            <xsd:complexType>
+              <xsd:sequence>
+                <xsd:element name="value" type="xsd:string" minOccurs="0" msdata:Ordinal="1" />
+              </xsd:sequence>
+              <xsd:attribute name="name" type="xsd:string" use="required" />
+            </xsd:complexType>
+          </xsd:element>
+        </xsd:choice>
+      </xsd:complexType>
+    </xsd:element>
+  </xsd:schema>
+  <resheader name="resmimetype">
+    <value>text/microsoft-resx</value>
+  </resheader>
+  <resheader name="version">
+    <value>2.0</value>
+  </resheader>
+  <resheader name="reader">
+    <value>System.Resources.ResXResourceReader, System.Windows.Forms, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089</value>
+  </resheader>
+  <resheader name="writer">
+    <value>System.Resources.ResXResourceWriter, System.Windows.Forms, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089</value>
+  </resheader>
+  <data name="MSBuildServer" xml:space="preserve">
+    <value>MSBuild server</value>
+  </data>
+  <data name="VBCSCompilerServer" xml:space="preserve">
+    <value>VB/C# compiler server</value>
+  </data>
+  <data name="RazorServer" xml:space="preserve">
+    <value>Razor build server</value>
+  </data>
+  <data name="NoRazorProjectFound" xml:space="preserve">
+    <value>a Razor project was not found in the current directory.</value>
+  </data>
+</root>

src/dotnet/BuildServer/MSBuildServerManager.cs

@@ -0,0 +1,29 @@
+// Copyright (c) .NET Foundation and contributors. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+
+using System;
+using System.Threading.Tasks;
+using Microsoft.Build.Execution;
+
+namespace Microsoft.DotNet.BuildServer
+{
+    internal class MSBuildServerManager : IBuildServerManager
+    {
+        public string ServerName => LocalizableStrings.MSBuildServer;
+
+        public Task<Result> ShutdownServerAsync()
+        {
+            return Task.Run(() => {
+                try
+                {
+                    BuildManager.DefaultBuildManager.ShutdownAllNodes();
+                    return new Result(ResultKind.Success);
+                }
+                catch (Exception ex)
+                {
+                    return new Result(ex);
+                }
+            });
+        }
+    }
+}

src/dotnet/BuildServer/RazorAssemblyResolver.cs

@@ -0,0 +1,52 @@
+// Copyright (c) .NET Foundation and contributors. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+
+using System;
+using System.Collections.Generic;
+using System.IO;
+using System.Linq;
+using Microsoft.DotNet.Cli.Utils;
+using Microsoft.Build.Execution;
+using Microsoft.Extensions.EnvironmentAbstractions;
+
+namespace Microsoft.DotNet.BuildServer
+{
+    internal class RazorAssemblyResolver : IRazorAssemblyResolver
+    {
+        private readonly IDirectory _directory;
+
+        public RazorAssemblyResolver(IDirectory directory = null)
+        {
+            _directory = directory ?? FileSystemWrapper.Default.Directory;
+        }
+
+        public IEnumerable<FilePath> EnumerateRazorToolAssemblies()
+        {
+            HashSet<string> seen = new HashSet<string>();
+
+            var globalProperties = new Dictionary<string, string>(StringComparer.OrdinalIgnoreCase)
+            {
+                // This property disables default item globbing to improve performance
+                // This should be safe because we are not evaluating items, only properties
+                { Constants.EnableDefaultItems, "false" }
+            };
+
+            foreach (var projectFile in _directory.EnumerateFiles(Directory.GetCurrentDirectory(), "*.*proj"))
+            {
+                var project = new ProjectInstance(projectFile, globalProperties, null);
+                var path = project.GetPropertyValue("_RazorToolAssembly");
+                if (string.IsNullOrEmpty(path))
+                {
+                    continue;
+                }
+
+                if (!seen.Add(path))
+                {
+                    continue;
+                }
+
+                yield return new FilePath(path);
+            }
+        }
+    }
+}

src/dotnet/BuildServer/RazorServerManager.cs

@@ -0,0 +1,65 @@
+// Copyright (c) .NET Foundation and contributors. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+
+using System;
+using System.IO;
+using System.Threading.Tasks;
+using Microsoft.Build.Exceptions;
+using Microsoft.DotNet.Cli;
+using Microsoft.DotNet.Cli.Utils;
+using Microsoft.DotNet.Tools;
+using Microsoft.Extensions.EnvironmentAbstractions;
+
+namespace Microsoft.DotNet.BuildServer
+{
+    internal class RazorServerManager : IBuildServerManager
+    {
+        private readonly IRazorAssemblyResolver _resolver;
+        private readonly ICommandFactory _commandFactory;
+
+        public RazorServerManager(IRazorAssemblyResolver resolver = null, ICommandFactory commandFactory = null)
+        {
+            _resolver = resolver ?? new RazorAssemblyResolver();
+            _commandFactory = commandFactory ?? new DotNetCommandFactory(alwaysRunOutOfProc: true);
+        }
+
+        public string ServerName => LocalizableStrings.RazorServer;
+
+        public Task<Result> ShutdownServerAsync()
+        {
+            return Task.Run(() => {
+                try
+                {
+                    bool haveRazorAssembly = false;
+
+                    foreach (var toolAssembly in _resolver.EnumerateRazorToolAssemblies())
+                    {
+                        haveRazorAssembly = true;
+
+                        var command = _commandFactory
+                            .Create("exec", new string[] { toolAssembly.Value, "shutdown" })
+                            .CaptureStdOut()
+                            .CaptureStdErr();
+
+                        var result = command.Execute();
+                        if (result.ExitCode != 0)
+                        {
+                            return new Result(ResultKind.Failure, result.StdErr);
+                        }
+                    }
+
+                    if (!haveRazorAssembly)
+                    {
+                        return new Result(ResultKind.Skipped, LocalizableStrings.NoRazorProjectFound);
+                    }
+
+                    return new Result(ResultKind.Success);
+                }
+                catch (InvalidProjectFileException ex)
+                {
+                    return new Result(ex);
+                }
+            });
+        }
+    }
+}

src/dotnet/BuildServer/Result.cs

@@ -0,0 +1,37 @@
+// Copyright (c) .NET Foundation and contributors. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+
+using System;
+
+namespace Microsoft.DotNet.BuildServer
+{
+    internal enum ResultKind
+    {
+        Success,
+        Failure,
+        Skipped
+    }
+
+    internal struct Result
+    {
+        public Result(ResultKind kind, string message = null)
+        {
+            Kind = kind;
+            Message = message;
+            Exception = null;
+        }
+
+        public Result(Exception exception)
+        {
+            Kind = ResultKind.Failure;
+            Message = exception.Message;
+            Exception = exception;
+        }
+
+        public ResultKind Kind { get; private set; }
+
+        public string Message { get; private set; }
+
+        public Exception Exception { get; private set; }
+    }
+}