To use the Akka Cloud Platform, you first need to install prerequisites and install the Akka Operator in an Amazon EKS cluster. The Akka Operator manages Akka Microservices in all namespaces of the Kubernetes cluster, which means that you should only install the operator once. It is possible to configure the operator to only manage a specific namespace, if required.
The following image shows the components required to deploy an Akka Microservice using Akka Cloud Platform. The steps you are responsible for include:
Creating and publishing the Docker image
Updating the deployment descriptor and applying it to the Kubernetes cluster
The call-outs in the illustration highlight the following:
|1||A Kubernetes Custom Resource Definition named
|2||The installed Akka Operator runs continuously in the Kubernetes cluster.|
|3||You publish a Docker image containing the Akka Microservices application.|
|4||You define the deployment descriptor for the Akka Microservice in a yaml file. It refers to the Docker published image and specifies other operational properties. You apply the
|5||The Akka Operator sees the new deployment descriptor and creates a Kubernetes Deployment|
|6||Kubernetes downloads the application image and starts the Akka Microservices application. The Akka Operator automatically provides additional configuration to the application.|
To update the Akka Microservices application, you repeat steps 3 - 6. The Akka Operator sees the changes to the deployment descriptor and updates the Kubernetes Deployment accordingly. Kubernetes performs a rolling update of the application as shown in the illustration below.
|1||You build and publish the Docker image.|
|2||You apply the deployment descriptor.|
|3||The operator creates a separate Kubernetes Deployment for the other Microservice.|
|4||The pods and application are started.|
Each step of the Implementing Microservices with Akka tutorial has instructions of how to use Akka Cloud Platform to run the Microservices on Kubernetes.
Akka Management for Akka Cluster formation and health checks