Skip to main content

         This documentation site is for previous versions. Visit our new documentation site for current releases.      

Installing Constellation by using Helm for Kubernetes

Updated on February 7, 2022

Test the latest run-time improvements by installing the Constellation engine, which offers improved performance, responsiveness, and a more convenient authoring experience for portals and views. Kubernetes users can deploy the Constellation update by using a Helm chart.

By using Helm for Kubernetes, you can set up Constellation as a multitenant service for your system.

Note: 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.
  • You have a Pega hosted lab system.
  • Your IT organization has already installed Constellation as a corporate wide service, possibly at the same time as they installed Infinity. This is the expected deployment type. Installing Constellation as a single corporate wide service requires network and security awareness.

In these cases, the Constellation engine is already a part of your development environment, and you only need to enable the framework for your applications. No Constellation install is necessary, you just need the URL for the Constellation service:

  • Pega Cloud: The regionally correct URL for the Pega Cloud Constellation service is embedded into Infinity during Infinity deployment.
  • Pega lab system: Your technical support contact provides the correct URL for the Pega hosted Constellation service.
  • IT organization installed Constellation as a single corporate wide service: This group provides you with the Constellation service URL.
Before you begin: Check your installation environment:
  • Contact Pega to gain access to the customer repository. Constellation files are in the Pega Infinity folder.
  • Ensure that you have a working Kubernetes cluster.
  • Ensure that you have Helm and Kubectl command line interface installed on your on-premises environment.
  • Ensure that you can communicate with the Kubernetes cluster by using Kubectl.
  • Review the process of implementing Constellation on your system. For more information, see Implementing Cosmos React UI in Pega Platform.
  1. In the Kubectl terminal window, create a namespace to which you want to deploy the service by entering kubectl create namespace <name of the namespace>.

    For example: kubectl create namespace Reactui.
  2. Create a secret with dockerconfig in the namespace by entering kubectl create secret generic regard --from-file=.dockerconfigjson=<path to dockerconfig.json> -n <name of the namespace>.

    Result: The system downloads the Constellation image to the cluster.
  3. Create a TLS secret with a certificate and a key by entering kubectl create secret tls ingresssecret --key <path to the key> --cert <path to the certificate> -n <name of the namespace>.

  4. Install NGINX Ingress Controller for Kubernetes.

    For more information, go to the NGINX website.
  5. In the terminal window, install Constellation by entering helm install <path to the ReactUI helm charts> --values <path to values.yaml> —namespace <name of the namespace> --generate-name.

    Result: The service is now available at https://<host name used in ingress>:<port exposed by nginx>/c11n.

Have a question? Get answers now.

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

Did you find this content helpful?

Want to help us improve this content?

We'd prefer it if you saw us at our best. is not optimized for Internet Explorer. For the optimal experience, please use:

Close Deprecation Notice
Contact us