Self-hosted
Operar la instalación
Actualizar, hacer copias, leer los logs, parar y rotar claves.
Todos los comandos se ejecutan en el directorio de la instalación.
Actualizar
Vuelve a ejecutar el instalador con la versión que quieras (--version), o cambia FORJAR_VERSION en .env y:
docker compose pull && docker compose up -dLa migración corre primero; la API y el worker la esperan.
Hacer copias
Guarda cuatro cosas:
-
El volumen
forja-postgres:docker compose exec postgres pg_dump -U forja forja > forjar.sql -
El volumen
forja-artifacts, salvo que uses S3. -
El directorio
secrets/y el fichero.env. -
FORJA_VAULT_KEY, además, en otro sitio: un gestor de contraseñas, aparte de la copia de la base de datos.
Si pierdes la clave del vault, cada credencial guardada queda ilegible y hay que darla otra vez. La copia de la base de datos sola no puede abrirlas, y nadie que lea solo la base de datos tampoco.
Logs
docker compose logs -f api workerNunca contienen tokens.
Parar
docker compose downpara y conserva los datos.docker compose down -vpara y borra los datos.
Parar el worker espera hasta 35 minutos a que termine el run que tiene entre manos.
Rotar la clave del vault
Genera una clave nueva
En tu ordenador, no en el servidor:
openssl rand -base64 32Pon la nueva y conserva la vieja
En .env, la nueva en FORJA_VAULT_KEY y la anterior en FORJA_VAULT_PREVIOUS_KEYS (separadas por comas si hay varias). Aplica con docker compose up -d.
Todo se sigue abriendo, y la API lo vuelve a sellar con la clave nueva al arrancar: logins, API keys, conectores y claves de Daytona de cada equipo, y después el contenido guardado.
Quita la vieja
Cuando el log de la API diga FORJA_VAULT_PREVIOUS_KEYS can be removed, espera a que terminen los runs en curso, quítala y aplica otra vez. Si dice que algunos objetos no se pudieron leer, consérvala.
Puedes rotar session-secret cuando quieras: solo firma las cookies, así que cierra la sesión de todos y no sella nada.
Renovar el login de Codex de la instalación
Solo si dejaste codex-auth.json en secrets/. Lo que cada equipo conecta desde la cabina lo renueva Forjar.
- En una máquina de confianza,
codex login --device-authy aprueba en el navegador. Escribe~/.codex/auth.json. - Cópialo sobre
secrets/codex-auth.json. El siguiente run lo lee, sin reiniciar. - No uses ese login en otra máquina después: Codex rota el token de refresco al usarlo y la otra copia dejaría de funcionar.
Con FORJA_CODEX_LOGIN_RENEW_BY el worker avisa los días previos (FORJA_CODEX_LOGIN_WARN_DAYS, 7 por defecto).
Un sandbox que dejó un fallo
Se llama forja-run-<id> y su red forja-net-<id>. Bórralos:
docker rm -f forja-run-<id>
docker network rm forja-net-<id>