Docker最全教程之使用.NET Core推送釘釘消息（十九）
阿新 • • 發佈：2019-03-22
des exception 鏡像 span 必須 ignore content end settings
前言
上一篇我們通過實戰分享了使用Go推送釘釘消息，由於技癢，筆者現在也編寫了一個.NET Core的Demo，作為簡單的對照和說明。
最後，由於精力有限，筆者希望有興趣的朋友可以分享下使用CoreRT將.NET Core編譯成機器代碼這塊的實踐。
目錄
-
使用.NET Core推送釘釘消息
-
獲取參數
-
設置消息數據格式
-
發送請求
-
設置Dockerfile
-
運行並設置環境變量推送消息
使用.NET Core推送釘釘消息
這裏我們使用.NET Core來完成相關需求，註意，這裏是.NET Core，而不是ASP.NET Core。需求和上面類似，工程相關依賴如下所示：
<PackageReferenceInclude="Microsoft.Extensions.Configuration"Version="2.2.0"/>
<PackageReferenceInclude="Microsoft.Extensions.Configuration.CommandLine"Version="2.2.0"/>
<PackageReferenceInclude="Microsoft.Extensions.Configuration.EnvironmentVariables"Version="2.2.0"/>
<PackageReferenceInclude="Microsoft.Extensions.Http"Version="2.2.0"/>
<PackageReferenceInclude="Newtonsoft.Json"Version="12.0.1"/>
以下是相關的主體代碼：
獲取參數
從環境變量或者命令行參數獲取配置：
///<summary> ///環境變量列表 ///</summary> privatestaticreadonlystring[] EnvList = { //釘釘機器人地址 "WEBHOOK", //@的手機號碼 "AT_MOBILES", //@所有人"IS_AT_ALL", //消息內容 "MESSAGE", //消息類型（僅支持文本和markdown） "MSG_TYPE" }; privatestaticvoid Main(string[] args) { var config = newConfigurationBuilder() //支持命令行參數 .AddCommandLine(args) //支持環境變量 .AddEnvironmentVariables() .Build(); #region參數檢查 foreach (var envName in EnvList) { var value =config[envName]; if (string.IsNullOrWhiteSpace(value)&& envName != "AT_MOBILES" && envName !="IS_AT_ALL") { Console.WriteLine($"{envName}不能為空！"); return; } } if (string.IsNullOrWhiteSpace(config["AT_MOBILES"]) &&string.IsNullOrWhiteSpace(config["IS_AT_ALL"])) { Console.WriteLine("必須設置參數 AT_MOBILES 和 IS_AT_ALL 兩者之一！"); return; } #endregion try { //推送消息 SetDataAndSendWebhooks(config).Wait(); } catch (Exception ex) { Console.WriteLine(ex.ToString()); } }
設置消息數據格式
設置消息格式，為了簡單，這裏我們使用匿名類：
///<summary> ///設置消息並調用Webhook ///</summary> ///<param name="config"></param> ///<returns></returns> privatestaticasync Task SetDataAndSendWebhooks(IConfigurationRoot config) { var at = new { AtMobiles = config["AT_MOBILES"]?.Split(‘,‘), IsAtAll = Convert.ToBoolean(config["IS_AT_ALL"] ?? "false") }; switch (config["MSG_TYPE"]) { case"text": { var data = new { Msgtype = "text", Text = new { Content =config["MESSAGE"] }, At = at }; awaitSendWebhooks(config["WEBHOOK"], data); break; } case"markdown": { var data = new { Msgtype = "markdown", Markdown = new { Title = "釘釘通知", Text = config["MESSAGE"] }, At = at }; awaitSendWebhooks(config["WEBHOOK"], data); break; } default: { Console.WriteLine($"不支持的格式:{config["MSG_TYPE"]}"); break; } } }
發送請求
此處代碼使用Newtonsoft.Json做JSON序列化，然後使用Microsoft.Extensions.Http的HttpClient庫來發送Post請求。
在數據格式這塊，我們通過配置做了以下設置：
-
忽略Null值。也就是為null的屬性不做JSON序列化。
-
設置屬性命名規則為Camel-Case駝峰式命名法，首字母小寫。
主體代碼如下所示：
///<summary> ///調用webhook ///</summary> ///<typeparamname="T"></typeparam> ///<param name="url">webhook地址</param> ///<param name="data">消息</param> ///<returns></returns> privatestaticasync Task SendWebhooks<T>(string url, T data) where T : class { JsonConvert.DefaultSettings = newFunc<JsonSerializerSettings>(() =>newJsonSerializerSettings() { NullValueHandling =NullValueHandling.Ignore, ContractResolver = newCamelCasePropertyNamesContractResolver() }); var jsonData =JsonConvert.SerializeObject(data); Console.WriteLine(jsonData); using (var httpClient = new HttpClient()) { var content = newStringContent(jsonData); content.Headers.ContentType = newMediaTypeHeaderValue("application/json"); var result = awaithttpClient.PostAsync(url, content); result.EnsureSuccessStatusCode(); Console.WriteLine($"Send webhook succeed. StatusCode:{result.StatusCode}"); } }
設置Dockerfile
在之前我們已經講述過，使用了分階段構建。整個Dockerfile基本上使用VS Docker tool生成：
FROMmicrosoft/dotnet:2.2-runtime AS base WORKDIR /app FROMmicrosoft/dotnet:2.2-sdk AS build WORKDIR /src COPY DingTalk.NET/DingTalk.NET.csprojDingTalk.NET/ RUN dotnet restoreDingTalk.NET/DingTalk.NET.csproj COPY . . WORKDIR /src/DingTalk.NET RUN dotnet buildDingTalk.NET.csproj -c Release -o /app FROM build AS publish RUN dotnet publish DingTalk.NET.csproj-c Release -o /app FROM base AS final WORKDIR /app COPY --from=publish/app . ENTRYPOINT ["dotnet", "DingTalk.NET.dll"] # 註意不要單獨使用 MAINTAINER 指令，MAINTAINER已被Label標簽代替 LABEL MAINTAINER ="[email protected]" # LABEL指令用於將元數據添加到鏡像，支持鍵值對和JSON，我們可以使用 docker inspect 命令來查看 LABELDingtalkComponent=‘{\ "description": "使用釘釘發送通知消息.", "input": [ {"name": "WEBHOOK","desc": "必填, 釘釘機器人Webhook地址"}, {"name":"AT_MOBILES", "desc": "非必填，被@人的手機號"}, {"name":"IS_AT_ALL", "desc": "非必填，@所有人時:true, 否則為:false"}, {"name": "MESSAGE","desc": "必填，自定義發送的消息內容"}， {"name":"MSG_TYPE", "desc": "必填，自定義發送的消息類型，目前僅支持text和markdown"} ] }‘
編譯完成後，我們來查看下鏡像大小：
註意:
通過上圖我們可以看到，鏡像大小不到200M，相比GO體重大了許多，但是相比其他語言卻輕了不少。不過，我們可以通過官方開源庫CoreRT將.NET Core編譯成機器代碼，也就是.NET Core也可以做到編譯完成後只有幾M大小。有興趣的朋友可以分享下這塊的實踐。
運行並設置環境變量推送消息
我們使用PowerShell編寫簡單腳本如下所示：
docker build --rm-f "Dockerfile" -t dingtalk.net:latest . docker run --rm -e"WEBHOOK=https://oapi.dingtalk.com/robot/send?access_token={yourAccess Token}" ` -e "MESSAGE=*使用.NET Core發送釘釘消息。*" ` -e "IS_AT_ALL=true" ` -e "MSG_TYPE=markdown" ` -d dingtalk.net
效果如圖：
Docker最全教程之使用.NET Core推送釘釘消息（十九）