Page created: 12 May 2021
|
Page updated: 1 Nov 2021
The following sections show example of using environment variables to create containers.
The containers must be created in the following order:
- MongoDB
- ABS
- ASE
- Dashboard
Launch MongoDB container: Run the following command with some sample environment
variables to launch the MongoDB container:
docker run -d --name mongo --hostname mongo -e MONGO_USERNAME="new_mongo_user" \
-e MONGO_PASSWORD="new_mongo_password" \
-e WIRED_TIGER_CACHE_SIZE_GB="1.8" \
-e MONGO_SSL="true" pingidentity/mongo:4.2.0
Running this command creates the MongoDB container with settings in environment variable provided. If any of the environment variable is not used, then the container is launched with default values.
Launch ABS container: Run the following command with some sample environment
variables to launch the ABS
container:
docker run -d --name abs --hostname abs --link mongo:mongo -e MONGO_RS=mongodb://mongo:27017 \
-e MONGO_USERNAME="new_mongo_user" \
-e MONGO_PASSWORD="new_mongo_password" -e MONGO_SSL="true" \
-e ABS_ACCESS_KEY="new_abs_ak" \
-e ABS_SECRET_KEY="new_abs_sk" -e ABS_ACCESS_KEY_RU="new_abs_ak_ru" \
-e ABS_SECRET_KEY_RU="new_abs_sk_ru" \
-e ATTACK_INITIAL_TRAINING="24" \
-e API_DISCOVERY="true" -e API_DISCOVERY_INITIAL_PERIOD="6" \
-e API_DISCOVERY_UPDATE_INTERVAL="1" \
-e API_DISCOVERY_SUBPATH="3" \
pingidentity/abs:5.0
Launch ASE container: Run the following command with some sample environment
variables to launch the ASE container:
docker run -d --name ase --link abs:abs --hostname ase -e MODE="inline" \
-e ENABLE_CLUSTER="true" -e ENABLE_ABS="true" -e ABS_ENDPOINT="abs:8080" \
-e ABS_ACCESS_KEY="new_abs_ak" -e ABS_SECRET_KEY="new_abs_sk" --shm-size=1g pingidentity/ase:5.0
Launch the second ASE node in ASE cluster: Run the following command with some
sample environment variables to launch the ASE node in a cluster:
docker run -d --name ase1 --link abs:abs --link ase:ase --hostname ase1 \
-e MODE="inline" -e ENABLE_CLUSTER="true" \
-e PEER_NODE="ase:8020" -e ENABLE_ABS="true" \
-e ABS_ENDPOINT="abs:8080" -e ABS_ACCESS_KEY="new_abs_ak" \
-e ABS_SECRET_KEY="new_abs_sk" --shm-size=1g pingidentity/ase:5.0
Launch Dashboard: Run the following command with some sample environment variables
to launch the Dashboard
container:
docker run -d --name webgui --link abs:abs --link ase:ase --hostname webgui \
-e ABS_RESTRICTED_USER_ACCESS="false" \
-e ABS_ACCESS_KEY="new_abs_ak" -e ABS_SECRET_KEY="new_abs_sk" -e ABS_HOST="abs" \
-e ABS_URL="https://abs:8080" -e ASE_URL="https://ase:8010" \
-e DASHBOARD_URL="https://localhost:5601" -e WEBGUI_ADMIN_PASSWORD="new_webgui_admin_password" \
-e WEBGUI_PING_USER_PASSWORD="new_webgui_pinguser_password" \
-p 8030:8030 pingidentity/dashboard:5.0
Port mapping
When the containers are created, the exposed ports are not mapped. To map the ports,
you need to complete port mapping using the
-p
option in the
docker run
command. The following table lists the ports that
should be exposed in the container.Component | Port number | Usage |
ASE | 8080 | HTTP data plane |
8443 | HTTPS data plane | |
8010 | Management port number | |
8020 | Cluster port number | |
ABS | 8080 | API server port number |
Dashboard | 8030 | Dashboard port number |
MongoDB | 27017 | MongoDB port number |