04-19 周五 GitHub actions-runner 程序解释

04-19 周五 GitHub actions-runner 程序解释

时间	版本	修改人	描述
2024年4月19日17:26:17	V0.1	宋全恒	新建文档

简介

 本文主要描述了actions-runner-linux-x64-2.315.0.tar.gz这个github actions CI所需要的客户端安装包的重要文件和内容信息。有关GitHub actions 的配置，使用，还可以参考如下相关的文件:

• 04-15 周一 GitHub仓库CI服务器配置过程与workflow配置文件解析文档.md
• 04-18 周四 为LLM_inference项目配置GitHub CI过程记录.md
• 04-19 周四 GitHub CI 方案设计和部署拓扑.md

actions-runner

关于仓库

 actions-runner托管于GitHub，其主要功能是:

The runner is the application that runs a job from a GitHub Actions workflow. It is used by GitHub Actions in the hosted virtual environments, or you can self-host the runner in your own environment.

 其主要支持的宿主机系统如下所示:

 下载地址。我们主要是关注Linux的。当前最新的版本是2.315.0

注，上述图片中显示当前支持的系统架构和系统。并且actions-runner客户端平均三周左右会出新版本。客户端在与GitHub Server的过程中会自动下载最新版本和更新。

配置变化

 下图演示了在为客户端配置仓库之前和之后文件的变化。

 可以看出，解压的actions-runner是不包含如组织下7个隐藏文件的，这些文件记录了config.sh执行产生的内容，这些信息具体如下图:

svc.sh

 用户最常用的大概是生成的svc.sh，因为可以通过这个命令查看该actions-runner的运行状态，并且管理其停止，卸载，安装。

yangfei@ubuntu:~/actions-ci$ sudo ./svc.sh status
[sudo] password for yangfei: 

/etc/systemd/system/actions.runner.CodexDive-LLMChat.42-application-runner.service
● actions.runner.CodexDive-LLMChat.42-application-runner.service - GitHub Actions Runner (CodexDive-LLMChat.42-application-runner)
     Loaded: loaded (/etc/systemd/system/actions.runner.CodexDive-LLMChat.42-application-runner.service; enabled; vendor preset: enabled)
     Active: active (running) since Thu 2024-04-18 08:57:47 UTC; 24h ago
   Main PID: 536962 (runsvc.sh)
      Tasks: 28 (limit: 629145)
     Memory: 161.0M
     CGroup: /system.slice/actions.runner.CodexDive-LLMChat.42-application-runner.service
             ├─536962 /bin/bash /home/yangfei/actions-ci/runsvc.sh
             ├─536965 ./externals/node16/bin/node ./bin/RunnerService.js
             └─536989 /home/yangfei/actions-ci/bin/Runner.Listener run --startuptype service

Apr 19 07:11:03 ubuntu runsvc.sh[536965]: 2024-04-19 07:11:03Z: Runner connect error: The HTTP request timed out after 00:01:00.. Retrying until reconnected.
Apr 19 07:12:14 ubuntu runsvc.sh[536965]: 2024-04-19 07:12:14Z: Runner reconnected.
Warning: journal has been rotated since unit was started, output may be incomplete.

注，svc.sh的执行，必须使用具有sudo权限的用户。

目录作用解析

 下图阐述了actions-runner运行目录中各个目录的作用，具体如下所示

总结

 本文主要是描述actions-runner-linux-x64-2.315.0.tar.gz这个客户端安装程序在配置(即向仓库注册runner)的前后文件的变更，重要的内容以及文件的作用。