Please enable Javascript to view the contents

如何给 GitHub Actions 添加自己的 Runner 主机

 ·  ☕ 3 分钟

1. 什么是 GitHub Actions

在前面的文档中,我对 GitLab 提供的 CI 功能进行了实践,点击查看 。使用 GitLab 的好处是可以私有化部署、无限的私有仓库数量、CI 配置简单、能接入自建的 Runner 。但随着 GitHub 越来越开放,GitLab 的这些优势在逐步丧失。

从 CICD 的角度看,越接近 Git 仓库的功能,越贴近开发者。未来的开发者市场上,GitHub、GitLab、Coding、Gitee 这样的 SaaS 平台将具有很顽强的生命力。

GitHub Actions 是一个类似 GitLab CI 的服务。GitLab 默认使用的是 .gitlab-ci.yml 文件,描述 CICD 流程。而 GitHub 使用的是 .github/workflows 目录下的 yaml 文件。最大的不同在于,GitHub 提供了一个 Actions 市场,开发者可以基于这些原子快速编排流程。

我在文档 使用镜像部署 Hexo 静态页面 中,使用下面的 yaml 配置进行编译和推送镜像:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
name: build

on: [push]

jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout
        uses: actions/checkout@v2

      - name: Build image
        run: make build

      - name: Login Registry
        uses: docker/login-action@v1
        with:
          registry: ghcr.io
          username: ${{ github.repository_owner }}
          password: ${{ secrets.GHCR_TOKEN }}

      - name: Push image
        run:
          docker push ghcr.io/shaowenchen/documents:latest

每次 push 代码之后,Actions 就会自动运行,如下图:

这种方式对开发者十分友好,如果网络通畅,GitHub Actions 能够满足很多团队的 CICD 需求。

2. 什么时候需要接入自己 Runner

2.1 对构建机器有要求

目前,GitLab 只提供了下面几类运行环境:

  • windows
  • ubuntu
  • macos

但并不是每个版本的系统都支持,目前只能使用指定的版本,也无法指定 CPU 架构。

另一方面,在构建过程当中,GitHub 提供的构建机,对物理资源也有所限制。构建虚拟机的配置如下:

  • 2 core CPUs
  • 7 GB of RAM memory
  • 14 GB of SSD disk space

可能在未来,相关的物理资源配置会有所提升,但始终会有限制。当需要构建某些大型项目,特别是 C++ 项目时,这样的物理资源配置是不能够满足要求的。

2.2 私有仓库需要大量构建

下图是目前 GitHub 官方给出的构建报价:

非常幸运的是公开仓库免费使用,只有私有仓库的额度有限制。不同付费级别的用户,具有不同的构建时长。需要注意的是,这里的时长指的是 Linux 的构建时长。Windows 使用一分钟,折算为 Linux 的两分钟。MacOS 使用一分钟,折算为 Linux 的十分钟。

对私有仓库有大量构建需求的项目,使用 GitHub Actions 提供的构建机性价比不高。

3. 添加主机 Runner

这里的 Runner 指的是 GitHub Actions 的运行环境,也就是 .github/workflows 文件夹下 yaml 中指令的运行环境。这里主要添加主机 Runner,如果是添加容器或者 Kubernetes Runner ,需要将 actions-runner 打包到镜像中,然后运行接入 GitHub Actions,在其他方面没有差别。

首先进入项目,在 Settings 页面中,找到 Actions 。

点击上图的 Add runner 进入下图的添加主机页面,同样支持三种操作系统,macOS、Linux、Windows。

在页面选择操作系统和架构之后,按照安装提示操作即可。

  • 新建用户 runner:runner
1
2
3
4
groupadd -g 1234 runner
useradd runner -u 1234 -g 1234
su runner
cd ~
  • 下载 Runner
1
2
3
mkdir actions-runner && cd actions-runner
curl -O -L https://github.com/actions/runner/releases/download/v2.274.2/actions-runner-linux-x64-2.274.2.tar.gz
tar xzf ./actions-runner-linux-x64-2.274.2.tar.gz
  • 配置 Runner

在这一步中,可能需要根据提示。执行命令 su root,切换到 root 用户,执行 ./bin/installdependencies.sh 安装依赖。

执行 config.sh 开始配置:

1
./config.sh --url https://github.com/shaowenchen/pipeline-test --token AKNLJON6JWRTO35GV3PXGVS7ZHPZO

根据命令的提示,进行如下交互:

Enter the name of runner: [press Enter for node1] mycentos

This runner will have the following labels: 'self-hosted', 'Linux', 'X64'
Enter any additional labels (ex. label-1,label-2): [press Enter to skip] centos

√ Runner successfully added
√ Runner connection is good

# Runner settings

Enter name of work folder: [press Enter for _work] /home/runner/workspaces

√ Settings Saved.
  • 运行 Runner
1
./run.sh
  • 页面查看 Runner

在 GitHub 的 Actions 页面可以看到新增加的 Runner。

4. 使用测试

  • 添加 workflows 文件

在项目 master 分支,增加文件 .github/workflows/blank.yml ,内容如下:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
name: CI
on:
  push:
    branches: [ master ]

jobs:
  hello:
    runs-on: self-hosted
    steps:
      - uses: actions/checkout@v2

      - name: Run a multi-line script
        run: |
          date
          uname -a          
  • 查看运行结果

提交文件之后,Actions 马上就会开始运行,执行结果如下图:

  • 查看节点上的 workspaces
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
tree -L 3 /home/runner/workspaces/

/home/runner/workspaces/
|-- _actions
|   `-- actions
|       `-- checkout
|-- _PipelineMapping
|   `-- shaowenchen
|       `-- pipeline-test
|-- pipeline-test
|   `-- pipeline-test
|       |-- a
|       |-- choice
|       |-- deploy
|       |-- Jenkinsfile
|       |-- plain-credential
|       `-- readme.md
|-- _temp
`-- _tool

从 workspaces 中的文件可以看到,Actions 将代码 checkout 到主机上,然后在主机上执行了编排命令。

5. 参考


微信公众号
作者
微信公众号