UI Development: Getting started

Purpose

Instructions on how to run the NodeJS server (aka UI server) without deploying the UI container in Kubernetes (k8).

Why would you want to do this?

• When testing code change, you can avoid redeploying the UI docker container in k8.
• Gives you choice to use different k8 clusters with the same local UI server

Prerequisites

• NodeJS
• Maven
• kubectl CLI from Kubernetes
  • https://kubernetes.io/docs/tasks/tools/install-kubectl/
• oc CLI from OpenShift
  • https://docs.openshift.com/container-platform/3.11/cli_reference/get_started_cli.html

Step One: Build API server

• git clone git@github.com:kappnav/apis.git
• cd apis
• mvn install

Step Two: Start API server

• echo -Dkappnav.disable.trust.all.certs=true > ./target/liberty/wlp/usr/servers/defaultServer/jvm.options
• echo KAPPNAV_CONFIG_NAMESPACE=<namespace> > ./target/liberty/wlp/usr/servers/defaultServer/server.env
  • Replace <namespace> with the namespace where you installed kAppNav on your k8 environment
• ./target/liberty/wlp/bin/server start defaultServer --clean

Step Three: Build UI Server

• git clone git@github.com:kappnav/ui.git
• cd ui
• npm install
• npm run-script build

Step Four: Start UI Server

• KUBE_ENV=minikube KAPPNAV_CONFIG_NAMESPACE=<namespace> npm start
  • Replace <namespace> with the namespace where you installed kAppNav on your k8 environment

Step Five: Proxy k8 calls from local machine to k8 environment

• oc login -u username -p password https://<ipaddress>:<port>/