Home - Eziuz/Proyecto-POLI-Generador-de-Claves GitHub Wiki
🏠 Wiki - Generador de Contraseñas Seguras con CI/CD
Bienvenido a la documentación completa del proyecto Proyecto-POLI-Generador-de-Claves, una aplicación web moderna que demuestra la implementación de un pipeline completo de CI/CD con Jenkins y Docker.
🎯 Objetivo del Proyecto
Este proyecto fue desarrollado como un laboratorio práctico de integración continua que incluye:
- 🔧 Aplicación web funcional - Generador de contraseñas con Next.js 14
- 🐳 Containerización - Docker multi-stage optimizado
- 🚀 CI/CD Pipeline - Jenkins con versionado semántico
- 📦 Registry público - Imágenes en Docker Hub
- 📚 Documentación completa - Guías paso a paso
🏗️ Arquitectura General
graph TB
A[👨💻 Developer] --> B[📝 Git Commit]
B --> C[🔄 GitHub Repository]
C --> D[🤖 Jenkins Pipeline]
D --> E[🐳 Docker Build]
E --> F[✅ Tests & Verification]
F --> G[📦 Docker Hub Registry]
G --> H[🚀 Production Deployment]
style A fill:#e1f5fe
style D fill:#f3e5f5
style G fill:#e8f5e8
style H fill:#fff3e0
📖 Contenido de la Wiki
🛠️ Configuración e Instalación
| Página | Descripción | Tiempo estimado |
|---|---|---|
| 📋 Instalación de Jenkins | Guía completa para instalar y configurar Jenkins | 30-45 min |
| 🔐 Configuración de Credenciales | Obtener y configurar tokens de GitHub y Docker Hub | 15-20 min |
| ⚙️ Creación del Pipeline | Configurar el job de Jenkins y conectar con GitHub | 20-30 min |
📚 Análisis Técnico
| Página | Descripción | Nivel |
|---|---|---|
| 🔍 Análisis del Jenkinsfile | Explicación detallada de cada stage del pipeline | Intermedio |
| 🐳 Docker y Containerización | Análisis del Dockerfile y estrategias de optimización | Intermedio |
| 📜 Scripts de Automatización | Documentación de scripts de release y build | Básico |
🚀 Inicio Rápido
Para Usuarios (Solo usar la aplicación)
# Ejecutar la aplicación directamente
docker run -d -p 3000:3000 dennismorato/generador-claves:latest
# Acceder en el navegador
open http://localhost:3000
Para Desarrolladores (Configurar CI/CD completo)
- 📋 Instalar Jenkins - Configurar el servidor CI/CD
- 🔐 Configurar Credenciales - Obtener tokens necesarios
- ⚙️ Crear Pipeline - Configurar el job de build
- 🚀 Ejecutar primer build - Probar el pipeline completo
📊 Información del Proyecto
🏷️ Versiones y Tags
- Imagen Docker:
dennismorato/generador-claves - Versionado: Semántico (v1.0.0, v1.1.0, etc.)
- Tags disponibles:
latest,1.x.x,dev
🛠️ Stack Tecnológico
| Categoría | Tecnologías |
|---|---|
| Frontend | Next.js 14, TypeScript, Tailwind CSS, shadcn/ui |
| DevOps | Jenkins, Docker, Docker Hub |
| Herramientas | Yarn 4, ESLint, Prettier |
| Infraestructura | Node.js 20 LTS, Alpine Linux |
📈 Métricas del Pipeline
- ⏱️ Tiempo de build: ~3-5 minutos
- 📦 Tamaño de imagen: ~150MB (optimizada)
- 🔄 Stages: 5 (Checkout, Version, Build, Verify, Push)
- 🏷️ Versionado: Automático con Git tags
🎓 Objetivos de Aprendizaje
Al completar este laboratorio, habrás aprendido:
- ✅ Configurar Jenkins desde cero
- ✅ Crear pipelines declarativos
- ✅ Integrar Docker en CI/CD
- ✅ Implementar versionado semántico
- ✅ Gestionar credenciales de forma segura
- ✅ Optimizar imágenes Docker
- ✅ Automatizar despliegues
- ✅ Documentar procesos
🆘 ¿Necesitas Ayuda?
🔗 Enlaces Útiles
- 🏠 Repositorio: GitHub
- 🐳 Docker Hub: dennismorato/generador-claves
- 📖 Jenkins Docs: jenkins.io
- 🐋 Docker Docs: docs.docker.com
📝 Notas Importantes
⚠️ Advertencia: Este proyecto es para fines educativos. Para uso en producción, considera implementar medidas adicionales de seguridad.
💡 Tip: Sigue las páginas de la wiki en orden para una mejor experiencia de aprendizaje.
🔄 Actualización: Esta documentación se actualiza regularmente. Verifica la fecha de la última modificación.
🏁 ¡Comencemos!
¿Listo para configurar tu pipeline de CI/CD?