Introduction to Eureka Service Registry and Discovery

Apa itu Eureka? Eureka merupakan Netflix Service registration and Discovery Server and Client.

Salah satu contoh fungsi dari Eureka pada Service registration and Discovery adalah untuk memudahkan pengalamatan suatu service/microservice (atau lebih dikenal dengan individual Microservices addresses). Untuk Eureka sendiri akan terbagi kedalam dua bagian, yaitu Eureka server dan Eureka client.

Eureka server akan berfungsi untuk mememelihara (maintain) registry dari semua service/microservice yang telah di deploy/remove. Sedangkan Eureka client (service/microservices) dapat mendaftarkan (register) diri sendiri ke eureka server dan juga dapat men-discover service/microservices lain yang terdaftar pada eureka server. Ketika sebuah service/microservice mendaftarkan diri ke eureka server dengan melakukan beberapa konfigurasi pada satu file (application.yml) dan menambahkan sebuah anotasi "@EnableEurekaClient" pada main class maka maka si service/microservice akan memberikan /menyediakan metadata seperti host, port, dan health indicator sehingga bisa di execute/ discover oleh service/microservice lain.

Baiklah kita langsung saja masuk ke tutorial :

1.   Scenario :

• Terdapat eureka server yang akan menyediakan/memberikan service registry dan service discovery.
• Terdapat service karyawan yang berisi beberapa data terkait karyawan dan pastinya akan menjadi client service eureka, dimana service ini akan melakukan registry dirisendiri ke eureka service registry server.
• Terdapat service perusahaan yang hamper sama dengan service karyawan, namun disini kita akan meng-invoke service karyawan dan proses interaksi dengan service karyawan tidak lagi menggunakan absolute URl.

     2.  Create Eureka Server

• Untuk memudahkan pembuatan spring boot project kita bisa membuka link https://start.spring.io/ dan membuat project secara online. Lalu bisa kita generate projectnya dengan penambahan beberapa dependencies yaitu eurekaserver dan actuator, kemudian unzip project, selanjutnya tinggal kita buka/import di IDE kita. Isi beberapa kolom menyesuaikan dengan gambar di bawah ini : 
  
• Buka eureka server application yang baru saja kita import, kemudian pada main class yang sudah ter-create tambahkan anotasi @EnableEurekaServer. Seperti gambar di bawah ini : 
  
• Kita akan melakukan beberapa konfigurasi untuk eureka server. Tambahkan sebuah file application.yml pada folder Resources dan copy paste sources dibawah ini :
  server: port: ${PORT:9000} #port yang di pakai ketika eureka server akan di jalankan eureka: client: register-with-eureka: false #berarti eureka server tidak mendaftarkan diri sendiri fetch-registry: false server: wait-time-in-ms-when-sync-empty: 0
