0Pricing
API Gateway & Reverse Proxy (Nginx + Spring Cloud Gateway) · Lección

Configuración centralizada con Config Server

Gestione de forma centralizada las configuraciones del gateway mediante Spring Cloud Config Server para aplicar actualizaciones dinámicas y ajustes específicos de cada entorno.

Configuración centralizada con Config Server es una lección gratuita de API Gateway & Reverse Proxy (Nginx + Spring Cloud Gateway) en CoddyKit. Esta es la lección 3 de 4. Puedes leer la lección completa abajo gratuitamente — luego la practicas en el navegador con un editor de código integrado y un tutor de IA 24/7. Forma parte de la ruta de aprendizaje de API Gateway & Reverse Proxy (Nginx + Spring Cloud Gateway), y tu progreso se sincroniza en la web y la app de CoddyKit. El curso de API Gateway & Reverse Proxy (Nginx + Spring Cloud Gateway) incluye 4 lecciones en total.

Partes de esta lección aún no han sido traducidas y se muestran en inglés.

Why Centralized Configuration?

In a microservice architecture, you might have many services, each with its own configuration files. Managing these files individually can become a huge challenge.

Imagine updating a database connection string across 20 different services! It's prone to errors and time-consuming.

  • Decentralized configs: Hard to manage at scale.
  • Inconsistent configs: Different services might have slightly varied settings.
  • Manual updates: Tedious and risky.

Meet Spring Cloud Config Server

Spring Cloud Config Server provides a centralized externalized configuration service for distributed systems. It's built on Spring Boot and can easily integrate with various backend storage options.

Think of it as a central hub where all your application's settings live. Your services (clients) then fetch their configurations from this hub.

  • Centralized storage: One place for all configurations.
  • Version controlled: Configurations stored in Git (or similar).
  • Environment specific: Easily manage configurations for different environments (dev, prod).

Setting Up Config Server

To create a Config Server, you first set up a basic Spring Boot application and add the spring-cloud-config-server dependency. Then, you enable it with the @EnableConfigServer annotation.

Here's the main class for our Config Server:

package com.coddykit.configserver;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.cloud.config.server.EnableConfigServer;

@SpringBootApplication
@EnableConfigServer
public class ConfigServerApplication {
  public static void main(String[] args) {
    SpringApplication.run(ConfigServerApplication.class, args);
  }
}

Config Server Properties

The Config Server needs to know where to find your configuration files. Typically, these are stored in a Git repository.

You configure the Git repository URI and search paths in your application.properties or application.yml file:

server.port=8888
spring.cloud.config.server.git.uri=https://github.com/your-org/config-repo.git
spring.cloud.config.server.git.search-paths=configs

This tells the server to run on port 8888 and fetch configurations from the specified Git repository, looking inside the 'configs' folder.

Storing Configurations in Git

Inside your Git repository (e.g., config-repo.git), you'll create configuration files for each service. The naming convention is {application-name}-{profile}.yml or .properties.

For our Spring Cloud Gateway, let's assume its spring.application.name is gateway-service. A basic configuration file in your Git repo (e.g., configs/gateway-service.yml) might look like this:

