更新接口

.vscode/launch.json

@@ -0,0 +1,35 @@
+{
+    "version": "0.2.0",
+    "configurations": [
+        {
+            // Use IntelliSense to find out which attributes exist for C# debugging
+            // Use hover for the description of the existing attributes
+            // For further information visit https://github.com/OmniSharp/omnisharp-vscode/blob/master/debugger-launchjson.md
+            "name": ".NET Core Launch (web)",
+            "type": "coreclr",
+            "request": "launch",
+            "preLaunchTask": "build",
+            // If you have changed target frameworks, make sure to update the program path.
+            "program": "${workspaceFolder}/DockerStudyApi/bin/Debug/net5.0/DockerStudyApi.dll",
+            "args": [],
+            "cwd": "${workspaceFolder}/DockerStudyApi",
+            "stopAtEntry": false,
+            // Enable launching a web browser when ASP.NET Core starts. For more information: https://aka.ms/VSCode-CS-LaunchJson-WebBrowser
+            "serverReadyAction": {
+                "action": "openExternally",
+                "pattern": "\\bNow listening on:\\s+(https?://\\S+)"
+            },
+            "env": {
+                "ASPNETCORE_ENVIRONMENT": "Development"
+            },
+            "sourceFileMap": {
+                "/Views": "${workspaceFolder}/Views"
+            }
+        },
+        {
+            "name": ".NET Core Attach",
+            "type": "coreclr",
+            "request": "attach"
+        }
+    ]
+}

.vscode/tasks.json

@@ -0,0 +1,42 @@
+{
+    "version": "2.0.0",
+    "tasks": [
+        {
+            "label": "build",
+            "command": "dotnet",
+            "type": "process",
+            "args": [
+                "build",
+                "${workspaceFolder}/DockerStudyApi/DockerStudyApi.csproj",
+                "/property:GenerateFullPaths=true",
+                "/consoleloggerparameters:NoSummary"
+            ],
+            "problemMatcher": "$msCompile"
+        },
+        {
+            "label": "publish",
+            "command": "dotnet",
+            "type": "process",
+            "args": [
+                "publish",
+                "${workspaceFolder}/DockerStudyApi/DockerStudyApi.csproj",
+                "/property:GenerateFullPaths=true",
+                "/consoleloggerparameters:NoSummary"
+            ],
+            "problemMatcher": "$msCompile"
+        },
+        {
+            "label": "watch",
+            "command": "dotnet",
+            "type": "process",
+            "args": [
+                "watch",
+                "run",
+                "${workspaceFolder}/DockerStudyApi/DockerStudyApi.csproj",
+                "/property:GenerateFullPaths=true",
+                "/consoleloggerparameters:NoSummary"
+            ],
+            "problemMatcher": "$msCompile"
+        }
+    ]
+}

Build/Dockerfile.ENV

@@ -1,4 +1,6 @@
-# 注释: Dockerfile学习镜像
-FROM busybox
-ENV file=app
-ADD ./project/ /usr/local/$file/
+# Deckerfile 环境变量测试
+FROM mcr.microsoft.com/dotnet/aspnet:5.0 AS EnvStudy
+ENV DockerfileEvn_A=InDockerfile
+WORKDIR /app
+COPY WebApiPublish/ /app/
+ENTRYPOINT ["dotnet", "DockerStudyApi.dll"]

Build/WebApiPublish/DockerStudyApi.xml

@@ -14,6 +14,11 @@
             服务测试
             </summary>
         </member>
+        <member name="M:DockerStudyApi.Controllers.DemoController.RunTime">
+            <summary>
+            获取运行时信息
+            </summary>
+        </member>
         <member name="M:DockerStudyApi.Controllers.DemoController.TestOption">
             <summary>
             说明：泛型左右尖括号，不能写在注释里，会生成无效的xml
@@ -42,20 +47,41 @@
             (仅支持字符串或Key=value两种形式)
             </summary>
         </member>
