2022-04-27 17:45:53 +08:00
# act runner
2023-03-22 14:48:35 +08:00
Act runner is a runner for Gitea based on [Gitea fork ](https://gitea.com/gitea/act ) of [act ](https://github.com/nektos/act ).
2022-10-07 20:59:02 +08:00
2023-03-14 13:39:12 +08:00
## Installation
### Prerequisites
2023-01-03 11:13:55 +08:00
2023-04-13 04:17:08 +08:00
Docker Engine Community version is required for docker mode. To install Docker CE, follow the official [install instructions ](https://docs.docker.com/engine/install/ ).
2023-01-03 11:13:55 +08:00
2023-03-14 13:39:12 +08:00
### Download pre-built binary
2023-05-04 09:36:31 +08:00
Visit [here ](https://dl.gitea.com/act_runner/ ) and download the right version for your platform.
2022-10-07 20:59:02 +08:00
2023-03-14 13:39:12 +08:00
### Build from source
2022-10-07 20:59:02 +08:00
2022-11-24 23:19:25 +08:00
```bash
2022-11-24 16:34:29 +08:00
make build
2022-10-07 20:59:02 +08:00
```
2022-11-24 16:34:29 +08:00
2023-04-13 04:17:08 +08:00
### Build a docker image
```bash
make docker
```
2023-03-14 13:39:12 +08:00
## Quickstart
2023-07-24 13:11:42 +08:00
Actions are disabled by default, so you need to add the following to the configuration file of your Gitea instance to enable it:
```ini
[actions]
ENABLED=true
```
2022-11-24 23:19:25 +08:00
### Register
2022-11-24 16:34:29 +08:00
2022-11-24 23:19:25 +08:00
```bash
2022-11-24 16:34:29 +08:00
./act_runner register
```
And you will be asked to input:
2022-11-25 00:40:00 +08:00
1. Gitea instance URL, like `http://192.168.8.8:3000/` . You should use your gitea instance ROOT_URL as the instance argument
and you should not use `localhost` or `127.0.0.1` as instance IP;
2023-07-24 13:11:42 +08:00
2. Runner token, you can get it from `http://192.168.8.8:3000/admin/actions/runners` ;
2022-11-24 16:34:29 +08:00
3. Runner name, you can just leave it blank;
4. Runner labels, you can just leave it blank.
The process looks like:
2022-11-24 23:19:25 +08:00
2022-11-24 16:34:29 +08:00
```text
INFO Registering runner, arch=amd64, os=darwin, version=0.1.5.
WARN Runner in user-mode.
INFO Enter the Gitea instance URL (for example, https://gitea.com/):
2022-11-25 00:40:00 +08:00
http://192.168.8.8:3000/
2022-11-24 16:34:29 +08:00
INFO Enter the runner token:
fe884e8027dc292970d4e0303fe82b14xxxxxxxx
2023-03-22 14:48:35 +08:00
INFO Enter the runner name (if set empty, use hostname: Test.local):
2022-11-24 16:34:29 +08:00
2024-04-02 15:38:14 +08:00
INFO Enter the runner labels, leave blank to use the default labels (comma-separated, for example, ubuntu-latest:docker://gitea/runner-images:ubuntu-latest):
2022-11-24 16:34:29 +08:00
2024-04-02 15:38:14 +08:00
INFO Registering runner, name=Test.local, instance=http://192.168.8.8:3000/, labels=[ubuntu-latest:docker://gitea/runner-images:ubuntu-latest ubuntu-22.04:docker://gitea/runner-images:ubuntu-22.04 ubuntu-20.04:docker://gitea/runner-images:ubuntu-20.04].
2022-11-24 16:34:29 +08:00
DEBU Successfully pinged the Gitea instance server
INFO Runner registered successfully.
```
2022-11-25 00:40:00 +08:00
You can also register with command line arguments.
```bash
./act_runner register --instance http://192.168.8.8:3000 --token < my_runner_token > --no-interactive
```
If the registry succeed, it will run immediately. Next time, you could run the runner directly.
2022-11-24 23:19:25 +08:00
### Run
2022-11-24 16:34:29 +08:00
2022-11-24 23:19:25 +08:00
```bash
2022-11-24 16:34:29 +08:00
./act_runner daemon
2023-03-14 13:39:12 +08:00
```
2023-04-02 22:41:48 +08:00
2023-07-12 09:43:26 +08:00
### Run with 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/act_runner:nightly
```
2023-04-02 22:41:48 +08:00
### Configuration
You can also configure the runner with a configuration file.
The configuration file is a YAML file, you can generate a sample configuration file with `./act_runner generate-config` .
```bash
./act_runner generate-config > config.yaml
```
You can specify the configuration file path with `-c` /`--config` argument.
```bash
./act_runner -c config.yaml register # register with config file
2023-05-11 14:25:39 +08:00
./act_runner -c config.yaml daemon # run with config file
2023-04-02 22:41:48 +08:00
```
2023-04-13 04:17:08 +08:00
2024-04-02 15:38:14 +08:00
You can read the latest version of the configuration file online at [config.example.yaml ](internal/pkg/config/config.example.yaml ).
2023-06-05 16:46:15 +08:00
### Example Deployments
2023-04-13 04:17:08 +08:00
2023-06-05 16:46:15 +08:00
Check out the [examples ](examples ) directory for sample deployment types.