Stand alone kubernetes configuration files for ConstellationUI Static service

Note:

Setup the service requires good understanding of containers and docker, https certificates, domain names and network server configuration. This is usually a task done by a K8s sys. admin.
In case you need help with the setup please contact pega support.
The K8s yaml files are simple examples of how to deploy the service. They must be customised to the specific network and cluster configuration.
In case you need help with the setup contact pega support.

Before you begin

Prepare for the installation

  1. Ensure that you have a working kubernetes cluster and the kubectl command line interface installed on your environment.

  2. Create a namespace for the Constellation static service in your cluster. - namespace 'c11n' is used in all examples here

    For example : kubectl create namespace c11n

  3. Obtain an API key from the Pega Digital Delivery site. For more information please check this page

  4. Prepare docker authentication. For more information please check this page

  5. Now create a secret to pull the docker images. Make sure that this is created in the same namespace as above.

    kubectl create secret generic regcred --from-file=.dockerconfigjson=<path to config.json from previous step> --type=kubernetes.io/dockerconfigjson -n c11n

  6. Run the following command to setup the service in your kubernetes cluster.

    kubectl apply -f https://documents.constellation.pega.io/static/86-87/c11n-static.yaml -n c11n

  7. ConstellationUI static service should now be reachable on http://constellation:3000/c11n inside your cluster.

  8. Please note that the above steps are only limited to deploying the constellation service in a working kubernetes cluster. Configuring the routing using the kubernetes ingress objects and a traditional loadbalancer should be done by the customers themselves. An example of configuring the ingress on AWS cloud is shown below.

  9. Once the service routing(with SSL) is setup you can set the Infinity ConstellationSvcURL DSS to your service URL and use the appstatic service.

Example configuration of an ingress in AWS cloud.

  1. Install the nginx-ingress on the kubernetes cluster. For more information please check this page
  2. The above step will also have created a loadbalancer of your choice in the cloud.
  3. Run the following command to setup the ingress in your kubernetes cluster.

    kubectl apply -f https://documents.constellation.pega.io/static/86-87/c11n-static-ingress.yaml -n c11n

  4. Now the service should be reachable from the loadbalancer URL. You can verify that by hitting the URL at

    <load-balancer-URL>/c11n/v860/ping

  5. The service must be exposed over https. Configuring a SSL certificate on the loadbalancer is the simplest approach.