oggit/installer

Instalación de dependencias para python

La conversion del código a Python 3 requiere actualmente los paquetes especificados en requirements.txt

Para instalar dependencias de python se usa el modulo venv (https://docs.python.org/3/library/venv.html) que instala todas las dependencias en un entorno independiente del sistema.

Instalación rápida

Ubuntu 24.04

sudo apt install python3-git opengnsys-libarchive-c python3-termcolor bsdextrautils

Agregar claves de SSH a oglive

El sistema de Git accede al ogrepository por SSH. Para funcionar, necesita que el oglive tenga una clave de SSH, y que el ogrepository la acepte.

El instalador de Git puede realizar los cambios requeridos, con:

./opengnsys_git_installer.py --set-ssh-key

O para hacerlo contra un oglive especifico:

./opengnsys_git_installer.py --set-ssh-key --oglive 1 # numero de oglive

Ejecutar este comando agrega la clave de SSH a Forgejo automáticamente.

La clave existente puede extraerse con:

./opengnsys_git_installer.py --extract-ssh-key --quiet

Ejecutar

# ./opengnsys_git_installer.py

Debe ejecutarse como root.

El instalador descarga e instala Forgejo, un interfaz web de Git. La configuración se genera automáticamente.

Forgejo gestiona los repositorios y el acceso por SSH, por lo cual debe quedarse siempre corriendo. Por defecto se instala en el puerto 3000.

El usuario por defecto es oggit con password opengnsys.

Paquetes con dependencias

El sistema OgGit requiere módulos de Python que no vienen en Ubuntu 24.04 o tienen versiones demasiado antiguas.

Los fuentes de los paquetes se encuentran en oggit/packages.

Documentación de código fuente

Se puede generar documentación de Python con una utilidad como pdoc3 (hay multiples alternativas posibles):

# Instalar pdoc3
pip install --user pdoc3

# Generar documentación
pdoc3 --force --html opengnsys_git_installer.py