Using Service Discovery with Eureka Server

This tutorial takes you through setting up two .NET Core applications using services discovery. The first will register it's endpoints for discovery, and the second will discover the first's services.

Note

For more detailed examples, please refer to the FortuneTeller (Discovery) solution in the Steeltoe Samples Repository.

First, start a Eureka Server using the Steeltoe dockerfile, start a local instance of Eureka.

docker run --publish 8761:8761 steeltoeoss/eureka-server

Next, create a .NET Core WebAPI that registers itself as a service.

1. Create a new ASP.NET Core WebAPI app with the Steeltoe Initializr

2. Name the project "EurekaRegisterExample"

3. Add the "Eureka Discovery Client" dependency

4. Click Generate to download a zip containing the new project

5. Extract the zipped project and open in your IDE of choice

6. Set the Eureka instance address in appsettings.json

   {
     "spring": {
       "application": {
         "name": "EurekaRegisterExample"
       }
     },
     "eureka": {
       "client": {
         "serviceUrl": "http://localhost:8761/eureka/",
         "shouldFetchRegistry": "false",
         "shouldRegisterWithEureka": true,
         "validateCertificates": false
       },
       "instance": {
         "port": "8080",
         "ipAddress": "localhost",
         "preferIpAddress": true
       }
     }
   }
   

   Tip

   Looking for additional params to use when connecting? Have a look at the docs.

7. Validate the port number the app will be served on, in launchSettings.json

   "iisSettings": {
     "windowsAuthentication": false,
     "anonymousAuthentication": true,
     "iisExpress": {
       "applicationUrl": "http://localhost:8080",
       "sslPort": 0
     }
   }
   

8. Run the application and confirm it has registered with Eureka

• .NET cli
• Visual Studio

dotnet run <PATH_TO>\EurekaRegisterExample.csproj

Navigate to the endpoint (you may need to change the port number) http://localhost:8080/api/values

1. Navigate to the Eureka dashboard at http://localhost:8761/ to see the service listed.
2. Leave the application running while you continue to the next steps, you'll be connecting to it.

Now, create another .NET Core WebAPI that will discover the registered service.

1. Create a new ASP.NET Core WebAPI app with the Steeltoe Initializr

2. Name the project "EurekaDiscoverExample"

3. Add the "Eureka Discovery Client" dependency

4. Click Generate to download a zip containing the new project

5. Extract the zipped project and open in your IDE of choice

6. Set the Eureka instance address in appsettings.json

   {
     "spring": {
       "application": {
         "name": "EurekaDiscoverExample"
       }
     },
     "eureka": {
       "client": {
         "serviceUrl": "http://localhost:8761/eureka/",
         "shouldFetchRegistry": "true",
         "shouldRegisterWithEureka": false,
         "validateCertificates": false
       },
       "instance": {}
     }
   }
   

7. Validate the port number the app will be served on, in launchSettings.json

   "iisSettings": {
     "windowsAuthentication": false,
     "anonymousAuthentication": true,
     "iisExpress": {
       "applicationUrl": "http://localhost:8081",
       "sslPort": 0
     }
   }
   

8. Change the values controller to make a request to the discovery service and return the result in contollers\ValuesController.cs

   using System.Threading.Tasks;
   using Microsoft.Extensions.Logging;
   using Microsoft.AspNetCore.Mvc;
   using Steeltoe.Common.Discovery;
   using System.Net.Http;
   
   [Route("api/[controller]")]
   [ApiController]
   public class ValuesController : ControllerBase {
     private readonly ILogger _logger;
     DiscoveryHttpClientHandler _handler;
     public ValuesController(ILogger<ValuesController> logger, IDiscoveryClient client) {
       _logger = logger;
       _handler = new DiscoveryHttpClientHandler(client);
     }
   
     // GET api/values
     [HttpGet]
     public async Task<string> Get() {
       var client = new HttpClient(_handler, false);
       return await client.GetStringAsync("http://EurekaRegisterExample/api/values");
     }
   }
   

   Note

   Notice the use of EurekaRegisterExample as the URI. Because Discovery has been enabled, the negotiation with the discovery Server happens automatically.

Run the app to see discovery in action

• .NET cli
• Visual Studio

dotnet run <PATH_TO>\EurekaDiscoverExample.csproj

Navigate to the endpoint (you may need to change the port number) http://localhost:8081/api/values

Once the discovery app loads in the browser you will see the 2 values that were retrieved from the registered app. "["value1","value2"]"