Github: Github actions 自动化工作原理与多workflow创建

Github actions

1 ）概述

• Github Actions 是Github官方推出的 CI/CD 解决方案
  • https://docs.githu.com/en/actions
• 优点
  • 自动发布流程可减少发布过程中手动操作成本，大幅提升ci/cd效率，快速实现项目发布上线
• 缺点
  • 存在较高的技术门槛
  • 需要利用额外服务，会产生技术成本

2 ）工作原理

• Repository 是代码仓库, .github 是特定的目录，里面有一个目录是 workflows
• workflow 是一个可配置的自动化流程，它可以包含多个jobs
  • 通过在 .github/workflows 添加 .yml 配置文件实现 1个 workflow
  • 一个工程可以包含多个 workflow
  • 参考：https://docs.github.com/cn/actions/learn-github-actions/understanding-github-actions#workflows
• 在 workflows 下包含了所有 .yml 结尾的文件
  • yaml 是一种标记语言，可读性较好，适合编写配置文件
• 有多少 yml 文件都会并发执行
• 每个 workflow 都通过 event 来触发
  • 比如 pull request, push 或 open issue, 也可以自定义事件
  • 如：https://docs.github.com/cn/actions/learn-github-actions/events-that-trigger-workflows
• 每个 workflow 包含若干 job
  • job 是 workflow 当中一系列的可执行步骤，每个 job 是在同一个 runner 中进行的
  • runner 是指处于 github 的一台特殊的虚拟机，支持各种操作系统
  • 每个步骤或是一个 shell 脚本，亦或是一个可执行的action
  • 每个步骤是按照顺序执行，并且互相依赖
• 每个 job 包含若干 step, 这里的stop 就是 cmd 或 action
  • 这里 action 就是 一些列 shell 的组合或传参的封装
• Action 是 github action 中的一个自定义应用，它可以以运行一系列复杂的并且常用的任务
  • 使用 action 可以帮我们减少在 workflow 中写重复代码
  • github 提供了非常多常用的action
  • 可以再这里查阅: https://github.com/marketplace?type=actions
  • 同时，我们也可以写自己的 action

3 ）yml 配置示例

• 在项目目录下新建 .github/workflows 目录, 在里面 新建 test.yml

  name: Github Actions Test
  on: [push]
  jobs:
      Test:
          runs-on: ubuntu-latest
          steps:
              - run: echo "hello test"
              - run: echo "${{ github.event_name }}"
  

• 可以看到，在里面可以使用环境变量和自定义变量, 同时，类似 jobs 下可定义多个任务，比如 再加一个 Test2

• 参考：https://docs.github.com/en/actions/learn-github-actions/environment-variables

• 上面的简单示例可以很明白的看清楚会发生什么

• 我们把代码提交到github, 在github的action上就会出现一条记录

• 点进去就可以看到具体运行的 job

多 workflow 演示

• 在上面 test.yml 同级，新增 test2.yml

  name: Github Actions Test2
  on: [push]
  jobs:
      Test2:
          runs-on: ubuntu-latest
          steps:
              - run: echo "hello test2"
              - run: echo "${{ github.action }}"
              - run: echo "${{ github.ref }}"
              - run: echo "${{ github.repository }}"
  

• 这样，再次提交运行，就可以重新运行这2个 workflow 了

• 如果没有触发，可能由于提交到真实的主机上，或workspaces 目录或具体配置错误