You can deploy an Akka gRPC application just like you would any other JVM-based project. For some general pointers on this topic, see the deployment section of the Akka documentation.

Remember that the cleartext HTTP/2 “h2c with prior knowledge” protocol is not compatible with HTTP/1.1, so if your infrastructure uses any proxies they must either understand this protocol or support generic TCP connections.

Serve gRPC over HTTPS

To deploy your gRPC service over a HTTPS connection you will have to use an HttpsConnectionContextHttpsConnectionContext as described in the Akka-HTTP documentation.

Example: Kubernetes

As an example, here is a complete project consisting of two applications (a gRPC service and an HTTP service that consumes the gRPC service) that can be deployed together in Kubernetes.

Building Native Images

Building native images with Akka gRPC is supported. None of the functionality requires any special concerns, metadata for the libraries Akka gRPC uses are provided out of the box.

For details about building native images with Akka in general see the Akka Documentation

Found an error in this documentation? The source code for this page can be found here. Please feel free to edit and contribute a pull request.