jboss/uf-dashbuilder-showcase repository overview

⁠JBoss UF Dashbuilder Showcase Docker image

JBoss UF Dashbuilder Showcase Docker⁠ image.

⁠Table of contents

• Introduction
• Usage
• Users and roles
• Logging
• GIT internal repository access
• Extending this image
• Experimenting
• Notes
• Release notes

⁠Introduction

The image contains:

• JBoss Wildfly 8.2.0.Final
• JBoss UF Dashbuilder 0.3.4.Final

This image inherits from jboss/uf-dashbuilder:0.3.4.Final and provides some additional configurations:

• Default users and roles

This is a ready to run Docker image for JBoss UF Dashbuilder. Just run it and try UF Dashbuilder!

⁠Usage

To run a container:

docker run -p 8080:8080 -p 8001:8001 -d --name uf-dashbuilder jboss/uf-dashbuilder-showcase:0.3.4.Final

Once container and web applications started, you can navigate to it using one of the users described in section Users and roles, using the following URL:

    http://localhost:8080/dashbuilder
    

⁠Users and roles

This showcase image contains default users and roles:

USER        PASSWORD    ROLE
*************************************************
admin       admin       admin

⁠Logging

You can see all logs generated by the standalone binary running:

docker logs [-f] <container_id>

You can attach the container by running:

docker attach <container_id>

The UF Dashbuilder web application logs can be found inside the container at path:

/opt/jboss/wildfly/standalone/log/server.log

Example:
sudo nsenter -t $(docker inspect --format '{{ .State.Pid }}' $(docker ps -lq)) -m -u -i -n -p -w
-bash-4.2# tail -f /opt/jboss/wildfly/standalone/log/server.log

⁠GIT internal repository

The workbench stores all the project artifacts in an internal GIT repository. By default, the protocol available for accessing the GIT repository is SSH at port 8001.

This showcase image provides some examples at the uf-playground repository, that you can clone it by running:

git clone ssh://admin@localhost:8001/uf-playground

By default, the GIT repository is created when the application starts for first time at $WORKING_DIR/.niogit, considering $WORKING_DIR as the current directory where the application server is started.

You can specify a custom repository location by setting the following Java system property to your target file system directory:

    -Dorg.uberfire.nio.git.dir=/home/youruser/some/path

NOTE: This directory can be shared with your docker host and with another containers using shared volumes when running the container, if you need so.

If necessary you can make GIT repositories available from outside localhost using the following Java system property:

    -org.uberfire.nio.git.ssh.host=0.0.0.0
    

You can set this Java system properties permanent by adding the following lines in your standalone-full.xml file as:

    <system-properties>
      <!-- Custom repository location. -->
      <property name="org.uberfire.nio.git.dir" value="/home/youruser/some/path"/>
      <!-- Make GIT repositories available from outside localhost. -->
      <property name="org.uberfire.nio.git.ssh.host" value="0.0.0.0"/>
    </system-properties>

NOTE: Users and password for ssh access are the same that for the web application users defined at the realm files.

⁠Experimenting

To spin up a shell in one of the containers try:

docker run -p 8080:8080 -p 8001:8001 -d --name uf-dashbuilder jboss/uf-dashbuilder-showcase:0.3.4.Final /bin/bash

You can then noodle around the container and run stuff & look at files etc.

You can run the UF Dashbuilder web application by running command:

/opt/jboss/wildfly/bin/standalone.sh -b $JBOSS_BIND_ADDRESS --server-config=standalone-full-dashbuilder.xml

⁠Notes

• UF Dashbuilder version is 0.3.4.Final
• UF Dashbuilder requires running JBoss Wildfly using the full server profile
• No support for clustering
• Use of embedded H2 database server by default
• No support for Wildfly domain mode, just standalone mode
• The context path for UF Dashbuilder web application is dashbuilder

⁠Release notes

0.3.4.Final

• See release notes for UF Dashbuilder⁠ version 0.3.4.Final