使用 GitHub Actions 实现项目的持续集成(CI)

news2024/11/22 13:51:11

目录

什么是 GitHub Actions

基础概念

Workflow 文件

Workflow 语法

实例：编译 OpenWrt

什么是 GitHub Actions

  • GitHub Actions 是 GitHub 推出的持续集成（Continuous Integration，简称 CI）服务
  • 它允许你创建自定义工作流，你可以使用这些工作流来自动化开发过程
  • 它提供了整套虚拟服务器环境，基于它可以进行构建、测试、打包、部署项目等等操作
  • 每个 GitHub 仓库都可以配置一个或多个工作流程，通过.github/workflows目录中的 YAML 文件定义
  • 简单来讲就是将软件开发中的一些流程交给云服务器自动化处理，比方说开发者把代码 push 到 GitHub 后它会自动测试、编译、发布
  • 有了持续集成服务开发者就可以专心于写代码，其它乱七八糟的事情就不用管了，这样可以大大提高开发效率
  • 持续集成（CI/CD）主要有三个： 持续集成、持续交付、持续部署
  • 我们一般的软件开发流程是：
  • 1-开发人员本地代码 commit,push
  • 2-通过 git hook 触发自动化测试
  • 3-测试通过后，合并发布分支
  • 4-通过 git hook 触发自动部署服务
  • 这里简单的描述了软件开发周期，当然实际上会更加复杂
  • CI/CD是由很多操作组成的，比如执行自动化测试、分支合并、服务部署等，而 GitHub 把这一系列的操作都称为 Actions
  • 当然 GitHub 创新点还不仅于此，不同的项目可能都会使用到相类似的 Action，GitHub 允许开发者把 action 写成独立的脚本文件，存放到代码仓库，使得其他开发者可以引用
  • GitHub 提供了一个官方市场：GitHub Action Market
  • GitHub Actions · GitHub
  • 在这里可以搜索到你想要的任何 actions，直接引用别人造好的轮子

基础概念

  • Workflows（工作流）：持续集成一次运行的过程，可以添加到存储库中的自动化过程
  • 工作流由一个或多个作业组成，可以由事件调度或触发
  • Event（事件）：触发工作流的特定动作；例如，向存储库提交 pr 或 pull 请求
  • Jobs（作业）：在同一跑步器上执行的一组步骤；默认情况下，具有多个作业的工作流将并行运行这些作业
  • Steps（步骤）：可以在作业中运行命令的单个任务；步骤可以是操作，也可以是 shell 命令
  • 作业中的每个步骤都在同一个运行程序上执行，从而允许该作业中的操作彼此共享数据
  • Actions（操作）：操作是独立的命令，它们被组合成创建作业的步骤
  • 操作是工作流中最小的可移植构建块
  • 你可以创建自己的动作，或者使用 GitHub 社区创建的动作
  • 每个 step 可以依次执行一个或多个命令（action）
  • Runners（运行器）：安装了 GitHub Actions 运行器应用程序的服务器
  • Github 托管的运行器基于 Ubuntu Linux、Microsoft Windows 和 macOS，工作流中的每个作业都在一个新的虚拟环境中运行

Workflow 文件

  • GitHub Ac­tions 的配置文件叫做 work­flow 文件（官方中文翻译为 “工作流程文件”）
  • 存放在代码仓库的.github/workflows目录中
  • work­flow 文件采用 YAML 格式，文件名可以任意取，但是后缀名统一为.yml或.yaml，比如icpctj.yml
  • 一个库可以有多个 work­flow 文件，GitHub 只要发现.github/workflows目录里面有.yml或.yaml文件，就会按照文件中所指定的触发条件在符合条件时自动运行该文件中的工作流程
  • 在 Ac­tions 页面可以看到很多种语言的 work­flow 文件的模版，可以用于简单的构建与测试
  • 下面是一个简单的 work­flow 文件示例：
  • 示例文件运行截图：

