Json2Ldap with Docker

The evaluation version of Json2Ldap is now also available as a Docker image.

1. Docker quick start

If Docker isn’t installed on your computer you can find instructions here. The Community Edition (CE) is sufficient to run a Json2Ldap instance.

The provided Docker image includes the required Java runtime and an Apache Tomcat web server with Json2Ldap installed as the sole application in it.

To run the Json2Ldap evaluation version in a Docker container:

Pull the latest image from Docker Hub

Where [version] is the latest available listed in the c2id Docker repository.
```
docker pull c2id/json2ldap-demo:[version]
```
Run a container with the Json2Ldap image

Replace host_port with an available port on your host:
```
docker run -p host_port:8080 --network host c2id/json2ldap-demo:[version]
```
The Json2Ldap configuration can be overridden with Java system properties passed via the CATALINA_OPTS environment variable into the container:
```
docker run -p host_port:8080 -e CATALINA_OPTS='-Dprop-name-1=value -Dprop-name-2=value' c2id/c2id-server:[version]
```
The CATALINA_OPTS environment variable can alternatively be stored in a text file passed via the --env-file switch.
Verify

Verify that the Json2Ldap service is up by opening its banner page with a web browser:

http://localhost:host_port/
Play

Check out the quick start guide.

When done the container can be terminated with Ctrl + C.

2. Docker file

The Docker file used to build the demo image of Json2Ldap:

# Use the Amazon Corretto Tomcat image
FROM tomcat:9.0.107-jdk17-corretto

# Label the maintainer
LABEL maintainer="support@connect2id.com"

# Add the Json2Ldap WAR as the root (/) web application
COPY war/eval/json2ldap.war /usr/local/tomcat/webapps/ROOT.war

# Direct Json2Ldap logging to STDOUT
ENV CATALINA_OPTS="-Dlog4j.loggers.root.appender=console"

# Expose port 8080
EXPOSE 8080

# Health check
HEALTHCHECK --interval=30s --timeout=3s \
  CMD curl -f http://localhost:8080/ || exit 1

# Launch Tomcat
CMD ["catalina.sh", "run"]