Inicio Rápido para Usuarios ========================== Esta guía te ayudará a comenzar con NoxPanel rápidamente, desde el primer acceso hasta la gestión de tus máquinas virtuales. .. note:: El dashboard de usuario muestra los pools asignados y las máquinas virtuales disponibles. Primer Acceso ------------- 1. **Acceder al panel**: - URL: http://tu-dominio.com - Usuario: El asignado por el administrador - Contraseña: La proporcionada por el administrador 2. **Verificar pools asignados**: Al acceder, verás los pools a los que tienes acceso. Si no ves ninguno, contacta con el administrador. .. note:: Los pools son grupos de recursos que contienen máquinas virtuales. Tu acceso está limitado a los pools asignados. Dashboard Principal ------------------ El dashboard muestra: * **Pools disponibles**: Los pools a los que tienes acceso * **VMs en tiempo real**: Estado actual de las máquinas virtuales * **Estadísticas**: Uso de recursos y métricas * **Acciones rápidas**: Botones para operaciones comunes .. note:: El dashboard muestra pools disponibles, VMs en tiempo real, estadísticas y acciones rápidas. **Elementos del Dashboard**: * **Pool Cards**: Cada pool muestra: - Nombre y descripción - Número de VMs - Uso de recursos (CPU, memoria, almacenamiento) - Estado general * **VM List**: Lista de máquinas virtuales con: - Nombre y ID - Estado (Running, Stopped, etc.) - Uso de recursos - Acciones disponibles * **Quick Stats**: Estadísticas rápidas: - Total de VMs - VMs ejecutándose - Uso total de recursos Gestión de Máquinas Virtuales ----------------------------- Crear una Nueva VM ~~~~~~~~~~~~~~~~~~ 1. **Acceder a la creación**: - Desde el dashboard: Botón "Crear VM" - Desde un pool específico: Botón "Nueva VM" 2. **Configurar la VM**: .. code-block:: text Nombre: web-server-01 Pool: development Nodo: pve-cluster-01 Cores: 2 Memoria: 4096 MB Disco: 50 GB Storage: local-lvm 3. **Configuración Cloud-Init** (opcional): .. code-block:: text Usuario: ubuntu Contraseña: (generada automáticamente) SSH Keys: (opcional) Configuración IP: DHCP 4. **Crear la VM**: - Hacer clic en "Crear VM" - Esperar la creación (proceso automático) - Recibir notificación de completado .. note:: La creación de VMs puede tomar varios minutos dependiendo del tamaño y configuración. Controlar VMs ~~~~~~~~~~~~ **Acciones Disponibles**: * **Start**: Iniciar la VM * **Stop**: Detener la VM * **Restart**: Reiniciar la VM * **Shutdown**: Apagar la VM * **Reset**: Resetear la VM (forzado) **Ejemplo de uso**: .. code-block:: python # Ejemplo: Controlar VM desde API import requests # Iniciar VM response = requests.post('/api/vms/100/start/', headers={'Authorization': 'Bearer token'}) # Verificar estado status = requests.get('/api/vms/100/status/', headers={'Authorization': 'Bearer token'}) Acceso a Consola --------------- VNC Console ~~~~~~~~~~~ 1. **Acceder a la consola**: - Desde la lista de VMs: Botón "Consola VNC" - Desde detalles de VM: Pestaña "Consola" 2. **Configuración VNC**: * **Puerto**: Asignado automáticamente (77-999) * **Resolución**: Configurable * **Teclado**: Layout configurable 3. **Usar la consola**: - Conexión automática al arrancar - Control completo de la VM - Captura de pantalla disponible .. code-block:: html Terminal Web ~~~~~~~~~~~ 1. **Acceder al terminal**: - Botón "Terminal" en la VM - Acceso SSH integrado 2. **Características**: * **SSH directo**: Conexión SSH nativa * **Terminal web**: Terminal en el navegador * **Sesiones múltiples**: Múltiples conexiones * **Historial**: Comandos ejecutados Gestión de Redes --------------- IP Addresses ~~~~~~~~~~~~ **Ver IPs asignadas**: * Desde el dashboard: Sección "IP Addresses" * Desde detalles de VM: Pestaña "Red" **Solicitar nueva IP**: 1. Ir a "IP Addresses" > "Añadir" 2. Seleccionar pool de IP 3. Elegir IP específica o automática 4. Asignar a VM .. code-block:: python # Ejemplo: Asignar IP from vms.models import IPPool pool = IPPool.objects.get(name='production-network') ip_address = pool.allocate_ip( vm_id=100, user=request.user ) Network Configuration ~~~~~~~~~~~~~~~~~~~~ **Configuración automática**: * **DHCP**: Configuración automática por defecto * **IP estática**: Configuración manual * **VLAN**: Asignación automática según pool **Ejemplo de configuración**: .. code-block:: yaml # Cloud-Init network config network: version: 2 ethernets: eth0: dhcp4: true dhcp6: false Monitoreo y Métricas ------------------- Métricas en Tiempo Real ~~~~~~~~~~~~~~~~~~~~~~~ **Información disponible**: * **CPU Usage**: Porcentaje de uso de CPU * **Memory Usage**: Uso de memoria RAM * **Disk I/O**: Actividad de disco * **Network Traffic**: Tráfico de red * **Uptime**: Tiempo de funcionamiento **Gráficos**: .. note:: Las métricas muestran el uso de recursos en tiempo real de las máquinas virtuales. Alertas y Notificaciones ~~~~~~~~~~~~~~~~~~~~~~~ * **Uso alto de recursos**: Alertas automáticas * **VM offline**: Notificaciones de estado * **Errores de sistema**: Alertas de problemas * **Completado de tareas**: Notificaciones de éxito Gestión de Permisos ------------------- Roles de Usuario ~~~~~~~~~~~~~~~~ **Tipos de roles**: * **Owner**: Control total del pool * **Admin**: Gestión completa de VMs * **User**: Crear y controlar VMs * **Read-only**: Solo visualización **Permisos por rol**: .. code-block:: python # Ejemplo: Verificar permisos from vms.models import PoolMembership membership = PoolMembership.objects.get( user=request.user, pool=pool ) if membership.can_manage_vms(): # Puede crear VMs pass if membership.can_control_vms(): # Puede controlar VMs pass Acciones Disponibles ------------------- Según tu rol, podrás: **Owner/Admin**: * Crear, modificar, eliminar VMs * Gestionar usuarios del pool * Configurar recursos * Acceso completo a consola **User**: * Crear y controlar VMs * Acceso a consola * Ver métricas **Read-only**: * Ver VMs y métricas * Sin acceso a consola * Sin modificaciones Troubleshooting Básico --------------------- Problemas Comunes ~~~~~~~~~~~~~~~~~ 1. **VM no inicia**: * Verificar recursos disponibles * Comprobar configuración de red * Revisar logs de la VM 2. **Error de consola**: * Verificar que la VM esté ejecutándose * Comprobar configuración VNC * Revisar permisos de acceso 3. **Problemas de red**: * Verificar asignación de IP * Comprobar configuración VLAN * Revisar configuración DNS Comandos Útiles ~~~~~~~~~~~~~~~ **Desde la consola de la VM**: .. code-block:: bash # Verificar estado de red ip addr show # Verificar conectividad ping 8.8.8.8 # Ver uso de recursos htop # Ver logs del sistema journalctl -f **Desde el panel web**: * **Refresh**: Actualizar datos en tiempo real * **Logs**: Ver logs de la VM * **Metrics**: Ver métricas detalladas * **Console**: Acceso directo a consola Próximos Pasos -------------- * :doc:`Dashboard detallado ` * :doc:`Gestión avanzada de VMs ` * :doc:`Configuración de redes ` * :doc:`Acceso a consola ` * :doc:`Troubleshooting ` .. note:: Si necesitas ayuda adicional, contacta con el administrador del sistema o consulta la documentación completa.