Workflow 语法

  • name
  • workflow的名称，GitHub在仓库的操作页面上显示workflow的名称
  • on
  • 触发 workflow 的 GitHub 事件的名称
  • 比如示例中的触发事件(使用单个事件)是 push，即在代码 push 到仓库后被触发
  • on 字段也可以是事件的数组，多种事件触发(使用多个事件)，比如在 push 或 pull-request 时触发：
  • 某些事件具有活动类型，可让你更好地控制工作流的运行时间
  • 使用 on.<event.name>.types 定义将触发工作流运行的事件活动类型(使用活动类型)
  • 例如，issue-comment 事件具有 created、edited 和 deleted 活动类型
  • 如果工作流在 label 事件上触发，则每当创建、编辑或删除标签时，它都会运行
  • 如果为 created 事件指定 label 活动类型，则工作流将在创建标签时运行，但不会在编辑或删除标签时运行
  • 如果指定多个活动类型，则只需要发生其中一种事件活动类型就可触发工作流
  • 如果触发工作流的多个事件活动类型同时发生，则将触发多个工作流运行
  • 例如，创建或标记问题时，会触发以下工作流
  • 如果创建了一个带两个标签的问题，则将启动三个工作流运行：一个用于创建问题的事件，另外两个用于两个标记问题的事件
  • 某些事件具有筛选器，可让你更好地控制工作流的运行时间(使用筛选器)
  • 例如，push 事件具有 branches 筛选器，该筛选器仅在发生目标为与 branches 筛选器匹配的分支的推送时（而不是在发生任何推送时）运行工作流
  • (将活动类型和筛选器用于多个事件)
  • 如果为事件指定活动类型或筛选器，并且针对多个事件指定工作流触发器，则必须单独配置每个事件
  • 必须为所有事件附加冒号 (:)，包括没有配置的事件
  • 例如，具有以下 on 值的工作流将在以下情况下运行：
  • 1-创建标签
  • 2-推送到存储库中的 main 分支
  • 3-推送到启用了 GitHub Pages 的分支
  • 完整的事件列表，请查看官方文档
  • 下面是一些比较常见的事件：
  • Jobs
  • 作业，workflow 主要执行的核心任务
  • 表示要执行的一项或多项任务
  • 每一项任务必须关联一个 ID (job.id)，比如示例中的 my.first.job 和 my.second.job
  • jobs.<job.id>
  • job.id 里面的 name 字段是任务的名称
  • jobs.<job.id>.name
  • job.id 不能有空格，只能使用数字、英文字母和 - 符号，而 name 可以随意，若忽略 name 字段，则默认会设置为 job.id
  • job.id 里面的 needs 表示识别在此作业运行之前必须成功完成的任何作业
  • jobs.<job.id>.needs
  • 当有多个任务时，可以指定任务的依赖关系，即运行顺序，否则是同时运行
  • 上面代码中，job1 必须先于 job2 完成，而 job3 等待 job1 和 job2 的完成才能运行
  • 因此，这个 work­flow 的运行顺序依次为：job1、job2、job3
  • runs-on
  • runs-on 字段指定任务运行所需要的虚拟服务器环境，是必填字段
  • jobs.<job.id>.runs-on
  • 机器可以是 GitHub 托管的运行器或自托管的运行器
  • steps
  • steps 字段指定每个任务的运行步骤，可以包含一个或多个步骤
  • jobs.<job.id>.steps
  • 步骤可以是运行命令、运行设置任务，或者运行仓库中的操作和 Dcoker 镜像发布等
  • 步骤开头使用 - 符号表示
  • 每个步骤可以指定以下字段：
  • 1-jobs.<job.id>.steps[*].id
  • 步骤的唯一标识符
  • 可以使用 id 在上下文中引用该步骤
  • 2-jobs.<job.id>.steps[*].if
  • 可以使用 if 条件来阻止步骤运行，除非满足条件
  • 您可以使用任何支持上下文和表达式来创建条件
  • 3-jobs.<job.id>.steps[*].name
  • 步骤显示在 GitHub 上的名称
  • 4-jobs.<job.id>.steps[*].uses
  • 选择要作为作业中步骤的一部分运行的操作
  • 操作是一种可重复使用的代码单位
  • 可以使用在与工作流、公共存储库或已发布的 Docker 容器映像相同的存储库中定义的操作
  • 5-jobs.<job.id>.steps[*].run
  • 使用操作系统的 shell 运行不超过 21,000 个字符的命令行程序
  • 如果不提供 name，步骤名称将默认为 run 命令中指定的文本
  • 6-jobs.<job.id>.steps[*].working-directory
  • 使用 working-directory 关键字，你可以指定运行命令的工作目录位置
  • 7-jobs.<job.id>.steps[*].shell
  • 可以使用 shell 关键字，覆盖运行器操作系统中的默认 Shell 设置，以及作业的默认值
  • 8-jobs.<job.id>.steps[*].with
  • 由操作定义的输入参数的 map
  • 每个输入参数都是一个键/值对
  • 输入参数被设置为环境变量
  • 该变量的前缀为 INPUT_，并转换为大写
  • 为 Docker 容器定义的输入参数必须使用 args
  • 示例：
  • 定义由 hello_world 操作定义的三个输入参数（first_name、middle_name 和 last_name）
  • 这些输入变量将作为 INPUT_FIRST_NAME、INPUT_MIDDLE_NAME 和 INPUT_LAST_NAME 环境变量，由 hello-world 操作访问
  • 9-jobs.<job.id>.steps[*].env
  • 设置供步骤在运行器环境中使用的变量
  • 也可以设置用于整个工作流或某个作业的变量
  • 10-下面是一些常见的字段：
  • 其中 uses 和 run 是必填字段，每个步骤只能有其一
  • 同样名称也是可以忽略的
  • action
  • action 是 GitHub Ac­tions 中的重要组成部分，这点从名称中就可以看出，actions 是 action 的复数形式
  • 它是已经编写好的步骤脚本，存放在 GitHub 仓库中
  • 对于初学者来说可以直接引用其它开发者已经写好的 action
  • 可以在官方 action 仓库或者 GitHub Marketplace 去获取
  • 此外 Awesome Actions 这个项目收集了很多非常不错的 action
  • 既然 action 是代码仓库，当然就有版本的概念
  • 引用某个具体版本的 action：
  • 一般来说 action 的开发者会说明建议使用的版本