+        <member name="M:DockerStudyApi.Controllers.DemoController.AllCmdPara">
+            <summary>
+            获取所有命令参数
+            </summary>
+        </member>
         <member name="M:DockerStudyApi.Controllers.DemoController.Evn(System.String)">
             <summary>
             获取环境变量
             </summary>
         </member>
+        <member name="M:DockerStudyApi.Controllers.DemoController.AspNetCoeEvn">
+            <summary>
+            获取AspNetCore环境变量
+            (以ASPNETCORE_开头)
+            </summary>
+        </member>
+        <member name="M:DockerStudyApi.Controllers.DemoController.AllEvn">
+            <summary>
+            获取所有环境变量
+            </summary>
+        </member>
         <member name="M:DockerStudyApi.Controllers.DemoController.ConfigItem(System.String)">
             <summary>
             获取配置项
             </summary>
         </member>
-        <member name="M:DockerStudyApi.Controllers.DemoController.Info">
+        <member name="M:DockerStudyApi.Controllers.DemoController.AllConfigItes">
             <summary>
             获取所有配置项
             </summary>
         </member>
+        <member name="M:DockerStudyApi.Controllers.DemoController.ConfigProviders">
+            <summary>
+            获取配置源
+            </summary>
+        </member>
     </members>
 </doc>

Build/WebApiPublish/Script/InstallWindowServer.ANSI.bat

@@ -0,0 +1,31 @@
+::使用SC命令，安装成Windows服务
+::===================================
+::请求管理员省份运行，可以删除
+@echo off
+>nul 2>&1 "%SYSTEMROOT%\system32\cacls.exe" "%SYSTEMROOT%\system32\config\system"
+if '%errorlevel%' NEQ '0' (
+    :: 请求管理员权限...
+    echo "Request to run with administrator privileges......"
+    goto UACPrompt
+) else ( goto gotAdmin )
+:UACPrompt
+    echo Set UAC = CreateObject^("Shell.Application"^) > "%temp%\getadmin.vbs"
+    echo UAC.ShellExecute "%~s0", "", "", "runas", 1 >> "%temp%\getadmin.vbs"
+    "%temp%\getadmin.vbs"
+    exit /B
+:gotAdmin
+    if exist "%temp%\getadmin.vbs" ( del "%temp%\getadmin.vbs" )
+    pushd "%CD%"
+    CD /D "%~dp0"
+::===================================           
+echo %cd% 
+:: 创建Windows服务
+sc create DockerStudy.WebApi.Service binpath= "%cd%\..\DockerStudyApi.exe" start= auto
+
+:: 设置服务的描述字符串       
+sc description DockerStudy.WebApi.Service "DockerStudy.WebApi 服务."
+
+:: 启动服务
+sc start "DockerStudy.WebApi.Service"
+
+pause

Build/WebApiPublish/Script/InstallWindowServer.UTF8.bat

@@ -0,0 +1,31 @@
+::使用SC命令，安装成Windows服务
+::===================================
+::请求管理员省份运行，可以删除
+@echo off
+>nul 2>&1 "%SYSTEMROOT%\system32\cacls.exe" "%SYSTEMROOT%\system32\config\system"
+if '%errorlevel%' NEQ '0' (
+    :: 请求管理员权限...
+    echo "Request to run with administrator privileges......"
+    goto UACPrompt
+) else ( goto gotAdmin )
+:UACPrompt
+    echo Set UAC = CreateObject^("Shell.Application"^) > "%temp%\getadmin.vbs"
+    echo UAC.ShellExecute "%~s0", "", "", "runas", 1 >> "%temp%\getadmin.vbs"
+    "%temp%\getadmin.vbs"
+    exit /B
+:gotAdmin
+    if exist "%temp%\getadmin.vbs" ( del "%temp%\getadmin.vbs" )
+    pushd "%CD%"
+    CD /D "%~dp0"
+::===================================           
+echo %cd% 
+:: 创建Windows服务
+sc create DockerStudy.WebApi.Service binpath= "%cd%\..\DockerStudyApi.exe" start= auto
+
+:: 设置服务的描述字符串       
+sc description DockerStudy.WebApi.Service "DockerStudy.WebApi 服务."
+
+:: 启动服务
+sc start "DockerStudy.WebApi.Service"
+
+pause

