https://github.com/ankitrajput0096/springcloud_api_gateway_with_eureka
Dockerized Spring Boot application for Server side load balancing and routing using Spring Cloud API Gateway and Eureka.
https://github.com/ankitrajput0096/springcloud_api_gateway_with_eureka
docker docker-compose eureka-cluster maven spring-boot-2 spring-cloud-gateway
Last synced: 2 months ago
JSON representation
Dockerized Spring Boot application for Server side load balancing and routing using Spring Cloud API Gateway and Eureka.
- Host: GitHub
- URL: https://github.com/ankitrajput0096/springcloud_api_gateway_with_eureka
- Owner: ankitrajput0096
- Created: 2020-07-27T03:45:24.000Z (almost 6 years ago)
- Default Branch: master
- Last Pushed: 2020-08-22T21:07:39.000Z (almost 6 years ago)
- Last Synced: 2025-02-26T03:45:38.594Z (over 1 year ago)
- Topics: docker, docker-compose, eureka-cluster, maven, spring-boot-2, spring-cloud-gateway
- Language: Java
- Homepage:
- Size: 85.9 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Server Side Load Balancing and Routing using Spring Cloud API Gateway and Eureka
Dockerized Spring Boot application for Server side load balancing and routing using Spring Cloud API Gateway and Eureka.
## Getting Started
These instructions will get you a copy of the project up and running on your local machine for development purposes. See running for notes on how to run the project on a system.
### Prerequisites
1. Clone the project to your local environment:
```
git clone https://github.com/ankitrajput0096/SpringCloud_API_Gateway_with_Eureka
```
2. You need Docker to be installed:
#### Windows:
https://download.docker.com/win/stable/Docker%20for%20Windows%20Installer.exe
#### Mac:
https://download.docker.com/mac/stable/Docker.dmg
#### Ubuntu:
https://docs.docker.com/install/linux/docker-ce/ubuntu/
### Installing
Once you have docker installed on your environment, install the project dependencies via:
Build docker Image:
```
docker-compose build
```
## Running
Start docker:
```
docker-compose up
```
Or
Start docker with scaled up services:
```
docker-compose up --scale clientone=3 --scale clienttwo=3
```
### NOTE:
Can scale up clientone and clienttwo services to max instances of 5.
If you want to scale even higher, then increase the port range in `docker-compose` file.
Your Spring Cloud API Gateway server should be now running on http://localhost:8000, ClientOne server should be now running on http://localhost:8080-8085 and ClientTwo server should be now running on http://localhost:8086-90 and Eureka server cluster should be now running on http://localhost:9001, http://localhost:9002, http://localhost:9003
## Get an access to all exposed API's with Postman
1. Install Postman (https://www.getpostman.com)
2. Import Postman collection from the `SpringCloud_API_Gateway_Eureka_SpringBoot.postman_collection.json` file
3. Enjoy !!
#### NOTE : To see server side load balancing observe terminal logs of `docker-compose`. When trying to hit same endpoint multiple times parallely.
## Architecture design of Spring Cloud API Gateway
## Built With
* [Spring Boot](https://spring.io/projects/spring-boot) - Spring Boot 2
* [Maven](https://maven.apache.org/) - Dependency Management
* [Docker](https://www.docker.com/) - For containerization of application
* [Spring Cloud Gateway](https://spring.io/projects/spring-cloud-gateway) - For API Gateway, Routing and Filtering using Spring Cloud Gateway
* [Eureka](https://spring.io/guides/gs/service-registration-and-discovery/) - For Eureka admin and client
## Contributing
If you have any improvement suggestions please create a pull request and I'll review it.
## Authors
* **Ankit Rajput** - *Initial work* - [Github](https://github.com/ankitrajput0096)
## License
This project is licensed under the MIT License
## Acknowledgments
* Big thanks to Pivotal for Spring Boot framework, love it!