# Loong Runner

Loong Runner 是基于 [Gitea派生(fock)的act](https://gitea.com/gitea/act) 的 [二次派生](https://git.whlug.cn/LoongArchActions/loong_runner) 主要适用于当前龙架构的运行时。

> 上游的Gitea派生是可以直接在龙架构上编译使用的, 此派生仓库主要是解决上游的Docker是基于乌班图系统制作的, 目前龙架构暂无乌班图系统
> * 当前计划使用`Debian`来代替乌班图用于构建容器镜像


## 安装

### 前提条件

在 Docker 模式下需要 `Docker Engine Community` 版本。要安装 `Docker CE`，请遵循官方 [安装说明](https://docs.docker.com/engine/install/)。

### 下载预构建的二进制文件

访问 [这里](https://git.whlug.cn/LoongArchActions/loong_runner) 仅提供龙架构版本。

### 从源码构建

```bash
make build
```

### 构建 Docker 容器镜像

```bash
make docker
```

## 快速入门

默认情况下，操作是禁用的，因此您需要在 Gitea 实例的配置文件中添加以下内容以启用它：

```ini
[actions]
ENABLED=true
```

### 注册

```bash
./loong_runner register
```

系统将提示您输入：

1. Gitea 实例 URL，例如 `http://192.168.8.8:3000/`。您应该使用您的 Gitea 实例的 ROOT_URL 作为实例参数，并且不应使用 `localhost` 或 `127.0.0.1` 作为实例 IP；
2. 运行器令牌，您可以从 `http://192.168.8.8:3000/admin/actions/runners` 获取；
3. 运行器名称，您可以留空；
4. 运行器标签，您可以留空。

过程如下：

```text
INFO 注册运行器，架构=loong64，操作系统=linux，版本=0.1.5。
WARN 运行器处于用户模式。
INFO 输入 Gitea 实例 URL（例如，https://gitea.com/）：
http://192.168.8.8:3000/
INFO 输入运行器令牌：
fe884e8027dc292970d4e0303fe82b14xxxxxxxx
INFO 输入运行器名称（如果设置为空，则使用主机名：Test.local）：

INFO 输入运行器标签，留空以使用默认标签（逗号分隔，例如，debian-latest:docker://docker.gitea.com/runner-images:latest）

INFO 注册运行器，名称=Test.local，实例=http://192.168.8.8:3000/，标签=[debian-latest:docker://docker.gitea.com/runner-images:latest debian-sid:docker://docker.gitea.com/runner-images:debian-sid anolisos-latest:docker://lcr.loongnix.cn/library/anolisos:latest]。
DEBU 成功 ping 到 Gitea 实例服务器
INFO 运行器注册成功。
```

您也可以使用命令行参数进行注册。

```bash
./loong_runner register --instance http://192.168.8.8:3000 --token <my_runner_token> --no-interactive
```

如果注册成功，它将立即运行。下次，您可以直接运行运行器。

### 运行

```bash
./loong_runner daemon
```

### 使用 Docker 运行

```bash
docker run -e GITEA_INSTANCE_URL=https://your_gitea.com -e GITEA_RUNNER_REGISTRATION_TOKEN=<your_token> -v /var/run/docker.sock:/var/run/docker.sock --name my_runner gitea/loong_runner:nightly
```

### 配置

您还可以使用配置文件配置运行器。
配置文件是一个 YAML 文件，您可以使用 `./loong_runner generate-config` 生成一个示例配置文件。

```bash
./loong_runner generate-config > config.yaml
```

您可以使用 `-c`/`--config` 参数指定配置文件路径。

```bash
./loong_runner -c config.yaml register # 使用配置文件注册
./loong_runner -c config.yaml daemon # 使用配置文件运行
```

您可以在 [config.example.yaml](internal/pkg/config/config.example.yaml) 上在线查看配置文件的最新版本。

### 示例部署

查看 [examples](examples) 目录中的示例部署类型。