This project has been integrated in Lagom 1.5.1 and 1.4.12 and therefore this repository is now archived.

Further developement will be done on Lagom project.

This project provides:

• AkkaDiscoveryServiceLocator, a Lagom ServiceLocator implementation based on Akka Discovery
• AkkaDiscoveryServiceLocatorModule, a Guice Module to wire-up the AkkaDiscoveryServiceLocator when using runtime-time DI.
• AkkaDiscoveryComponents, a cake component to wire-up the AkkaDiscoveryServiceLocator when using compile-time DI (macwire).

Additionally, you will need to choose one of the existing Akka Discovery implementations and configure it for production in your application.

Version 1.0.0 or later of this library is ready to be used in production and its APIs are stable. It is Supported with a Lightbend Platform subscription.

This library is initially intended to be used with Lagom 1.5.x series. However, since the ServiceLocator API didn't change between Lagom 1.4.x and 1.5.x, using it with a Lagom 1.4.x application should not present a problem.

For sbt users, add the dependencies to your build.sbt file:

lazy val `hello-impl` = (project in file("hello-impl"))
  .enablePlugins(LagomJava)
  .settings(
    libraryDependencies ++= Seq(
      "com.lightbend.lagom" %% "lagom-javadsl-akka-discovery-service-locator" % "1.0.0",

      // for example, include Akka Discovery Kubernetes implementation
      // see https://doc.akka.io/docs/akka/2.5/discovery/index.html
      "com.lightbend.akka.discovery" %% "akka-discovery-kubernetes-api" % "1.0.0"
    )
  )

For maven users, add the dependencies to your pom.xml

<dependency>
    <groupId>com.lightbend.lagom</groupId>
    <artifactId>lagom-javadsl-akka-discovery-service-locator_2.12</artifactId>
    <version>1.0.0</version>
</dependency>

<!--
  for example, include Akka Discovery Kubernetes implementation
  see https://doc.akka.io/docs/akka/2.5/discovery/index.html
-->
<dependency>
    <groupId>com.lightbend.akka.discovery</groupId>
    <artifactId>akka-discovery-kubernetes-api_2.12</artifactId>
    <version>1.0.0</version>
</dependency>

The Guice module AkkaDiscoveryServiceLocatorModule will be added by default to your project, but will only wire in the AkkaDiscoveryServiceLocator when running in production mode.

In development, your Lagom application will keep using the Lagom's dev-mode ServiceLocator.

Next, you will need to configure Akka Discovery in your application.conf file. Consult the Akka Discovery documentation for further instructions.

Add the dependencies to your build.sbt file:

lazy val `hello-impl` = (project in file("hello-impl"))
  .enablePlugins(LagomScala)
  .settings(
    libraryDependencies ++= Seq(
      "com.lightbend.lagom" %% "lagom-scaladsl-akka-discovery-service-locator" % "1.0.0",

      // for example, include Akka Discovery Kubernetes implementation
      // see https://doc.akka.io/docs/akka/current/discovery/index.html
      "com.lightbend.akka.discovery" %% "akka-discovery-kubernetes-api" % "1.0.0"
    )
  )

Wire AkkaDiscoveryComponents in your ApplicationLoader:

class HelloServiceLoader extends LagomApplicationLoader {

  override def load(context: LagomApplicationContext): LagomApplication =
    new HelloProxyApplication(context) with AkkaDiscoveryComponents

  override def loadDevMode(context: LagomApplicationContext): LagomApplication =
    new HelloProxyApplication(context) with LagomDevModeComponents

  override def describeService = Some(readDescriptor[HelloService])

}

Next, you will need to configure Akka Discovery in your application.conf file. Consult the Akka Discovery documentation for further instructions.