Install Helper (Advanced)

Install Helper is an advanced way to install PrimeHub and relative components. It uses environment variables to share common settings for multiple helm charts. Such as,

• Host name for ingress
• Airgap relative settings
• Keycloak settings
• Storage class

How to Use

Please clone the primehub repository or untar the primehub release

1. Init the configuration.

   export PRIMEHUB_SCHEME=https
   export PRIMEHUB_DOMAIN=primehub.example.com
   export PRIMEHUB_CONSOLE_DOCKER_USERNAME=<the primehub console repo user>
   export PRIMEHUB_CONSOLE_DOCKER_PASSWORD=<the primehub console repo password>
   export KC_USER=<user>
   export KC_PASSWORD=<password>
   export KC_SCHEME=https
   export KC_DOMAIN=id.example.com
   export PRIMEHUB_STORAGE_CLASS=<the storage class of RWO PVCs>
   
   make init
   

   then the configuration is generated to ~/.primehub/config/<cluster-name> or bin/phenv --path

2. Configure PrimeHub for advanced features. Please reference the environment variables and primehub chart configuration.

   For more detail of the configuration structure, please see install helper design

3. Install the metacontroller

   make metacontroller-install
   

4. Install the keycloak

   make keycloak-install
   

5. Install the primehub

   make primehub-install
   

Once complete, please check the http(s)://primehub.example.com/

Upgrade Primehub

1. Diff and install keycloak

   make release-diff-keycloak
   make release-install-keycloak
   

2. Diff and install primehub

   make release-diff-primehub
   make primehub-upgrade
   

Install Grafana

1. Create Grafana Keycloak client:

   make create-grafana-keycloak-client
   

   Don't forget to update .env about your GRAFANA_KEYCLOAK_PROXY_CLIENT_SECRET.

2. Set environment GRAFANA_ADMIN & GRAFANA_PASSWORD in .env file

   Never forget to assign their values, or it will be hard for you to log in as GRAFANA_ADMIN since Grafana will pick a random password if we didn't assign it before.

3. Check Helm difference:

   make component-diff-prometheus-operator
   

4. Install applications:

   make component-install-prometheus-operator
   

5. Check your Grafana ingress by running:

   kubectl get ingresses -n monitoring prometheus-operator-grafana
   

Upgrade individual helm Release

1. Get the releases in helm

   helm ls
   

2. Check the different

   make release-diff-<release name>
   

3. Upgrade

   make release-install-<release name>