Jenkins 构建自动化.NET C ore 发布镜像

简介: Jenkins 构建自动化.NET C ore 发布镜像

导读


在本章中,将介绍如何在 Linux 下使用 Docker 部署、启动 Jenkins,编写脚本,自动化构建 .NET Core 应用,最终将 .NET Core 应用打包为 Docker 镜像。


部署 Jenkins


请提前在 Linux 上安装 Docker,在 Linux 中,我们使用 Docker 启动 Jenkins,这样可以避免手动安装大量依赖以及污染本地环境,也便于快速启动和故障恢复。


安装 Docker 完毕后,使用 docker version 检查 Docker 版本,Docker 版本不能为 1.x、3.x 这种版本,请升级到 18.x 以上版本。一般在 Ubuntu 系统中,下载安装的是最新版本,但是在 Centos 中因为默认镜像源中的版本比较旧, 安装 Doker 版本较低,需要手动添加新版本的镜像源再升级。

请参考:https://www.cnblogs.com/harlanzhang/p/9965534.html


因为会使用到容器提供环境,以及使用 Docker 打包 .NET Core 程序为 Docker 镜像,所以需要在 Jenkins 容器中映射 Docker 的 .sock 文件,以便在容器中,还能使用 Docker 命令。


在宿主机中创建 /var/jenkins_home 目录,用于备份 Jenkins 中的数据。

在 Linux 中使用 Docker 启动 Jenkins ,其命令如下:


docker run \
  -u root \
  -itd \
  -p 8080:8080 \
  -p 50000:50000 \
  -v /var/jenkins_home:/var/jenkins_home \
  -v /var/run/docker.sock:/var/run/docker.sock \
  jenkinsci/blueocean


启动后,使用 docker logs {容器ID} 查看日志获取 Jenkins 登录密码,其密码是一串哈希字符串,例如:1abc12445adcf

最后打开 8080 端口,即可访问 Jenkins。


安装插件


登录 Jenkins 后,会提示安装推荐的插件,请根据提示安装推荐的插件,推荐安装的插件列表如下:

Folders Plugin
OWASP Markup Formatter Plugin
Build Timeout
Credentials Binding Plugin
Timestamper
Workspace Cleanup
Ant
Gradle
Pipeline
GitHub Branch Source Plugin
Pipeline: GitHub Groovy Libraries
Pipeline: Stage View
Git plugin
SSH Build Agents
Matrix Authorization Strategy Plugin
PAM Authentication
LDAP
Email Extension
Mailer Plugin
Localization: Chinese (Simplified)


另外为了提供容器打包支持等,需要另外手工安装以下插件。


微信图片_20220505152103.png


# 提供 Docker 支持(必装)
docker
Docker Pipeline
docker-build-step
# 可视化设计流水线脚本的工具(必装)
Blue Ocean
# 提供对 gitlab 支持,如果不使用可以不安装
gitlab
# 提供 Git 参数化和钩子触发构建支持,不需要可以不安装
Git Parameter
Generic Webhook Trigger


拉取镜像


这里介绍一下我们后面要用到的两个镜像。

拉取一个 .NET Core SDK,每次启动流水线时,都会启动一个 .NET Core SDK 容器,为我们提供构编译、发布 .NET Core 程序的环境。


docker pull mcr.microsoft.com/dotnet/sdk:3.1


拉取一个 ASP.NET Core Runtime,用于制作应用镜像的基础镜像。

docker pull mcr.microsoft.com/dotnet/aspnet:3.1


镜像列表:

mcr.microsoft.com/dotnet/aspnet   3.1          ac199e8d6dff   2 weeks ago   208MB
mcr.microsoft.com/dotnet/sdk      3.1          82e2a34647f0   2 weeks ago   710MB


制作 Jenkinsfile 脚本


笔者贴心地给各位同学准备了 Demo 项目,请到 https://github.com/whuanle/DotNetCoreJenkinsDemo 仓库,fork 到你的仓库,后续我们使用这个 ASP.NET Core 的 Demo 程序实践流程。


在项目文件中,可以找到一个 Jenkinsfile 文件,此文件为我们定义流水线的步骤。


我们看一下简单的 Jenkinsfile 模板:

pipeline {
    stages {
        stage('Build') {
            steps {
                echo 'Building..'
            }
        }
        stage('Test') {
            steps {
                echo 'Testing..'
            }
        }
        stage('Deploy') {
            steps {
                echo 'Deploying....'
            }
        }
    }
}


