Deployment of JAR and WAR archives
For JVM-based web applications, instead of deploying the code by building the code a pre-built autonomous JAR archive or WAR build can be directly deployed on the platform.
It can be especially useful when using a Continuous Integration platform like TravisCI or Jenkins. These platforms are usually building the project to execute the application test suites against it. Instead of building a second time the application code, the JAR and WAR archives generated during the build can be directly deployed on Scalingo.
This deployment method currently only supports Tomcat server to execute your archive.
Deploy a WAR Archive
You can deploy your WAR archive with the following command:
$ scalingo --app my-app deploy ./application.war -----> Deploying WAR archive: ./application.war -----> Uploading archive… Deployment started, streaming output: [LOG] Fetching source code [LOG] Fetching deployment cache [LOG] -----> Installing JDK 1.8... done [LOG] [LOG] -----> Build complete, uploading deployment cache. [LOG] Build complete, shipping your container... [LOG] Waiting for your application to boot... [LOG] <-- https://my-app.osc-fr1.scalingo.io -->
Deploy a JAR Archive
Deploying a JAR archive is slightly more complicated. You need to build a
.tar.gz archive with some specific files.
Create a directory which contains the JAR file, and a Procfile which explains how to start the application:
web: java -jar ./my-app.jar
.tar.gz archive content tree should be like:
Indicate to Scalingo deployment system the type of technology used by your application by defining the following environment variable:
scalingo --app my-app env-set BUILDPACK_URL="https://github.com/Scalingo/buildpack-jvm-common"
Last, deploy your archive with:
$ scalingo --app my-app deploy ./archive.tar.gz <-- Start deployment of my-app --> Fetching source code Fetching deployment cache -----> Cloning custom buildpack: https://github.com/Scalingo/buildpack-jvm-common#master -----> Installing JDK 1.8... done Build complete, shipping your container... Waiting for your application to boot... <-- https://my-app.osc-fr1.scalingo.io -->
JVM version selection
The used version of OpenJDK (Java runtime) can be defined by the environment
JAVA_VERSION. By default the 1.8 version will be used.
# Configure the application to use OpenJDK version 1.9 $ scalingo --app my-app env-set JAVA_VERSION=1.9
Webapp Runner / Tomcat version selection
By default, Tomcat 8.5 is installed with the last version of the webapp-runner,
if you want to use another version, you can defined the environment variable
WEBAPP_RUNNER_VERSION. You can find all the available versions
The 8.0.x versions are installing Tomcat 8, and the 8.5.x releases are installing Tomcat 8.5:
# Install Tomcat 8 $ scalingo env-set WEBAPP_RUNNER_VERSION=220.127.116.11