259238eedf
docs(detached-note): add runner user guide and update deployment examples
...
Add comprehensive GUIDE.md (1000+ lines) covering GitCaddy Runner installation, registration, configuration, deployment options (Docker, Kubernetes, VM), workflow examples, artifact handling, cache server setup, and troubleshooting.
Update all deployment example READMEs with improved instructions and clarifications for Docker Compose, Kubernetes (DinD and rootless), and VM deployments. Enhance YAML configurations with better comments and security practices.
2026-01-27 22:50:23 -05:00
armistace
8dfb805c62
Update examples/kubernetes/dind-docker.yaml to reflect recent changes to Dockerfile ( #633 )
...
With the changes made two months ago for the Dockerfile /opt/act/run.sh no longer exists in the docker container, this caused this example to fail, updating the example so that it correctly references run.sh now located in /usr/local/bin
I have used this to deploy on my own cluster and it is now working swimmingly
Reviewed-on: https://gitea.com/gitea/act_runner/pulls/633
Reviewed-by: Zettat123 <zettat123@noreply.gitea.com >
Reviewed-by: techknowlogick <techknowlogick@noreply.gitea.com >
Co-authored-by: armistace <armistace@noreply.gitea.com >
Co-committed-by: armistace <armistace@noreply.gitea.com >
2025-01-26 02:10:17 +00:00
Zettat123
a7080f5457
Update examples for GITEA_RUNNER_REGISTRATION_TOKEN env ( #630 )
...
For https://github.com/go-gitea/gitea/pull/32946
Reviewed-on: https://gitea.com/gitea/act_runner/pulls/630
Reviewed-by: Lunny Xiao <lunny@noreply.gitea.com >
Reviewed-by: techknowlogick <techknowlogick@noreply.gitea.com >
Co-authored-by: Zettat123 <zettat123@gmail.com >
Co-committed-by: Zettat123 <zettat123@gmail.com >
2025-01-05 22:25:32 +00:00
frank-dspeed
0e2a3e00f5
examples/vm/rootless-docker.md aktualisiert ( #487 )
...
Depending on the VM's existing users the id can vary
Reviewed-on: https://gitea.com/gitea/act_runner/pulls/487
Reviewed-by: techknowlogick <techknowlogick@noreply.gitea.com >
Reviewed-by: Lunny Xiao <xiaolunwen@gmail.com >
Co-authored-by: frank-dspeed <frank-dspeed@noreply.gitea.com >
Co-committed-by: frank-dspeed <frank-dspeed@noreply.gitea.com >
2024-09-30 01:55:04 +00:00
Schallbert
b282356e9e
update example for docker-compose to allow fix 502 errors in case Gitea not yet ready on runner startup ( #605 )
...
Minimalistic approach: Only adds what is needed to fix #600
Context: https://blog.schallbert.de/en/fix-gitea-runner/
Reviewed-on: https://gitea.com/gitea/act_runner/pulls/605
Reviewed-by: Lunny Xiao <xiaolunwen@gmail.com >
Reviewed-by: Zettat123 <zettat123@noreply.gitea.com >
Co-authored-by: Schallbert <schallbert@mailbox.org >
Co-committed-by: Schallbert <schallbert@mailbox.org >
2024-09-26 05:54:54 +00:00
vilunov
4c35288175
Add DIND docker-compose example ( #365 )
...
Co-authored-by: Nikita Vilunov <nikita@vilunov.me >
Reviewed-on: https://gitea.com/gitea/act_runner/pulls/365
Reviewed-by: Lunny Xiao <xiaolunwen@gmail.com >
Co-authored-by: vilunov <vilunov@noreply.gitea.com >
Co-committed-by: vilunov <vilunov@noreply.gitea.com >
2023-10-02 15:12:31 +00:00
Andrew Imeson
990db1bfc0
Fix k8s rootless Docker filesystem permissions ( #366 )
...
Without this the deployment fails because the runner can't write to
/data/
Credit to @ccureau for identifying the fix
Relates to: gitea/act_runner#264
Reviewed-on: https://gitea.com/gitea/act_runner/pulls/366
Reviewed-by: techknowlogick <techknowlogick@noreply.gitea.com >
Co-authored-by: Andrew Imeson <andrew@andrewimeson.com >
Co-committed-by: Andrew Imeson <andrew@andrewimeson.com >
2023-10-02 15:12:14 +00:00
m90
10dc6fb60d
Allow reading registration token from file ( #350 )
...
When deploying the runner in a Docker Swarm setup, it can be useful to
read the potentially sensitive token from a secret instead of having to
pass it from an environment variable.
Co-authored-by: Frederik Ring <frederik.ring@gmail.com >
Reviewed-on: https://gitea.com/gitea/act_runner/pulls/350
Reviewed-by: Jason Song <i@wolfogre.com >
Reviewed-by: Lunny Xiao <xiaolunwen@gmail.com >
Co-authored-by: m90 <m90@noreply.gitea.com >
Co-committed-by: m90 <m90@noreply.gitea.com >
2023-09-04 04:12:07 +00:00
Jason Song
316534996a
Build docker image gitea/act_runner/x.y.z-dind-rootless ( #239 )
...
Follow #208
Reviewed-on: https://gitea.com/gitea/act_runner/pulls/239
Reviewed-by: Zettat123 <zettat123@noreply.gitea.com >
2023-06-15 05:27:35 +00:00
ccureau
341d49a24d
implement act_runner rootless image ( #208 )
...
This PR creates a rootless Docker image that runs both `dockerd` and `act_runner` using `supervisord`. It has been tested locally for a few days and seems stable.
Co-authored-by: ccureau <ccureau@noreply.gitea.io >
Reviewed-on: https://gitea.com/gitea/act_runner/pulls/208
Reviewed-by: Jason Song <i@wolfogre.com >
Co-authored-by: ccureau <ccureau@noreply.gitea.com >
Co-committed-by: ccureau <ccureau@noreply.gitea.com >
2023-06-12 06:35:27 +00:00
Bo-Yi Wu
a83f29d5a9
docs: improve examples README and organization ( #230 )
...
- Update the introduction and descriptions in the examples README
- Add a table with descriptions for each section (docker, docker-compose, kubernetes, vm)
Signed-off-by: Bo-Yi Wu <appleboy.tw@gmail.com >
Reviewed-on: https://gitea.com/gitea/act_runner/pulls/230
Reviewed-by: techknowlogick <techknowlogick@noreply.gitea.com >
Reviewed-by: Lunny Xiao <xiaolunwen@gmail.com >
Co-authored-by: Bo-Yi Wu <appleboy.tw@gmail.com >
Co-committed-by: Bo-Yi Wu <appleboy.tw@gmail.com >
2023-06-06 02:42:58 +00:00
Chris Cureau
a384adbbc6
Documentation enhancements ( #207 )
...
This PR addresses the issue listed in issue #170 regarding how to set up rootless Docker. It also expands on the documentation to show how to create deployments for different environments.
Co-authored-by: ccureau <ccureau@noreply.gitea.io >
Reviewed-on: https://gitea.com/gitea/act_runner/pulls/207
Reviewed-by: Jason Song <i@wolfogre.com >
Co-authored-by: Chris Cureau <cmcureau@gmail.com >
Co-committed-by: Chris Cureau <cmcureau@gmail.com >
2023-06-05 08:46:15 +00:00