praqma/confluence repository overview

⁠OpenSource ASK - Atlassian Software in Kubernetes (ASK) - Confluence

This respository is a component of ASK⁠ Atlassian Software in Kubernetes ; and holds program-code to create Docker image for Confluence Software (not Confluence Core).

Although the title says "Atlassian Software in Kubernetes", the container image can be run on plain Docker/Docker-Compose/Docker-Swarm, etc.

This image can be used to run a single / stand-alone instance of Confluence Software, or a clustered setup known as "Confluence DataCenter". You simply need to enable certain environment variables to get that done.

The source-code in this repository is released under MIT License, but the actual docker container images (binaries) built by it are not. You are free to use this source-code to build your own Confluence docker images and host them whereever you want. Please remember to consider various Atlassian and Oracle related lincense limitations when doing so.

⁠Description

• Uses Fedora 30 as base image.
• Uses Atlassian Confluence binary installer, which comes with built-in Oracle JDK - Adopt JDK/JRE in the newer installers.
• Exposes port 8090
• Supports data center mode and self signed certs.
• Can be setup behind a reverse proxy by setting up certain proxy related environment variables as mentioned below.

⁠Getting Started

⁠Build:

First, you need to build the container image.

docker build -t local/confluence:version-tag .

⁠Usage:

In it's simplest form, this image can be used by executing:

$ docker run -p 8090:8090 -d local/confluence:version-tag

If you want to set it up behind a reverse proxy, use the following command:

docker run \
  --name confluence \
  --publish 8090:8090 \
  --publish 8091:8091 \
  --env X_PROXY_NAME="confluence.example.com" \
  --env X_PROXY_PORT="8090" \
  --env X_PROXY_SCHEME="https" \
  --detach \
  praqma/confluence:<version-tag>

Note: When setting up Confluence behind a (GCE/AWS/other) proxy/load balancer, make sure to setup proxy/load-balancer timeouts to large values such as 300 secs or more. (The default is set to 60 secs). It is very important to setup these timeouts, as Confluence (and other atlassian software) can take significant time setting up initial database. Smaller timeouts will panic Confluence setup process and it will terminate.

If you run without providing any exisiting database, CONFLUENCE will run and will present you with the setup/wizard:

docker run \
  -p 8090:8090  \
  -d local/confluence:version-tag

If you want to use a different CONFLUENCE version, then simply change the version number in the Dockerfile, and rebuild the image.

⁠Certificates

Supply additional certificates from a single mounted directory.

docker run \
    --name confluence \
    --publish 8090:8090 \
    --publish 8091:8091 \
    --volume /path/to/certificates:/var/atlassian/ssl \
    --detach \
    owner/image:tag

See SSL_CERTS_PATH ENV variable in Dockerfile⁠.

Similar output should be shown by docker logs container-name.

Importing certificate: /var/atlassian/ssl/eastwind.crt ...
Certificate was added to keystore
Importing certificate: /var/atlassian/ssl/northwind.crt ...
Certificate was added to keystore
Importing certificate: /var/atlassian/ssl/southwind.pem ...
Certificate was added to keystore
Importing certificate: /var/atlassian/ssl/westwind.pem ...
Certificate was added to keystore

⁠User provided plugins:

If you want to add plugins of your choice, you can list their IDs in confluence-plugins.list file , one plugin at each line. You can volume-mount this file inside the container as /tmp/confluence-plugins.list . The docker-entrypoint.sh script will process this file and install the plugins. You can customize the location of this file in Dockerfile by setting the PLUGINS_FILE environment var to a different location.

docker run \
  -p 8090:8090  \
  -v ${PWD}/confluence-plugins.list:/tmp/confluence-plugins.list \
  -d local/confluence:version-tag

⁠Environment variables

The following environment variables can be set when building your docker image.

⁠Get newest version from Atlassian

You can use Curl and jq to get the latest version og download link for the installed used in this repository. It makes it easy when you need to build a newer image.

curl -s https://my.atlassian.com/download/feeds/current/confluence.json | sed 's\downloads(\\' | sed s'/.$//' | jq -r '.[] | select(.platform=="Unix") | "Url:" + .zipUrl, "Version:" + .version, "Edition:" + .edition'

Output :

Url:https://www.atlassian.com/software/confluence/downloads/binary/atlassian-confluence-6.15.4-x64.bin
Version:6.15.7
Edition:Standard

⁠Linter

You can use a linter that analyze source code to flag programming errors, bugs, stylistic errors, and suspicious constructs. There is dockerlinter⁠ , which does this quite easily.

⁠Installation

$ sudo npm install -g dockerlint

⁠Usage:

dockerlint Dockerfile

Above command will parse the file and notify you about any actual errors (such an omitted tag when : is set), and warn you about common pitfalls or bad idiom such as the common use case of ADD. In order to treat warnings as errors, use the -p flag.