Initial check-in of Kudu 1.12 (#1)

Author: xqrzd

.gitignore

@@ -348,3 +348,6 @@ MigrationBackup/
 
 # Ionide (cross platform F# VS Code tools) working folder
 .ionide/
+
+# Include Kudu binaries
+!**/kudu/bin/

.nuget/icon.png

@@ -0,0 +1,30 @@
+
+Microsoft Visual Studio Solution File, Format Version 12.00
+# Visual Studio Version 16
+VisualStudioVersion = 16.0.30128.74
+MinimumVisualStudioVersion = 10.0.40219.1
+Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "Knet.Kudu.Binary", "src\Knet.Kudu.Binary\Knet.Kudu.Binary.csproj", "{E522DC5D-6DAA-4A97-A587-37F112670E18}"
+EndProject
+Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "src", "src", "{8BB323C7-55FF-40FA-B47E-3C29E8DB4114}"
+EndProject
+Global
+	GlobalSection(SolutionConfigurationPlatforms) = preSolution
+		Debug|Any CPU = Debug|Any CPU
+		Release|Any CPU = Release|Any CPU
+	EndGlobalSection
+	GlobalSection(ProjectConfigurationPlatforms) = postSolution
+		{E522DC5D-6DAA-4A97-A587-37F112670E18}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{E522DC5D-6DAA-4A97-A587-37F112670E18}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{E522DC5D-6DAA-4A97-A587-37F112670E18}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{E522DC5D-6DAA-4A97-A587-37F112670E18}.Release|Any CPU.Build.0 = Release|Any CPU
+	EndGlobalSection
+	GlobalSection(SolutionProperties) = preSolution
+		HideSolutionNode = FALSE
+	EndGlobalSection
+	GlobalSection(NestedProjects) = preSolution
+		{E522DC5D-6DAA-4A97-A587-37F112670E18} = {8BB323C7-55FF-40FA-B47E-3C29E8DB4114}
+	EndGlobalSection
+	GlobalSection(ExtensibilityGlobals) = postSolution
+		SolutionGuid = {BC6B5B1D-E3DC-4394-B2AB-CBF974E7E2D0}
+	EndGlobalSection
+EndGlobal

kudu-binary.sln

@@ -0,0 +1,23 @@
+using System.Collections.Generic;
+
+namespace Knet.Kudu.Binary
+{
+    public class ExecutableInfo
+    {
+        /// <summary>
+        /// Path to the executable.
+        /// </summary>
+        public string ExePath { get; }
+
+        /// <summary>
+        /// Any environment variables that should be set when running the executable.
+        /// </summary>
+        public IReadOnlyDictionary<string, string> EnvironmentVariables { get; }
+
+        public ExecutableInfo(string exePath, IReadOnlyDictionary<string, string> environmentVariables)
+        {
+            ExePath = exePath;
+            EnvironmentVariables = environmentVariables;
+        }
+    }
+}

src/Knet.Kudu.Binary/ExecutableInfo.cs

@@ -0,0 +1,22 @@
+<Project Sdk="Microsoft.NET.Sdk">
+
+  <PropertyGroup>
+    <TargetFrameworks>netstandard2.0</TargetFrameworks>
+    <NoWarn>CS1591</NoWarn>
+
+    <PackageId>$(AssemblyName)</PackageId>
+    <Version>0.1.0-preview.1</Version>
+    <Authors>xqrzd</Authors>
+    <GenerateDocumentationFile>true</GenerateDocumentationFile>
+    <Description>Native Apache Kudu binary for testing</Description>
+    <PackageIcon>icon.png</PackageIcon>
+    <PackageProjectUrl>https://github.com/xqrzd/kudu-binary-net</PackageProjectUrl>
+    <RepositoryUrl>https://github.com/xqrzd/kudu-binary-net</RepositoryUrl>
+  </PropertyGroup>
+
+  <ItemGroup>
+    <None Include="..\..\.nuget\icon.png" Pack="true" PackagePath="" Visible="false" />
+    <Content Include="runtimes\**" PackagePath="runtimes" Visible="false" />
+  </ItemGroup>
+
+</Project>

src/Knet.Kudu.Binary/Knet.Kudu.Binary.csproj

@@ -0,0 +1,30 @@
+namespace Knet.Kudu.Binary
+{
+    /// <summary>
+    /// Simple struct to provide various properties of a binary artifact to callers.
+    /// </summary>
+    public class KuduBinaryInfo
+    {
+        /// <summary>
+        /// Return the binary directory of an extracted artifact.
+        /// </summary>
+        public string BinDir { get; }
+
+        /// <summary>
+        /// Return the SASL module directory of an extracted artifact.
+        /// May be null if unknown.
+        /// </summary>
+        public string SaslDir { get; }
+
+        public KuduBinaryInfo(string binDir)
+            : this(binDir, null)
+        {
+        }
+
+        public KuduBinaryInfo(string binDir, string saslDir)
+        {
+            BinDir = binDir;
+            SaslDir = saslDir;
+        }
+    }
+}

src/Knet.Kudu.Binary/KuduBinaryInfo.cs

@@ -0,0 +1,73 @@
+using System;
+using System.Collections.Generic;
+using System.IO;
+using System.Runtime.InteropServices;
+
+namespace Knet.Kudu.Binary
+{
+    public static class KuduBinaryLocator
+    {
+        private const string SaslPathName = "SASL_PATH";
+
+        /// <summary>
+        /// Retrieve info needed to start Kudu.
+        /// </summary>
+        /// <param name="exeName">The binary to look for (eg 'kudu-tserver').</param>
+        public static ExecutableInfo FindBinary(string exeName)
+        {
+            var artifactInfo = FindBinaryLocation();
+
+            var executable = Path.Combine(artifactInfo.BinDir, exeName);
+            if (!File.Exists(executable))
+            {
+                throw new FileNotFoundException($"Cannot find executable {exeName} " +
+                    $"in binary directory {artifactInfo.BinDir}");
+            }
+
+            var env = new Dictionary<string, string>();
+            if (artifactInfo.SaslDir != null)
+            {
+                env.Add(SaslPathName, artifactInfo.SaslDir);
+            }
+
+            return new ExecutableInfo(executable, env);
+        }
+
+        private static KuduBinaryInfo FindBinaryLocation()
+        {
+            var appPath = AppContext.BaseDirectory;
+            var rid = GetRid();
+
+            var artifactRoot = Path.Combine(appPath, "runtimes", rid, "native", "kudu");
+            var binPath = Path.Combine(artifactRoot, "bin");
+            if (Directory.Exists(binPath))
+            {
+                // Only set the saslDir property if we find it in the artifact,
+                // since that affects whether the caller needs to set SASL_PATH
+                // when executing the binaries.
+                var saslDir = Path.Combine(artifactRoot, "lib", "sasl2");
+
+                if (!Directory.Exists(saslDir))
+                {
+                    saslDir = null;
+                }
+
+                return new KuduBinaryInfo(binPath, saslDir);
+            }
+
+            throw new Exception("Unable to find Kudu");
+        }
+
+        private static string GetRid()
+        {
+            if (RuntimeInformation.IsOSPlatform(OSPlatform.Linux) &&
+                RuntimeInformation.OSArchitecture == Architecture.X64)
+            {
+                return "linux-x64";
+            }
+
+            throw new NotSupportedException($"{RuntimeInformation.OSDescription} " +
+                $"{RuntimeInformation.OSArchitecture} is not supported");
+        }
+    }
+}