stages 中,定义流水线的阶段,在模板中,一个定义了三个阶段,分别是 BuildTestDeploy


每个阶段都可以定义多个步骤(steps),每个步骤中都可以执行多个不同类型的 step。


stage('Test') {
        steps {
            echo 'Testing..'
        }
    }


demo 中的 Jenkinsfile 比较简单,我们可以找个 Publish 阶段的内容看一下:

stage('Publish') { 
            steps {
                sh 'dotnet publish src/WebDemo -c Release'
            }
        }


其实很简单,每个步骤执行 shell 命令就行,我们可以使用 sh '...' 表示此步骤要执行的 shell 命令。


接着我们看一下 Jenkinsfile 开头的两部分内容。

// 全局环境变量
    environment {
        IMAGENAME     = 'webdemo'       // 镜像名称
        IMAGETAG      = '1.0.0'         // 镜像标签
        APPPORT       = '8089'          // 应用占用的端口
        APPDIR        = '/opt/app'      // 应用工作的目录
    }
    agent {
        docker {
            image 'mcr.microsoft.com/dotnet/sdk:3.1' 
            args '-v /var/run/docker.sock:/var/run/docker.sock -v /usr/bin/docker:/usr/bin/docker'
        }
    }


environment 中,可以定义此次构建过程的环境变量。

agent 则是节点选择器,可以选择在何种环境下启动流水线,有 nodedocker 等类型。


构建流水线


登录到 Jenkins 网页后台,在左侧菜单栏中点击 New Item,开始创建流水线。

Jenkins 有多种流水线风格,还可以通过添加插件,来加入更多的流水线类型,我们主要了解 Freestyle project 、Pipeline、Multibranch Pipeline 即可。


  • Freestyle project
    Freestyle project流水线 使用上比较自由,不需要对项目做更改即可创建流水线,可以添加很多选择、配置。如果流程需要变化,改动比较麻烦。
  • Pineline、Multibranch Pipeline
    他们都可以同时处理多个分支,这两种都是依赖于项目中的 Jenkinsfile 文件。Multibranch Pipeline 好处是可以同时检查多个分支,为每个分支创建构建Job,而 Pipeline 会把多个分支放到一个 Job 中。

点击 New Item ,创建流水线,选择 Mutibranch Pipline。

添加 Git 源代码 仓库方式,我们可以自由选择一种类型,建议使用 Single repository & branch


微信图片_20220505152111.png

由于我们没有添加密钥,所以 Jenkins 无法访问你的 Github 仓库,所以需要添加一个可访问的密钥。

微信图片_20220505152115.png


找一台已经安装了 git 的电脑,生成公钥私钥,为 Jenkins 和 GitHub 之间提供加密连接。

执行命令:


ssh-keygen -t rsa -b 2048 -C "email@example.com"


根据提示,填写要存放密钥的路径,如 D:/id_rsa

执行命令后,会生成两个文件, id_rsaid_rsa.pub,复制 id_rsa (私钥)中的内容到 Jenkins 中。

然后把 id_rsa.pub (公钥)的内容添加到 Github 你的账号中。


你可以使用多种方式添加认证方式,最简单、安全的是密钥,我们可以选择 Secret file,然后上传私钥,或者使用别的方式,这里就不赘述了。

微信图片_20220505152122.png


然后选择要发布的分支,最后直接保存即可。

微信图片_20220505152125.png

然后回到主界面,打开 我们创建的流水线,点击 Build Now,即可启动流水线。

微信图片_20220505152325.png


构建成功截图:

微信图片_20220505152329.png


在 Linux 服务器上,查看镜像列表:

root@localhost ~ 19:54:20 # docker images
REPOSITORY                        TAG          IMAGE ID       CREATED         SIZE
webdemo                           1.0.0        79b636ddef73   2 minutes ago   208MB


可以看到,已经自动打包应用为镜像,其镜像名称和版本号,都可以在 Jenkinsfile 中设置。


观察


我们可以在构建界面中,观察每个步骤的日志。


微信图片_20220505152333.png


微信图片_20220505152338.png


在 Open Blue Ocean 中,有更加好看的 UI 和方便的工具。

微信图片_20220505152342.png


可视化设计流水线步骤。


