Github Actions工作流入门

主要参考资料：
GitHub Actions 工作流编写指南: https://blog.csdn.net/i89211/article/details/144881603

简介

GitHub Actions的核心在于它允许你在GitHub仓库中定义自定义的工作流程，这些工作流程由一系列动作(actions)组成，它们可以在特定事件发生时自动触发。

• 事件触发器(Event Triggers)：
  当你指定某些事件（如push、pull_request等），GitHub会监听这些事件并在其发生时启动相应的工作流。

• 运行器(Runners)：
  GitHub提供托管的虚拟机作为运行器，你可以选择不同的操作系统（如Ubuntu、Windows或macOS）。运行器负责执行你的工作流中的各个步骤。

• 动作(Actions)：
  Actions是构成工作流的基本单元，可以是一个简单的shell命令，也可以是一个复杂的Docker容器。GitHub Marketplace提供了大量预构建的动作供用户直接使用或作为参考。

• 矩阵(Matrix)：
  对于需要跨平台或跨版本测试的情况，可以使用矩阵策略来同时在多个环境中运行相同的工作流。

通过这种机制，GitHub Actions使得开发者能够轻松地实现CI/CD管道，提高软件开发效率，减少手动操作带来的错误风险。此外，由于其与GitHub紧密集成，因此特别适合于基于GitHub进行项目管理的团队。

工作流文件

什么是工作流文件？

• 文件必须保存在仓库的 .github/workflows 目录中
• 文件格式为 YAML，后缀为 .yml 或 .yaml
• 一个仓库可以有多个工作流文件

YAML 语法基础

key: value          # 基本的键值对
parent:             # 缩进表示层级关系child: value
array:              # 列表使用 - 表示- item1- item2

工作流文件结构：

名称定义（name）

name: My Workflow   # 工作流的名称，会显示在 Actions 页面

触发条件（on）

on:push:                    # 推送时触发branches:- main              # 只在 main 分支触发pull_request:           # PR 时触发branches: - mainschedule:               # 定时触发- cron: '0 0 * * *'   # 每天零点触发

常用的 cron 表达式：

* * * * * 分别代表：分钟(0-59) 小时(0-23) 日期(1-31) 月份(1-12) 星期几(0-6)
0 0 * * * = 每天午夜
0 */4 * * * = 每4小时
0 9 * * 1-5 = 工作日早上9点

工作定义（jobs）

jobs:build:                  # 工作IDruns-on: ubuntu-latest    # 运行环境steps:                # 步骤定义- name: Step 1        # 步骤名称uses: actions/checkout@v2    # 使用现成的 action- name: Step 2run: echo "Hello"   # 运行命令

常用环境变量

env:GLOBAL_VAR: value      # 全局环境变量jobs:job1:env:JOB_VAR: value     # 作业级环境变量steps:- env:STEP_VAR: value  # 步骤级环境变量

常用 Actions

检出代码

- uses: actions/checkout@v2

设置环境

- uses: actions/setup-node@v2with:node-version: '14'- uses: actions/setup-python@v2with:python-version: '3.8'

缓存依赖

- uses: actions/cache@v2with:path: ~/.npmkey: ${{ runner.os }}-node-${{ hashFiles('**/package-lock.json') }}