实例：编译 OpenWrt

  • 既然是编译 Open­Wrt 那么 work­flow 的名称就叫 Build OpenWrt
  • 触发事件我选择了 push
  • 个人常用的 Open­Wrt 编译环境使用的是 Ubuntu 18.04，所以任务所使用的虚拟环境也一样
  • 我并不确定系统中是否有编译所需要依赖，所以第一个步骤是安装依赖软件包
  • 由于我使用的是一个空仓库，所以第二个步骤使用 Git 去拉取 Open­Wrt 官方源码
  • TIPS：如果是有源码的仓库，可以引用 actions/checkout 这个官方 ac­tion 把源码签出到工作目录中
  • 工作目录也就是在 Ac­tions 中执行命令的根目录，其绝对路径为/home/runner/work/REPO_NAME/REPO_NAME，环境变量为$GITHUB_WORKSPACE
  • 然后还需要拉取 feeds，它是扩展软件包源码，所以需要单独拉取
  • 既然都是拉取源码，所以就都放在一起吧
  • 由于这只是尝试，所以第三个步骤就让它生成一个默认的配置文件
  • 由于每个步骤都会回退到工作目录，所以前面还需要加一条进入 buildroot 的命令
  • 第四个步骤是下载第三方软件包（俗称 dl 库）
  • 最后为了防止下载不完整导致编译失败，加了显示不完整文件和删除不完整文件的命令
  • 第五个步骤进入到最重要的开始编译环节
  • 同样是先进入 buildroot，为了能更快的编译，我自信的选择了多线程编译且不显示详细日志
  • 最后编译出的二进制文件如何取出来呢？
  • 官方有个 ac­tion 叫 upload-artifact，它可以将虚拟环境中的指定文件打包上传到 Ac­tions 页面
  • 为了方便我选择了上传整个 bin 目录，文件名为 OpenWrt
  • 最后展示一下完整 work­flow 文件：
  • 最后 push 到仓库运行

本文来自互联网用户投稿，该文观点仅代表作者本人，不代表本站立场。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。如若转载，请注明出处：http://www.coloradmin.cn/o/1634569.html

如若内容造成侵权/违法违规/事实不符，请联系多彩编程网进行投诉反馈，一经查实，立即删除！

相关文章

源码编译framework.jar 并成功导入android studio 开发

源码编译framework.jar 并成功导入android studio 开发

一、不同安卓版本对应路径 Android N/O: 7 和 8 out/target/common/obj/JAVA_LIBRARIES/framework_intermediates/classes.jar Android P/Q: 9 和 10 out/soong/.intermediates/frameworks/base/framework/android_common/combined/framework.jar Android R: 11以上 out/so…
阅读更多...
Qt下使用7Z源码进行压缩和解压缩

Qt下使用7Z源码进行压缩和解压缩