Build/WebApiPublish/Script/UnInstallWindowServer.bat

@@ -0,0 +1,24 @@
+::卸载Windows服务
+::===================================
+::请求管理员省份运行，可以删除
+@echo off
+>nul 2>&1 "%SYSTEMROOT%\system32\cacls.exe" "%SYSTEMROOT%\system32\config\system"
+if '%errorlevel%' NEQ '0' (
+	:: 请求管理员权限...
+    echo "Request to run with administrator privileges......"
+    goto UACPrompt
+) else ( goto gotAdmin )
+:UACPrompt
+    echo Set UAC = CreateObject^("Shell.Application"^) > "%temp%\getadmin.vbs"
+    echo UAC.ShellExecute "%~s0", "", "", "runas", 1 >> "%temp%\getadmin.vbs"
+    "%temp%\getadmin.vbs"
+    exit /B
+:gotAdmin
+    if exist "%temp%\getadmin.vbs" ( del "%temp%\getadmin.vbs" )
+    pushd "%CD%"
+    CD /D "%~dp0"
+::===================================
+echo %cd%
+sc stop DockerStudy.WebApi.Service  
+sc delete DockerStudy.WebApi.Service           
+pause

DockerStudyApi/Controllers/DemoController.cs

@@ -6,7 +6,9 @@ using Microsoft.Extensions.Options;
 
 using System;
 using System.Collections.Generic;
+using System.ComponentModel.DataAnnotations;
 using System.Linq;
+using System.Runtime.InteropServices;
 using System.Threading.Tasks;
 
 namespace DockerStudyApi.Controllers
@@ -54,6 +56,24 @@ namespace DockerStudyApi.Controllers
             return Ok();
         }
 
+        /// <summary>
+        /// 获取运行时信息
+        /// </summary>
+        [HttpGet]
+        public IActionResult RunTime()
+        {
+            var runInfo = new Dictionary<string, string>()
+            {
+                {"操作系统",RuntimeInformation.OSDescription },
+                {".Net版本",RuntimeInformation.FrameworkDescription },
+                {"运行平台",RuntimeInformation.RuntimeIdentifier },
+                {"平台架构",RuntimeInformation.OSArchitecture.ToString() },
+                {"进程架构",RuntimeInformation.ProcessArchitecture.ToString() },
+            };
+
+            return Ok(runInfo);
+        }
+
         /// <summary>
         /// 说明：泛型左右尖括号，不能写在注释里，会生成无效的xml
         /// 解决：用[]或{}或中文符号＜＞ 代替，或者使用xml转义字符 &lt;&gt;
@@ -99,7 +119,7 @@ namespace DockerStudyApi.Controllers
         /// (仅支持字符串或Key=value两种形式)
         /// </summary>
         [HttpGet]
-        public IActionResult CmdPara(string cmdName)
+        public IActionResult CmdPara([Required(ErrorMessage = "命令行参数名必填")]string cmdName)
         {
             var cmdArgs = System.Environment.GetCommandLineArgs();
             if (cmdArgs == null)
@@ -141,21 +161,74 @@ namespace DockerStudyApi.Controllers
            
         }
 
+        /// <summary>
+        /// 获取所有命令参数
+        /// </summary>
+        [HttpGet]
+        public IActionResult AllCmdPara()
+        {
+            var cmdArgs = System.Environment.GetCommandLineArgs();
+            if (cmdArgs == null)
+            {
+                return Ok("启动时没有设置：命令行参数");
+            }
+            return Ok(cmdArgs);
+
+        }
+
         /// <summary>
         /// 获取环境变量
         /// </summary>
         [HttpGet]
