前往小程序,Get更优阅读体验!
立即前往
首页
学习
活动
专区
工具
TVP
发布
社区首页 >专栏 >[Cake] 1. CI中的Cake

[Cake] 1. CI中的Cake

作者头像
blackheart
发布2018-03-28 14:11:59
1.2K0
发布2018-03-28 14:11:59
举报
文章被收录于专栏:blackheart的专栏

在上一篇C#Make自动化构建-简介中,简单的介绍了下Cake的脚本如何编写以及通过Powershell在本地运行Cake脚本。本篇在此基础上,介绍下如何在CI环境中使用Cake。

1. Cake简介续

1.1 为Task添加注释信息

Cake的每一个Task都可以添加一项描述,用来解释它的用途。比如下面的示例:

代码语言:javascript
复制
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):

  1. Cake.exe是面向net461的,可以在winodws上直接运行;也可以在linux上借助  (Mono已经实现net47)来运行。

mono cake.exe

  1. 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来实现的。基于这些,我们可以有如下的组合:

  1. windows:用powershell来引导执行cake.exe。
  2. windows:用powershell来引导执行dotnet cake.dll。
  3. linux:用bash来引导执行mono cake.exe。
  4. linux:用bash来引导执行dotnet cake.dll。
  5. docker:视docker镜像的os平台而定,从上面四个组合中选择一个。

由于目前dotnet cli本身的不健全,缺少独立于*.csproj文件之外来安装nuget包的命令,故而使得安装cake.coreclr变得非常恶心。参见两种变通方法:

  1. 借助外部工具下载cake.coreclr的nuget包:https://github.com/devlead/BitbucketPipelinesShield/blob/master/build.sh
  2. 构造一个临时的*.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的服务即可。

代码语言:javascript
复制
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的服务即可。

代码语言:javascript
复制
 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的服务即可。

代码语言:javascript
复制
 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

本文参与 腾讯云自媒体同步曝光计划,分享自作者个人站点/博客。
如有侵权请联系 cloudcommunity@tencent.com 删除

本文分享自 作者个人站点/博客 前往查看

如有侵权,请联系 cloudcommunity@tencent.com 删除。

本文参与 腾讯云自媒体同步曝光计划  ,欢迎热爱写作的你一起参与!

评论
登录后参与评论
0 条评论
热度
最新
推荐阅读
目录
  • 1. Cake简介续
    • 1.1 为Task添加注释信息
      • 1.2 Cake.exe 和 Cake.CoreCLR
      • 2. Cake运行环境搭配
      • 3. 在不同的CI环境中执行相同的自动构建
        • 3.1 Cake with AppVeyor
          • 3.2 Cake with Travis
            • 3.3 Cake with Circle
            • 4. 总结
            • 参考
            相关产品与服务
            容器服务
            腾讯云容器服务(Tencent Kubernetes Engine, TKE)基于原生 kubernetes 提供以容器为核心的、高度可扩展的高性能容器管理服务,覆盖 Serverless、边缘计算、分布式云等多种业务部署场景,业内首创单个集群兼容多种计算节点的容器资源管理模式。同时产品作为云原生 Finops 领先布道者,主导开源项目Crane,全面助力客户实现资源优化、成本控制。
            领券
            问题归档专栏文章快讯文章归档关键词归档开发者手册归档开发者手册 Section 归档