Docker最全教程之使用.NET Core推送钉钉消息（十九） - 好文

前言

上一篇我们通过实战分享了使用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

效果如图：

热门工具换一换