Changes between Version 6 and Version 7 of Version2/Arquitectura


Ignore:
Timestamp:
Oct 25, 2010, 10:37:48 AM (13 years ago)
Author:
adelcastillo
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • Version2/Arquitectura

    v6 v7  
    22[[TOC(heading=Índice)]]
    33
    4 En esta página encontrarás los principales componentes que componen el sistema !OpenGnSys y que funciones tienen.
     4En esta página encontrarás los principales componentes que componen el sistema !OpenGnSys y que funciones tienen. Su lectura es importante tanto para el uso como para el desarrollo de !OpenGnSys.
    55
    66= Servidor =
     
    1212El servidor de !OpenGnSys tiene una base de datos donde se centralizan toda la información relevante del complejo, desde que los datos de los clientes, que sistemas operativos tienen cada uno, que imágenes tiene cada repo y un largo etc.
    1313
    14 == WebConsole ==
     14== !WebConsole ==
    1515
    1616Es un servicio web y principal elemento de comunicación que se tiene para comunicarse con el sistema. Es un panel de control donde puedes administrar todo el complejo. Sus funcionalidades pueden verse en [milestone:OpenGnSys2.0 objetivos de OpenGnSys 2.0].
     
    6060Los scripts del engine se llaman a través de un servicio creado por nosotros. Este servicio recibe comandos desde el Servidor y los ejecuta. La salida la envía de vuelta al servidor. Este programa no es muy complejo, está hecho en Python. Es un servidor web usando webpy. En este puerto escucha peticiones, las parsea y si llega correctamente lo ejecuta. Si el proceso tarda mucho va mandando mensajes de que el proceso todavía se está ejecutando al Servidor. La salida la va mandando a medida que se va generando para que llegue la mayor información posible al Servidor, de esta forma se ha implementado un progreso para saber cuanto le falta.
    6161
    62 = Estructuración del código =
     62= Más información =
    6363
    64 El código actual de la versión dos se encuentra ahora mismo en el directorio de subversion: source:branches/version2. Allí encontramos varios directorios. Vayamos viendo que encontramos en cada uno.
    65 
    66 == art ==
    67 
    68 Aquí debemos alojar todo los ficheros artísticos para OpenGnSys. Un ejemplo, creamos una imagen svg que luego para usarlo en la web la exportamos a png a un tamaño determinado para usarla en la web. Pues la imagen png deberá en su parte correspondiente en el código pero la imagen svg debería ir en este directorio para poder reutilizarla posteriormente. También encajarían aquí logo, diseños, sonidos, etc.
    69 
    70 == client_daemon ==
    71 
    72 Aquí encontramos todo el código referente del demonio que corre en los clientes y también en los repositorios. El fichero principal es client_daemon.py que se ejecuta para correr el servicio. Encontramos además un fichero de configuración config.py. Los archivos acabados en *_tester.py se usan para realizar pruebas. En la carpeta ssl encontramos certificados usados para realizar las pruebas. La carpeta web es el webpy que usa el servicio para ejecutarse.
    73 
    74 == doc ==
    75 
    76 Este directorio se aloja toda la documentación que no se encuentra en el wiki. Por ahora sólo hay un directorio para alojar diagramas y un web_html, que es el html generado por la herramienta ????? de la documentación python del proyecto. En estos momentos se encuentra muy desactualizada.
    77 
    78 == live ==
    79 
    80 En éste hallamos los scripts que generan una distribución Ubuntu live mínima incluyendo el software necesario para ejecutar el cliente de OpenGnSys:
    81 
    82  * create_directories.sh: crea los directorios donde se va alojar el live resultante y algunos directorios vacios necesarios para crearlo correctamente en includes.
    83  * create_config_tree.sh: crea el árbol de configuración inicial de live-build.
    84  * generate.sh es el principal. Desde él se llama a los demás scripts y además carga la configuración. También descarga los últimos engine, client_daemon y scripts de svn. De esta manera se hará automáticamente.
    85  * gnsyslive.sh: es antiguo y será borrado próximamente.  Es la antigua manera que generamos el live. Se pueden sacar ideas por eso no es borrado todavía.
    86  * hooks: contiene scripts que se ejecutarán dentro del live antes de ser generado definitivamente. Puedes añadir nuevos para añadir cosas o eliminar cosas de manera sencilla.
    87  * includes: contiene ficheros que se van a agregar al live directamente en su directorio raíz.
    88  * packages_lists: contiene ficheros que tienen dentro una lista de paquetes que serán instalados en el live automáticamente.
    89  * server: encontraremos ficheros de configuración que pueden ser útiles para configurar los servicios necesarios para arrancar el cliente que son por ahora: NFS, DHCP y TFTP.  Se da la alternativa de usar dnsmasq solamente o dhcpd3 con tftpd.
    90 
    91 == sslsockets_examples ==
    92 
    93 El código que encontramos aquí fue creado antes que el client_daemon. Al principio, para el demonio del cliente, íbamos a usar C++ con Qt. Los primeros pasos fueron crear un socket seguro. Como no está claro que todavía que vayamos a quedarnos con python para esta parte, dejamos aquí ese código por si sirve posteriormente.
    94 
    95 == web ==
    96 
    97 Aquí se encuentra la consola web. #238
    98 
    99 === Ficheros ===
    100 
    101  * setup.sh: Se ejecuta para instalar la consola web. Borra todos los datos de la anterior instalación y llama a los siguientes scripts para generar una instalación limpia:
    102    * db.py: Crea la base de datos principal.
    103    * i18n_make.sh: Genera las traducciones.
    104    * i18n_make_plugins.sh: Lo mismo que antes pero para los plugins.
    105    * fill_data.sh: Rellana algunos datos para poder probar el código.
    106  * admin.py: Se ejecuta para ejecutar la consola web. Se le puede pasar el puerto por el que se quiere ejecutar. Por defecto es el 8080.
    107  * config.py: Aquí podemos configurar muchos aspectos de la consola web.
    108  * i18n_extract.sh y i18n_extract_plugin.sh: Sirve para extraer los mensajes para traducir.
    109  * decorators.py: Están los decoradores para las funciones donde hay mensajes para traducir.
    110  * log.py: Este fichero se configura como se guarda el log.
    111  * runtests.sh: Para correr los tests.
    112  * utils.py: Funciones que se usan en todo el código y no sabíamos donde colocar.
    113  * daemon.py: El demonio que debe ser ejecutar para recibir las respuestas de los clientes.
    114 
    115 === Directorios ===
    116 
    117  * clientjob: Todo lo referente a envío de trabajos a los clientes y también a los repositorios.
    118  * dbadmin: Es el formalchemy, que crea a partir de base de datos formularios para poder modificarlos. Todavía no está desarrollado todo lo que debería.
    119  * i18n: Generado para las traducciones.
    120  * log : Generado para el log.
    121  * login: ¿No hay nada?
    122  * main: La base de datos principal de ordenadores, grupos, repositorios, etc.
    123  * navigator: Todo lo referente a la pestaña navigator de la consola web.
    124  * panel: Todo lo refrente a la pestaña panel.
    125  * pluginmanager: Todo lo referente a la pestaña pluginmanager. Instala, activa, desactiva y elimina plugins. También puede configurar sus opciones.
    126  * plugins: Aquí está el esqueleto de los plugins. pluginbase.py es el fichero principal y ahí se encuentra mucho código usado por los plugins que heredan de esa clase. En este directorio existen más directorios que son los plugins propiamente dichos que se pueden activar desde pluginmanager. Por ahora ahí:
    127    * disk_image: Todo lo referente a los discos de los clientes.
    128    * hardware_inventory: Crea un inventario hardware a los clientes.
    129  * sessions: Creado para guardar la sesión.
    130  * ssl: Certificados para conexiones seguras.
    131  * static: El javascript, css, imagenes, etc. También se enlaza con el material estático con enlaces simbólicos de los plugins cuando se instalan.
    132  * templates: Todo el sistema de plantillas que se usa en la consola web. Se organiza por carpetas y también se enlaza templates de plugins cuando se instalan.
    133  * tests: Para crear tests. No está muy desarrollado.
    134  * user: Aquí vemos todo el código relacionado con los usuarios del sistema.
    135  * web: El webpy que usa la consola web.
     64Para más información puedes irte a la página de [wiki:Version2/Desarrollo desarrollo] de este mismo Wiki.