微信图片_20220505152346.png

微信图片_20220505152409.png

观察构建过程。


微信图片_20220505152417.png

微信图片_20220505152422.png

相关文章
|
17天前
|
JSON 编解码 API
Go语言网络编程:使用 net/http 构建 RESTful API
本章介绍如何使用 Go 语言的 `net/http` 标准库构建 RESTful API。内容涵盖 RESTful API 的基本概念及规范,包括 GET、POST、PUT 和 DELETE 方法的实现。通过定义用户数据结构和模拟数据库,逐步实现获取用户列表、创建用户、更新用户、删除用户的 HTTP 路由处理函数。同时提供辅助函数用于路径参数解析,并展示如何设置路由器启动服务。最后通过 curl 或 Postman 测试接口功能。章节总结了路由分发、JSON 编解码、方法区分、并发安全管理和路径参数解析等关键点,为更复杂需求推荐第三方框架如 Gin、Echo 和 Chi。
|
2月前
|
jenkins 持续交付 开发工具
利用Dockerfile自主构建Jenkins镜像
希望这个过程能善用你的野马般想象,把自己置身于和计算机的卓尔不凡的对话中,让编程的过程充满趣味。
104 36
|
1月前
|
Ubuntu jenkins 机器人
在Jenkins上配置触发Ubuntu环境的图形用户界面(GUI)构建任务。
以上,这趟融合了技术与艺术的Jenkins配置之旅就告一段落了。记住,技术应当像艺术一样有趣和生动,这样才能激发出最大的创新和效率。
47 2
|
3月前
|
jenkins Java Linux
Jenkins环境的部署及任务构建
以上就是Jenkins环境的部署及任务构建的全部内容。希望可以帮助你轻松上手Jenkins,让你的CI/CD之旅更加顺畅!
289 68
|
3月前
|
人工智能 算法 物联网
5G赋能工业自动化:构建未来工厂的新引擎
5G赋能工业自动化:构建未来工厂的新引擎
99 10
|
4月前
|
机器学习/深度学习 设计模式 测试技术
Python 高级编程与实战:构建自动化测试框架
本文深入探讨了Python中的自动化测试框架,包括unittest、pytest和nose2,并通过实战项目帮助读者掌握这些技术。文中详细介绍了各框架的基本用法和示例代码,助力开发者快速验证代码正确性,减少手动测试工作量。学习资源推荐包括Python官方文档及Real Python等网站。
|
5月前
|
监控 jenkins 测试技术
Ansible与Jenkins:自动化工具的对比
Ansible和Jenkins是自动化领域的两大巨头。Ansible专注于配置管理和任务自动化,采用无代理架构,使用YAML定义配置,具有幂等性和可扩展性。Jenkins则擅长持续集成和持续交付(CI/CD),支持丰富的插件生态系统,适用于自动化构建、测试和部署。两者各有优势,Ansible适合配置管理与大规模部署,Jenkins则在CI/CD方面表现出色。结合使用可创建更强大的自动化工作流,提升团队生产力和软件质量。选择工具时应根据具体需求决定。
|
6月前
|
人工智能
LangGraph:构建多代理动态工作流的开源框架,支持人工干预、循环、持久性等复杂工作流自动化
LangGraph 是一个基于图结构的开源框架,专为构建状态化、多代理系统设计,支持循环、持久性和人工干预,适用于复杂的工作流自动化。
627 12
LangGraph:构建多代理动态工作流的开源框架,支持人工干预、循环、持久性等复杂工作流自动化
|
7月前
|
前端开发 C# 开发者
.NET使用Umbraco CMS快速构建一个属于自己的内容管理系统
.NET使用Umbraco CMS快速构建一个属于自己的内容管理系统
90 12
|
7月前
|
Serverless 决策智能 UED
构建全天候自动化智能导购助手:从部署者的视角审视Multi-Agent架构解决方案
在构建基于多代理系统(Multi-Agent System, MAS)的智能导购助手过程中,作为部署者,我体验到了从初步接触到深入理解再到实际应用的一系列步骤。整个部署过程得到了充分的引导和支持,文档详尽全面,使得部署顺利完成,未遇到明显的报错或异常情况。尽管初次尝试时对某些复杂配置环节需反复确认,但整体流程顺畅。
152 3

热门文章

最新文章

推荐镜像

更多