0Pricing
API Gateway & Reverse Proxy (Nginx + Spring Cloud Gateway) · Aula

Configuração Centralizada com Config Server

Gerencie centralmente as configurações do gateway usando o Spring Cloud Config Server para atualizações dinâmicas e definições específicas de cada ambiente.

Configuração Centralizada com Config Server é uma aula grátis de API Gateway & Reverse Proxy (Nginx + Spring Cloud Gateway) no CoddyKit. Esta é a aula 3 de 4. Você pode ler a aula completa abaixo gratuitamente — depois pratica ao vivo no navegador com um editor de código integrado e um tutor de IA 24/7. Faz parte do caminho de aprendizado de API Gateway & Reverse Proxy (Nginx + Spring Cloud Gateway), e seu progresso é sincronizado entre a web e o app CoddyKit. O curso de API Gateway & Reverse Proxy (Nginx + Spring Cloud Gateway) inclui 4 aulas no total.

Partes desta aula ainda não foram traduzidas e aparecem em 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!

Perguntas Frequentes

A aula “Configuração Centralizada com Config Server” é grátis?

Sim — o texto completo de “Configuração Centralizada com Config Server” é grátis para ler aqui na web. Para praticá-la interativamente (um editor de código integrado e um tutor de IA 24/7) e desbloquear o restante do curso de API Gateway & Reverse Proxy (Nginx + Spring Cloud Gateway), atualize para CoddyKit PRO. O curso de API Gateway & Reverse Proxy (Nginx + Spring Cloud Gateway) inclui 4 aulas no total.

O que vou aprender em “Configuração Centralizada com Config Server”?

Gerencie centralmente as configurações do gateway usando o Spring Cloud Config Server para atualizações dinâmicas e definições específicas de cada ambiente. Você pratica API Gateway & Reverse Proxy (Nginx + Spring Cloud Gateway) com código prático que executa diretamente no navegador, e um tutor de IA 24/7 responde suas dúvidas enquanto trabalha na aula.

Preciso ter experiência prévia para começar API Gateway & Reverse Proxy (Nginx + Spring Cloud Gateway)?

Nenhuma experiência prévia é necessária. API Gateway & Reverse Proxy (Nginx + Spring Cloud Gateway) no CoddyKit é estruturado para alunos iniciantes até avançados, então você pode começar aqui ou desde o início e aprender no seu ritmo. Esta é a aula 3 de 4.

Quanto tempo leva a aula “Configuração Centralizada com Config Server”?

A maioria das aulas CoddyKit leva cerca de 5–10 minutos. Cada uma é compacta e interativa, então você faz progresso constante e retoma exatamente de onde parou entre web e app.

Posso escrever e executar código nesta aula de API Gateway & Reverse Proxy (Nginx + Spring Cloud Gateway)?

Sim. Cada aula de API Gateway & Reverse Proxy (Nginx + Spring Cloud Gateway) inclui um editor de código integrado, então você escreve e executa código real direto no navegador e recebe feedback de IA instantaneamente — nenhuma configuração local necessária.

Todas as aulas deste curso

  1. Autenticação e Autorização com JWT
  2. Rastreamento Distribuído com Sleuth e Zipkin
  3. Configuração Centralizada com Config Server
  4. Expondo métricas com Actuator e Prometheus
← Voltar para API Gateway & Reverse Proxy (Nginx + Spring Cloud Gateway)