Skip to content

Latest commit

 

History

History
50 lines (41 loc) · 1.61 KB

README.md

File metadata and controls

50 lines (41 loc) · 1.61 KB
Raw

A [Giter8][g8] template for Akka HTTP in a docker image

Prerequisites:

  • JDK 8
  • sbt 1.1.1 or higher
  • Docker

Featuring:

  • Latest version of the libraries (akka, scala, spec2 json4s)
  • Json4s library with native backend
  • Spec2 for the test with an example API spec
  • Scalariform formatting according to Scala Style Guide
  • Optimized dockerization using alpine with openjdk8 (image is ~120MB)
  • Slf4j, TypesafeConfig and sbt revolver for code hot reloading
  • Example graylog_gelf configuration (disabled by default)

Open a console and run the following command to apply this template:

sbt -Dsbt.version=1.1.1 new https://github.com/araspitzu/akka-http-docker.g8

This template will prompt for the following parameters. Press Enter if the default values suit you:

  • name: Becomes the name of the project.
  • scala_version: Specifies the Scala version for this project.
  • akka_http_version: Specifies which version of Akka HTTP should be used for this project.
  • akka_version: Specifies which version of Akka should be used for this project.
  • json4sVersion: Specifies which version of Json4s should should be used for this project.
  • organization: Specifies the organization for this project.

To publish the docker image of the template you can cd into the name folder and run

docker build -t your_project_name .

the resulting image will have version tag 0.0.1 appended

Verify the image has been published with:

docker image ls

To run the example webserver execute:

docker run --rm -p8080:8080 <project_name>:0.0.1

Check its functioning with:

curl localhost:8080/hello/your_name