• Dan satu file bootstrap.yml pada Folder Resources juga, kemudian copy paste source dibawah ini :
  spring: application: name: eureka cloud: config: uri: ${CONFIG_SERVER_URL:http://localhost:8888}
• Run Application anda dan pada Web browser anda buka host http://localhost:9000. Maka akan muncul tampilan seperti gambar di bawah ini : 
  
• Kita dapat melihat bahwa pada table Application kita belum memiliki service yang terdaftar karena kita memang memiliki eureka client service/microservice.

     3.  Membuat service karyawan

• Buka kembali link https://start.spring.io/ dan membuat project secara online. Lalu bisa kita generate projectnya dengan penambahan beberapa dependencies dependencies yaitu Eureka Discovery, Web, Rest Repository dan actuator, kemudian unzip project, selanjutnya tinggal kita buka/import di IDE kita. Isi beberapa kolom menyesuaikan dengan gambar di bawah ini : 
  
• Buka eureka server application yang baru saja kita import, kemudian pada main class yang sudah ter-create tambahkan anotasi @EnableEurekaClient. Seperti gambar di bawah ini : 
  
• Kita akan melakukan beberapa konfigurasi untuk eureka client service karywan. Tambahkan sebuah file application.yml pada folder Resources dan copy paste sources dibawah ini :
  server: port: 9001 #default port where the service will be started eureka: #tells about the Eureka server details and its refresh time instance: leaseRenewalIntervalInSeconds: 1 leaseExpirationDurationInSeconds: 2 client: serviceUrl: defaultZone: http://127.0.0.1:9000/eureka/ healthcheck: enabled: true lease: duration: 5 spring: application: name: karyawan-service #current service name to be used by the eureka server management: security: enabled: false #disable the spring security on the management endpoints like /env, /refresh etc. logging: level: com.example.howtodoinjava: DEBUG
• Tambahkan sebuah file controller untuk REST data pada Folder yang sama dengan main class, copy paste source berikut :
  package com.example.Eureka.eurekaservicekaryawan; import java.util.ArrayList; import java.util.HashMap; import java.util.List; import java.util.Map; import org.springframework.web.bind.annotation.PathVariable; import org.springframework.web.bind.annotation.RequestMapping; import org.springframework.web.bind.annotation.RequestMethod; import org.springframework.web.bind.annotation.RestController; @RestController @RequestMapping(value = "/getdetailKaryawan") public class KaryawanRestController { private static Map<String, List<karyawan>> schooDB = new HashMap<String, List<karyawan>>(); static { schooDB = new HashMap<String, List<karyawan>>(); List<karyawan> lst = new ArrayList<karyawan>(); Karyawan std = new Karyawan("land", "Baru 1 bulan"); lst.add(std); std = new Karyawan("Doan", "Baru 2 bulan"); lst.add(std); schooDB.put("NST", lst); lst = new ArrayList<karyawan>(); std = new Karyawan("Jefta", "Baru 3 bulan"); lst.add(std); std = new Karyawan("Jefri", "Baru 4 bulan"); lst.add(std); schooDB.put("NostraTech", lst); } @RequestMapping(value = "/{perusahaan}", method = RequestMethod.GET) public List<karyawan> getKaryawan(@PathVariable String perusahaan) { System.out.println("detail karyawan untuk" + perusahaan); List<karyawan> karyawanList = schooDB.get(perusahaan); if (karyawanList == null) { karyawanList = new ArrayList<karyawan>(); Karyawan std = new Karyawan("Not Found", "N/A"); karyawanList.add(std); } return karyawanList; } }
• Tambahakan sebuah file POJO untuk file Controller diatas, copy paste source berikut :
  package com.example.Eureka.eurekaservicekaryawan; public class Karyawan { private String name; private String bulanKerja; public Karyawan(String name, String bulanKerja) { super(); this.name = name; this.bulanKerja = bulanKerja; } public String getName() { return name; } public void setName(String name) { this.name = name; } public String getbulanKerja() { return bulanKerja; } public void setbulanKerja(String className) { this.bulanKerja = className; } }
• Run kembali eureka server dan karyawan service anda, perhatikan pada gambar perubahan yang terjadi. Pada Application table sudah ada satu service/microservice yang ter-registry.
  
• Dan kemudian klik link application yang sudah terdaftar dan kemudian ubah urlnya sesuai url yang terdaftar di Rest Controller anda. Berikut adalah hasil run microservice : 
  

     4.  Membuat service perusahaan

• Buka kembali link https://start.spring.io/ dan membuat project secara online. Lalu bisa kita generate projectnya dengan penambahan beberapa dependencies dependencies yaitu Eureka Discovery, Web, Rest Repository dan actuator, kemudian unzip project, selanjutnya tinggal kita buka/import di IDE kita. Isi beberapa kolom menyesuaikan dengan gambar di bawah ini : 
  
• Buka eureka server application yang baru saja kita import, kemudian pada main class yang sudah ter-create tambahkan anotasi @EnableEurekaClient. Seperti gambar di bawah ini : 
  
• Kita akan melakukan beberapa konfigurasi untuk eureka client service karywan. Tambahkan sebuah file application.yml pada folder Resources dan copy paste sources dibawah ini :
  server: port: 9002 #port number eureka: instance: leaseRenewalIntervalInSeconds: 1 leaseExpirationDurationInSeconds: 2 client: serviceUrl: defaultZone: http://127.0.0.1:9000/eureka/ healthcheck: enabled: true lease: duration: 5 spring: application: name: perusahaan-service #service name logging: level: com.example.howtodoinjava: DEBUG
• Tambahkan sebuah file controller untuk REST data pada Folder yang sama dengan main class, copy paste source berikut :
  package com.example.Eureka.eurekaserviceperusahaan; import org.springframework.beans.factory.annotation.Autowired; import org.springframework.cloud.client.loadbalancer.LoadBalanced; import org.springframework.context.annotation.Bean; import org.springframework.core.ParameterizedTypeReference; import org.springframework.http.HttpMethod; import org.springframework.web.bind.annotation.PathVariable; import org.springframework.web.bind.annotation.RequestMapping; import org.springframework.web.bind.annotation.RequestMethod; import org.springframework.web.bind.annotation.RestController; import org.springframework.web.client.RestTemplate; @RestController public class PerusahaanServiceController { @Autowired RestTemplate restTemplate; @RequestMapping(value = "/detailPerusahaan/{perusahaan}", method = RequestMethod.GET) public String getStudents(@PathVariable String perusahaan) { System.out.println("Getting perusahaan details for " + perusahaan); String response = restTemplate.exchange("http://karyawan-service/getdetailKaryawan/{perusahaan}", HttpMethod.GET, null, new ParameterizedTypeReference<string>() {}, perusahaan).getBody(); System.out.println("Response Received as " + response); return " Nama Perusahaan - " + perusahaan + " \n karyawan Details " + response; } @Bean @LoadBalanced public RestTemplate restTemplate() { return new RestTemplate(); } }
• Run kembali eureka server karyawan service dan perusahaan service anda, perhatikan pada gambar perubahan yang terjadi pada dashboard eureka server. Pada Application table sudah ada dua service/microservice yang ter-registry
  
• Jalankan masing-masing service dan lihat hasilnya. 

  

  Perusahaan Service

  

  Karyawan service
  
  
  

  
  

      References :

• https://dzone.com/articles/microservice-spring-cloud-eureka-server-configurat
• https://dzone.com/articles/the-netflix-stack-using-spring-boot-part-1-eureka
• https://dzone.com/articles/microservices-communication-eureka-client
• https://bushkarl.gitbooks.io/spring-cloud/content/spring_cloud_netflix/service_discovery_eureka_clients.html
• https://howtodoinjava.com/spring/spring-cloud/spring-cloud-service-discovery-netflix-eureka/