64 lines
1.9 KiB
Markdown
64 lines
1.9 KiB
Markdown
# 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
|
|
|