Stand alone kubernetes configuration files for Constellation AppStatic 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.

The K8s yaml files are simple examples of how to deploy the service. They must be customised to the specific network and cluster configuration. Do not proceed if you do not know how to download, modify and execute the K8s files referenced below.

Prepare for the installation

  1. Ensure that you have a working kubernetes cluster and the kubectl command line interface installed on your environment. You need a working ingress and access to a valid https certificate for your domain.
  2. Create a namespace for Constellation App-Static service in your cluster. - namespace 'c11n-appstatic' is used in all examples here:

For example : kubectl create namespace c11n-appstatic

  1. Obtain an API key from the Pega Digital Delivery site. For more information please check this page
  2. Prepare docker authentication. For more information please check this page

Note: Installing and using ConstellationUI is independent of the other backing services. For use of Constellation UI instead of the traditional harness and section UI, only the Constellation image is necessary: https://downloads.pega.com/artifactory/pega-docker/constellation-appstatic-service/docker-image/1.0.3-20221017111244/

  1. With the Constellation App-Static image available in your Docker repository, create a K8s secret to pull the docker image during cluster install. Make sure that this is created in the same namespace as above.

kubectl create secret generic regcred --from-file=.dockerconfigjson= --type=kubernetes.io/dockerconfigjson -n c11n-appstatic

Installation

  1. Download, edit for your local repos and run the following command to setup the service in your kubernetes cluster.

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

  1. Constellation appstatic service should now be reachable on http://constellation-appstatic-service:3000/c11n-appstatic inside your cluster.
  2. Please note that the above steps are only limited to deploying the constellation-appstatic-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.
  3. Once the service routing(with SSL) is setup you can set the Infininty 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/88/c11n-appstatic-ingress.yaml -n c11n-appstatic

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

[load-balancer-URL]/c11n-appstatic/v860/ping

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

Demo Example