An experiment running http4s as native image with Graal (+ Substrate)
http4s-graal
is an experiment to get http4s web service running as native image with Graal (+ Substrate).
The following binaries / libraries need to be installed in order to compile the web service (including converting it to native image). The version numbers denotes the specific version used to develop the web service, it may not work under other minor versions:
bin
) to PATH
, e.g. export PATH=~/graalvm-ce-1.0.0-rc14/bin:$PATH
sbt assembly
on the project rootnative-image -H:+ReportUnsupportedElementsAtRuntime -jar target/scala-2.12/http4s-graal-assembly-0.0.1-SNAPSHOT.jar
./http4s-graal-assembly-0.0.1-SNAPSHOT
Now you can visit localhost:8080
from your browser.
Alternatively:
./scripts/graal/bin/setup.sh
to download and setup Graal../scripts/graal/bin/dist.sh
to create a native image distribution under the /dist
directory.Several Dockerfiles have been provided to allow project compilation and packaging, targeting multiple runtime
environments. It utilises multi-stage Docker builds, so no other dependency is required apart from Docker itself.
All containers by default will be accessible at port 9080, e.g. localhost:9080
.
Run ./scripts/graal/bin/build.sh -i <image>
where image is one of the following:
zulu8
(default) Azul Zulu 8 on Ubuntu 18.04zulu11
Azul Zulu 11 on Ubuntu 18.04graal
GraalVM on Oracle Linux 7 (slim)native
Graal + Substrate native image on Oracle Linux 7 (slim)NOTE: http4s Docker containers will be constrained to 1 CPU and 4GB of memory.
Portainer is an open-source web-based Docker management UI. It allows viewing of container stats in realtime: CPU and memory usage, networking, and processes running in the container.
./scripts/portainer/bin/setup.sh
to pull the latest Portainer image and create the data volume../scripts/portainer/bin/start.sh
to start the Portainer container:
localhost:9000
Portainer web UIGatling is an open-source load and performance testing framework based on Scala, Akka and Netty.
sbt gatling:test
to download, setup, and run Gatling load testing simulation(s).We follow the "feature-branch" Git workflow.
snake_case
convention):
chore/
prefix followed by the short description, e.g. chore/do_this_chore
feature/
prefix followed by the feature name, e.g. feature/feature_name
bug/
prefix followed by the short description, e.g. bug/fix_this_bug
develop
branch with your changesPlease read CONTRIBUTING for more details.
Copyright (c) 2018 - 2019 Herdy Handoko
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
http4s-graal
is released under the Apache Version 2.0 License. See the LICENSE file for further details.