Skip to content

Latest commit

 

History

History
 
 

eureka-examples

Folders and files

NameName
Last commit message
Last commit date

parent directory

..
conf
conf
 
 
src/main/java/com/netflix/eureka
src/main/java/com/netflix/eureka
 
 
README.md
README.md
 
 
build.gradle
build.gradle
 
 

README.md

Example Overview

The eureka example requires 3 participants:

  • a centralized eureka server for registration and discovery
  • an example service to register with eureka that exposes a REST endpoint
  • an example client that discovers the example service via discovery, and then queries the example service on it's registered REST endpoint.

Setting up the Eureka server

  1. Edit eureka-server.properties and uncomment the two settings that makes the demo server start up faster (via disabling safeguards)
  2. Build the application.
  3. The above build also sets up all the libraries needed for running the demo service and the demo client.
  4. Copy the WAR artifact to your tomcat deployment directory under _$TOMCAT_HOME/webapps/

cp ./eureka-server/build/libs/eureka-server-XXX-SNAPSHOT.war $TOMCAT_HOME/webapps/eureka.war
  1. Create (or add to) a setenv.sh in tomcat/bin/ with the following java opts (these are for the demo server to start up fast, see EurekaServerConfig.java for their documentation):
JAVA_OPTS=" \
  -Deureka.waitTimeInMsWhenSyncEmpty=0 \
  -Deureka.numberRegistrySyncRetries=0"
  1. Start your tomcat server. Access http://localhost:8080/eureka to verify the information there. Your server's eureka client should register itself in 30 seconds and you should see that information there.

Running the examples directly

  1. Start up a local eureka server
  2. Run the example service first with ./gradlew :eureka-examples:runExampleService and wait until you see "Service started and ready to process requests.." indicating that is had registered with eureka.
  3. Run the example client with ./gradlew :eureka-examples:runExampleClient.

Running the examples as an app

  1. Start up a local eureka server
  2. Build a zip distribution with ./gradlew :eureka-examples:distZip
  3. In the distribution run ./bin/ExampleEurekaService and wait until you see "Service started and ready to process requests.." indicating that is had registered with eureka.
  4. In the distribution run ./bin/ExampleEurekaClient to run the example client.

Examples Provided

ExampleEurekaService

An example service that registers itself with eureka. (Note: prefer the DI version of creation in ExampleEurekaGovernatedService).

ExampleEurekaGovernatedService

The same as the ExampleEurekaService, where Governator/Guice is used to initialize everything. The gradle javaExec for this is ./gradlew :eureka-examples:runExampleGovernatedService and the distribution generated script is ./bin/ExampleEurekaGovernatedService

ExampleEurekaClient

An example use case of the eureka client to find a particular application/vip (in this case the example service) via eureka for communication.