Ping Identity DevOps Docker Image - `pingcentral`

This docker image includes the Ping Identity PingCentral product binaries and associated hook scripts to create and run PingCentral in a container.

pingidentity/pingbase - Parent Image

This image inherits, and can use, Environment Variables from pingidentity/pingbase
pingidentity/pingcommon - Common Ping files (i.e. hook scripts)

Environment Variables

The following environment ENV variables can be used with this image, in addition to any inherited from parent images.

ENV Variable	Default	Description
SHIM	${SHIM}
IMAGE_VERSION	${IMAGE_VERSION}
IMAGE_GIT_REV	${IMAGE_GIT_REV}
DATE	${DATE}
PING_PRODUCT_VERSION	${VERSION}
PING_CENTRAL_SERVER_PORT	9022
PING_PRODUCT	PingCentral	Ping product name
LICENSE_DIR	${SERVER_ROOT_DIR}/conf	License directory
LICENSE_FILE_NAME	pingcentral.lic	Name of license file
LICENSE_SHORT_NAME	PC	Short name used when retrieving license from License Server
LICENSE_VERSION	${LICENSE_VERSION}	Version used when retrieving license from License Server
STARTUP_COMMAND	${SERVER_ROOT_DIR}/bin/run.sh	The command that the entrypoint will execute in the foreground to instantiate the container
TAIL_LOG_FILES	${SERVER_ROOT_DIR}/log/application.log	Files tailed once container has started
PING_CENTRAL_LOG_LEVEL	INFO
PING_CENTRAL_BLIND_TRUST	false
PING_CENTRAL_VERIFY_HOSTNAME	true

ENV Variable

Default

Description

SHIM

${SHIM}

IMAGE_VERSION

${IMAGE_VERSION}

IMAGE_GIT_REV

${IMAGE_GIT_REV}

DATE

${DATE}

PING_PRODUCT_VERSION

${VERSION}

PING_CENTRAL_SERVER_PORT

9022

PING_PRODUCT

PingCentral

Ping product name

LICENSE_DIR

${SERVER_ROOT_DIR}/conf

License directory

LICENSE_FILE_NAME

pingcentral.lic

Name of license file

LICENSE_SHORT_NAME

Short name used when retrieving license from License Server

LICENSE_VERSION

${LICENSE_VERSION}

Version used when retrieving license from License Server

STARTUP_COMMAND

${SERVER_ROOT_DIR}/bin/run.sh

The command that the entrypoint will execute in the foreground to instantiate the container

TAIL_LOG_FILES

${SERVER_ROOT_DIR}/log/application.log

Files tailed once container has started

PING_CENTRAL_LOG_LEVEL

INFO

PING_CENTRAL_BLIND_TRUST

false

PING_CENTRAL_VERIFY_HOSTNAME

true

Ports Exposed

The following ports are exposed from the container. If a variable is used, then it may come from a parent container

9022

Running a PingCentral container

To run a PingCentral container with your devops configuration file:

docker run -Pt \
           --name pingcentral \
           --env-file ~/.pingidentity/config \
           --env PING_IDENTITY_ACCEPT_EULA=YES \
           --env PING_IDENTITY_DEVOPS_USER \
           --env PING_IDENTITY_DEVOPS_KEY \
           --tmpfs /run/secrets \
           pingidentity/pingcentral:edge

or with long options in the background:

  docker run \
           --name pingcentral \
           --publish 9022:9022 \
           --detach \
           --env-file ~/.pingidentity/config \
           --env PING_IDENTITY_ACCEPT_EULA=YES \
           --env PING_IDENTITY_DEVOPS_USER \
           --env PING_IDENTITY_DEVOPS_KEY \
           --tmpfs /run/secrets \
           pingidentity/pingcentral:edge

or if you want to specify everything yourself:

  docker run \
           --name pingcentral \
           --publish 9022:9022 \
           --detach \
           --env PING_IDENTITY_ACCEPT_EULA=YES \
           --env PING_IDENTITY_DEVOPS_USER \
           --env PING_IDENTITY_DEVOPS_KEY \
           --tmpfs /run/secrets \
           pingidentity/pingcentral:edge

Follow Docker logs with:

docker logs -f pingcentral

If using the command above with the embedded server profile, log in with:

https://localhost:9022/
Username: Administrator
Password: 2Federate

Docker Container Hook Scripts

Please go here for details on all pingcentral hook scripts

This document is auto-generated from pingcentral/Dockerfile