DevOps Product Licenses ¶

To run the Ping Identity DevOps images, you must have a valid product license. You can use either of the following licenses for DevOps images.

Evaluation License ¶

When you register for Ping Identity's DevOps program, you are issued credentials that automate the process of retrieving an evaluation product license.

Evaluation License

Evaluation licenses are short-lived (30 days) and must not be used in production deployments.

Evaluation licenses can only be used with images published in the last 90 days. If you want to continue to use an image that was published more than 90 days ago, you must obtain a product license. After you have a product license for the product and version of the more-than-90-days-old image, follow the instructions to mount the product license.

Using your DevOps User/Key

Existing License ¶

Mount Existing Product License

Using Your DevOps User and Key ¶

When starting an image, you can provide your DevOps property file ~/.pingidentity/config or use the individual environment variables.

The examples provided for docker-compose are set up to use this property file by default.

For more details, run the pingctl info to view your DevOps environment information.

Example Docker Run Command ¶

The following example shows running a Docker image using the docker run command.

docker run \
  --name pingdirectory \
  --publish 1389:1389 \
  --publish 8443:1443 \
  --detach \
  --env SERVER_PROFILE_URL=https://github.com/pingidentity/pingidentity-server-profiles.git \
  --env SERVER_PROFILE_PATH=getting-started/pingdirectory \
  --env-file ~/.pingidentity/config \
  pingidentity/pingdirectory

Example YAML file ¶

The following example shows running a Docker image using any Docker .yaml file.

...
  pingdirectory:
    image: pingidentity/pingdirectory
    env_file:
      - ${HOME}/.pingidentity/config
    environment:
      - SERVER_PROFILE_URL=https://github.com/pingidentity/pingidentity-server-profiles.git
      - SERVER_PROFILE_PATH=getting-started/pingdirectory
...

Example Inline Env Variables ¶

This example shows running a Docker image using any Docker .yaml file where you specify inline environment variables. (See the two environment variables starting with PING_IDENTITY_DEVOPS).

...
  pingdirectory:
    image: pingidentity/pingdirectory
    environment:
      - SERVER_PROFILE_URL=https://github.com/pingidentity/pingidentity-server-profiles.git
      - SERVER_PROFILE_PATH=getting-started/pingdirectory
      - PING_IDENTITY_DEVOPS_USER=jsmith@example.com
      - PING_IDENTITY_DEVOPS_KEY=e9bd26ac-17e9-4133-a981-d7a7509314b2
...