O que é o Forgejo Runner?
O Forgejo Runner é o runner de CI para o Forgejo Actions. É um daemon leve que se conecta à sua instância Forgejo, pega jobs de workflow enfileirados e os executa na sua própria infraestrutura — usando Docker, LXC ou diretamente o host — proporcionando um pipeline de CI/CD totalmente auto-hospedado e compatível com o GitHub Actions.
🚀 Por que as últimas versões são importantes: O runner acompanha de perto os lançamentos do Forgejo, adicionando suporte a novos recursos de workflow, melhor isolamento e correções de bugs. Mantê-lo atualizado garante compatibilidade com os recursos mais recentes do Forgejo Actions.
⚡ Principais Recursos do Forgejo Runner
🔁 Compatível com Actions
Executa workflows usando a mesma sintaxe e o mesmo ecossistema de actions do GitHub Actions.
🐳 Execução Flexível
Execute jobs em containers Docker, LXC ou diretamente na máquina host.
🔐 Auto-hospedado
Mantenha seu CI/CD totalmente em sua própria infraestrutura, sem dependência de terceiros.
⚖️ Escalável
Registre múltiplos runners com labels para distribuir e direcionar cargas de trabalho.
🎯 Por que o Forgejo Runner?
- Controle seu CI: Execute pipelines em hardware que você controla
- Ecossistema de Actions: Reutilize definições de workflow no estilo GitHub existentes
- Isolamento flexível: Execução via Docker, LXC ou host para atender às suas necessidades
- Leve: Um único binário Go, simples de implantar
🆕 Destaques
- Execução de Jobs: Executa workflows do Forgejo Actions enfileirados
- Labels: Direcione jobs para runners específicos
- Suporte a Containers: Builds isolados via Docker
- Modo Daemon: Executa continuamente como um serviço
📦 Instalação a partir do debian.griffo.io
Passo 1: Adicionar repositório
sudo install -d -m 0755 /etc/apt/keyrings
curl -fsSL https://debian.griffo.io/EA0F721D231FDD3A0A17B9AC7808B4DD62C41256.asc | sudo gpg --dearmor --yes -o /etc/apt/keyrings/debian.griffo.io.gpg
echo "deb [signed-by=/etc/apt/keyrings/debian.griffo.io.gpg] https://debian.griffo.io/apt $(lsb_release -sc 2>/dev/null) main" | sudo tee /etc/apt/sources.list.d/debian.griffo.io.list > /dev/null
sudo apt update
install -d -m 0755 /etc/apt/keyrings
curl -fsSL https://debian.griffo.io/EA0F721D231FDD3A0A17B9AC7808B4DD62C41256.asc | gpg --dearmor --yes -o /etc/apt/keyrings/debian.griffo.io.gpg
echo "deb [signed-by=/etc/apt/keyrings/debian.griffo.io.gpg] https://debian.griffo.io/apt $(lsb_release -sc 2>/dev/null) main" | tee /etc/apt/sources.list.d/debian.griffo.io.list > /dev/null
apt update
Passo 2: Instalar forgejo-runner
# Install latest forgejo-runner
sudo apt install forgejo-runner
# Verificar instalação
forgejo-runner --version
# Install latest forgejo-runner
apt install forgejo-runner
# Verificar instalação
forgejo-runner --version
🎯 Exemplos Básicos de Uso
# Show version
forgejo-runner --version
# Generate a default config file
forgejo-runner generate-config > config.yaml
# Register the runner with your Forgejo instance
forgejo-runner register --instance https://forgejo.example.com --token
# Start the runner daemon
forgejo-runner daemon
🚀 Por que escolher o debian.griffo.io?
📊 Comparação de Repositórios:
- Ubuntu Oficial: Frequentemente meses atrasado, sem os recursos mais recentes
- debian.griffo.io: Última versão poucas horas após o lançamento
- Instalação Manual: Requer downloads manuais e configuração do PATH
- Nosso Repositório: Pacotes pré-compilados e prontos para uso
- ✅ Últimos Recursos: Obtenha os recursos e melhorias mais recentes do Forgejo Runner imediatamente
- ✅ Sem Configuração Manual: Binários pré-compilados, instalados e atualizados via apt
- ✅ Atualizações Automáticas: Pacotes atualizados poucas horas após os lançamentos upstream
- ✅ Dependências Corretas: Empacotado corretamente com todas as bibliotecas necessárias
- ✅ Multi-Distribuição: Funciona no Jammy e Noble
- ✅ Manutenção Fácil: Comandos apt simples para atualizações
📦 Repositório de construção de pacotes
Os pacotes Ubuntu são construídos e mantidos automaticamente neste repositório do GitHub:
- 📁 forgejo-runner-debian - Latest release builds
🔗 Pacotes relacionados
Também disponível no debian.griffo.io:
- Forgejo - Forge de software leve auto-hospedada
- Garage - Armazenamento de objetos distribuído compatível com S3
- Headscale - Servidor de controle Tailscale auto-hospedado
🎯 Perfeito para: Equipes e indivíduos que hospedam o Forgejo e querem executar seus próprios pipelines de CI/CD com controle total sobre o ambiente de build e a infraestrutura.
💝 Apoiar Este Projeto
Se este repositório economiza seu tempo e esforço, considere apoiá-lo!