7Z压缩是一款常用的压缩算法和工具&#xff0c;本文主要介绍一款在qt环境下进行编译的压缩方法。 本人测试是可以正常跑通的&#xff0c;具体代码部分请下载&#xff1a;下载链接&#xff0c;提取码&#xff1a;ev9t 7z源码网址&#xff1a;7-Zip 7z简介&#xff1a; 7z 是…
阅读更多...
有趣的大模型之我见 | Llama AI Model

有趣的大模型之我见 | Llama AI Model

Llama 开源吗&#xff1f; 我在写《有趣的大模型之我见 | Mistral 7B 和 Mixtral 8x7B》时曾犹豫&#xff0c;在开源这个事儿上&#xff0c;到底哪个大模型算鼻祖&#xff1f;2023 年 7 月 18 日&#xff0c;Meta 推出了最受欢迎的大型语言模型&#xff08;LLM&#xff09;的第…
阅读更多...
opencv_23_高斯模糊

opencv_23_高斯模糊

void ColorInvert::gaussian_blur(Mat& image) { Mat dst; GaussianBlur(image, dst, Size(0, 0), 15); // Size(2, 2), imshow("图像模糊2", dst); }
阅读更多...
MySQL中SELECT语句的执行过程

MySQL中SELECT语句的执行过程

2.1.1. 一条SELECT语句的执行过程 MySQL 的架构共分为两层&#xff1a;Server 层和存储引擎层 Server层负责建立连接、分析和执行SQL存储引擎层负责数据的存储和提取&#xff0c;支持 InnoDB、MyISAM、Memory 等多个存储引擎&#xff0c;MySQL5.5以后默认使用InnoDB&#xff0…
阅读更多...
什么是DDoS攻击？怎么防御DDoS攻击？

什么是DDoS攻击？怎么防御DDoS攻击？

在网络安全领域&#xff0c;DDoS攻击一直是热门话题&#xff0c;随着网络技术的不断发展和网络环境的复杂化演变&#xff0c;DDoS攻击变得愈加频繁、更具破坏性。根据2023年网络安全态势研判分析年度综合报告&#xff0c;全年全网网络层的DDoS攻击次数达2.51亿次&#xff01;本…
阅读更多...
五一前的最后一个工作日

五一前的最后一个工作日

最近在学习 Elasticsearch 的使用&#xff0c;也更了几篇文章了&#xff0c;后续的话应该要等到节后再说了&#xff08;因为真的背不动电脑回家&#xff09; 再来看下这次五一假期的组成&#xff0c;1 号到 5 号&#xff0c;共五天&#xff0c;其中 2 号是 28 号周日调休来的&a…
阅读更多...
【leetcode面试经典150题】74. 填充每个节点的下一个右侧节点指针 II（C++）

【leetcode面试经典150题】74. 填充每个节点的下一个右侧节点指针 II（C++）

【leetcode面试经典150题】专栏系列将为准备暑期实习生以及秋招的同学们提高在面试时的经典面试算法题的思路和想法。本专栏将以一题多解和精简算法思路为主&#xff0c;题解使用C语言。&#xff08;若有使用其他语言的同学也可了解题解思路&#xff0c;本质上语法内容一致&…
阅读更多...
【人工智能】AI赋能城市交通 未来城市的驱动力

【人工智能】AI赋能城市交通 未来城市的驱动力

前言 随着城市化进程的不断加速&#xff0c;交通拥堵、环境污染等问题日益凸显&#xff0c;人们对交通系统的效率和可持续性提出了更高的要求。在这样的背景下&#xff0c;智能交通技术正成为改善城市交通的重要驱动力。本文将探讨智能交通技术在解决城市交通挑战方面的应用和未…
阅读更多...
信息化工作人员必备常识12——远程桌面的使用与技巧

信息化工作人员必备常识12——远程桌面的使用与技巧

信息化工作人员必备常识12——远程桌面的使用与技巧 前言信息化人员必备常识回顾&#xff08;不想看回顾的直接往下滑哦~&#xff09;pingtelnetnslookup命令ipconfig命令域名DNS本机DNS缓存查看与清理DNS劫持DNS污染&#xff08;域名服务器缓存投毒&#xff09; 远程桌面开启远…
阅读更多...
Python多线程并不是真的并行执行

Python多线程并不是真的并行执行

Python多线程虽然能够利用多个CPU核执行计算&#xff0c;但并不能真正执行多线程并行计算。因为在Python中&#xff0c;有一个全局解释锁&#xff08;GlobalInterpreter Lock&#xff0c;GIL&#xff09;&#xff0c;该锁的存在使得在同一个时间只有一个线程执行任务&#xff0…
阅读更多...
TiDB 利用binlog 恢复-反解析binlog

TiDB 利用binlog 恢复-反解析binlog

我们知道TiDB的binlog记录了所有已经执行成功的dml语句&#xff0c;类似mysql binlog row模式 &#xff0c;TiDB官方也提供了reparo可以进行解析binlog&#xff0c;如下所示: [2024/04/26 20:58:02.136 08:00] [INFO] [config.go:153] ["Parsed start TSO"] [ts449…
阅读更多...
软考中级之数据库系统工程师笔记总结(五)网络基础

软考中级之数据库系统工程师笔记总结(五)网络基础

作者&#xff1a;Maynor 博客之星大数据领域Top1,GitHub项目awesome-chatgpt-project作者, 腾讯云TDSQL-C数据库开发者, 全网技术矩阵粉丝7w 公众号&#xff1a;Maynor996随着信息技术的飞速发展&#xff0c;数据库已成为现代企业和组织不可或缺的数据管理工具。对于许多专业人…
阅读更多...
pycharm安装pandas包

pycharm安装pandas包

import pandas时提示未安装pandas&#xff0c;点击下图红框选项&#xff0c;进行pandas安装 pycharm底部会有安装中的提示 pycharm底部提示红框的内容&#xff0c;说明安装成功 这个时候就可以看到import pandas不再报错了
阅读更多...
Spring-Mybatis-Xml管理(动态sql语句,sql语句复用)

Spring-Mybatis-Xml管理(动态sql语句,sql语句复用)

目录 前置条件 动态SQL语句 动态删除数据 1.集合类型:数组 2.集合类型: List 型 SQL语句重用 说明 &#x1f9e8;前置条件 已经创建了实体类(这边举个例子) 实体类User表 表中的字段名User实体类的属性值id (bigint auto increment) 长整型 自动增长private Long iduser…
阅读更多...
消失的数字

消失的数字

一、题目 原题链接. - 力扣&#xff08;LeetCode&#xff09; 二、解题 int missingNumber(int* nums, int numsSize){ //a^0a; //a^a0; //先求出0^1^2......^n的数&#xff0c;再将其与数组每个元素异或即可得到要寻找的数字 int ret0; for(int i0;i<numsSize;i) {ret^i;…
阅读更多...
transformer原理-Attention Is All You Need

transformer原理-Attention Is All You Need

文章目录 前言动机NLP任务特点循环神经网络循环神经网络流行原因循环神经网络缺点 transformer架构整体架构&#xff08;编码器-解码器&#xff09;自注意力&#xff08;self-attention&#xff09;传统NLP解决方案改进思路 多头注意力&#xff08;Multi-Head Attention&#x…
阅读更多...
《Fundamentals of Power Electronics》——反激变换器

《Fundamentals of Power Electronics》——反激变换器

反激转换器基于升降压转换器&#xff0c;接下去介绍它的演变过程。下图中的a描述了基本升降压型转换器电路&#xff0c;用一个MOSFET和二极管实现开关。 在图b中&#xff0c;电感绕组由两根导线构成&#xff0c;匝数比为1:1。电感的基础作用未改变&#xff0c;并联绕组可以等效…
阅读更多...
在 Windows 系统上安装 TeamViewer 13

在 Windows 系统上安装 TeamViewer 13

在 Windows 系统上安装 TeamViewer 13 References 默认安装到所有用户 同意协议 安装目录 勾选内容 打开文件位置 打开 rClientID.exe Extras -> Options -> Advanced Show advanced options -> Display language 重新启动TeamViewer 语言可修改为中文简体 …
阅读更多...
Web 渗透测试神器：HackBar 保姆级教程

Web 渗透测试神器：HackBar 保姆级教程

一、介绍 HackBar 是一个用于浏览器的扩展插件&#xff0c;主要用于进行网络渗透测试和安全评估。它提供了一系列方便的工具和功能&#xff0c;可以帮助用户执行各种网络攻击和测试&#xff0c;包括 XSS、SQL 注入、CSRF、路径穿越等。以下是 HackBar 插件的一些主要特点和功能…
阅读更多...
推荐文章
最新文章

Copyright @ 2022~2023