No description, website, or topics provided.
HTML Shell Java Makefile
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.

Wildfly Swarm - CentOS Docker image

This repository contains the source for building various versions of the WildFly Swarm application as a reproducible Docker image using source-to-image. The resulting image can be run using Docker.


WildFly Swarm versions currently provided are:

  • Whatever version your application uses

CentOS versions currently provided are:

  • CentOS7


To build a WildFly Swarm image from scratch, run:

$ git clone
$ cd sti-wildflyswarm
$ make build

Standalone Usage

To build a simple jee application using standalone S2I and then run the resulting image with Docker execute:

$ s2i build git:// openshift/wildflyswarm-10-centos7 wildflyswarmtest
$ docker run -p 8080:8080 wildflyswarmtest

Accessing the application:

$ curl

OpenShift 3 Usage

First ensure you have a working OpenShift 3 environment with the oc command in your path.

$ oc create -f

Wait for that wildflyswarm-10-centos7-build to complete. Monitor it with oc status. After it finishes:

$ oc new-app wildflyswarm-10-centos7~

Wait for the build and deployment to complete and then visit your app's service host/port (given by oc status) to see the sample app. The path /snoop.jsp will also test a JSP page and output some server information.


This repository also provides a S2I test framework, which launches tests to check functionality of a simple WildFly Swarm application built on top of the wildfly swarm image.

  • CentOS based image

    $ cd sti-wildflyswarm
    $ make test

Repository organization

  • <Image version>

    • Dockerfile

      CentOS based Dockerfile

    • s2i/bin/

      This folder contains scripts that are run by S2I:

      • assemble
      Is used to restore the build artifacts from the previous built (in case of
      'incremental build'), to install the sources into location from where the
      application will be run and prepare the application for deployment (eg.
      installing maven dependencies, building java code, etc..).
      • run
      This script is responsible for running the application built
      using WildFly Swarm.
      • save-artifacts
      In order to do an *incremental build* (iow. re-use the build artifacts
      from an already built image in a new image), this script is responsible for
      archiving those. In this image, this script will archive the
      maven dependencies and previously built java class files.
    • contrib/

      This folder contains commonly used modules

      • wfbin/

        Contains script used to launch wildfly after performing environment variable substitution into the standalone.xml configuration file.

    • test/

      This folder contains the S2I test framework with a simple JEE application.

      • test-app/

        A simple Node.JS echo server used for testing purposes by the S2I test framework.

      • run

        This script runs the S2I test framework.

  • hack/

    Folder containing scripts which are responsible for the build and test actions performed by the Makefile.

Image name structure

Structure: openshift/1-2-3
  1. Platform name (lowercase) - wildflyswarm
  2. Platform version(without dots) - 10
  3. Base builder image - centos7

Example: openshift/wildflyswarm-10-centos7 Environment variables

To set environment variables, you can place them as a key value pair into a .sti/environment file inside your source code repository.


    Overrides the default arguments passed to maven durin the build process


    This value will be appended to either the default maven arguments, or the value of MAVEN_ARGS if MAVEN_ARGS is set.


    If set, WildFly will attempt to define a MySQL datasource based on the assumption you have an OpenShift service named "mysql" defined. It will attempt to reference the following environment variables which are automatically defined if the "mysql" service exists: MYSQL_SERVICE_PORT MYSQL_SERVICE_HOST MYSQL_PASSWORD MYSQL_USER


    If set, WildFly will attempt to define a PostgreSQL datasource based on the assumption you have an OpenShift service named "postgresql" defined. It will attempt to reference the following environment variables which are automatically defined if the "postgresql" service exists: POSTGRESQL_SERVICE_PORT POSTGRESQL_SERVICE_HOST POSTGRESQL_PASSWORD POSTGRESQL_USER


Released under the Apache License 2.0. See the LICENSE file.