Skip to content

🖥️ Runner Requirements

💻 Hardware Mínimo

╔═════════════════════════════════════════════════════════╗ ║ Componente │ Mínimo │ Recomendado ║ ╠════════════╪═══════════╪══════════════════════════════╣ ║ CPU │ 2 cores │ 4+ cores ║ ║ RAM │ 4 GB │ 8+ GB ║ ║ Disk │ 50 GB │ 100+ GB SSD ║ ║ Network │ 10 Mbps │ 100+ Mbps ║ ╚═════════════════════════════════════════════════════════╝

📦 Software Pre-instalado

Build essentials:

  • Git 2.30+
  • CMake 3.22+
  • Compiler (gcc/clang/MSVC)

Platform specific:

  • Windows: Visual Studio 2022
  • macOS: Xcode CLI tools
  • Linux: build-essential

Optional:

  • Docker (for containerized builds)
  • ccache (for caching)

🌐 Network Access

Required:

  • GitHub/GitLab access (HTTPS)
  • Package managers (apt, brew, choco)
  • Artifact storage (S3/Azure/etc)

Firewall rules:

  • Outbound HTTPS (443)
  • SSH (22) if needed

🔐 Security

Isolation:

  • Dedicated user account for runner
  • No admin/root permissions
  • Restricted file system access

Secrets:

  • No secrets in runner config
  • Use CI/CD secrets management
  • Rotate tokens regularly

📊 Monitoring

Required metrics:

  • CPU/RAM usage
  • Disk space
  • Job queue length
  • Success/failure rates

Alerts:

  • Disk space < 10%
  • Runner offline > 5 min
  • Job failure rate > 20%

🔄 Maintenance

Daily:

  • Clean build artifacts
  • Clear temp files
  • Verify connectivity

Weekly:

  • Update runner software
  • Rotate logs
  • Security patches

Monthly:

  • Full system update
  • Performance review
  • Capacity planning