K-Forge / K-Forge/Beetle

Script de instalación

Open
#197 0 comments 0 reactions 1 assignee Claimed by @MauItu View on GitHub
fase-6
Dominant language
Shell
Stars
1
Forks
0
PR merge metrics
No merged PRs in 30d

Description

## Qué es esta tarea

Crear el script `install.sh` que instala Doctor J/K completo en un servidor limpio: crea usuarios, directorios, instala dependencias, copia archivos y habilita el servicio. Meta dura: menos de 15 minutos de principio a fin.

## Qué se debe hacer

- Crear `instalador/install.sh` que:
1. Crea el usuario `doctorjk` (sin login)
2. Crea los directorios necesarios (`/opt/doctorjk/`, `/var/lib/doctorjk/informes/`)
3. Instala dependencias del sistema (Python 3.11+, pip)
4. Instala dependencias de Python (`requests` o `httpx`)
5. Copia los archivos del agente a `/opt/doctorjk/`
6. Copia la unit de systemd y la habilita
7. Configura las credenciales del servicio: para el prototipo, lee las variables de entorno de un archivo `.env` (API key de Cloudflare del equipo). En producción, las credenciales las provee Beetle como parte del servicio (ver sección 23 del documento de proyecto)
8. Arranca el servicio
- El script debe ser idempotente (ejecutarlo dos veces no rompe nada)
- Debe funcionar en Ubuntu Server 24.04 y Debian 12+

## Por qué importa

El buyer persona (Mateo, sección 2.1) abandona cualquier herramienta que tome más de 15 minutos de instalar. La meta de <15 minutos no es una aspiración — es criterio de avance de la Fase 6 (roadmap). El script de instalación es la puerta de entrada al producto.

## Criterio de avance

Sobre un VPS limpio con Ubuntu Server 24.04, ejecutar `install.sh` deja Doctor J/K corriendo como servicio en menos de 15 minutos cronometrados. Sin pasos manuales adicionales excepto proveer las credenciales.

Contributor guide

Open the contributing guide

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.