在 Github Action 中执行 C# 脚本Intro

dotnet-exec 是一个命令行小工具，可以用来执行 C# 程序/脚本，我们在前面一篇文章中 基于 C# 编写构建脚本 介绍了使用基于 C# 编写构建脚本，在有 .NET SDK 的环境中我们直接安装 dotnet-execute 这个 dotnet tool 即可

在没有 .NET SDK 的环境中我们也可以基于 docker 来执行 C# 脚本，为了方便在 Github Action 中使用发布了一个简单的 Github Action 来方便使用

Implement

Github Action 的类型分为三种

JavaScript/TypeScript Action，通过 nodejs 来完成一些 taskDocker Action，基于 Dockerfile 或者 docker image 来实现 task 逻辑Composite Action，将多个 step 组合成一个步骤的 action

目前 dotnet-exec 的 action 是 docker action 基于 docker 来实现的，基于 docker 创建 Github action 可以参考文档：https://docs.github.com/en/actions/creating-actions/creating-a-docker-container-action

实现源码：https://github.com/WeihanLi/dotnet-exec-action

Usage Sample

基本使用如下：

- name: dotnet-exec scriptuses: WeihanLi/dotnet-exec-action@0.16.0with:script: "./build/build.cs" # script text or script patharguments: "target=test" # optional

目前有两个参数，一个是 script，一个是 arguments

Script 是必选参数，要执行的 script 路径或者 url 或者 script 源代码arguments 是一个可选参数，要传给 script 的命令行参数，就是 C# 程序里的 args

来看一个实际的示例，使用如下：

- name: dotnet-execuses: WeihanLi/dotnet-exec-action@0.16.0with:script: "./scripts/build.cs"env:DingBotWebhookUrl: ${{ secrets.DINGBOTWEBHOOKURL }}

完整的 github workflow 可以参考：https://github.com/WeihanLi/markdown-nice/blob/master/.github/workflows/docker.yaml

如果查看完整的 workflow yaml 的会发现，没有 setup .NET SDK 的地方，这就是为什么要使用这个 action 了

这里的示例指定了 script 的路径是 ./scripts/build.cs，并且设置了环境变量以供我们 C# 代码里使用

script 代码如下 https://github.com/WeihanLi/markdown-nice/blob/master/scripts/build.cs：

using System.Net.Http.Json;var message = """The `weihanli/mdnice` docker image has been updated[Amazing]""";var webhookUrl = Environment.GetEnvironmentVariable("DingBotWebhookUrl");if (string.IsOrEmpty(webhookUrl)){ Console.WriteLine("WebhookUrl not found");return;}using var response = await HttpHelper.HttpClient.PostAsJsonAsync(webhookUrl, new { msgtype = "text", text = new { content = message } });response.EnsureSuccessStatusCode();

这个示例是一个纯前端的项目打包 docker 镜像成功之后发一个钉钉消息推送，这个 script 就是用来推送钉钉消息的，推送消息效果如下：

action build

dingding-notification

Let C# power everywhere~~

Referenceshttps://github.com/WeihanLi/dotnet-exechttps://github.com/WeihanLi/dotnet-exec-actionhttps://github.com/marketplace/actions/dotnet-exechttps://github.com/WeihanLi/markdown-nice/blob/master/scripts/build.cshttps://github.com/WeihanLi/markdown-nice/blob/master/.github/workflows/docker.yaml#L34https://docs.github.com/en/actions/creating-actions/metadata-syntax-for-github-actionshttps://docs.github.com/en/actions/creating-actions/creating-a-docker-container-action