OpenGnsys Client boot-tools   INSTALL.es.txt
============================================


Advertencia previa:
-----------------------------
- Se puede ejecutar este script desde un sistema Ubuntu 10.04 o superior.
- Mas información https://opengnsys.es/trac/wiki/ClienteInitrdDSGenerarloV1.0.2


Requisitos iniciales
--------------------
- Comprobar la conexión a Internet, sobre todo si usas proxy (el hecho de que funcione apt-get no significa que tengas el proxy configurado).


Proceso de creación de imagen docker
------------------------------------

Simplemente llamar a docker build sin sorpresas:

  docker build -t opengnsys/mkoglive .

Si queremos usar una rama diferente del repo de opengnsys:

  docker build --build-arg OPENGNSYS_BRANCH=mybranch -t opengnsys/mkoglive .


Proceso de creación de imagen oglive
------------------------------------

  mkdir ogclient
  docker run --rm --name mkoglive --privileged=true --volume $PWD/ogclient:/var/lib/tftpboot/ogclient opengnsys/mkoglive --codename noble

Hace falta --privileged=true para que mkoglive.py pueda ejecutar, entre otras cosas, losetup y mount.

El parámetro --codename permite especificar la versión de ubuntu.

También se puede especificar, por ejemplo, --loglevel debug.

Y también podemos indicar otro archivo de configuración usando --config.

Las imágenes se crean en ./ogclient. Es conveniente crear este directorio con antelación, antes de ejecutar docker, porque de este modo el directorio queda con permisos de usuario. De lo contrario, docker lo crearía como root y necesitaríamos sudo para hacer cualquier cosa dentro de él.


Descripción de la estrucutra de boot-tools
------------------------------------------

- INSTALL.es.txt          este mismo archivo.
- mkoglive:
  - mkoglive.py           script principal para crear la imagen oglive
  - mkoglive.cfg          configuración de mkoglive.py
  - boottools/            libreria complementaria del mkoglive.py
  - includes/             directorio con ficheros específicos para incluir en la distribución
- schroot:
  - schroot.conf          configuración de schroot
  - mount-defaults        configuración de puntos de montaje para schroot
  - chroot-tasks.py       helper para configurar el oglive estando en schroot
- docker:
  - Dockerfile            para crear una imagen docker
  - .dockerignore         para limitar el contexto de docker-build