Vlastní Forgejo Runner na Codebergu: Jak si postavit CI/CD bez cizí infrastruktury
Proč si hostovat vlastní CI/CD runner?
Codeberg se stal oblíbenou alternativou k GitHubu. Stojí na Forgejo a spravuje ho nezisková organizace, která klade důraz na soukromí a komunitu. Přesto má jako každý provozovatel omezené zdroje. Sdílené běhové prostředí tam proto není vždy nejrychlejší.
Mnoho lidí proto přechází na vlastní Forgejo runner. Výhoda je v tom, že runner sám navazuje spojení směrem ven. Díky tomu ho můžete spustit na VPS, domácím serveru i na notebooku – bez nutnosti otevírat porty.
Máte nápad? Najděte pro něj dokonalou doménu
Náš AI generátor doménových jmen navrhuje volná jména napříč stovkami koncovek. SSL, DNS a ochrana soukromí Whois zdarma v ceně.
Jak to celé funguje
Runner je v podstatě pracovník, který přijímá úkoly z Codebergu a spouštějí je. Abychom ho ochránili, izolujeme ho pomocí Docker-in-Docker. Runner tak vytváří kontejnery, aniž by sahal na Docker vašeho hostitele.
Docker Compose nastavení
Základem je jednoduché dvoukontejnerové řešení:
version: '3.8'
services:
docker-in-docker:
image: docker:dind
container_name: 'docker_dind'
privileged: 'true'
command: ['dockerd', '-H', 'tcp://0.0.0.0:2375', '--tls=false']
restart: 'unless-stopped'
runner:
image: 'data.forgejo.org/forgejo/runner:12'
links:
- docker-in-docker
depends_on:
docker-in-docker:
condition: service_started
container_name: 'runner'
environment:
DOCKER_HOST: tcp://docker-in-docker:2375
user: 1001:1001
volumes:
- ./data:/data
restart: 'unless-stopped'
command: 'forgejo-runner daemon --config runner-config.yml'
První kontejner poskytuje izolované Docker prostředí. Druhý pak komunikuje s tímto prostředí.
Příprava systému
Před spuštěním kontejnerů si připravte strukturu. Vytvořte na serveru novou adresář odkazující na /opt/forgejo-runner,navigujte k ní a pak větí:
cd /opt/forgejo-runner
mkdir -p data/.cache
chown -R 1001:1001 data
chmod 775 data/.cache
chmod g+s data/.cache
Potom generujte konfigurační soubor:
sudo sh -c 'docker run --rm data.forgejo.org/forgejo/runner:12 forgejo-runner generate-config > data/runner-config.yml'
Jak runner zaregistrovat na Codebergu
Go to your Codeberg account or organization settings → Actions → Runners. Vytvořte nový runner, která has a memorable name. Codeberg pak generuje UUID a token – ty si hned zapisujte. Tyto údaje umožňují runneru komunikovat s Codebergu.
Labels a capacity
V souboru runner-config.yml upravte dvě hlavní části.
1. Server konfigurace
Přidejte UUID a token, kteray Codeberg poskytl.
2. Labels
Labels jsou značky, ktery workflows ovladají. Příklad:
labels:
- 'ubuntu-latest:docker://node:20-bookworm'
- 'ubuntu-22.04:docker://node:20-bookworm'
- 'ubuntu-24.04:docker://node:22-bookworm'
When a workflow specifies runs-on: ubuntu-latest, Codeberg finds the runner with that label. This is your matchmaking system between jobs and runners.
Optional: Adjust Capacity
Default je 1 job per runner. Pokud má server dostatečné zdroje, můžete capacity zvýšit.
Jak spustit runner
Once your configuration is complete, start the runner:
docker-compose up -d
Monitorujte logy:
docker-compose logs -f runner
Co si všimnete na výkonu
By self-hosting your runner, you'll experience:
- Rychlejší spuštění – žádné čekání v queue
- Plná kontrola nad CI/CD prostředí
- Úspora a podpora neziskové organizace
- Soukromí – logy zůstávají u vás
- Flexibilita – můžete rozšířit podle potřeby
Závěr
Nastavení vlastního Forgejo runneru je jednoduchý projekt, který se vyplatí ihned. Pokud už Codeberg používáte, je to přirozený další krok.
Máte nápad? Najděte pro něj dokonalou doménu
Náš AI generátor doménových jmen navrhuje volná jména napříč stovkami koncovek. SSL, DNS a ochrana soukromí Whois zdarma v ceně.