| 时间 | 版本 | 修改人 | 描述 |
|---|---|---|---|
| 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)的前后文件的变更，重要的内容以及文件的作用。
