Repolode
spring-cloud

spring-cloud/spring-cloud-gateway

Um API gateway baseado em Spring Framework e Spring Boot para rotear e filtrar requisições HTTP em ambientes de microsserviços.

Estrelas
4,919
Forks
3,481
Issues abertas
565
Último commit
há 7 horas

O que é?

Spring Cloud Gateway é um API gateway para aplicações Java, desenvolvido com Spring Framework 6 e Spring Boot 3, e que roda no Java 17. Ele fica à frente dos serviços de backend e encaminha as requisições HTTP recebidas com base em regras de correspondência, como caminho, método HTTP, cabeçalho ou host.

As rotas têm filtros associados: cada filtro se aplica apenas às requisições que correspondem à rota. Os filtros podem adicionar, remover ou reescrever cabeçalhos e parâmetros, reescrever ou definir o caminho da requisição e aplicar recursos como circuit breaker. As rotas podem ser definidas pela API ou por configuração, e também podem ser carregadas de um Spring Cloud DiscoveryClient.

O projeto é compilado com Maven usando o wrapper incluído, ./mvnw, e requer JDK 17. Testes que dependem de middleware, como Redis, precisam de uma instância local do Docker em execução.

Recursos principais

  • 01Correspondência de rotas por caminho, método, cabeçalho, host e outros atributos da requisição
  • 02Filtros associados individualmente às rotas correspondentes
  • 03Filtros podem modificar cabeçalhos, parâmetros e caminhos da requisição e da resposta
  • 04Suporte a circuit breaker entre os filtros integrados
  • 05Rotas configuráveis pela API ou por configuração, ou carregadas de um Spring Cloud DiscoveryClient

Casos de uso

  • Roteamento de entrada para um conjunto de microsserviços Spring Boot
  • Adicionar ou reescrever cabeçalhos e caminhos antes de as requisições chegarem aos serviços de backend
  • Integrar a descoberta de serviços para que as rotas acompanhem os serviços registrados

Início rápido

  1. 1

    Clone o repositório do projeto

  2. 2

    Instale o JDK 17 e compile o código-fonte com o Maven Wrapper

    ./mvnw install

Antes de usar

  • É necessário ter o JDK 17 para compilar.
  • Alguns testes precisam que o Docker esteja em execução localmente.

Em coleções

Tópicos

Perguntas frequentes

O que é spring-cloud-gateway?
Um API gateway baseado em Spring Framework e Spring Boot para rotear e filtrar requisições HTTP em ambientes de microsserviços. Spring Cloud Gateway é um API gateway para aplicações Java, desenvolvido com Spring Framework 6 e Spring Boot 3, e que roda no Java 17. Ele fica à frente dos serviços de backend e encaminha as requisições HTTP recebidas com base em regras de correspondência, como caminho, método HTTP, cabeçalho ou host.
spring-cloud-gateway é gratuito? Qual é a licença?
spring-cloud-gateway é open source sob a licença Apache-2.0. Confira os termos da licença antes de usá-lo em produtos comerciais.
spring-cloud-gateway ainda é mantido?
Manutenção ativa. O último commit de spring-cloud-gateway foi em 6 de nov. de 2026.
Para que posso usar spring-cloud-gateway?
Roteamento de entrada para um conjunto de microsserviços Spring Boot Adicionar ou reescrever cabeçalhos e caminhos antes de as requisições chegarem aos serviços de backend Integrar a descoberta de serviços para que as rotas acompanhem os serviços registrados
Como instalar spring-cloud-gateway?
Clone o repositório do projeto Instale o JDK 17 e compile o código-fonte com o Maven Wrapper: ./mvnw install
Onde consigo spring-cloud-gateway?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/spring-cloud/spring-cloud-gateway

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados