wiki:DocumentacionUsuario1.1.0/EntornosVagrant

Version 1 (modified by ramon, 8 years ago) (diff)

Creación de la página

TOC(heading=Índice)?

Entornos de desarrollo estandarizados

Se pretende generar un conjunto de entornos para desarrollo y pruebas de los distintos componentes de OpenGnsys, utilizando herramientas de despliegue automático sobre máquinas virtuales o contenedores.

En una primera instancia, todos los entornos de trabajo se desplegarán utilizando Vagrant (https://www.vagrantup.com/) sobre máquinas virtuales ejecutadas con VirtualBox (https://www.virtualbox.org/).

Requisitos previos

  • Instalar Oracle VM VirtualBox 5.0 con su Extension Pack.
  • Instalar la última versión oficial de Vagrant (no usar la incluida en Ubuntu 14.04).
  • Crear un directorio de trabajo para dicho entorno.
  • Descargar en dicho directorio el fichero de configuración del entorno deseado y renombrarlo como Vagrantfile.

Entornos definidos

Los ficheros de configuración de Vagrant para los distintos entornos definidos en OpenGnsys 1.1 pueden descargarse de la sección de código fuente del proyecto o se encuentran en el directorio branches/version1.1/installer/vagrant, si se ha obtenido una copia local del código de OpenGnsys.

Fichero Entorno Recomendado para
Vagrantfile-trunk-vboxVagrantfile para la versión oficial de OpenGnsys (1.0.x).Pruebas en general
Vagrantfile-devel-vboxVagrantfile para la versión de desarrollo de OpenGnsys (1.1.x).Pruebas y desarrollo general
Vagrantfile-boottools-vboxVagrantfile para preparar el entorno de generación del cliente ogLiveDesarrolladores experimentados
Vagrantfile-ogagent-vboxVagrantfile para preparar el entorno de desarrollo del agente OGAgentMiembros del grupo de desarrollo

Entornos de pruebas de OpenGnsys

Ambos entornos de pruebas definen el mismo conjunto de máquinas virtuales, por lo que son mutuamente excluyentes.

MV Descripción
ogAdministratorServidor OpenGnsys, basado en Ubuntu 14.04 y con 2º disco para repositorio
ogClient01Cliente modelo con Ubuntu 14.04 instalado en una única partición
ogClient02 - ogclient0NClientes para restaurar con disco vacío

Configurar entorno de pruebas

Una vez elegido el entorno de pruebas deseado, opcionalmente puede editarse el fichero Vagrantfile para personalizar los valores de sus variables de configuración.

Variable Descripción Por omisión
LANGUAGEIdioma (se aceptan es_ES, ca_ES y en_GB)es_ES
NCLIENTSNº de clientes a generar (de 2 a 9)4
REPODISKFichero del disco duro virtual para el repositorio de imágenesogRepo.vdi
REPOSIZETamaño (en GB) del disco duro virtual para el repositorio de imágenes50
SERVERMEMMemoria virtual (en MB) para el servidor OpenGnsys1024
CLIENTMEMMemoria virtual (en MB) para los clientes512
NETPREFIXPrefijo para las direcciones IP de la red virtual192.168.2.
MACPREFIXPrefijo para las direcciones MAC de los clientes08:00:27:0E:65:
LOCALWEBPORTPuerto local para acceder al web de administración de OpenGnsys8443

Adicionalmente, los usuarios más experimentados pueden editar el fichero Vagranfile para insertar automáticamente en el servidor OpenGnsys la definición automática de un aula virtual con sus clientes incorporados, descomentando las órdenes relacionadas con los comandos mysql y setclientmode. Nota: no se recomienda que realicen esta operación los usuarios noveles que están aprendiendo el manejo de OpenGnsys.

Iniciar el entorno

Las máquinas virtuales deben iniciarse por primera vez en el siguiente orden, esperando a la finalización de cada operación.

  1. Iniciar la MV del servidor OpenGnsys:
    vagrant up
    
  2. Si no se ha preparado la inserción automática de datos, acceder al servidor OpenGnsys para crear un aula e incorporar los ordenadores de los clientes.
  3. Iniciar las MV del cliente modelo (tras iniciar el servidor):
    vagrant up ogClient01
    
  4. Usar VirtualBox para apagar esta máquina virtual y deshabilitar su interfaz de red 1.
  5. Iniciar las MV de los clientes vacíos para restaurar (siendo X de 2 al nº máximo definido):
    vagrant up ogClient0X
    

Nota:

  • Los procesos de inicio pueden tardar varios minutos en la primera ejecución, porque descargan y configuran las máquinas virtuales.
  • Ignorar los errores de conexión de Vagrant con los clientes vacíos.

IMPORTANTE: una vez que las máquinas virtuales estén definidas correctamente, dejar de usar Vagrant para su manejo y utilizar únicamente las herramientas VirtualBox.

Notas sobre la máquina virtual del servidor OpenGnsys

Notas sobre las máquinas virtuales de los clientes