Sobre el proyecto
Este es un laboratorio de aprendizaje personal diseñado para aprender el ciclo completo de un servidor Linux: «construcción → verificación de funcionamiento → investigación de anomalías → recuperación». No representa un historial de operación profesional, sino que sigue la política de registrar claramente las áreas ejecutadas y las no ejecutadas por el autor. La licencia es MIT y el autor es Noriyuki Shimada.
La configuración central consiste en una aplicación Flask con autenticación (que devuelve el estado utilizando psutil dentro de un contenedor) y un nginx como punto de entrada, ambos iniciados con Docker Compose. El acceso se realiza a través de 127.0.0.1:8080 para verificar la respuesta de health y la diferencia entre 200 y 401 según la autenticación Basic. El sistema de monitoreo incluye un diagrama detallado donde Prometheus recopila datos de la aplicación y de node-exporter, Grafana se encarga de la visualización, y se integra la agregación de logs (Alloy / Loki) junto con notificaciones mediante Alertmanager. Se especifica que los valores globales del host deben consultarse a través de node-exporter.
Para la automatización de la construcción se utiliza Ansible, dividiendo el proceso en foundation.yml (construcción de base, incluyendo roles como common / docker) y site.yml (full-stack, incluyendo el monitoreo). Se conservan registros de la verificación de idempotencia y de la aplicación de la base tanto en Ubuntu como en AlmaLinux. Además, se abordan temas operativos como procedimientos de recuperación, gestión de cambios, SLO y presupuestos de error.
La verificación está automatizada mediante los flujos de trabajo python-check y full-stack-e2e de GitHub Actions, con un registro de 167 pruebas de pytest. El libro de evidencias (docs/evidence) gestiona la fecha de ejecución, el entorno, el commit objetivo, el resultado y el alcance no ejecutado. El 22-08-2026, en el E2E full-stack, 23 IDs pasaron (PASS) en construcción masiva, idempotencia, recuperación y restauración. El 04-09-2026 se registraron mediciones de construcción de base en Ubuntu y AlmaLinux, y entre el 07 y 08 de septiembre se registró la construcción manual en Ubuntu sobre Hyper-V (IP fija, autenticación por llave SSH, sudo, UFW, sincronización horaria, actualizaciones automáticas) y el inicio de la configuración mínima de Docker. Los resultados se desglosan en PASS 14 / PASS-ADAPTED 4 / PARTIAL 2 / NOT RUN 1.
Por otro lado, se indica explícitamente como NOT RUN la aplicación y eliminación real en AWS, el envío real a Slack, la operación a largo plazo del laboratorio de monitoreo y la restauración tras un fallo del host (D-2), para lo cual existe un plan de medición separado. Sobre los registros manuales, se aclara que son ejercicios de SO independiente que no utilizan Ansible ni el código de este repositorio y no son para un proyecto específico; asimismo, se nota que la IA asistió en la guía de procedimientos, lectura de imágenes y edición de registros, y que la reproducción autónoma o la operación a largo plazo están fuera del alcance.
La documentación es exhaustiva para el estudiante, incluyendo una guía de aprendizaje para principiantes (5 pasos comenzando con 2 servicios mínimos), una ruta de aprendizaje lineal del Nivel 0 al 5, un glosario de 408 términos básicos de servidor, un conjunto de palabras clave de construcción, plantillas de registro de prácticas, paquetes de proyectos (requisitos → valores de diseño → construcción → prueba → evidencia → operación → cambio), decisiones de diseño, casos aprendidos de fallos y un kit de operación autónoma. También se publica el alcance del uso de la IA, explicando la política de dejar constancia de lo ejecutado y explicado por uno mismo, lo asistido por IA y lo no verificado.
Comments
0 Rating appears after 10 ratings
Sign in to join the discussion.