S2 - Gestión Centralizada de Configuración y Ambientes¶
Por: Angel Sullon Macalupu @asullom - 2026
1. Introducción¶
Tiempo: 20 min.
1.1 Presentación de la sesión¶
pagatu-catalogo-ms guarda hoy su configuración en dos archivos propios: application-dev.yml y application-prod.yml (S1). Cuando orden-ms se sume al sistema (sección 4), va a necesitar prácticamente los mismos tipos de valores repetidos en sus propios archivos — con el riesgo real de que un ajuste se corrija en un servicio y se olvide en el otro. Esta sesión saca esa configuración de cada microservicio y la centraliza en un Config Server propio: pagatu-config. El porqué se desarrolla en 1.6, continuando el mismo camino hacia microservicios que empezó en S1.
1.2 Índice¶
- El problema de la configuración duplicada entre microservicios.
- Panorama de patrones de arquitectura de microservicios.
- Config Server y config-repo: dos responsabilidades distintas.
- Convención de nombres:
{aplicación}-{perfil}.yml. - Config Server en DEV (y, de forma opcional, en producción local).
1.3 Propósito de aprendizaje¶
Al concluir la clase, estarás en condiciones de:
- Construir e implementar un Config Server (Spring Cloud Config) que centraliza la configuración de
pagatu-catalogo-mspor ambiente, verificando las consultas por HTTP y migrando el microservicio de S1 para leer su configuración externa en DEV (opcionalmente también en producción local).
1.4 Producto de sesión¶
pagatu-config operativo en infra/pagatu-config, con config-repo local (pagatu-catalogo-ms-dev.yml, pagatu-catalogo-ms-prod.yml), consultado por HTTP en ambos perfiles, y pagatu-catalogo-ms migrado para leer su configuración desde pagatu-config en DEV. De forma opcional, también en producción local con Docker.
1.5 Metodología¶
Tabla 1. Metodología de la sesión
| Actividades a Realizar en el Periodo | Orientaciones generales (Orientaciones Metodológicas) | Material de estudio recomendado |
|---|---|---|
| Revisión previa individual | Revisar application-dev.yml y application-prod.yml de pagatu-catalogo-ms (S1) y confirmar que el servicio sigue arrancando con Maven Wrapper. Trabajo individual, antes de clase; identificar qué valores son iguales y cuáles cambian entre DEV y PROD. |
Evidencia individual de S1, application-dev.yml/application-prod.yml actuales. |
| Clase presencial | Construcción guiada de pagatu-config, config-repo y migración de pagatu-catalogo-ms a Config Client; verificación por HTTP en DEV. Trabajo individual, siguiendo al docente paso a paso; consulta inmediata ante un perfil no encontrado o un microservicio que no arranca. Producción local con Docker (3.11-3.14) es alcance opcional: no es necesario completarla para cerrar la sesión. |
Pasos 3.1 a 3.14 de esta guía. |
| Evaluación formativa | Revisión en clase de pagatu-config respondiendo por HTTP en DEV, y de pagatu-catalogo-ms arrancando con configuración externa. La evidencia se completa y sustenta de forma individual, fuera del aula, según los criterios mínimos de la sección 4.4 — solo DEV es requisito; producción local suma como evidencia adicional opcional. |
Indicaciones de entrega (4.3), rúbrica de evaluación (4.6). |
1.6 Motivación de la sesión¶
1.6.1 Caso: la configuración que no crece igual que el sistema¶
Retomando el caso de S1 (la plataforma de comercio electrónico que migró a microservicios): el equipo sigue creciendo, y con él, el número de servicios, cada uno con su propia configuración por ambiente. Un día alguien necesita cambiar un solo valor — un tiempo de espera, un límite de reintentos — y descubre que no basta con editar un archivo: hay que recompilar, generar un nuevo build y volver a desplegar el servicio, solo para que ese cambio tome efecto. Con un servicio es una molestia; con varios corriendo a la vez, cada ajuste menor se convierte en un ciclo completo de despliegue — y tarde o temprano alguien copia mal un valor entre dos servicios sin que nadie lo note, hasta que falla en el peor momento.
Esto no es un problema exclusivo de pagatu: con decenas de microservicios, gestionar la configuración individualmente en cada uno se vuelve inmanejable:
- Cada ajuste de configuración exige recompilar y volver a desplegar el servicio.
- Diferencias accidentales entre DEV y PROD, o valores hardcodeados.
- Ningún lugar único donde saber qué configuración usa cada servicio.
- Mayor riesgo de errores al levantar varias instancias a la vez.
Con dos servicios el problema ya es real; con diez, es prácticamente imposible mantener la configuración sincronizada a mano.
Preguntas de análisis
Activación de conocimientos previos
- En S1 configuraste el mismo usuario y contraseña de PostgreSQL en dos archivos distintos:
compose-dev.ymlyapplication-dev.yml. ¿Qué hubiera pasado si cambiabas ese valor en uno de los dos y te olvidabas del otro?
Comprensión de configuración centralizada
- ¿Cómo hacemos que los servicios lean su configuración desde un punto central sin recompilar ni duplicar valores?
1.7 Ubicación en el curso¶
- Unidad: U1 - Sistema distribuido base orientado a producción.
- Producto del curso: Proyecto Sello: sistema distribuido de microservicios end-to-end, configurable, escalable, seguro, resiliente, consistente, observable, integrado con frontend y defendido técnicamente.
- Producto de unidad: sistema distribuido base funcional, configurable y preparado para múltiples instancias, ejecutable en desarrollo y producción local en paralelo.
- Avance del producto en esta sesión: configuración externa por ambiente mediante Config Server, con
pagatu-catalogo-msmigrado a Config Client.
Figura 1. Roadmap del producto de la unidad
flowchart TB
Cliente["Cliente de prueba - PowerShell / bash / Swagger"]
Gateway["Gateway - punto único de acceso - balanceo de carga"]
Catalogo["pagatu-catalogo-ms - construido en S1 - REST + BD + health"]
Orden["orden-ms - trabajo aplicado"]
Eureka["Registro de servicios - Eureka"]
Config["Servidor de configuración - pagatu-config - HOY"]
Repo[("Repositorio de configuración - pagatu-catalogo-ms-dev.yml / -prod.yml - HOY")]
Cliente --> Gateway
Gateway --> Catalogo
Gateway --> Orden
Gateway -. descubre servicios .-> Eureka
Catalogo -. registra instancia .-> Eureka
Orden -. registra instancia .-> Eureka
Catalogo -. carga configuración .-> Config
Orden -. carga configuración .-> Config
Config --> Repo
classDef done fill:#e8f5e9,stroke:#2e7d32,color:#111;
classDef today fill:#ffe08a,stroke:#9a6b00,stroke-width:2px,color:#111;
class Catalogo done;
class Config,Repo today;
Hoy se construye pagatu-config y se migra pagatu-catalogo-ms para leer su configuración desde ahí. En las siguientes sesiones se agrega registro de servicios (Eureka), Gateway y balanceo — todos ellos, igual que pagatu-catalogo-ms hoy, consultarán su configuración al mismo Config Server.
2. Explica¶
Tiempo: 25 min.
2.1 Arquitectura de la sesión¶
Figura 2. Config Server y config-repo en DEV
flowchart LR
Client["Cliente - PowerShell / bash / navegador"]
Config["pagatu-config - Config Server - infra/pagatu-config - localhost:18888"]
Repo["file:./config-repo - pagatu-catalogo-ms-dev.yml - pagatu-catalogo-ms-prod.yml - orden-ms-dev.yml - orden-ms-prod.yml"]
Catalogo["pagatu-catalogo-ms"]
Orden["orden-ms"]
Client -->|"GET localhost:18888/pagatu-catalogo-ms/dev"| Config
Client -->|"GET localhost:18888/orden-ms/dev"| Config
Config -->|"lee archivos"| Repo
Catalogo -. "spring.config.import - http://localhost:18888" .-> Config
Orden -. "spring.config.import - http://localhost:18888" .-> Config
classDef server fill:#eef6ff,stroke:#2b6cb0,color:#111;
classDef repo fill:#fff4de,stroke:#b7791f,color:#111;
class Config,Catalogo,Orden server;
class Repo repo;
En DEV, pagatu-config corre con Maven Wrapper en el host:
localhost:18888
config-repo: file:./config-repo
Lectura del diagrama: pagatu-config deja de ser un archivo dentro de cada microservicio y pasa a ser un servicio propio, con su propio repositorio de configuración (config-repo) — cualquier microservicio que se sume al sistema (orden-ms, y luego cualquier otro) consulta el mismo lugar por HTTP, en vez de traer sus valores embebidos en el build. Este diagrama es el mapa que guía el resto de la explicación: cada apartado siguiente desarrolla uno de sus componentes, en el mismo orden del Índice (1.2).
2.2 El problema de la configuración duplicada entre microservicios¶
pagatu-catalogo-ms guarda hoy su configuración en dos archivos propios: application-dev.yml y application-prod.yml (S1, 3.2.3 y 3.6.3). Cuando orden-ms se construya (sección 4) va a necesitar prácticamente los mismos tipos de valores — puerto, conexión a base de datos, perfil de Flyway, qué expone Actuator — repetidos en sus propios archivos. El caso de 1.6.1 muestra qué pasa cuando eso crece sin control: cambios repetidos en muchos archivos, diferencias accidentales entre DEV y PROD, y ningún lugar único donde saber qué configuración usa cada servicio.
2.3 Panorama de patrones de arquitectura de microservicios¶
Config Server no es una idea suelta: es uno de varios patrones de arquitectura de microservicios ya catalogados y documentados, agrupados por el problema que resuelven. El catálogo de SACAViX System Design (2026) organiza cerca de 95 patrones en 11 categorías:
Tabla 2. Catálogo de patrones de arquitectura de microservicios, por categoría
| Categoría | Cantidad | Patrones |
|---|---|---|
| Fundamentales | 11 | API Gateway, Backend for Frontend, Strangler Fig, Sidecar Pattern, Service Registry, GraphQL Gateway, Anti-corruption Layer, Modular Monolith, Hexagonal Architecture, Service Mesh, Load Balancing. |
| Comunicación | 15 | Synchronous REST, Asynchronous Messaging, Event-Driven Architecture, Event Notification, Event-Carried State Transfer, Message Broker, Webhook, gRPC Communication, API Composition, Request-Reply Pattern, Publish-Subscribe, Message Filtering/Routing, Idempotency Key Pattern, Idempotent Consumer, Fire and Forget. |
| Datos | 10 | Event Sourcing, Saga Pattern, CQRS, Database per Service, Change Data Capture, Outbox Pattern, Polyglot Persistence, Transactional Log Tailing, Pulling Publisher, Two-Phase Commit. |
| Resiliencia | 10 | Circuit Breaker, Bulkhead, Retry Pattern, Timeout Pattern, Rate Limiting, Chaos Engineering, Caching Strategies, Fallback Pattern, Graceful Degradation, Backpressure. |
| Observabilidad | 9 | Distributed Tracing, Structured Logging, Metrics & Monitoring, Health Checks, Alerting & On-Call, Synthetic Monitoring, Error Tracking, Correlation ID, Audit Logging. |
| Seguridad | 5 | Zero Trust Security, OAuth2 / OpenID Connect, Secret Management, RBAC / Control de Acceso, API Key Management. |
| DevOps / Deployment | 8 | Blue-Green Deployment, Canary Deployment, Infrastructure as Code, Feature Toggles, Rolling Deployment, GitOps, CI/CD Pipeline, Trunk-Based Development. |
| Gobernanza | 7 | API Versioning, Contract Testing, Service Chassis, Schema Registry, Developer Portal, Schema Evolution, Centralized Configuration. |
| Escalabilidad | 7 | Materialized View, Database Sharding, Index Pattern, Read Replicas, Queue-Based Load Leveling, Consistent Hashing, Cell-Based Architecture. |
| Sincronización | 5 | Distributed Lock, Leader Election, Barrier / Rendezvous, Distributed Sequence Number, Distributed Semaphore. |
| Anti-patrones | 8 | Shared Database, Distributed Monolith, Chatty API, God Service, Shared Infrastructure, Nano-services, Everything-is-a-Service, Anemic Domain Model. |
Nota. Adaptado de Catálogo de patrones, por SACAViX, 2026, SACAViX System Design (https://systemdesign.sacavix.com/patterns).
El patrón de esta sesión, Centralized Configuration, está clasificado dentro de Gobernanza — no de "Infraestructura", que ya no existe como categoría separada en la versión actual del catálogo.
Ubicando lo ya construido y lo que viene en el curso dentro de este mismo catálogo:
Tabla 3. Patrones del catálogo ya trabajados o próximos en el curso
| Categoría | Patrón | Dónde aparece |
|---|---|---|
| Fundamentales | Service Registry | S3 — Eureka. |
| Fundamentales | API Gateway | S4 — punto único de acceso. |
| Fundamentales | Load Balancing | S4 — distribución de tráfico entre instancias. |
| Fundamentales | Backend for Frontend | S11 — integración con cliente frontend vía Gateway. |
| Comunicación | Publish-Subscribe | S8 — mensajería asíncrona entre servicios. |
| Comunicación | Idempotent Consumer | S9 — idempotencia en procesos de negocio distribuidos. |
| Datos | Database per Service | S1 — cada microservicio con su propia PostgreSQL. |
| Datos | Saga Pattern | S9 — consistencia eventual y compensación en procesos de negocio. |
| Resiliencia | Circuit Breaker | S6 — comunicación síncrona resiliente. |
| Seguridad | RBAC / Control de Acceso | S7 — seguridad distribuida y control de acceso (JWT propio, roles, Gateway como Resource Server). |
| Observabilidad | Distributed Tracing, Structured Logging, Metrics & Monitoring, Health Checks | S10 — observabilidad y diagnóstico. |
| Gobernanza | Centralized Configuration | S2 (hoy) — pagatu-config y config-repo. |
No todos los patrones del catálogo entran en el alcance del curso (por ejemplo, Database Sharding o CQRS no se trabajan) — el catálogo sirve para ubicar cada sesión dentro de un mapa más amplio, no como lista obligatoria.
2.4 Config Server y config-repo: dos responsabilidades distintas¶
Config Server es el componente que entrega configuración por HTTP; config-repo es donde viven los archivos de configuración en sí. Aunque en este curso ambos van a convivir dentro de la misma carpeta del proyecto (infra/pagatu-config), son responsabilidades lógicamente distintas: uno atiende peticiones, el otro almacena archivos.
2.4.1 Qué es el patrón de Configuración Centralizada¶
Según el catálogo de patrones SACAViX System Design (2026), Centralized Configuration es el patrón que centraliza la configuración de todos los microservicios en un repositorio o servicio dedicado, permitiendo gestión, versionado y actualización de configuración sin redespliegues.
Problema: con decenas de microservicios, gestionar configuración individualmente en cada servicio es inmanejable. Los cambios de configuración requieren redespliegues y es difícil mantener consistencia entre entornos.
Contexto: sistemas con múltiples microservicios que necesitan configuración externalizada, especialmente cuando hay múltiples entornos (dev, staging, prod) con diferentes configuraciones.
Cómo funciona: un Config Service centraliza toda la configuración. Los servicios obtienen su configuración al arrancar desde el Config Service. Los cambios de configuración pueden propagarse sin redespliegue. La configuración queda versionada en Git.
Figura 3. Patrón de Configuración Centralizada
flowchart LR
Git[("Git Repository / local repo")]
Config["Config Server"]
A["Service A"]
B["Service B"]
C["Service C"]
Git -->|"source of truth"| Config
Config -->|"pull on startup"| A
Config -.->|"hot reload"| A
Config -->|"pull on startup"| B
Config -.->|"hot reload"| B
Config -->|"pull on startup"| C
Config -.->|"hot reload"| C
Nota. Adaptado de Centralized Configuration, por SACAViX, 2026, SACAViX System Design — Centralized Config (https://systemdesign.sacavix.com/patterns/centralized-config).
Casos de uso del patrón, según el catálogo:
- Feature flags que deben cambiar sin redespliegue.
- Configuración de conexiones a bases de datos por entorno.
- Parámetros de lógica de negocio que cambian frecuentemente (timeouts, límites).
Trade-offs a considerar:
- El Config Service se vuelve un componente crítico (single point of failure).
- Latencia adicional al arranque mientras se obtiene la configuración.
- Configuración sensible requiere cifrado y gestión de secrets.
Errores comunes al implementarlo:
- No implementar caché local en los servicios (dependencia total del Config Service).
- Mezclar secrets y configuración normal sin seguridad adecuada.
- No versionar los cambios de configuración.
Tabla 4. Madurez y atributos de calidad del patrón
| Aspecto | Detalle |
|---|---|
| Nivel de madurez | Básico-Intermedio — relativamente simple de implementar con herramientas existentes. |
| Atributos de calidad | Mantenibilidad, Operabilidad, Deployabilidad. |
En esta sesión, pagatu-config implementa exactamente este patrón, con dos diferencias que conviene tener presentes desde ya:
- En vez de un repositorio Git remoto separado (el backend
git:nativo de Spring Cloud Config, con su propia URL y credenciales) como source of truth,config-repoes una carpeta local dentro del propio proyecto — más simple para esta sesión, sin necesidad de gestionar un segundo repositorio. Ojo: esto no protege por sí solo las contraseñas deconfig-repo— comopagatuya es un repositorio público en GitHub, cualquier archivo que se comitee ahí (local o no) queda visible igual. Los valores de esta sesión son de prueba (pagatu/pagatu); si más adelante se manejan credenciales reales, la protección real es la misma que ya usa.env/.env.exampleenpagatu-catalogo-ms: versionar solo plantillas y dejar el archivo con el valor real fuera de Git. - Ninguno de los tres trade-offs de arriba se resuelve en esta sesión:
pagatu-configno tiene caché local en los clientes (si se cae, un servicio que todavía no arrancó no consigue su configuración), no cifra secrets (las contraseñas de PostgreSQL viajan en texto plano dentro deconfig-repo) y es, literalmente, el punto único de falla del sistema en esta unidad. Son simplificaciones deliberadas para esta sesión — no la forma en que un Config Server se protege en un sistema en producción real.
Los servicios (pagatu-catalogo-ms, orden-ms) obtienen su configuración al arrancar (pull on startup, ver 3.10); la recarga en caliente (hot reload) queda fuera del alcance de esta sesión.
2.4.2 Configuración en DEV¶
Ver Figura 2 (2.1): en DEV, pagatu-config corre con Maven Wrapper en el host, en localhost:18888, leyendo config-repo desde file:./config-repo. Se muestran dos servicios (pagatu-catalogo-ms y orden-ms) para que se entienda que Config Server no es exclusivo de uno — cualquier microservicio que se sume al sistema consulta el mismo lugar. En esta sesión solo pagatu-catalogo-ms se migra en clase (3.9); orden-ms se conecta como trabajo autónomo (sección 4).
2.4.3 Configuración en PROD local¶
Figura 4. Config Server y config-repo en producción local
flowchart LR
Client["Cliente - PowerShell / bash"]
subgraph Docker["Docker Network: pagatu-prod-net"]
Config["pagatu-config - Config Server - 8888 interno"]
Repo["file:/config-repo - pagatu-catalogo-ms-prod.yml - orden-ms-prod.yml"]
Catalogo["pagatu-catalogo-ms"]
Orden["orden-ms"]
end
Client -->|"GET localhost:28888/pagatu-catalogo-ms/prod"| Config
Client -->|"GET localhost:28888/orden-ms/prod"| Config
Config -->|"lee archivos"| Repo
Catalogo -. "spring.config.import - http://pagatu-config:8888" .-> Config
Orden -. "spring.config.import - http://pagatu-config:8888" .-> Config
classDef server fill:#eef6ff,stroke:#2b6cb0,color:#111;
classDef repo fill:#fff4de,stroke:#b7791f,color:#111;
class Config,Catalogo,Orden server;
class Repo repo;
En PROD local, pagatu-config corre como contenedor:
host: localhost:28888
docker interno: pagatu-config:8888
CONFIG_REPO_LOCATION=file:/config-repo
Conceptos de la sesión:
- Config Server: componente que entrega configuración por HTTP.
- Config repo: carpeta donde viven los archivos
*.ymlde configuración. - Perfil: variante de configuración, por ejemplo
devoprod. - Config Client: aplicación que lee su configuración desde Config Server (
pagatu-catalogo-ms, desde 3.8).
2.5 Convención de nombres: {aplicación}-{perfil}.yml¶
Config Server busca el archivo de un servicio combinando spring.application.name con el perfil activo:
{spring.application.name}-{profile}.yml
Para pagatu-catalogo-ms:
pagatu-catalogo-ms-dev.yml
pagatu-catalogo-ms-prod.yml
Error frecuente: que spring.application.name no coincida exactamente con el nombre del archivo (por ejemplo, catalogo-ms en el código contra pagatu-catalogo-ms-dev.yml en el repo). Si no coinciden letra por letra, Config Server no encuentra ninguna configuración y el microservicio arranca con valores vacíos o falla.
2.6 Config Server en DEV y en producción local¶
Tabla 5. URLs de Config Server por ambiente
| Ambiente | Componente | URL o nombre |
|---|---|---|
| DEV | Config Server | http://localhost:18888 |
| DEV | Config de pagatu-catalogo-ms |
http://localhost:18888/pagatu-catalogo-ms/dev |
| PROD local | Config Server desde el host | http://localhost:28888 |
| PROD local | Config Server desde otros contenedores | http://pagatu-config:8888 |
| PROD local | Config de pagatu-catalogo-ms |
http://localhost:28888/pagatu-catalogo-ms/prod |
En DEV, pagatu-config corre con Maven Wrapper en el host, igual que pagatu-catalogo-ms (mismo patrón de S1). En PROD local corre como contenedor pagatu-config, dentro de una red Docker compartida con pagatu-catalogo-ms (3.12).
El puerto sigue el mismo patrón ya establecido en S1 para distinguir DEV de PROD local sin chocar entre sí:
Tabla 6. Puertos de host por componente y ambiente
| Componente | Puerto DEV (host) | Puerto PROD local (host) |
|---|---|---|
| PostgreSQL | 15432 |
25432 |
pagatu-catalogo-ms |
8080 |
28080 (no publicado por defecto, ver S1 Anexo) |
pagatu-config |
18888 |
28888 |
2.7 Observabilidad: diagnosticar un perfil no encontrado¶
En esta sesión la observabilidad se enfoca en confirmar que pagatu-config está activo y entrega la configuración esperada.
Tabla 7. Errores frecuentes y diagnóstico
| Problema | Causa probable | Solución |
|---|---|---|
| 404 o respuesta vacía al consultar configuración | Nombre de aplicación o perfil incorrecto | Revisar que la URL coincida con {app}-{profile}.yml |
| Config Server no encuentra archivos | Ruta de config-repo incorrecta |
En DEV revisar file:./config-repo; en PROD revisar CONFIG_REPO_LOCATION |
| Microservicio arranca con valores vacíos | No importa Config Server | Revisar spring.config.import en application.yml |
| Microservicio no arranca | Config Server apagado o URL incorrecta | Levantar Config Server primero y revisar CONFIG_SERVER_URL |
Se consulta prod pero aparecen valores de dev |
Perfil activo incorrecto | Revisar SPRING_PROFILES_ACTIVE |
Los pasos 3.2-3.14 de abajo se enfocan solo en pagatu-config y en migrar pagatu-catalogo-ms (3.1 solo verifica pagatu-catalogo-ms) — no avanzan a construir pagatu-orden-ms ni pagatu-cliente-ms. Si en la sección 4 (trabajo autónomo) todavía no tienes esos dos microservicios creados, revisa Alcance por microservicio y proyecto base — sigue exactamente el mismo patrón de pagatu-catalogo-ms (S1).
3. Aplica: actividad práctica guiada¶
Tiempo: 3h.
Actividad: construcción de pagatu-config y migración de pagatu-catalogo-ms a Config Client, verificado en DEV (y, de forma opcional, en producción local).
Propósito de la actividad: que cada estudiante construya un Config Server operativo, mueva la configuración de pagatu-catalogo-ms hacia config-repo, y verifique que el microservicio sigue funcionando igual que en S1, ahora con configuración externa.
Orientaciones metodológicas: el docente guía la construcción de pagatu-config y la migración de pagatu-catalogo-ms paso a paso frente a la clase; los estudiantes replican cada paso en su propio equipo, verificando cada consulta HTTP antes de avanzar al siguiente paso.
Actividades para realizar:
- 3.1 Verificar el punto de partida.
- 3.2 Crear la carpeta
infra. - 3.3 Crear el proyecto
pagatu-config. - 3.4 Habilitar Config Server.
- 3.5 Configurar
pagatu-configpara leerconfig-repoen DEV. - 3.6 Probar
pagatu-configen DEV. - 3.7 Mover la configuración de
pagatu-catalogo-msaconfig-repo. - 3.8 Consultar los perfiles por HTTP.
- 3.9 Conectar
pagatu-catalogo-mscomo Config Client. - 3.10 Levantar
pagatu-catalogo-msen DEV con configuración externa. - 3.11 Dockerizar
pagatu-configpara producción local (opcional). - 3.12 Compartir red entre
pagatu-configypagatu-catalogo-msen producción local (opcional). - 3.13 Probar
pagatu-configypagatu-catalogo-msen producción local (opcional). - 3.14 Revisar logs y bajar el entorno (opcional).
3.1 Verificar el punto de partida¶
Punto de partida común: todo el equipo debe comenzar exactamente desde el mismo estado, no desde su propio avance individual. Clona la rama s01-servicio-base (el snapshot de cierre de S1 — incluye pagatu-catalogo-ms tal como quedó esa sesión):
git clone --branch s01-servicio-base https://github.com/262dist/pagatu.git
Producto del paso: confirmación de que pagatu-catalogo-ms ya existe en services/ y arranca de forma independiente en DEV, antes de tocar código nuevo.
Requisito antes de continuar: levanta pagatu-catalogo-ms (docker compose -f compose-dev.yml up -d + .\mvnw.cmd spring-boot:run, ver el README.md de la carpeta) y confirma que http://localhost:8080/actuator/health responde UP. Si falla, el problema es anterior a esta sesión (S1), no de los pasos 3.2 en adelante.
pagatu-orden-ms/pagatu-cliente-ms (Alcance por microservicio y proyecto base) no son prerrequisito de los pasos 3.2-3.14: esos solo trabajan sobre pagatu-config y pagatu-catalogo-ms. Esta sesión, tal como se dictó, no avanzó a construirlos — quedan como preparación para la actividad autónoma (sección 4), no como algo ya resuelto en clase.
3.2 Crear la carpeta infra¶
Producto del paso: carpeta infra preparada para alojar componentes de infraestructura del sistema.
Desde la raíz del repositorio pagatu:
mkdir infra
infra/pagatu-config no se crea a mano — nace en el siguiente paso, cuando Spring Initializr genera el proyecto directamente ahí.
Estructura esperada al iniciar la sesión:
pagatu/
├── infra/
└── services/
└── pagatu-catalogo-ms/
3.3 Crear el proyecto pagatu-config¶
Producto del paso: proyecto Spring Boot pagatu-config creado dentro de infra/pagatu-config.
Desde VS Code, usa Spring Initializr (Spring Initializr: Create a Maven Project):
Tabla 8. Configuración del proyecto pagatu-config en Spring Initializr
| Campo | Valor |
|---|---|
| Project | Maven Project |
| Spring Boot | 4.1.1 |
| Language | Java |
| Group Id | pe.edu.upeu |
| Artifact Id | pagatu-config |
| Package name | pe.edu.upeu.config |
| Packaging | Jar |
| Java | 21 |
| Dependencias | Seleccionar dependencias del proyecto |
| Ubicación sugerente | infra/pagatu-config |
Dependencias a seleccionar:
Tabla 9. Dependencias del proyecto pagatu-config
| Grupo | Dependencias | Propósito |
|---|---|---|
| Spring Cloud | Config Server | Entregar configuración externa por HTTP |
| Productividad | Spring Boot DevTools | Facilitar ejecución en desarrollo (reinicio automático al cambiar config-repo/código) |
| Ops | Spring Boot Actuator | Verificar health de pagatu-config |
En pom.xml, la dependencia clave es:
<dependency>
<groupId>org.springframework.cloud</groupId>
<artifactId>spring-cloud-config-server</artifactId>
</dependency>
Spring Cloud necesita su propio BOM, con la versión compatible con Spring Boot 4.1.1 — Spring Cloud 2025.1.2 (release Oakwood), el mismo release train que ya cubría 4.0.x y ahora también cubre oficialmente la línea 4.1.x:
<properties>
<java.version>21</java.version>
<spring-cloud.version>2025.1.2</spring-cloud.version>
</properties>
<dependencyManagement>
<dependencies>
<dependency>
<groupId>org.springframework.cloud</groupId>
<artifactId>spring-cloud-dependencies</artifactId>
<version>${spring-cloud.version}</version>
<type>pom</type>
<scope>import</scope>
</dependency>
</dependencies>
</dependencyManagement>
Error frecuente: usar una versión de Spring Cloud anterior a 2025.1.x con Spring Boot 4. Las líneas de Spring Cloud anteriores (por ejemplo 2025.0.x) no son compatibles con Spring Boot 4.0.1 en adelante — el proyecto no compila o falla al arrancar con errores de beans que no encuentra.
3.4 Habilitar Config Server¶
Producto del paso: aplicación Spring Boot marcada como servidor de configuración.
En la clase principal, agrega @EnableConfigServer:
package pe.edu.upeu.config;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.cloud.config.server.EnableConfigServer;
@SpringBootApplication
@EnableConfigServer
public class PagatuConfigApplication {
public static void main(String[] args) {
SpringApplication.run(PagatuConfigApplication.class, args);
}
}
3.5 Configurar pagatu-config para leer config-repo en DEV¶
Producto del paso: config-repo creado y pagatu-config configurado para leerlo en DEV.
Crea la carpeta del repositorio local de configuración:
mkdir infra/pagatu-config/config-repo
En infra/pagatu-config/src/main/resources/application.yml:
server:
port: 18888
spring:
application:
name: pagatu-config
profiles:
active: native
cloud:
config:
server:
native:
search-locations: ${CONFIG_REPO_LOCATION:file:./config-repo}
management:
endpoints:
web:
exposure:
include: health,info,metrics
endpoint:
health:
show-details: always
En DEV no se define ninguna variable de entorno: se usa el valor por defecto, file:./config-repo. Eso significa que Maven debe ejecutarse parado exactamente en infra/pagatu-config, no en la raíz del repositorio.
3.6 Probar pagatu-config en DEV¶
Producto del paso: pagatu-config ejecutando en localhost:18888.
cd infra/pagatu-config
.\mvnw.cmd spring-boot:run
Verifica health y metrics:
PowerShell:
Invoke-RestMethod -Method Get -Uri "http://localhost:18888/actuator/health"
Invoke-RestMethod -Method Get -Uri "http://localhost:18888/actuator/metrics"
bash macOS/Linux:
curl http://localhost:18888/actuator/health
curl http://localhost:18888/actuator/metrics
Confirma el "antes": config-repo todavía está vacío, así que pagatu-config responde UP, pero la configuración de pagatu-catalogo-ms todavía no tiene ninguna propiedad real:
PowerShell:
Invoke-RestMethod -Method Get -Uri "http://localhost:18888/pagatu-catalogo-ms/dev"
Invoke-RestMethod -Method Get -Uri "http://localhost:18888/pagatu-catalogo-ms/prod"
bash macOS/Linux:
curl http://localhost:18888/pagatu-catalogo-ms/dev
curl http://localhost:18888/pagatu-catalogo-ms/prod
Ambas responden 200 OK con "propertySources": [] (vacío) — pagatu-config sabe responder por ese nombre y ese perfil, pero no tiene nada que servir todavía, porque config-repo no tiene ningún archivo pagatu-catalogo-ms-*.yml. 3.7 crea esos archivos, y 3.8 corre exactamente estos mismos dos comandos otra vez — compara ahí: propertySources ya no estará vacío, va a traer las propiedades reales de dev/prod.
3.7 Mover la configuración de pagatu-catalogo-ms a config-repo¶
Producto del paso: pagatu-catalogo-ms-dev.yml y pagatu-catalogo-ms-prod.yml creados en config-repo, con el mismo contenido que ya tenían application-dev.yml y application-prod.yml en S1.
Crea, dentro de infra/pagatu-config/config-repo:
pagatu-catalogo-ms-dev.yml (mismo contenido que application-dev.yml de S1):
server:
port: 8080
spring:
datasource:
url: jdbc:postgresql://localhost:15432/pagatu_catalogo_db
username: pagatu
password: pagatu
driver-class-name: org.postgresql.Driver
flyway:
enabled: true
locations: classpath:db/migration
jpa:
hibernate:
ddl-auto: validate
show-sql: true
properties:
hibernate:
format_sql: true
devtools:
restart:
enabled: true
quiet-period: 2s
poll-interval: 3s
livereload:
enabled: true
springdoc:
swagger-ui:
path: /swagger-ui.html
logging:
level:
pe.edu.upeu.catalogo: DEBUG
management:
endpoints:
web:
exposure:
include: health,info,metrics
endpoint:
health:
show-details: always
pagatu-catalogo-ms-prod.yml (mismo contenido que application-prod.yml de S1):
server:
port: 8080
spring:
datasource:
url: jdbc:postgresql://${DB_HOST}:${DB_PORT}/${DB_NAME}
username: ${DB_USER}
password: ${DB_PASS}
driver-class-name: org.postgresql.Driver
flyway:
enabled: true
locations: classpath:db/migration
jpa:
hibernate:
ddl-auto: validate
show-sql: false
properties:
hibernate:
format_sql: false
springdoc:
swagger-ui:
enabled: false
api-docs:
enabled: false
management:
endpoints:
web:
exposure:
include: health,info,metrics
endpoint:
health:
show-details: never
El server.port: 8080 se mantiene fijo, igual que en S1 — la segunda instancia de pagatu-catalogo-ms sigue tomando su puerto por argumento de línea de comandos (--server.port=8081, S1 3.4.1), no por puerto dinámico.
3.8 Consultar los perfiles por HTTP¶
Producto del paso: configuración externa consultada sin levantar pagatu-catalogo-ms.
Son los mismos dos comandos que ya corriste en 3.6, antes de que config-repo tuviera contenido — ahí propertySources salió vacío; ahora, con pagatu-catalogo-ms-dev.yml/pagatu-catalogo-ms-prod.yml ya creados (3.7), la respuesta trae las propiedades reales.
Con pagatu-config ejecutando (3.6):
PowerShell:
Invoke-RestMethod -Method Get -Uri "http://localhost:18888/pagatu-catalogo-ms/dev"
Invoke-RestMethod -Method Get -Uri "http://localhost:18888/pagatu-catalogo-ms/prod"
bash macOS/Linux:
curl http://localhost:18888/pagatu-catalogo-ms/dev
curl http://localhost:18888/pagatu-catalogo-ms/prod
Resultado esperado:
- La respuesta indica
"name": "pagatu-catalogo-ms". - La respuesta indica
"profiles": ["dev"](o["prod"]según la consulta). - En
propertySourcesaparece un archivo comofile:.../config-repo/pagatu-catalogo-ms-dev.yml. - Dentro de
sourcese ven propiedades comoserver.port,spring.datasource.url,spring.flyway.enabled,spring.jpa.hibernate.ddl-autoymanagement.endpoints.web.exposure.include.
Si pagatu-config no muestra esas propiedades, no continúes al siguiente paso — corrige primero el nombre del archivo, el perfil o la ruta de config-repo.
3.8.1 Probar una consulta incorrecta para aprender del error¶
Consulta un nombre que no coincide con spring.application.name:
curl http://localhost:18888/catalogo/dev
Resultado esperado: la consulta no devuelve la configuración de pagatu-catalogo-ms-dev.yml. El error conceptual es que catalogo no coincide con pagatu-catalogo-ms — este es justo el error frecuente de la Tabla 4.
3.9 Conectar pagatu-catalogo-ms como Config Client¶
Producto del paso: pagatu-catalogo-ms preparado para consumir configuración externa.
Este paso tiene tres cambios: agregar Config Client al pom.xml, dejar application.yml minimalista, y retirar application-dev.yml/application-prod.yml (ya migrados en 3.6).
1. Declarar la versión de Spring Cloud y agregar el BOM en services/pagatu-catalogo-ms/pom.xml:
<properties>
<java.version>21</java.version>
<spring-cloud.version>2025.1.2</spring-cloud.version>
</properties>
<dependencyManagement>
<dependencies>
<dependency>
<groupId>org.springframework.cloud</groupId>
<artifactId>spring-cloud-dependencies</artifactId>
<version>${spring-cloud.version}</version>
<type>pom</type>
<scope>import</scope>
</dependency>
</dependencies>
</dependencyManagement>
2. Agregar la dependencia de Config Client:
<dependency>
<groupId>org.springframework.cloud</groupId>
<artifactId>spring-cloud-starter-config</artifactId>
</dependency>
3. Dejar services/pagatu-catalogo-ms/src/main/resources/application.yml solo con lo esencial:
spring:
application:
name: pagatu-catalogo-ms
profiles:
active: dev
config:
import: "optional:configserver:${CONFIG_SERVER_URL:http://localhost:18888}"
4. Elimina application-dev.yml y application-prod.yml de services/pagatu-catalogo-ms/src/main/resources/ — su contenido ya vive en config-repo (3.7); mantenerlos ahí duplicaría exactamente el problema de 1.6.1.
El prefijo optional: evita que pagatu-catalogo-ms falle al arrancar si pagatu-config está apagado — pero igual necesita una conexión real a PostgreSQL para funcionar, así que en la práctica sigue dependiendo de que pagatu-config esté disponible para recibir esos valores.
3.10 Levantar pagatu-catalogo-ms en DEV con configuración externa¶
Producto del paso: pagatu-catalogo-ms ejecutando con valores entregados por pagatu-config.
Terminal 1 (Config Server):
cd infra/pagatu-config
.\mvnw.cmd spring-boot:run
Terminal 2 (base de datos + microservicio):
cd services/pagatu-catalogo-ms
docker compose -f compose-dev.yml up -d
.\mvnw.cmd spring-boot:run
Verifica en la consola de arranque:
- Nombre de aplicación
pagatu-catalogo-ms. - Perfil
dev. - Puerto
8080. - Conexión a PostgreSQL DEV.
- Configuración recibida desde
pagatu-config(aparece un log de Spring Cloud Config indicando la fuente).
Prueba que el CRUD de S1 sigue funcionando igual:
PowerShell:
Invoke-RestMethod -Method Get -Uri "http://localhost:8080/actuator/health"
Invoke-RestMethod -Method Get -Uri "http://localhost:8080/api/v1/categorias"
bash macOS/Linux:
curl http://localhost:8080/actuator/health
curl http://localhost:8080/api/v1/categorias
Resultado esperado: /actuator/health responde UP, /api/v1/categorias responde 200 OK — el mismo comportamiento de S1, ahora con la configuración viniendo de pagatu-config en vez de un archivo local.
Puedes iniciar también la segunda instancia (S1, 3.4.1), en otra terminal:
cd services/pagatu-catalogo-ms
.\mvnw.cmd spring-boot:run "-Dspring-boot.run.arguments=--server.port=8081"
Ambas instancias leen la misma configuración centralizada desde pagatu-config y responden el mismo CRUD.
3.11 Dockerizar pagatu-config para producción local (opcional)¶
3.11 a 3.14 son opcionales
El alcance evaluado de S2 termina en 3.10 (pagatu-catalogo-ms como Config Client, funcionando en DEV). Producción local con Docker (3.11-3.14) es contenido adicional — profundiza la ejecución reproducible del patrón, pero no es necesario completarlo para que la sesión se considere lograda, y por capacidad de cómputo de las laptops del curso no se exige para la evaluación (4.4, 4.6). Si te queda tiempo en clase o quieres profundizar por tu cuenta, adelante.
Producto del paso: pagatu-config preparado para ejecutarse como contenedor.
infra/pagatu-config/Dockerfile (mismo patrón multi-stage que el Dockerfile de pagatu-catalogo-ms, S1 3.6.1):
FROM maven:3.9.9-eclipse-temurin-21 AS build
WORKDIR /app
COPY pom.xml .
RUN mvn -q -DskipTests dependency:go-offline
COPY src ./src
RUN mvn -q clean package -DskipTests
FROM eclipse-temurin:21-jre
WORKDIR /app
COPY --from=build /app/target/*.jar app.jar
EXPOSE 8888
ENTRYPOINT ["java", "-jar", "app.jar"]
infra/compose.yml:
name: pagatu-infra-prod
services:
pagatu-config:
build:
context: ./pagatu-config
dockerfile: Dockerfile
container_name: pagatu-config
restart: unless-stopped
ports:
- "28888:8888"
volumes:
- ./pagatu-config/config-repo:/config-repo
environment:
SERVER_PORT: 8888
SPRING_PROFILES_ACTIVE: native
CONFIG_REPO_LOCATION: file:/config-repo
networks:
- pagatu-prod-net
networks:
pagatu-prod-net:
name: pagatu-prod-net
En PROD local, pagatu-config usa file:/config-repo (ruta dentro del contenedor) — el volumen monta infra/pagatu-config/config-repo del host en /config-repo dentro del contenedor, así que los mismos archivos de 3.6 se reutilizan sin duplicarlos.
3.12 Compartir red entre pagatu-config y pagatu-catalogo-ms en producción local (opcional)¶
Producto del paso: pagatu-catalogo-ms conectado a la misma red Docker que pagatu-config, además de su propia red con PostgreSQL.
pagatu-config vive en un compose.yml distinto (infra/compose.yml) al de pagatu-catalogo-ms (services/pagatu-catalogo-ms/compose.yml) — son dos proyectos Docker Compose separados. Para que uno resuelva al otro por nombre (http://pagatu-config:8888), ambos deben compartir una red Docker declarada como externa desde el lado que no la crea.
infra/compose.yml (3.11) crea la red pagatu-prod-net. En services/pagatu-catalogo-ms/compose.yml, agrega esa misma red como externa, sin dejar de tener su propia red interna con PostgreSQL:
pagatu-catalogo-ms:
build: .
restart: unless-stopped
depends_on:
postgres-catalogo:
condition: service_healthy
environment:
SPRING_PROFILES_ACTIVE: ${SPRING_PROFILES_ACTIVE}
CONFIG_SERVER_URL: ${CONFIG_SERVER_URL}
DB_HOST: pagatu-postgres-catalogo
DB_PORT: 5432
DB_NAME: ${DB_NAME}
DB_USER: ${DB_USER}
DB_PASS: ${DB_PASS}
volumes:
- ./logs:/app/logs
networks:
- pagatu-catalogo-int
- pagatu-prod-net
networks:
pagatu-catalogo-int:
name: pagatu-catalogo-int
pagatu-prod-net:
external: true
external: true le dice a Compose "esta red ya existe, no la crees, solo únete" — si pagatu-prod-net no existe todavía (porque infra no se levantó primero), este compose.yml falla al arrancar con un error claro de red no encontrada. Ese es justo el orden que exige el siguiente paso.
Agrega también CONFIG_SERVER_URL a .env y .env.example de pagatu-catalogo-ms:
SPRING_PROFILES_ACTIVE=prod
CONFIG_SERVER_URL=http://pagatu-config:8888
DB_NAME=pagatu_catalogo_db
DB_USER=pagatu
DB_PASS=pagatu
Regla de orden de arranque en producción local:
1. Levantar infra (crea pagatu-prod-net y pagatu-config)
2. Levantar services/pagatu-catalogo-ms (se une a pagatu-prod-net ya creada)
3.13 Probar pagatu-config y pagatu-catalogo-ms en producción local (opcional)¶
Producto del paso: ambos componentes ejecutando en Docker, con pagatu-catalogo-ms leyendo su configuración desde pagatu-config.
Primero, infraestructura:
cd infra
docker compose up -d --build
docker compose ps
Verifica pagatu-config en PROD local:
PowerShell:
Invoke-RestMethod -Method Get -Uri "http://localhost:28888/actuator/health"
Invoke-RestMethod -Method Get -Uri "http://localhost:28888/pagatu-catalogo-ms/prod"
bash macOS/Linux:
curl http://localhost:28888/actuator/health
curl http://localhost:28888/pagatu-catalogo-ms/prod
Resultado esperado: propertySources debe apuntar a file:/config-repo/pagatu-catalogo-ms-prod.yml, con valores de PROD (server.port: 8080, springdoc.swagger-ui.enabled: false, etc.).
Luego, el microservicio:
cd services/pagatu-catalogo-ms
docker compose up -d --build --scale pagatu-catalogo-ms=2
Error frecuente: docker compose logs pagatu-catalogo-ms muestra Application run failed con FlywayValidateException: Migration checksum mismatch for migration version 1. Significa que el volumen de PostgreSQL de PROD local ya tiene aplicada una versión anterior de V1__create_catalogo_tables.sql, distinta a la que existe hoy en el proyecto (S1 ya advirtió esto: no se edita una migración ya aplicada, se crea una V2 — pero si el volumen quedó con una versión vieja de todos modos, hay que empezar de cero). Como este entorno de PROD local es de práctica, sin datos reales que proteger, la solución es bajar el entorno con el volumen y volver a levantarlo:
docker compose down -v
docker compose up -d --build --scale pagatu-catalogo-ms=2
down sin -v borra los contenedores pero no el volumen — el historial de Flyway (flyway_schema_history) sigue ahí y el error se repite igual.
Verifica health y CRUD desde dentro de la red (mismo patrón de S1, 3.7.3-3.7.4):
docker run --rm --network pagatu-catalogo-int curlimages/curl:8.10.1 -s http://pagatu-catalogo-ms:8080/actuator/health
docker run --rm --network pagatu-catalogo-int curlimages/curl:8.10.1 -s http://pagatu-catalogo-ms:8080/api/v1/categorias
Resultado esperado:
pagatu-catalogo-msarranca con perfilprod.- El microservicio obtiene su configuración desde
http://pagatu-config:8888. /actuator/healthrespondeUP./api/v1/categoriasresponde200 OK.- Swagger no se prueba en PROD — sigue deshabilitado en
pagatu-catalogo-ms-prod.yml(3.7), igual que en S1.
3.14 Revisar logs y bajar el entorno (opcional)¶
Producto del paso: evidencia de logs revisada, entorno completo liberado.
docker compose ps
Revisa logs de pagatu-config:
docker compose logs --tail=80 pagatu-config
(desde infra). Y de pagatu-catalogo-ms (desde services/pagatu-catalogo-ms):
docker compose logs --tail=80 pagatu-catalogo-ms
Al terminar la evidencia, baja ambos entornos, en orden inverso al que los levantaste:
cd services/pagatu-catalogo-ms
docker compose down
cd ../../infra
docker compose down
Evidencia de aprendizaje:
pagatu-configoperativo en DEV, entregandopagatu-catalogo-ms-dev.yml/-prod.ymlpor HTTP.pagatu-catalogo-msmigrado a Config Client, funcionando igual que en S1.- (Opcional)
pagatu-configypagatu-catalogo-msoperativos también en producción local, con la red compartida (pagatu-prod-net) entre los dos proyectos Docker Compose documentada y probada.
4. Crea: actividad autónoma¶
Tiempo: 4h fuera del aula.
4.1 Actividad¶
Replicación autónoma del patrón de configuración centralizada en otro microservicio del dominio (por ejemplo, orden-ms — ver Alcance por microservicio y proyecto base), documentada en evidencia individual.
Hito de equipo: Brief técnico
S2 es también el hito del Brief técnico del Proyecto Sello (ver cronograma): tu equipo declara por escrito el dominio, el flujo de negocio y los microservicios previstos para su propio proyecto (no necesariamente pagatu). Complétalo usando la plantilla del brief — es un entregable de equipo, una sola copia por proyecto, independiente de la evidencia individual de esta sección.
Completa y evidencia estas tareas:
- Crear
orden-ms-dev.ymlyorden-ms-prod.ymlenconfig-repo, con los valores de ambiente del microservicio replicado. - Conectar el microservicio replicado como Config Client (mismo patrón de 3.8).
- Consultar por HTTP su configuración en
devy enprod. - Verificar que sigue funcionando igual que antes de la migración.
- Comparar
pagatu-catalogo-ms-dev.ymlconpagatu-catalogo-ms-prod.ymle identificar al menos un valor que antes estaba hardcodeado y ahora no. - Explicar, con tus propias palabras, cómo Config Server separa código y configuración.
- (Opcional) Ejecutar
pagatu-configy el microservicio replicado en producción local con Docker.
4.2 Propósito¶
Que cada estudiante demuestre, de forma individual y fuera del aula, que puede reproducir el patrón construido en clase sin el acompañamiento del docente, aplicándolo sobre un microservicio distinto al trabajado en clase.
Esta actividad autónoma se desarrolla sobre el proyecto de fin de curso del equipo. El producto de la unidad se construye por acumulación de los avances de cada sesión; por eso, la evidencia de esta sesión debe incorporarse a la documentación del proyecto y quedar trazable en GitHub.
4.3 Indicaciones¶
Entrega un PDF con el siguiente nombre:
S02_Equipo##_ApellidoNombre.pdf
Cada captura de pantalla del informe debe mostrar, sin recortar, el reloj del sistema (fecha y hora) y tu usuario o foto de perfil (Windows, VS Code o navegador) visibles en pantalla — es lo que permite verificar que la evidencia es tuya y que corresponde al momento real de tu trabajo.
4.3.1 Estructura del informe¶
Datos del estudiante
- Nombre:
- Equipo:
- Sesión: S02 - Gestión Centralizada de Configuración y Ambientes
- Rol o aporte realizado:
- Link de GitHub:
Evidencia técnica
Incluye capturas o extractos con una breve explicación debajo de cada uno, organizados en los mismos 4 bloques de la rúbrica (4.6):
pagatu-configoperativo- Captura de
pagatu-configrespondiendo/actuator/healthen DEV. - (Opcional) Lo mismo en producción local.
- Captura de
- Configuración externa del microservicio replicado (p. ej.
orden-ms)orden-ms-dev.ymlyorden-ms-prod.ymlcreados enconfig-repo.- Consultas HTTP a
/orden-ms/devy/orden-ms/prod.
- Microservicio replicado como Config Client funcional
- Evidencia del microservicio replicado arrancando con configuración externa y respondiendo su propio health/endpoint en DEV.
- Comparación DEV/PROD y comprensión
- Comparación entre
pagatu-catalogo-ms-dev.ymlypagatu-catalogo-ms-prod.yml, con el valor identificado en la tarea 5. - Explicación propia de cómo Config Server separa código y configuración.
- Comparación entre
Error o hallazgo
Describe un error real: un perfil no encontrado, un nombre de aplicación que no coincidió con el archivo, o un microservicio que no arrancó por no encontrar pagatu-config.
Reflexión técnica breve
Responde en 5 a 8 líneas:
¿Cómo ayuda Config Server cuando el sistema crece a muchos microservicios
e instancias? Relaciona tu respuesta con el caso de 1.6.1.
4.4 Criterios mínimos de aceptación¶
La evidencia individual se considera completa si:
pagatu-configresponde en DEV, con evidencia real.orden-ms-dev.ymlyorden-ms-prod.yml(o los del microservicio replicado) existen enconfig-repo, con valores propios de ese microservicio.- El microservicio replicado arranca leyendo su configuración desde
pagatu-config, no desde archivos locales. - La comparación DEV/PROD identifica al menos un valor real, no genérico.
- (Opcional)
pagatu-configy el microservicio replicado ejecutan en producción local con Docker. - Cada captura de la evidencia técnica muestra el reloj del sistema y el usuario/perfil visible, sin recortar.
- Las fechas y horas de las capturas son coherentes con el historial de commits de su repositorio en GitHub.
- Incluye un error o hallazgo técnico diagnosticado.
- Incluye la reflexión técnica breve solicitada.
Producción local con Docker (3.11-3.14) es opcional: si se incluye, suma como evidencia adicional, pero su ausencia no hace que la entrega se considere incompleta.
4.5 Preguntas de defensa¶
- ¿Qué problema resuelve la configuración centralizada?
- ¿Qué diferencia hay entre Config Server y config-repo?
- ¿Cómo se forma la URL
/{application}/{profile}? - ¿Qué debe coincidir exactamente entre
spring.application.namey los archivos deconfig-repo? - ¿Cómo diagnosticas un perfil no encontrado?
Si completaste la parte opcional de 3.11-3.14:
- ¿Qué cambia entre DEV y producción local para
pagatu-config? - ¿Por qué
pagatu-catalogo-msypagatu-confignecesitan compartir una red Docker en producción local?
4.6 Rúbrica de evaluación¶
Tabla 10. Rúbrica de evaluación
| Criterio | Peso (%) | A (20 pts) | B (15 pts) | C (10 pts) | D (5 pts) | Nivel obtenido |
|---|---|---|---|---|---|---|
1. pagatu-config operativo* |
25 | pagatu-config funcional en DEV, con health y perfiles correctos. |
Funcional en DEV, con verificación parcial de health o perfiles. | Arranca pero sin verificación clara de health o perfiles. | No evidencia pagatu-config funcionando. |
|
2. Configuración externa del microservicio replicado (p. ej. orden-ms)* |
25 | -dev.yml/-prod.yml completos, con diferencias claras entre ambientes. |
Archivos presentes con diferencias parciales. | Un solo perfil o configuración incompleta. | No evidencia separación entre código y configuración. | |
| 3. Microservicio replicado como Config Client* | 25 | Arranca leyendo Config Server y responde funcionalmente en DEV. | Arranca leyendo Config Server, con respuesta parcial. | Arranque parcial o sin prueba funcional. | No demuestra conexión con pagatu-config. |
|
| 4. Comparación DEV/PROD y comprensión* | 25 | Comparación precisa con valor real identificado; explicación clara de Config Server. | Comparación correcta con explicación básica. | Comparación superficial o explicación imprecisa. | No compara ni explica el patrón. |
* Agregado manual.
Producción local con Docker (3.11-3.14) es opcional y no es necesario para alcanzar el nivel A en ningún criterio. Si el estudiante lo evidencia, el docente puede considerarlo un plus dentro del criterio 1, a su criterio.
Nota final = suma de (Peso / 100 × Puntos del nivel obtenido) = ____ / 20.
Para usar la rúbrica con IA, solicita:
Evalúa el PDF usando la rúbrica de la sesión.
Para cada criterio selecciona el nivel obtenido usando la escala A=20, B=15, C=10, D=5 puntos.
Justifica brevemente cada nivel asignado.
Verifica que cada captura muestre reloj del sistema y usuario/perfil visible, y que las fechas sean coherentes con el historial de commits de GitHub. Si falta esta evidencia o hay inconsistencias, indícalo explícitamente antes de calificar.
Calcula la nota final con la fórmula: suma de (Peso/100 × Puntos del nivel obtenido), directamente sobre 20.
Indica 2 fortalezas y 2 recomendaciones.
5. Cierre¶
Tiempo: 5 min.
Resumen breve: hoy pagatu-catalogo-ms dejó de guardar su propia configuración: pagatu-config centraliza los valores de DEV y PROD en config-repo, y el microservicio los consume por HTTP en vez de leerlos de archivos locales — la base sobre la que, en las siguientes sesiones, se conectarán también Eureka, el Gateway y cada nuevo microservicio del sistema.
Dinámica participativa: cada estudiante comparte en una frase un error o hallazgo real que tuvo al migrar pagatu-catalogo-ms (o orden-ms) a Config Client.
Metacognición: ¿qué parte del patrón de configuración centralizada te costó más entender — la separación Config Server/config-repo, la convención de nombres, o la red compartida en producción local?
Proyección: en S3 se agrega el registro y descubrimiento dinámico de servicios con Eureka, sobre este mismo pagatu-config — cada microservicio que se registre en Eureka también consultará su configuración aquí, sin que el patrón de hoy cambie.
Bibliografía¶
- VMware Tanzu / Broadcom Inc. (2026). Spring Cloud Config reference documentation. https://docs.spring.io/spring-cloud-config/reference/
- VMware Tanzu / Broadcom Inc. (2026). Spring Cloud 2025.1.2 (aka Oakwood) release notes. https://spring.io/blog/2026/06/11/spring-cloud-2025-1-2-aka-oakwood-has-been-released/
- Broadcom Inc. (2025). Spring Boot reference documentation (versión 4.1.1). VMware Tanzu. https://docs.spring.io/spring-boot/index.html
- SACAViX. (2026). Catálogo de patrones. SACAViX System Design. https://systemdesign.sacavix.com/patterns
- SACAViX. (2026). Centralized Configuration. SACAViX System Design — Centralized Config. https://systemdesign.sacavix.com/patterns/centralized-config