-        public IActionResult Evn(string envName)
+        public IActionResult Evn([Required(ErrorMessage = "环境变量名必填")]string envName)
         {
             var envValue = System.Environment.GetEnvironmentVariable(envName);
             return Ok(envValue??"无此环境变量");
         }
 
+        /// <summary>
+        /// 获取AspNetCore环境变量
+        /// (以ASPNETCORE_开头)
+        /// </summary>
+        [HttpGet]
+        public IActionResult AspNetCoeEvn()
+        {
+            var envValues = System.Environment.GetEnvironmentVariables();
+            if (envValues == null)
+            { 
+                return Ok("无环境变量！");
+            }
+
+            var keys = envValues.Keys.Cast<string>().ToList();
+            foreach (var key in keys)
+            {
+                if (string.IsNullOrEmpty(key))
+                {
+                    continue;
+                }
+                if (key.ToString().ToUpper().StartsWith("ASPNETCORE_") == false)
+                {
+                    envValues.Remove(key);
+                }
+            }
+            return Ok(envValues);
+        }
+
+        /// <summary>
+        /// 获取所有环境变量
+        /// </summary>
+        [HttpGet]
+        public IActionResult AllEvn()
+        {
+            var envValues = System.Environment.GetEnvironmentVariables();
+            return Ok(envValues);
+        }
+
         /// <summary>
         /// 获取配置项
         /// </summary>
         [HttpGet]
-        public IActionResult ConfigItem(string itemName)
+        public IActionResult ConfigItem([Required(ErrorMessage = "配置项名称必填")]string itemName)
         {
             var envValue = _configuration.GetValue<string>(itemName);
             return Ok(envValue ?? "无此配置变量");
@@ -165,10 +238,24 @@ namespace DockerStudyApi.Controllers
         /// 获取所有配置项
         /// </summary>
         [HttpGet]
-        public IActionResult Info()
+        public IActionResult AllConfigItes()
+        {
+            return Ok(_configuration.GetChildren());
+        }
+
+        /// <summary>
+        /// 获取配置源
+        /// </summary>
+        [HttpGet]
+        public IActionResult ConfigProviders()
         {
-            var cnfigText = Newtonsoft.Json.JsonConvert.SerializeObject(_configuration.GetChildren());
-            return Ok(cnfigText);
+            var root = _configuration as ConfigurationRoot;
+
+            var providers = root.Providers.Select(p=>new { 
+                Name=p.GetType().FullName,
+            });
+
+            return Ok(providers);
         }
     }
 }

DockerStudyApi/DockerStudyApi.csproj

@@ -9,13 +9,27 @@
 
   <ItemGroup>
     <PackageReference Include="Microsoft.AspNetCore.Mvc.NewtonsoftJson" Version="5.0.12" />
+    <PackageReference Include="Microsoft.Extensions.Hosting.Systemd" Version="6.0.0" />
+    <PackageReference Include="Microsoft.Extensions.Hosting.WindowsServices" Version="6.0.0" />
     <PackageReference Include="Microsoft.Extensions.Options" Version="6.0.0" />
     <PackageReference Include="Microsoft.Extensions.Options.ConfigurationExtensions" Version="6.0.0" />
     <PackageReference Include="Microsoft.Extensions.Options.DataAnnotations" Version="6.0.0" />
     <PackageReference Include="Microsoft.VisualStudio.Azure.Containers.Tools.Targets" Version="1.11.1" />
     <PackageReference Include="Newtonsoft.Json" Version="13.0.1" />
-    <PackageReference Include="Swashbuckle.AspNetCore" Version="5.6.3" />
+    <PackageReference Include="Swashbuckle.AspNetCore" Version="6.2.3" />
     <PackageReference Include="Swashbuckle.AspNetCore.Newtonsoft" Version="6.2.3" />
   </ItemGroup>
 
