如何给 GitHub Actions 添加自己的超大资源 Runner 主机

更多奇技淫巧欢迎订阅博客：https://fuckcloudnative.io

前言

1. 什么是 GitHub Actions

在前面的文档中，我对 GitLab 提供的 CI 功能进行了实践，点击查看^[1] 。使用 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 静态页面^[2] 中，使用下面的 yaml 配置进行编译和推送镜像:

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

对构建机器有要求

目前，GitHub 只提供了下面几类运行环境:

• windows

• ubuntu

• macos

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

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

• 2 core CPUs

• 7 GB of RAM memory

• 14 GB of SSD disk space

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

私有仓库需要大量构建

下图是目前 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

$ groupadd -g 1234 runner
$ useradd runner -u 1234 -g 1234
$ su runner
$ cd ~

• 下载 Runner

$ 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 开始配置:

$ ./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

$ ./run.sh

• 页面查看 Runner

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

4. 使用测试

• 添加 workflows 文件

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

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

$ 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 到主机上，然后在主机上执行了编排命令。

参考

• https://github.com/features/actions

• https://docs.github.com/en/free-pro-team@latest/actions/hosting-your-own-runners/about-self-hosted-runners

参考资料

[1]

点击查看: https://www.chenshaowen.com/blog/tag/GitLab/

[2]

使用镜像部署 Hexo 静态页面: https://www.chenshaowen.com/blog/deploy-static-server-by-docker-image.html

你可能还喜欢

点击下方图片即可阅读

将 Docker 踢出群聊后，Kubernetes 还能否欢快地跑 GPU？当然能！

云原生是一种信仰 ????

扫码关注公众号

后台回复◉k8s◉获取史上最方便快捷的 Kubernetes 高可用部署工具，只需一条命令，连 ssh 都不需要！

点击 "阅读原文" 获取更好的阅读体验！

❤️给个「在看」，是对我最大的支持❤️