¡Bienvenido developer de Uguimar! Este proyecto está compuesto por múltiples microservicios organizados mediante submódulos de Git, lo que permite una estructura modular, limpia y escalable. A continuación, encontrarás los pasos para dejar todo listo en tu máquina local. 🛠️
Antes de comenzar, asegúrate de tener instalado:
- Git
- Bash (Linux, macOS o Git Bash en Windows)
Primero, clona este repositorio como lo harías normalmente:
git clone https://github.com/Uguimar-Platform/launcher.git
cd launcherUna vez clonado el proyecto, ejecuta el siguiente script para inicializar y configurar correctamente todos los submódulos:
USAR GIT BASH, no PowerShell
./init-submodules.shEste script se encargará de:
- Inicializar los submódulos.
- Descargar el contenido de cada uno.
- Preparar el entorno base para el desarrollo.
Este proyecto incluye un archivo docker-compose.yml que orquesta todos los microservicios del sistema.
Para levantar el entorno completo, simplemente ejecuta:
docker-compose up --buildEsto compilará las imágenes necesarias (si no existen) y levantará todos los contenedores definidos en el
docker-compose.yml.
Para detener los servicios:
docker-compose downproyecto/
├── config-server/ # Submódulo
├── service-discovery/ # Submódulo
├── .env # Submódulo
├── .docker-compose.yml # docker compose
├── .init-submodules.sh # Script de inicialización
├── ...Utilizamos submódulos para:
- Separar lógicamente los microservicios.
- Facilitar el mantenimiento independiente de cada módulo.
- Promover la reutilización de código entre proyectos.
- Si clonas el proyecto sin ejecutar
.init-submodules.sh, no verás el contenido de los submódulos, solo carpetas vacías. - Puedes actualizar los submódulos en cualquier momento con:
git submodule update --remote --mergeTodos los microservicios han sido levantados. 🙌
Hecho con ❤️ por Tadeo Portillo.