inspectit/jboss repository overview

⁠JBoss with inspectIT

JBoss Dockerfile including inspectIT

This docker image is based on the tutum/JBoss docker image including the inspectIT agent of the open source APM solution www.inspectit.rocks⁠. This image can be used easily as a replacement for the JBoss image, meaning you only have to change your existing Dockerfile FROM xyz/jboss:5 to FROM inspectit/jboss:5.

⁠Quickstart

First you need a running inspectIT CMR. You can use our docker image:

$ docker run -d --name inspectIT-CMR -p 8182:8182 -p 9070:9070 inspectit/cmr

Now you can start a container with the following command:

$ docker run -d --link inspectIT-CMR:cmr -p 8080:8080 inspectit/jboss:5

You can now adjust the instrumentation configuration with the inspectIT UI for your needs. Please refer to our documentation⁠ or just leave a comment.

##Usage To get the admin password of your new container, check the logs of the container by running:

docker logs <CONTAINER_ID>

You should see something like the following:

=> Configuring admin user with a random password in JBoss
=> Done!
========================================================================
You can now configure to this JBoss server using:

    admin:yDY4ZnRXw1Gy

========================================================================

⁠Configuration

⁠Agent name

By default, the inspectIT agent uses the hostname (docker-ID) as agent name. You can set a different name setting AGENT_NAME or hostname:

$ docker run -d --link inspectIT-CMR:cmr -p 8080:8080 -e AGENT_NAME=<agent-name> inspectit/jboss:5

$ docker run -d --link inspectIT-CMR:cmr -h <agent-name> -p 8080:8080 inspectit/jboss:5

⁠JBoss password

If you want to use your own password for the JBoss application server, then you can set a specific password setting JBOSS_PASS:

$ docker run -d --link inspectIT-CMR:cmr -h <agent-name> -p 8080:8080 -e JBOSS_PASS="<jboss-password>" inspectit/jboss:5

⁠Using a custom inspectIT CMR

If you don't want to use the inspectIT CMR docker image or cannot link to it, you can set the IP address and port manually:

$ docker run -d -e INSPECTIT_CMR_ADDR=<cmr-ip-address> -e INSPECTIT_CMR_PORT=<cmr-port> -p 8080:8080 inspectit/jboss:5

⁠Specifying the JBoss version

Currently, this image is based on the JBoss 5 image. Support for different version 6 and 7 is also available.

⁠Specifying the inspectIT version

Currently, this image is based on the latest beta inspectIT release. Later, support for other versions is added.

⁠Build the docker image

If you want to build the JBoss/as5 inspectIT image yourself, checkout this repository and run

$ docker build -t inspectit/jboss:5 .