{"id":26833905,"url":"https://github.com/tabkram/spring-cloud-seed","last_synced_at":"2025-04-30T11:05:36.219Z","repository":{"id":72744780,"uuid":"115756613","full_name":"tabkram/spring-cloud-seed","owner":"tabkram","description":"The Strangler Application pattern with (Eureka, Zuul, Hystrix and Zipkin)","archived":false,"fork":false,"pushed_at":"2017-12-29T22:04:09.000Z","size":649,"stargazers_count":5,"open_issues_count":0,"forks_count":1,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-04-30T11:05:31.368Z","etag":null,"topics":["api-gateway","docker","eureka-server","hystrix","hystrix-dashboard","microservice","registration-service","spring-cloud","zipkin","zuul"],"latest_commit_sha":null,"homepage":null,"language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/tabkram.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2017-12-29T21:56:06.000Z","updated_at":"2023-12-20T10:49:09.000Z","dependencies_parsed_at":null,"dependency_job_id":"d164e7b3-588b-4013-863e-2bc155b8daff","html_url":"https://github.com/tabkram/spring-cloud-seed","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tabkram%2Fspring-cloud-seed","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tabkram%2Fspring-cloud-seed/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tabkram%2Fspring-cloud-seed/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tabkram%2Fspring-cloud-seed/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/tabkram","download_url":"https://codeload.github.com/tabkram/spring-cloud-seed/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":251686903,"owners_count":21627494,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["api-gateway","docker","eureka-server","hystrix","hystrix-dashboard","microservice","registration-service","spring-cloud","zipkin","zuul"],"created_at":"2025-03-30T15:30:29.250Z","updated_at":"2025-04-30T11:05:36.212Z","avatar_url":"https://github.com/tabkram.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Spring cloud Seed (Server)\n\n## Description \n\nThis reference application is a Spring Cloud example of implementing a [Strangler Pattern](https://www.martinfowler.com/bliki/StranglerApplication.html) using microservices. \n\n## Architecture Diagram\n\n![](architecture_diagram.PNG)\n\n## Project structure\n\n**1- Eureka Server (for service discovery register)** \n\nIt's about using an Eureka server to maintain a registry of microservices. All with the help of the spring cloud project.\nUI is available here : http://127.0.0.1:8002\n\n- NB: Eureka Server exposes a REST API specially for communicating with non-java registry clients. Documentation is available here: [Eureka-REST-operations](https://github.com/Netflix/eureka/wiki/Eureka-REST-operations)\n(If you can't believe me : http://127.0.0.1:8002/eureka/apps)\n\n- Examples: Android example: (https://github.com/thomasletsch/moserp/blob/master/gui/inventory-app/app/src/main/java/org/moserp/common/rest/RestServiceRegistry.java)\n\n**2- Zuul (API Gateway)**\n \n It's about an API gateway that represents a single entry point to our microservices. Zuul by itself represents a service registred in API client and it gets all registred services to know to which instance it should redirected the call\n\n- Examples: if you want to test how it works : http://localhost:8003/api/acme-service\n\n**3- [Hystrix-Dashboard + Turbine](hystrix-dashboard/README.md)**\n\n- This application is playing the role of both showing the Hystrix Dashboard and exposing turbine stream. [see more..](hystrix-dashboard/README.md)\n\n**4- [Zipkin-Server](zipkin-server/README.md)**\n\n**5- Swagger-ui**\n\n**6- [Acme-service](acme-service/README.md)**\n\n**7- [Config-server](config-server/README.md)**\n\n- This provides server support for externalized configuration in a distributed system through `Spring Cloud Config`. This Client-side is in the `acme-service`. the exernalized config is in the `/config` folder.\nBut it could be totally in the external repo. Configuration keys and values can be read from a Git repository online or on a disk\n\n## Getting started \n\n**1- Clone the project:**\n\nIf you just want to start a new project without the `spring-cloud-seed` commit history then you can do:\n\n         git clone --depth 1 https://github.com/tabkram/spring-cloud-seed.git\n        \n**2- Run apps:**\n\n- With Spring boot maven plugin:  use the following command `mvn spring-boot:run` on each module.\n\n- If you are using intelliJ, You could create a `Compound` run type and add all your applications in it. [more info](http://stackoverflow.com/questions/36055601/is-there-a-way-to-run-multiple-spring-boot-applications-with-a-single-running-co)\n\n- With Docker : [see below](#Deploy)\n\n## Deploy\n\nwith Docker (on Linux)\n\n**1- Build**\n\n- To build the images use the following maven command :  ~~`sudo mvn package docker:build` on each module~~ `maven package -Pdocker`. \n\n*(see more information about docker build process in the wiki)*\n\n**2- Install**\n\n- Requirements: Here are the required versions of Docker and Docker-compose :\n\n    Tool  | Version\n    ------------- | -------------\n    Docker  |  17.03.1-ce\n    Docker-compose | 1.12.0\n    Compose file format | version 3\n\n- Install on Linux :\n\n```\ncurl -L https://github.com/docker/compose/releases/download/1.12.0/docker-compose-`uname -s`-`uname -m` \u003e /usr/local/bin/docker-compose\nchmod +x /usr/local/bin/docker-compose\n```\n\n- More information:\n\nNB: see *dockerfile \u003c-\u003e docker-compose* compatibility here: https://docs.docker.com/compose/compose-file/compose-versioning/\n\n**3- RUN**\n\n- Old school:\n\n\u003e sudo docker container run -d -p 8002:8002 --name=eureka-server eureka-server:latest\n\n- via compose\n\n\u003e sudo docker-compose up -d\n\n## Other springCloud/NetflixOSS examples\n\nLike `spring-cloud-seed` there are other existing microservice POCs \u0026 examples on the net. In fact, our project is inspired by  what exists.\n\n*NB : It's just an inspiration, not a copy ! We have our own reasons that lead to choose to create our own stack.*\n\n- Existing projects (examples):\n\nhttps://github.com/Oreste-Luci/netflix-oss-example\n\nhttps://github.com/ewolff/microservice\n\nhttps://github.com/sqshq/PiggyMetrics\n\nhttps://github.com/singram/spring-cloud-microservices\n\nhttps://github.com/kbastani/cloud-native-microservice-strangler-example/tree/master/microservices\n\nhttps://github.com/kbastani/spring-cloud-microservice-example\n\n## references\n\nhttp://cloud.spring.io/spring-cloud-netflix/spring-cloud-netflix.html\n\nhttp://www.thomas-letsch.de/2015/using-netflix-eureka-with-spring-cloud/\n\nhttps://nofluffjuststuff.com/magazine/2016/06/cloud_native_spring_configuring_microservices\n\nhttp://stackoverflow.com/questions/39380936/load-balancing-ribbon-and-routing-zuul-spring-rest-api-spring-data-jpa-req\n\nhttps://gist.github.com/denji/8333630\n\nhttp://callistaenterprise.se/blogg/teknik/2015/04/15/building-microservices-with-spring-cloud-and-netflix-oss-part-2/\n\n- Docker \n\nexamples: https://github.com/fabric8io/shootout-docker-maven\n\n\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftabkram%2Fspring-cloud-seed","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftabkram%2Fspring-cloud-seed","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftabkram%2Fspring-cloud-seed/lists"}