+  <ItemGroup>
+    <None Update="Script\InstallWindowServer.ANSI.bat">
+      <CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
+    </None>
+    <None Update="Script\InstallWindowServer.UTF8.bat">
+      <CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
+    </None>
+    <None Update="Script\UnInstallWindowServer.bat">
+      <CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
+    </None>
+  </ItemGroup>
+
 </Project>

DockerStudyApi/Program.cs

@@ -6,6 +6,7 @@ using Microsoft.Extensions.Logging;
 using System;
 using System.Collections.Generic;
 using System.Linq;
+using System.Runtime.InteropServices;
 using System.Threading.Tasks;
 
 namespace DockerStudyApi
@@ -17,15 +18,56 @@ namespace DockerStudyApi
             CreateHostBuilder(args).Build().Run();
         }
 
-        public static IHostBuilder CreateHostBuilder(string[] args) =>
-            Host.CreateDefaultBuilder(args)
+        public static IHostBuilder CreateHostBuilder(string[] args)
+        {
+            var hostBuilder = Host.CreateDefaultBuilder(args);
+
+            //根据操作系统设置服务
+            if (RuntimeInformation.IsOSPlatform(OSPlatform.Windows))
+            {
+                hostBuilder.UseWindowsService(config =>
+               {
+                   //设置服务名
+                   //config.ServiceName = "";
+
+                   /*  注意：
+                    *  一、若应用不作为Windows服务运行，则.UseWindowsService（）不启使用
+                    *  二、应用作为Windows服务运行时，.UseWindowsService()方法做了如下操作：
+                       1、将主机生存期设置为 WindowsServiceLifetime。
+                       2、将内容根设置为 AppContext.BaseDirectory。通过为 Windows 服务调用 GetCurrentDirectory 返回的当前工作目录是 C:\WINDOWS\system32 文件夹
+                       3、为事件日志启用日志记录：
+                           应用名称用作默认源名称。
+                           对于基于 ASP.NET Core 模板且调用 CreateDefaultBuilder 生成主机的应用，默认日志级别为“警告”或更高级别。
+                           在 appsettings.json/appsettings.{Environment}.json 或其他配置提供程序中，使用 Logging:EventLog:LogLevel:Default 键覆盖默认日志级别。
+                           只有管理员可以创建新的事件源。 无法使用应用程序名称创建事件源时，应用程序源将记录一条警告，并禁用事件源。
+                    */
+               });
+            }
+            
+            if (RuntimeInformation.IsOSPlatform(OSPlatform.Linux))
+            {
+                hostBuilder.UseSystemd();
+            }
+
+            hostBuilder
                 .ConfigureAppConfiguration((hostingContext, config) =>
-                {
-                   // config.AddJsonFile("appsettings.json", false, true);
+            {
+                    // 作为windos服务运行时，.UseWindowsService()方法，将 ContentRootPath 设置为 AppContext.BaseDirectory
+
+                    /* 通过调用 CreateDefaultBuilder during host construction，从应用的内容根加载应用的默认设置文件 appsettings.json 和 appsettings.{Environment}.json
+                        ConfigureAppConfiguration 中的开发人员代码加载的其他设置文件，无需调用 SetBasePath。
+                        在下面的示例中，custom_settings.json 文件位于应用的内容根，加载它时未显式设置基本路径：
+                        config.AddJsonFile("custom_settings.json");
+                    */
+
+                    // config.AddJsonFile("appsettings.json", false, true);
                 })
                 .ConfigureWebHostDefaults(webBuilder =>
                 {
                     webBuilder.UseStartup<Startup>();
                 });
+
+            return hostBuilder;
+        }
     }
 }

DockerStudyApi/Script/InstallWindowServer.ANSI.bat

