.net项目在linux平台的CI流程（基于Jenkins+mono+jexus）

内容较多，主要分为以下4方面内容：

• Jenkins的安装部署(centos 7+)
• .net在linux平台CI流程所需的插件管理&配置
• Jenkins配置连接Gitlab(也可使用对应插件连接SVN,TFS作为源码仓库)
• 基于Jenkins的CI流程构建

---

Jenkins安装部署

• 下载[Jenkins最新版]；
• 在服务器上jenkins.war所在目录建立脚本：start-jenkins.sh：

#!/bin/bash
JENKINS_ROOT=/opt/jenkins
export JENKINS_HOME=$JENKINS_ROOT/jenkins_home
nohup java -jar $JENKINS_ROOT/jenkins.war --httpPort= > jenkins.log >& &

• 修改脚本执行权限:

chmod a+x start-jenkins.sh

• 执行脚本:

/bin/bash start-jenkins.sh

• 访问服务器地址（测试服务器地址，脚本指定端口）:

http://10.200.XX.XX:8000

---

.net在linux平台CI流程所需的插件管理&配置

Jenkins在当前开发环境下所需要的插件列表如下：

• Docker相关插件

1. CloudBees Docker Build and Publish plugin （This plugin provides the ability to build projects with a Dockerfile, and publish the resultant tagged image (repo) to the docker registry.）
2. Docker plugin （This plugin allows slaves to be dynamically provisioned using Docker.）
3. docker-build-step （This plugin allows to add various Docker commands into you job as a build step.）

• CaaS插件

1. Kubernates plugin （This plugin allows slaves to be dynamically provisioned on multiple Docker hosts using Kubernetes.）

• Building插件

1. Git plugin
2. Nuget plugin
3. MSBuild

• Gitlab Connector

1. Gitlab Hook Plugin
2. GitLab Plugin

---

Jenkins配置连接Gitlab

• 在jenkins服务器上新生成SSH key

1. 通过以下指令检查服务器是否已经存在SSH Key：

   1. cat ~/.ssh/id_rsa.pub

2. 如果没有Key，则通过以下指令新生成一个Key：

   1. ssh-keygen -t rsa -C "jiakai@gridsum.com"

3. 通过刚才的指令：　cat ~/.ssh/id_rsa.pub　获得生成的Key(公钥部分)

• 在生成Key对应的账户个人"Profile Settings"下的"SSH Keys"标签下，新增这个Key， 新增的Title直接设置为账户名即可
• 完成后在"Your SSH Keys"下可以看到新增的SSH Key公钥信息

---

基于Jenkins的CI流程构建

---

Jenkins内部的各流程说明如下：

• 测试项目目录结构如下图：

• Source Copy
  • 该过程对应Jenkins工作项中的"源码管理"工作区，在该工作区中选中"Git"，配置Repository URL及上一步已经添加好的Credential即可，并制定需要编译的分支，比如"master"分支;
  • 该流程配置完毕后，可保存工作项，然后"立即构建"，正确的话将在Jenkins工作区目录的~/workspace/${JobName}/路径下，查看到从制定的Git Repository上拉取的源码;
• Nuget还原包
  • Nuget还原包依赖nuget.exe（需要mono），下载nuget.exe(这里我下载的是2.8.6版本），拷贝至Jenkins服务器的Jenkins运行目录下的.nuget文件夹；
  • 在Nuget还原工作项的"Execute shell"中，使用nuget.exe还原包即可：

    mono ../../.nuget/nuget.exe restore ${solution file path(.sln)}

  • 注：nuget2.5版本缺少必要的操作(restore)，不可用。
  • 在执行过程可能报以下错误：

    WARNING: Error: TrustFailure (The authentication or decryption has failed.)
    WARNING: Error: TrustFailure (The authentication or decryption has failed.)
    WARNING: Error: TrustFailure (The authentication or decryption has failed.)
    WARNING: Error: TrustFailure (The authentication or decryption has failed.)
    WARNING: Error: TrustFailure (The authentication or decryption has failed.)

    需要引入秘钥证书至machine store（注意不要引入到user store）:

    mozroots --import --machine --sync
    certmgr -ssl -m https://go.microsoft.com
    certmgr -ssl -m https://nugetgallery.blob.core.windows.net
    certmgr -ssl -m https://nuget.org

• mono编译包
  • 安装mono后（以安装路径/usr/mono为例），重启 jenkins，查看jenkins系统设置中的环境变量，其中的PATH变量，并确保mono的bin目录已经在PATH环境变量之中:
  • 

    然后直接调用xbuild编译项目：

    xbuild TestApi.sln

• [可选步骤]将编译后的文件形成发布文件，例如：

  # Get the deploy files Ready
  if [ ! -x ./deploy ] ;then
  mkdir deploy
  else
  rm ./deploy/* -rf
  fi
  cp ./src/DemoApi/bin ./deploy/bin -Rf
  cp ./src/DemoApi/packages.config ./deploy/packages.config -f
  cp ./src/DemoApi/Web.config ./deploy/Web.config -f
  cp ./src/DemoApi/Global.asax ./deploy/Global.asax -f

• 构建Docker镜像所需的Dockerfile
  • 由于我们这里需要在jexus中部署我们的demo api，因此采用公司docker源中的jexus服务器V3版镜像：

    if [ -f ./Dockerfile ] ;then
    rm ./Dockerfile -f
    fi
    cat > ./Dockerfile <<EOF
    FROM .xxx.xxx.xxx:/library/mono-jexus:v3
    COPY ./deploy /data
    CMD /usr/jexus/jws start && /usr/sbin/sshd -D
    EOF

• 打包Docker镜像并推送至公司的Docker源
• 这里我们用到CloudBees Docker Build and Publish plugin这个插件
• 
• 按照如下图所示的配置
• • 
  • 在“高级设置”中，勾选"Skip tag as latest","Force Pull"，并且，如果Dockerfile不在默认(./)目录，还需要在“Dockerfile Path”中指定Dockerfile的具体位置：
  • 
• 删除过期的Docker镜像

　　　　在成功生成新版本的镜像之后，需要删除（或untag）之前版本的镜像：

#Untag the expired images except the newest image id
#Init the parameters
IMG_NAME=demoapi
IMG_URL=/gridsum/ld/demoapi
(docker images | grep ${IMG_NAME} | awk '{print $2}') >.version
#Delete expired images
count=
maxnum=$(wc -l .version | awk '{print $1}')
 ] ;then
sort .version | while read line
do
if [ $count -lt $maxnum ] ;then
    docker rmi $IMG_URL:$line
    let count=count+
fi
done
fi
#Clean the parameters
unset IMG_NAME
unset IMG_URL
rm .version -f

• 建立项目对应的RC文件，注意在RC中指定的Docker镜像版本为本次build的镜像版本：

• 启动新的容器：

# Delete the existed rc by kubectl
#NEED to redrect stderr into null or the BUILD process will be FAILED if there IS a RC running
/opt/jenkins/kube/kubectl -s http://10.200.xx.xx:8080 delete rc demoapi 2>/dev/null
#Create the k8s rc by kubectl
/opt/jenkins/kube/kubectl -s http://10.200.xx.xx:8080 create -f ./rc.yaml

• 容器对应的服务最好手动建立，因为服务是常态化的，一般不随源代码版本更迭发生变化，因此服务的创建可以实现创建好;

• 最后对已发布的服务进行简单的功能测试，通过curl即可：