Dockerfile for WSO2 Identity Server

This section defines the step-by-step instructions to build the Docker image for WSO2 Identity Server 5.5.0.

Prerequisites

• Docker v17.09.0 or above

How to build an image and run

1. Checkout this repository into your local machine using the following git command.

git clone https://github.com/wso2/docker-is.git

The local copy of the dockerfiles/is directory will be referred to as IS_DOCKERFILE_HOME from this point onwards.

2. Add JDK, WSO2 Identity Server distribution and MySQL connector to <IS_DOCKERFILE_HOME>/files

• Download JDK 1.8 and extract it to <IS_DOCKERFILE_HOME>/files.

• Download the WSO2 Identity Server 5.5.0 distribution (https://wso2.com/identity-and-access-management) and extract it to <IS_DOCKERFILE_HOME>/files.
  

• Once both JDK and WSO2 Identity Server distributions are extracted it may look as follows:

  <IS_DOCKERFILE_HOME>/files/jdk<version>/
  <IS_DOCKERFILE_HOME>/files/wso2is-5.5.0/

• Download MySQL Connector/J v5.1.45 and then copy that to <IS_DOCKERFILE_HOME>/files folder

Please refer to WSO2 Update Manager documentation in order to obtain latest bug fixes and updates for the product.

3. Build the Docker image.

• Navigate to <IS_DOCKERFILE_HOME> directory.
  Execute docker build command as shown below.
  • docker build -t wso2is:5.5.0 .

4. Running the Docker image.

• docker run -it -p 9443:9443 wso2is:5.5.0

Here, only port 9443 (HTTPS servlet transport) has been mapped to a Docker host port. You may map other container service ports, which have been exposed to Docker host ports, as desired.

6. Accessing management console.

• To access the management console, use the docker host IP and port 9443.
  • https://<DOCKER_HOST>:9443/carbon

In here, <DOCKER_HOST> refers to hostname or IP of the host machine on top of which containers are spawned.

How to update configurations

Configurations would lie on the Docker host machine and they can be volume mounted to the container.
As an example, steps required to change the port offset using carbon.xml is as follows.

1. Stop the Identity Server container if it's already running.

In WSO2 Identity Server 5.5.0 product distribution, carbon.xml configuration file
can be found at <DISTRIBUTION_HOME>/repository/conf. Copy the file to some suitable location of the host machine,
referred to as <SOURCE_CONFIGS>/carbon.xml and change the offset value under ports to 1.

2. Grant read permission to other users for <SOURCE_CONFIGS>/carbon.xml

chmod o+r <SOURCE_CONFIGS>/carbon.xml

3. Run the image by mounting the file to container as follows.

docker run \
-p 9444:9444 \
--volume <SOURCE_CONFIGS>/carbon.xml:<TARGET_CONFIGS>/carbon.xml \
wso2is:5.5.0

In here, <TARGET_CONFIGS> refers to /home/wso2carbon/wso2is-5.5.0/repository/conf folder of the container.

Docker command usage references

• Docker build command reference
• Docker run command reference
• Dockerfile reference