@@ -0,0 +1,31 @@
+::使用SC命令，安装成Windows服务
+::===================================
+::请求管理员省份运行，可以删除
+@echo off
+>nul 2>&1 "%SYSTEMROOT%\system32\cacls.exe" "%SYSTEMROOT%\system32\config\system"
+if '%errorlevel%' NEQ '0' (
+    :: 请求管理员权限...
+    echo "Request to run with administrator privileges......"
+    goto UACPrompt
+) else ( goto gotAdmin )
+:UACPrompt
+    echo Set UAC = CreateObject^("Shell.Application"^) > "%temp%\getadmin.vbs"
+    echo UAC.ShellExecute "%~s0", "", "", "runas", 1 >> "%temp%\getadmin.vbs"
+    "%temp%\getadmin.vbs"
+    exit /B
+:gotAdmin
+    if exist "%temp%\getadmin.vbs" ( del "%temp%\getadmin.vbs" )
+    pushd "%CD%"
+    CD /D "%~dp0"
+::===================================           
+echo %cd% 
+:: 创建Windows服务
+sc create DockerStudy.WebApi.Service binpath= "%cd%\..\DockerStudyApi.exe" start= auto
+
+:: 设置服务的描述字符串       
+sc description DockerStudy.WebApi.Service "DockerStudy.WebApi 服务."
+
+:: 启动服务
+sc start "DockerStudy.WebApi.Service"
+
+pause

DockerStudyApi/Script/InstallWindowServer.UTF8.bat

@@ -0,0 +1,31 @@
+::使用SC命令，安装成Windows服务
+::===================================
+::请求管理员省份运行，可以删除
+@echo off
+>nul 2>&1 "%SYSTEMROOT%\system32\cacls.exe" "%SYSTEMROOT%\system32\config\system"
+if '%errorlevel%' NEQ '0' (
+    :: 请求管理员权限...
+    echo "Request to run with administrator privileges......"
+    goto UACPrompt
+) else ( goto gotAdmin )
+:UACPrompt
+    echo Set UAC = CreateObject^("Shell.Application"^) > "%temp%\getadmin.vbs"
+    echo UAC.ShellExecute "%~s0", "", "", "runas", 1 >> "%temp%\getadmin.vbs"
+    "%temp%\getadmin.vbs"
+    exit /B
+:gotAdmin
+    if exist "%temp%\getadmin.vbs" ( del "%temp%\getadmin.vbs" )
+    pushd "%CD%"
+    CD /D "%~dp0"
+::===================================           
+echo %cd% 
+:: 创建Windows服务
+sc create DockerStudy.WebApi.Service binpath= "%cd%\..\DockerStudyApi.exe" start= auto
+
+:: 设置服务的描述字符串       
+sc description DockerStudy.WebApi.Service "DockerStudy.WebApi 服务."
+
+:: 启动服务
+sc start "DockerStudy.WebApi.Service"
+
+pause

DockerStudyApi/Script/UnInstallWindowServer.bat

@@ -0,0 +1,24 @@
+::卸载Windows服务
+::===================================
+::请求管理员省份运行，可以删除
+@echo off
+>nul 2>&1 "%SYSTEMROOT%\system32\cacls.exe" "%SYSTEMROOT%\system32\config\system"
+if '%errorlevel%' NEQ '0' (
+	:: 请求管理员权限...
+    echo "Request to run with administrator privileges......"
+    goto UACPrompt
+) else ( goto gotAdmin )
+:UACPrompt
+    echo Set UAC = CreateObject^("Shell.Application"^) > "%temp%\getadmin.vbs"
+    echo UAC.ShellExecute "%~s0", "", "", "runas", 1 >> "%temp%\getadmin.vbs"
+    "%temp%\getadmin.vbs"
+    exit /B
+:gotAdmin
+    if exist "%temp%\getadmin.vbs" ( del "%temp%\getadmin.vbs" )
+    pushd "%CD%"
+    CD /D "%~dp0"
+::===================================
+echo %cd%
+sc stop DockerStudy.WebApi.Service  
+sc delete DockerStudy.WebApi.Service           
+pause