mirror of https://code.forgejo.org/forgejo/runner
cleanup the examples section, remove unsupported elements
Earl Warren
parent
b9e3e5b62d
commit
9d79a0b92d
|
|
@ -1,12 +1,7 @@
|
||||||
# Usage Examples for `act_runner`
|
A collection of usage and deployment examples.
|
||||||
|
|
||||||
Welcome to our collection of usage and deployment examples specifically designed for Gitea setups. Whether you're a beginner or an experienced user, you'll find practical resources here that you can directly apply to enhance your Gitea experience. We encourage you to contribute your own insights and knowledge to make this collection even more comprehensive and valuable.
|
|
||||||
|
|
||||||
| Section | Description |
|
| Section | Description |
|
||||||
|-----------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
|
|-----------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
|
||||||
| [`docker`](docker) | This section provides you with scripts and instructions tailored for running containers on a workstation or server where Docker is installed. It simplifies the process of setting up and managing your Gitea deployment using Docker. |
|
| [`docker`](docker) | using the host docker server by mounting the socket |
|
||||||
| [`docker-compose`](docker-compose) | In this section, you'll discover examples demonstrating how to utilize docker-compose to efficiently handle your Gitea deployments. It offers a straightforward approach to managing multiple containerized components of your Gitea setup. |
|
| [`docker-compose`](docker-compose) | all in one docker-compose with the Forgejo server, the runner and docker in docker |
|
||||||
| [`kubernetes`](kubernetes) | If you're utilizing Kubernetes clusters for your infrastructure, this section is specifically designed for you. It presents examples and guidelines for configuring Gitea deployments within Kubernetes clusters, enabling you to leverage the scalability and flexibility of Kubernetes. |
|
| [`kubernetes`](kubernetes) | a sample deployment for the Forgejo runner |
|
||||||
| [`vm`](vm) | This section is dedicated to examples that assist you in setting up Gitea on virtual or physical servers. Whether you're working with virtual machines or physical hardware, you'll find helpful resources to guide you through the deployment process. |
|
|
||||||
|
|
||||||
We hope these resources provide you with valuable insights and solutions for your Gitea setup. Feel free to explore, contribute, and adapt these examples to suit your specific requirements.
|
|
||||||
|
|
|
||||||
|
|
@ -1,8 +1,12 @@
|
||||||
### Run `act_runner` in a Docker Container
|
The following assumes:
|
||||||
|
|
||||||
|
* a docker server runs on the host
|
||||||
|
* the docker group of the host is GID 133
|
||||||
|
* a `.runner` file exists in /tmp/data
|
||||||
|
* a `runner-config.yml` file exists in /tmp/data
|
||||||
|
|
||||||
```sh
|
```sh
|
||||||
docker run -e GITEA_INSTANCE_URL=http://192.168.8.18:3000 -e GITEA_RUNNER_REGISTRATION_TOKEN=<runner_token> -v /var/run/docker.sock:/var/run/docker.sock -v $PWD/data:/data --name my_runner gitea/act_runner:nightly
|
docker run -v /var/run/docker.sock:/var/run/docker.sock -v /tmp/data:/data --user 1000:133 --rm code.forgejo.org/forgejo/runner:3.0.0 forgejo-runner --config runner-config.yaml daemon
|
||||||
```
|
```
|
||||||
|
|
||||||
The `/data` directory inside the docker container contains the runner API keys after registration.
|
The workflows will run using the host docker srever
|
||||||
It must be persisted, otherwise the runner would try to register again, using the same, now defunct registration token.
|
|
||||||
|
|
|
||||||
|
|
@ -1,6 +0,0 @@
|
||||||
## `act_runner` on Virtual or Physical Servers
|
|
||||||
|
|
||||||
Files in this directory:
|
|
||||||
|
|
||||||
- [`rootless-docker.md`](rootless-docker.md)
|
|
||||||
How to set up a rootless docker implementation of the runner.
|
|
||||||
|
|
@ -1,87 +0,0 @@
|
||||||
## Using Rootless Docker with`act_runner`
|
|
||||||
|
|
||||||
Here is a simple example of how to set up `act_runner` with rootless Docker. It has been created with Debian, but other Linux should work the same way.
|
|
||||||
|
|
||||||
Note: This procedure needs a real login shell -- using `sudo su` or other method of accessing the account will fail some of the steps below.
|
|
||||||
|
|
||||||
As `root`:
|
|
||||||
|
|
||||||
- Create a user to run both `docker` and `act_runner`. In this example, we use a non-privileged account called `rootless`.
|
|
||||||
|
|
||||||
```bash
|
|
||||||
useradd -m rootless
|
|
||||||
passwd rootless
|
|
||||||
```
|
|
||||||
|
|
||||||
- Install [`docker-ce`](https://docs.docker.com/engine/install/)
|
|
||||||
- (Recommended) Disable the system-wide Docker daemon
|
|
||||||
|
|
||||||
``systemctl disable --now docker.service docker.socket``
|
|
||||||
|
|
||||||
As the `rootless` user:
|
|
||||||
|
|
||||||
- Follow the instructions for [enabling rootless mode](https://docs.docker.com/engine/security/rootless/)
|
|
||||||
- Add the following lines to the `/home/rootless/.bashrc`:
|
|
||||||
|
|
||||||
```bash
|
|
||||||
export XDG_RUNTIME_DIR=/home/rootless/.docker/run
|
|
||||||
export PATH=/home/rootless/bin:$PATH
|
|
||||||
export DOCKER_HOST=unix:///run/user/1001/docker.sock
|
|
||||||
```
|
|
||||||
|
|
||||||
- Reboot. Ensure that the Docker process is working.
|
|
||||||
- Create a directory for saving `act_runner` data between restarts
|
|
||||||
|
|
||||||
`mkdir /home/rootless/act_runner`
|
|
||||||
|
|
||||||
- Register the runner from the data directory
|
|
||||||
|
|
||||||
```bash
|
|
||||||
cd /home/rootless/act_runner
|
|
||||||
act_runner register
|
|
||||||
```
|
|
||||||
|
|
||||||
- Generate a `act_runner` configuration file in the data directory. Edit the file to adjust for the system.
|
|
||||||
|
|
||||||
```bash
|
|
||||||
act_runner generate-config >/home/rootless/act_runner/config
|
|
||||||
```
|
|
||||||
|
|
||||||
- Create a new user-level`systemd` unit file as `/home/rootless/.config/systemd/user/act_runner.service` with the following contents:
|
|
||||||
|
|
||||||
```bash
|
|
||||||
Description=Gitea Actions runner
|
|
||||||
Documentation=https://gitea.com/gitea/act_runner
|
|
||||||
After=docker.service
|
|
||||||
|
|
||||||
[Service]
|
|
||||||
Environment=PATH=/home/rootless/bin:/sbin:/usr/sbin:/home/rootless/bin:/home/rootless/bin:/home/rootless/bin:/usr/local/bin:/usr/bin:/bin:/usr/local/games:/usr/games
|
|
||||||
Environment=DOCKER_HOST=unix:///run/user/1001/docker.sock
|
|
||||||
ExecStart=/usr/bin/act_runner daemon -c /home/rootless/act_runner/config
|
|
||||||
ExecReload=/bin/kill -s HUP $MAINPID
|
|
||||||
WorkingDirectory=/home/rootless/act_runner
|
|
||||||
TimeoutSec=0
|
|
||||||
RestartSec=2
|
|
||||||
Restart=always
|
|
||||||
StartLimitBurst=3
|
|
||||||
StartLimitInterval=60s
|
|
||||||
LimitNOFILE=infinity
|
|
||||||
LimitNPROC=infinity
|
|
||||||
LimitCORE=infinity
|
|
||||||
TasksMax=infinity
|
|
||||||
Delegate=yes
|
|
||||||
Type=notify
|
|
||||||
NotifyAccess=all
|
|
||||||
KillMode=mixed
|
|
||||||
|
|
||||||
[Install]
|
|
||||||
WantedBy=default.target
|
|
||||||
```
|
|
||||||
|
|
||||||
- Reboot
|
|
||||||
|
|
||||||
After the system restarts, check that the`act_runner` is working and that the runner is connected to Gitea.
|
|
||||||
|
|
||||||
````bash
|
|
||||||
systemctl --user status act_runner
|
|
||||||
journalctl --user -xeu act_runner
|
|
||||||
Loading…
Reference in New Issue