LinkedIn
Copied!

Table of Contents

Installing Constellation by using Docker

Version:

Only available versions of this content are shown in the dropdown
Applicable to Cosmos React and Theme Cosmos applications

Explore the latest React-based run-time environment, which improves performance and responsiveness, and offers a revised set of user-friendly tools for authoring views and portals. You can use Docker to install the Constellation engine framework in your on-premises development environment.

You do not have to install Constellation manually if your environment meets any of the following criteria:
  • Pega Platform is hosted on Pega Cloud Services.
  • Pega Platform is hosted on a client-managed cloud environment.
  • Constellation was installed with Pega Infinity.
In such cases, the Constellation engine is already a part of your development environment, and you only need to enable the framework for your applications.
Prepare for the installation:
  1. Log in to Pega's Docker repository.

    docker login pega-docker.downloads.pega.com/constellationui/service:8.6.0-rc-latest
  2. In a terminal window, pull the Constellation container by entering docker pull pega-docker.downloads.pega.com/constellationui/service:8.6.0-rc-latest.

  3. Start the service by entering docker run -v /<path to folder with key certificate>:/host_folder -p 3443:3443 --name <container name> pega-docker.downloads.pega.com/constellationui/service:8.6.0-rc-latest httpsKey=<SSL key> httpsCert=<SSL certificate> urlPath=<service URL path> port=3443 logLevel=info

    The variables have the following values:
    • <path to folder with key certificate> is the absolute path to the local folder that contains the HTTPS key file and the certificate file.
    • <container name> is the name of the Docker container.
    • <SSL key> is the name of the key file.
    • <SSL certificate> is the name of the certificate file.
    • <service URL path> is the URL path on which the service is deployed. The path must match the load balancer or router traffic routing.
    docker run -p 3443:3443 -v /usr/abc/certs:/host_folder --name constellation-service pega-docker.downloads.pega.com/constellationui/service:8.6.0-rc-latest port=3443 urlPath=/c11n httpsKey=afile.key httpsCert=bfile.cert logLevel=info
    When you deploy behind a load balancer, the load balancer usually holds the SSL certificate. In this case, you do not need to add the certificate at this point.
For multiple containers, you can use a Docker compose file similar to the following example:



# sample compose file to show use of Constellation Static Service
# host_folder  needs to be mapped to the host folder containing the ssl cert and key files
# docker-compose -f docker-compose.yml up / docker-compose -f docker-compose.yml down -v

version: "3.2"

services:

  constellation:
    image: "pega-docker.downloads.pega.com/constellationui/service:8.6.0-rc-latest"
    ports:
    - "3443:3443"
    volumes:
      - /Users/johnn/ssl-cert:/host_folder
    command:  httpsKey=tomcat.key httpsCert=tomcat.cer info

Have a question? Get answers now.

Visit the Collaboration Center to ask questions, engage in discussions, share ideas, and help others.