[Cake] 1. CI中的Cake
[Cake] 1. CI中的Cake
在上一篇C#Make自动化构建-简介中，简单的介绍了下Cake的脚本如何编写以及通过Powershell在本地运行Cake脚本。本篇在此基础上，介绍下如何在CI环境中使用Cake。
1. Cake简介续
1.1 为Task添加注释信息
Cake的每一个Task都可以添加一项描述，用来解释它的用途。比如下面的示例：
1 Task("restore")
2 .Description("还原项目依赖")
3 .Does(() =>
4 {
5 DotNetCoreRestore(soluction);
6 });然后Cake接收一个名为 ShowsDescription 的参数，运行Powershell或者bash的时候可以传递-ShowDescription来显示Task的信息。为了方便输入，我把ShowDescription改成了Help（仅更改了build.ps1中传递参数的名称）。
1.2 Cake.exe 和 Cake.CoreCLR
Cake目前有两个版本（参见Cake Releases）：
- Cake.exe是面向net461的，可以在winodws上直接运行；也可以在linux上借助 (Mono已经实现net47)来运行。
mono cake.exe
- Cake.CoreCLR（0.26版本以后开始支持.net core 2的，之前是.net core 1.1）面向.netcore的，可以使用 来运行。
dotnet cake.dll
我们直接下载这两个nuget包，然后用7z解压一下（nupkg文件为zip）：
cake.0.26.1.nupkg解压后如下：
在windows下可以直接通过console窗口来运行它：
cake.coreclr.0.26.1.nupkg解压后如下：
可以通过dotnet cake.dll来运行它：
2. Cake运行环境搭配
Cake脚本本身的跨平台（windows，linux，docker等）是借助于上面提到的cake.exe或cake.coreclr来实现的。基于这些，我们可以有如下的组合：
- windows：用powershell来引导执行cake.exe。
- windows：用powershell来引导执行dotnet cake.dll。
- linux：用bash来引导执行mono cake.exe。
- linux：用bash来引导执行dotnet cake.dll。
- docker：视docker镜像的os平台而定，从上面四个组合中选择一个。
由于目前dotnet cli本身的不健全，缺少独立于*.csproj文件之外来安装nuget包的命令，故而使得安装cake.coreclr变得非常恶心。参见两种变通方法：
- 借助外部工具下载cake.coreclr的nuget包：https://github.com/devlead/BitbucketPipelinesShield/blob/master/build.sh
- 构造一个临时的*.csproj文件，然后用dotnet restore来下载cake.coreclr的nuget包：https://gist.github.com/luigiberrettini/19a124d24af74039ae87065adb007e2c
故而目前在window平台下选择1，在其他平台下选择3比较合适，在docker下可以构建一个mone+dotnet的混合环境的image（https://hub.docker.com/r/lnhcode/dotnet2-mono5/）。
好消息是目前.net core的每日构建版已经添加了 dotnet install 和 dotnet install tool 的命令（https://github.com/dotnet/cli/blob/master/src/dotnet/commands/dotnet-install/InstallCommandParser.cs），可以直接用来安装nuget包。这个新功能会随着.net core 2.1的正式发布而到来。到时候就可以统一借助dotnet cli来安装cake.coreclr了。
3. 在不同的CI环境中执行相同的自动构建
cake的目的在于一次编写，可以运行在不同的构建环境和构建工具中。同时可以把构建脚本纳入到源代码管理中，而不是编写在某一特定的ci/cd工具中。正如这篇文章https://www.thoughtworks.com/radar/techniques/programming-in-your-ci-cd-tool中的观点一样。
借助Github提供的很多免费的CI服务，我在https://github.com/linianhui/cake.example上接入了3个CI服务。
3.1 Cake with AppVeyor
AppVeyor主要提供有windows的ci环境，我们只需要再github的项目根目录添加 appveyor.yml 文件，然后关联一下AppVeyor的服务即可。
1 version: 1.0.{build}
2 image: Visual Studio 2017
3 build: off
4 test_script:
5 - ps: ./build.ps1 -target test上面的这个示例调用了build.ps1来运行测试https://ci.appveyor.com/project/linianhui/cake-example。
3.2 Cake with Travis
Travis提供有linux的ci环境，同样的我们添加一个 .travis.yml 文件然后关联Travis的服务即可。
1 language: csharp
2
3 os:
4 - linux
5
6 mono: latest
7
8 dotnet: 2.1.4
9
10 script:
11 - chmod +x ./build.sh
12 - ./build.sh -target=test上面的这个示例的运行环境是linux，安装了mone和dotnet，然后调用了build.sh来运行测试https://travis-ci.org/linianhui/cake.example。
3.3 Cake with Circle
Circle提供有docker的环境，同样的添加一个 .circleci/config.yml 文件然后关联Circle的服务即可。
1 version: 2
2
3 jobs:
4 test:
5 docker:
6 - image: lnhcode/dotnet2-mono5
7 steps:
8 - checkout
9 - run: chmod +x ./build.sh
10 - run: ./build.sh -target=test
11
12 workflows:
13 version: 2
14 test:
15 jobs:
16 - test上面的示例中我使用了自己定义的一个dotnet2-mono2的docker镜像，然后调用builds.sh来运行测试https://circleci.com/gh/linianhui/cake.example/tree/master。dotnet2-mono5的镜像位于：https://hub.docker.com/r/lnhcode/dotnet2-mono5/
4. 总结
以上简单的介绍了一下Cake的简介信息，和如何再不同的CI环境中使用Cake来维护一个相同的自动化构建的流程。如有错误，欢迎指正！
参考
dotnet2-mono5 的dockerfile：https://github.com/linianhui/dockerfiles/blob/master/dotnet2-mono5/Dockerfile
本文示例代码：https://github.com/linianhui/cake.example
不要再CI/CD中编程：https://www.thoughtworks.com/radar/techniques/programming-in-your-ci-cd-tool