spring:
  cloud:
    gateway:
      routes:
        - id: example_route
          uri: http://example.org
          predicates:
            - Path=/example/**

Gateway as a Config Client

Now, let's configure our Spring Cloud Gateway to act as a client and fetch its configurations from the Config Server. You'll need the spring-cloud-starter-config dependency.

Instead of application.properties, the client uses bootstrap.properties (or .yml) to connect to the Config Server *before* the main application context loads.

spring.application.name=gateway-service
spring.cloud.config.uri=http://localhost:8888

The spring.application.name helps the Config Server find the right config file (e.g., gateway-service.yml).

Using Centralized Properties

Once configured, your Gateway service will automatically connect to the Config Server at startup, fetch the configurations (like routes, predicates, filters), and apply them.

This means you can define all your gateway's routing rules, global filters, and other settings in the Git repository, managed by the Config Server, rather than directly in your gateway's code.

For example, a route defined in gateway-service.yml in your Git repo will be applied by your gateway.

Environment Profiles

Config Server excels at managing environment-specific configurations. You can create files like gateway-service-dev.yml or gateway-service-prod.yml in your Git repo.

Your gateway client can then specify its active profile in bootstrap.properties:

spring.application.name=gateway-service
spring.cloud.config.uri=http://localhost:8888
spring.profiles.active=dev

The Config Server will prioritize gateway-service-dev.yml, overriding any properties in the base gateway-service.yml.

Dynamic Configuration Refresh

One powerful feature is the ability to refresh configurations without restarting your Gateway service. This is achieved using Spring Cloud Actuator and the @RefreshScope annotation.

1. Add spring-boot-starter-actuator dependency to your Gateway.

2. Enable the /actuator/refresh endpoint in your application.properties:

management.endpoints.web.exposure.include=refresh

3. Annotate any beans in your Gateway that use configuration properties with @RefreshScope.

After updating your Git config and pushing changes, you can send a POST request to /actuator/refresh on your Gateway, and it will pull the new configs!

Quick Check on Config

Which of the following are key benefits of using Spring Cloud Config Server for a microservices architecture?

Recap: Centralized Config

You've learned how Spring Cloud Config Server tackles the challenge of managing configurations in distributed systems. It acts as a central hub, typically backed by a Git repository, to store and serve configurations.

Key takeaways:

  • Config Server: A Spring Boot app with @EnableConfigServer.
  • Config Client: Your Gateway (or other services) connecting via bootstrap.properties.
  • Git Integration: Configurations stored as {application}-{profile}.yml.
  • Dynamic Refresh: Update configs on the fly using Actuator's /refresh endpoint and @RefreshScope.

This centralized approach brings order and efficiency to your microservice configuration management!

Preguntas frecuentes

¿La lección «Configuración centralizada con Config Server» es gratis?

Sí — el texto completo de «Configuración centralizada con Config Server» es gratis para leer aquí en la web. Para practicarla de forma interactiva (editor de código integrado y tutor de IA 24/7) y desbloquear el resto del curso de API Gateway & Reverse Proxy (Nginx + Spring Cloud Gateway), actualiza a CoddyKit PRO. El curso de API Gateway & Reverse Proxy (Nginx + Spring Cloud Gateway) incluye 4 lecciones en total.

¿Qué aprenderé en «Configuración centralizada con Config Server»?

Gestione de forma centralizada las configuraciones del gateway mediante Spring Cloud Config Server para aplicar actualizaciones dinámicas y ajustes específicos de cada entorno. Practicas API Gateway & Reverse Proxy (Nginx + Spring Cloud Gateway) con código real que ejecutas directamente en el navegador, y un tutor de IA 24/7 responde tus preguntas mientras trabajas en la lección.

¿Necesito experiencia previa para empezar API Gateway & Reverse Proxy (Nginx + Spring Cloud Gateway)?

No se requiere experiencia previa. API Gateway & Reverse Proxy (Nginx + Spring Cloud Gateway) en CoddyKit está estructurado para principiantes hasta estudiantes avanzados, así que puedes empezar aquí o desde el inicio y avanzar a tu ritmo. Esta es la lección 3 de 4.

¿Cuánto tiempo toma la lección «Configuración centralizada con Config Server»?

La mayoría de las lecciones de CoddyKit toman alrededor de 5–10 minutos. Cada una es compacta e interactiva, así que avanzas constantemente y retomas exactamente por donde dejaste en la web y la app.

¿Puedo escribir y ejecutar código en esta lección de API Gateway & Reverse Proxy (Nginx + Spring Cloud Gateway)?

Sí. Cada lección de API Gateway & Reverse Proxy (Nginx + Spring Cloud Gateway) incluye un editor de código integrado, así que escribes y ejecutas código real directamente en tu navegador y obtienes retroalimentación instantánea de IA — sin configuración local necesaria.

Todas las lecciones de este curso

  1. Autenticación y autorización con JWT
  2. Trazabilidad distribuida con Sleuth/Zipkin
  3. Configuración centralizada con Config Server
  4. Exposición de métricas con Actuator y Prometheus
← Volver a API Gateway & Reverse Proxy (Nginx + Spring Cloud Gateway)