underpost 2.89.0 → 2.89.2

package/.github/workflows/release.cd.yml

@@ -30,7 +30,9 @@ jobs:
             echo "Starting remote release deploy"
             underpost run pull
             underpost run secret
+            npm install -g underpost
             cd /home/dd/engine
+            underpost run secret
             node bin run --dev git-conf
             node bin run --dev template-deploy-image
             node bin run --dev ssh-deploy sync-engine-test

package/README.md

@@ -18,7 +18,7 @@
 
 <!-- badges -->
 
-[![Node.js CI](https://github.com/underpostnet/engine/actions/workflows/docker-image.ci.yml/badge.svg?branch=master)](https://github.com/underpostnet/engine/actions/workflows/docker-image.yml) [![Test](https://github.com/underpostnet/engine/actions/workflows/coverall.ci.yml/badge.svg?branch=master)](https://github.com/underpostnet/engine/actions/workflows/coverall.ci.yml) [![Downloads](https://img.shields.io/npm/dm/underpost.svg)](https://www.npmjs.com/package/underpost) [![Socket Badge](https://socket.dev/api/badge/npm/package/underpost/2.89.0)](https://socket.dev/npm/package/underpost/overview/2.89.0) [![Coverage Status](https://coveralls.io/repos/github/underpostnet/engine/badge.svg?branch=master)](https://coveralls.io/github/underpostnet/engine?branch=master) [![Version](https://img.shields.io/npm/v/underpost.svg)](https://www.npmjs.org/package/underpost) [![License](https://img.shields.io/npm/l/underpost.svg)](https://www.npmjs.com/package/underpost)
+[![Node.js CI](https://github.com/underpostnet/engine/actions/workflows/docker-image.ci.yml/badge.svg?branch=master)](https://github.com/underpostnet/engine/actions/workflows/docker-image.yml) [![Test](https://github.com/underpostnet/engine/actions/workflows/coverall.ci.yml/badge.svg?branch=master)](https://github.com/underpostnet/engine/actions/workflows/coverall.ci.yml) [![Downloads](https://img.shields.io/npm/dm/underpost.svg)](https://www.npmjs.com/package/underpost) [![Socket Badge](https://socket.dev/api/badge/npm/package/underpost/2.89.2)](https://socket.dev/npm/package/underpost/overview/2.89.2) [![Coverage Status](https://coveralls.io/repos/github/underpostnet/engine/badge.svg?branch=master)](https://coveralls.io/github/underpostnet/engine?branch=master) [![Version](https://img.shields.io/npm/v/underpost.svg)](https://www.npmjs.org/package/underpost) [![License](https://img.shields.io/npm/l/underpost.svg)](https://www.npmjs.com/package/underpost)
 
 <!-- end-badges -->
 
@@ -66,7 +66,7 @@ Run dev client server
 npm run dev
 ```
 <!-- -->
-## underpost ci/cd cli v2.89.0
+## underpost ci/cd cli v2.89.2
 
 ### Usage: `underpost [options] [command]`
   ```

package/bin/index.js

@@ -1,5 +1,12 @@
 #! /usr/bin/env node
 
 import { program } from '../src/cli/index.js';
+import { loggerFactory } from '../src/server/logger.js';
 
-program.parse();
+const logger = loggerFactory(import.meta);
+
+try {
+  program.parse();
+} catch (error) {
+  logger.error(error);
+}

package/cli.md

@@ -1,4 +1,4 @@
-## underpost ci/cd cli v2.89.0
+## underpost ci/cd cli v2.89.2
 
 ### Usage: `underpost [options] [command]`
   ```
@@ -277,6 +277,8 @@ Options:
                           kubeconfig files.
   --k3s                   Initializes the cluster using K3s (Lightweight
                           Kubernetes).
+  --hosts <hosts>         A comma-separated list of cluster hostnames or IP
+                          addresses.
   -h, --help              display help for command
  
 ```
@@ -289,50 +291,53 @@ Options:
 Manages application deployments, defaulting to deploying development pods.
 
 Arguments:
-  deploy-list                       A comma-separated list of deployment IDs
-                                    (e.g., "default-a,default-b").
-  env                               Optional: The environment for deployment
-                                    (e.g., "development", "production").
-                                    Defaults to "development".
+  deploy-list                        A comma-separated list of deployment IDs
+                                     (e.g., "default-a,default-b").
+  env                                Optional: The environment for deployment
+                                     (e.g., "development", "production").
+                                     Defaults to "development".
 
 Options:
-  --remove                          Deletes specified deployments and their
-                                    associated services.
-  --sync                            Synchronizes deployment environment
-                                    variables, ports, and replica counts.
-  --info-router                     Displays the current router structure and
-                                    configuration.
-  --expose                          Exposes services matching the provided
-                                    deployment ID list.
-  --info-util                       Displays useful `kubectl` utility
-                                    management commands.
-  --cert                            Resets TLS/SSL certificate secrets for
-                                    deployments.
-  --cert-hosts <hosts>              Resets TLS/SSL certificate secrets for
-                                    specified hosts.
-  --node <node>                     Sets optional node for deployment
-                                    operations.
-  --build-manifest                  Builds Kubernetes YAML manifests, including
-                                    deployments, services, proxies, and
-                                    secrets.
-  --replicas <replicas>             Sets a custom number of replicas for
-                                    deployments.
-  --image <image>                   Sets a custom image for deployments.
-  --versions <deployment-versions>  A comma-separated list of custom deployment
-                                    versions.
-  --traffic <traffic-versions>      A comma-separated list of custom deployment
-                                    traffic weights.
-  --disable-update-deployment       Disables updates to deployments.
-  --disable-update-proxy            Disables updates to proxies.
-  --status                          Retrieves current network traffic data from
-                                    resource deployments and the host machine
-                                    network configuration.
-  --kubeadm                         Enables the kubeadm context for deployment
-                                    operations.
-  --etc-hosts                       Enables the etc-hosts context for
-                                    deployment operations.
-  --restore-hosts                   Restores default `/etc/hosts` entries.
-  -h, --help                        display help for command
+  --remove                           Deletes specified deployments and their
+                                     associated services.
+  --sync                             Synchronizes deployment environment
+                                     variables, ports, and replica counts.
+  --info-router                      Displays the current router structure and
+                                     configuration.
+  --expose                           Exposes services matching the provided
+                                     deployment ID list.
+  --info-util                        Displays useful `kubectl` utility
+                                     management commands.
+  --cert                             Resets TLS/SSL certificate secrets for
+                                     deployments.
+  --cert-hosts <hosts>               Resets TLS/SSL certificate secrets for
+                                     specified hosts.
+  --node <node>                      Sets optional node for deployment
+                                     operations.
+  --build-manifest                   Builds Kubernetes YAML manifests,
+                                     including deployments, services, proxies,
+                                     and secrets.
+  --replicas <replicas>              Sets a custom number of replicas for
+                                     deployments.
+  --image <image>                    Sets a custom image for deployments.
+  --versions <deployment-versions>   A comma-separated list of custom
+                                     deployment versions.
+  --traffic <traffic-versions>       A comma-separated list of custom
+                                     deployment traffic weights.
+  --disable-update-deployment        Disables updates to deployments.
+  --disable-update-proxy             Disables updates to proxies.
+  --disable-deployment-proxy         Disables proxies of deployments.
+  --status                           Retrieves current network traffic data
+                                     from resource deployments and the host
+                                     machine network configuration.
+  --kubeadm                          Enables the kubeadm context for deployment
+                                     operations.
+  --etc-hosts                        Enables the etc-hosts context for
+                                     deployment operations.
+  --restore-hosts                    Restores default `/etc/hosts` entries.
+  --disable-update-underpost-config  Disables updates to Underpost
+                                     configuration during deployment.
+  -h, --help                         display help for command
  
 ```
   
@@ -623,7 +628,7 @@ Options:
 Runs a script from the specified path.
 
 Arguments:
-  runner-id                                The runner ID to run. Options: spark-template, rmi, kill, secret, underpost-config, gpu-env, tf-gpu-test, dev-cluster, ssh-cluster-info, dev-hosts-expose, dev-hosts-restore, cluster-build, template-deploy, template-deploy-image, clean, pull, release-deploy, ssh-deploy, ide, sync, tz, cron, ls-deployments, ls-images, host-update, dev-container, monitor, db-client, git-conf, promote, metrics, cluster, deploy, dev, service, sh, log, release-cmt, sync-replica, tf-vae-test, deploy-job.
+  runner-id                                The runner ID to run. Options: spark-template, rmi, kill, secret, underpost-config, gpu-env, tf-gpu-test, dev-cluster, metadata, svc-ls, svc-rm, ssh-cluster-info, dev-hosts-expose, dev-hosts-restore, cluster-build, template-deploy, template-deploy-image, clean, pull, release-deploy, ssh-deploy, ide, sync, tz, cron, ls-deployments, ls-images, host-update, dev-container, monitor, db-client, git-conf, promote, metrics, cluster, deploy, dev, service, sh, log, release-cmt, sync-replica, tf-vae-test, deploy-job.
   path                                     The absolute or relative directory path where the script is located.
 
 Options:
@@ -632,7 +637,10 @@ Options:
   --dev                                    Sets the development context environment for the script.
   --build                                  Set builder context runner
   --replicas <replicas>                    Sets a custom number of replicas for deployment.
-  --pod-name <pod-name>                    Optional: Specifies the pod name for test execution.
+  --pod-name <pod-name>                    Optional: Specifies the pod name for execution.
+  --node-name <node-name>                  Optional: Specifies the node name for execution.
+  --port <port>                            Optional: Specifies the port for execution.
+  --etc-hosts                              Enables etc-hosts context for the runner execution.
   --volume-host-path <volume-host-path>    Optional: Specifies the volume host path for test execution.
   --volume-mount-path <volume-mount-path>  Optional: Specifies the volume mount path for test execution.
   --volume-type <volume-type>              Optional: Specifies the volume type for test execution.

package/manifests/deployment/dd-default-development/deployment.yaml

@@ -17,7 +17,7 @@ spec:
     spec:
       containers:
         - name: dd-default-development-blue
-          image: localhost/rockylinux9-underpost:v2.89.0
+          image: localhost/rockylinux9-underpost:v2.89.2
           #          resources:
           #            requests:
           #              memory: "124Ki"
@@ -100,7 +100,7 @@ spec:
     spec:
       containers:
         - name: dd-default-development-green
-          image: localhost/rockylinux9-underpost:v2.89.0
+          image: localhost/rockylinux9-underpost:v2.89.2
           #          resources:
           #            requests:
           #              memory: "124Ki"

package/manifests/deployment/dd-test-development/deployment.yaml

@@ -17,7 +17,7 @@ spec:
     spec:
       containers:
         - name: dd-test-development-blue
-          image: localhost/rockylinux9-underpost:v2.89.0
+          image: localhost/rockylinux9-underpost:v2.89.2
 #          resources:
 #            requests:
 #              memory: "96294Ki"
@@ -104,7 +104,7 @@ spec:
     spec:
       containers:
         - name: dd-test-development-green
-          image: localhost/rockylinux9-underpost:v2.89.0
+          image: localhost/rockylinux9-underpost:v2.89.2
 #          resources:
 #            requests:
 #              memory: "96294Ki"

package/manifests/deployment/dd-test-development/proxy.yaml

@@ -10,6 +10,7 @@ spec:
   routes:
     - conditions:
         - prefix: /
+      
       enableWebsockets: true
       services:
         - name: dd-test-development-blue-service
@@ -18,6 +19,7 @@ spec:
     
     - conditions:
         - prefix: /peer
+      
       enableWebsockets: true
       services:
         - name: dd-test-development-blue-service
@@ -35,6 +37,7 @@ spec:
   routes:
     - conditions:
         - prefix: /
+      
       enableWebsockets: true
       services:
         - name: dd-test-development-blue-service
@@ -43,6 +46,7 @@ spec:
     
     - conditions:
         - prefix: /peer
+      
       enableWebsockets: true
       services:
         - name: dd-test-development-blue-service

package/manifests/grafana/deployment.yaml

@@ -21,6 +21,13 @@ spec:
       containers:
         - name: grafana
           image: grafana/grafana:latest
+          env:
+            # - name: GF_SERVER_ROOT_URL
+            #   value: '{{GF_SERVER_ROOT_URL}}'
+            - name: GF_SERVER_ROOT_URL
+              value: '/grafana'
+            - name: GF_SERVER_SERVE_FROM_SUB_PATH
+              value: 'true'
           imagePullPolicy: IfNotPresent
           ports:
             - containerPort: 3000

package/manifests/grafana/kustomization.yaml

@@ -2,6 +2,6 @@
 apiVersion: kustomize.config.k8s.io/v1beta1
 kind: Kustomization
 resources:
+  - storage-class.yaml
   - pvc.yaml
-  - deployment.yaml
   - service.yaml

package/manifests/grafana/pvc.yaml

@@ -6,7 +6,7 @@ metadata:
 spec:
   accessModes:
     - ReadWriteOnce
-  storageClassName: local-path
+  storageClassName: grafana-storage-class
   resources:
     requests:
       storage: 5Gi

package/manifests/grafana/storage-class.yaml

@@ -0,0 +1,9 @@
+apiVersion: storage.k8s.io/v1
+kind: StorageClass
+metadata:
+  name: grafana-storage-class
+  annotations:
+    storageclass.kubernetes.io/is-default-class: 'false'
+provisioner: rancher.io/local-path
+reclaimPolicy: Retain
+volumeBindingMode: WaitForFirstConsumer

package/package.json

@@ -2,7 +2,7 @@
     "type": "module",
     "main": "src/index.js",
     "name": "underpost",
-    "version": "2.89.0",
+    "version": "2.89.2",
     "description": "pwa api rest template",
     "scripts": {
         "start": "env-cmd -f .env.production node --max-old-space-size=8192 src/server",

package/scripts/rpmfusion-ffmpeg-setup.sh

@@ -0,0 +1,55 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+# Purpose: enable required repos (CRB, EPEL, RPM Fusion) and attempt to install ffmpeg on Rocky/Alma/RHEL-9 compatible systems.
+
+if [ "${EUID:-$(id -u)}" -ne 0 ]; then
+  echo "This script must be run as root or with sudo. Exiting."
+  exit 1
+fi
+
+echo "1) Ensure dnf-plugins-core is available (for config-manager)"
+dnf -y install dnf-plugins-core || true
+
+echo "2) Enable CodeReady / CRB (needed for some deps, e.g. ladspa)"
+# On RHEL you'd use subscription-manager; on CentOS/Rocky/Alma use config-manager
+dnf config-manager --set-enabled crb || true
+
+echo "3) Install EPEL release (required by some ffmpeg deps)"
+dnf -y install https://dl.fedoraproject.org/pub/epel/epel-release-latest-9.noarch.rpm || true
+
+echo "4) Add RPM Fusion (free + nonfree) repositories"
+# Using mirrors.rpmfusion.org recommended links
+dnf -y install https://mirrors.rpmfusion.org/free/el/rpmfusion-free-release-9.noarch.rpm \
+               https://mirrors.rpmfusion.org/nonfree/el/rpmfusion-nonfree-release-9.noarch.rpm || true
+
+echo "5) Refresh metadata and update system"
+dnf -y makecache
+# Optional: update system packages (comment out if you don't want a full update)
+# dnf -y update
+
+echo "6) Try to install audio helper packages that sometimes block ffmpeg (ladspa, rubberband)"
+# These may be provided by CRB/EPEL or other compatible repos
+dnf -y install ladspa || echo "ladspa not available from enabled repos (will try later)"
+dnf -y install rubberband || echo "rubberband not available from enabled repos (will try later)"
+
+echo "7) Try installing ffmpeg (several fallbacks tried)"
+if dnf -y install ffmpeg ffmpeg-devel --allowerasing; then
+  echo "ffmpeg installed successfully (used --allowerasing)."
+elif dnf -y install ffmpeg ffmpeg-devel --nobest; then
+  echo "ffmpeg installed successfully (used --nobest)."
+elif dnf -y install ffmpeg ffmpeg-devel --skip-broken; then
+  echo "ffmpeg installed (skip-broken). Some optional packages may have been skipped."
+else
+  echo "Automatic install failed."
+  echo "Helpful troubleshooting steps:"
+  echo " - Check which repo provides ladspa: dnf repoquery --whatprovides 'ladspa'"
+  echo " - Check which package provides librubberband: dnf repoquery --whatprovides 'librubberband.so.2'"
+  echo " - Try enabling CRB and EPEL (we already attempted that). If ladspa/rubberband are still missing you can fetch their EL9 rpm from a trusted mirror or build them."
+  echo " - Example manual install (ONLY if you trust the source): sudo dnf install /path/to/ladspa-*.el9.rpm /path/to/rubberband-*.el9.rpm"
+  echo " - After satisfying ladspa/rubberband, rerun: sudo dnf install ffmpeg ffmpeg-devel"
+  exit 2
+fi
+
+echo "\nInstallation finished. Verify with: ffmpeg -version"
+exit 0

package/src/cli/cluster.js

@@ -58,6 +58,7 @@ class UnderpostCluster {
      * @param {boolean} [options.config=false] - Apply general host configuration (SELinux, containerd, sysctl, firewalld).
      * @param {boolean} [options.worker=false] - Configure as a worker node (for Kubeadm or K3s join).
      * @param {boolean} [options.chown=false] - Set up kubectl configuration for the current user.
+     * @param {string} [options.hosts] - Set custom hosts entries.
      * @memberof UnderpostCluster
      */
     async init(
@@ -90,6 +91,7 @@ class UnderpostCluster {
         config: false,
         worker: false,
         chown: false,
+        hosts: '',
       },
     ) {
       // Handles initial host setup (installing docker, podman, kind, kubeadm, helm)
@@ -280,6 +282,14 @@ class UnderpostCluster {
       if (options.grafana === true) {
         shellExec(`kubectl delete deployment grafana --ignore-not-found`);
         shellExec(`kubectl apply -k ${underpostRoot}/manifests/grafana`);
+        const yaml = `${fs
+          .readFileSync(`${underpostRoot}/manifests/grafana/deployment.yaml`, 'utf8')
+          .replace('{{GF_SERVER_ROOT_URL}}', options.hosts.split(',')[0])}`;
+        console.log(yaml);
+        shellExec(`kubectl apply -f - <<EOF
+${yaml}
+EOF
+`);
       }
 
       if (options.prom && typeof options.prom === 'string') {

package/src/cli/deploy.js

@@ -91,12 +91,25 @@ class UnderpostDeploy {
      * @param {Array<string>} deploymentVersions - List of deployment versions.
      * @returns {string} - YAML service configuration for the specified deployment.
      * @param {string} [serviceId] - Custom service name (optional).
+     * @param {Array} [pathRewritePolicy] - Path rewrite policy (optional).
      * @memberof UnderpostDeploy
      */
-    deploymentYamlServiceFactory({ deployId, path, env, port, deploymentVersions, serviceId }) {
+    deploymentYamlServiceFactory({ deployId, path, env, port, deploymentVersions, serviceId, pathRewritePolicy }) {
       return `
     - conditions:
         - prefix: ${path}
+      ${
+        pathRewritePolicy
+          ? `pathRewritePolicy:
+          replacePrefix:
+          ${pathRewritePolicy.map(
+            (rd) => `- prefix: ${rd.prefix}
+            replacement: ${rd.replacement}
+            `,
+          ).join(`
+`)}`
+          : ''
+      }
       enableWebsockets: true
       services:
     ${deploymentVersions
@@ -230,7 +243,7 @@ ${UnderpostDeploy.API.deploymentYamlPartsFactory({
 
           const pathPortAssignment = pathPortAssignmentData[host];
           // logger.info('', { host, pathPortAssignment });
-          proxyYaml += `
+          let _proxyYaml = `
 ---
 apiVersion: projectcontour.io/v1
 kind: HTTPProxy
@@ -248,32 +261,31 @@ spec:
   routes:`;
           const deploymentVersions =
             options.traffic && typeof options.traffic === 'string' ? options.traffic.split(',') : ['blue'];
-          for (const conditionObj of pathPortAssignment) {
-            const { path, port } = conditionObj;
-            proxyYaml += UnderpostDeploy.API.deploymentYamlServiceFactory({
-              path,
-              deployId,
-              env,
-              port,
-              deploymentVersions,
-            });
-          }
+          let proxyRoutes = '';
+          if (!options.disableDeploymentProxy)
+            for (const conditionObj of pathPortAssignment) {
+              const { path, port } = conditionObj;
+              proxyRoutes += UnderpostDeploy.API.deploymentYamlServiceFactory({
+                path,
+                deployId,
+                env,
+                port,
+                deploymentVersions,
+              });
+            }
           for (const customService of customServices) {
-            const { path: _path, port, serviceId, host: _host } = customService;
+            const { path: _path, port, serviceId, host: _host, pathRewritePolicy } = customService;
             if (host === _host) {
-              switch (serviceId) {
-                case 'mongo-express-service': {
-                  proxyYaml += UnderpostDeploy.API.deploymentYamlServiceFactory({
-                    path: _path,
-                    port,
-                    serviceId,
-                    deploymentVersions,
-                  });
-                  break;
-                }
-              }
+              proxyRoutes += UnderpostDeploy.API.deploymentYamlServiceFactory({
+                path: _path,
+                port,
+                serviceId,
+                deploymentVersions,
+                pathRewritePolicy,
+              });
             }
           }
+          if (proxyRoutes) proxyYaml += _proxyYaml + proxyRoutes;
         }
         const yamlPath = `./engine-private/conf/${deployId}/build/${env}/proxy.yaml`;
         fs.writeFileSync(yamlPath, proxyYaml, 'utf8');
@@ -332,28 +344,30 @@ spec:
 
     /**
      * Callback function for handling deployment options.
-     * @param {string} deployList - List of deployment IDs to include in the manifest.
-     * @param {string} env - Environment for which the manifest is being built.
-     * @param {object} options - Options for the manifest build process.
-     * @param {string} options.remove - Whether to remove the deployment.
-     * @param {string} options.infoRouter - Whether to display router information.
-     * @param {string} options.sync - Whether to synchronize the deployment.
-     * @param {string} options.buildManifest - Whether to build the manifest.
-     * @param {string} options.infoUtil - Whether to display utility information.
-     * @param {string} options.expose - Whether to expose the deployment.
-     * @param {string} options.cert - Whether to create a certificate.
-     * @param {string} options.certHosts - List of hosts for which certificates are being created.
+     * @param {string} deployList - List of deployment IDs to process.
+     * @param {string} env - Environment for which the deployment is being processed.
+     * @param {object} options - Options for the deployment process.
+     * @param {boolean} options.remove - Whether to remove the deployment.
+     * @param {boolean} options.infoRouter - Whether to display router information.
+     * @param {boolean} options.sync - Whether to synchronize deployment configurations.
+     * @param {boolean} options.buildManifest - Whether to build the deployment manifest.
+     * @param {boolean} options.infoUtil - Whether to display utility information.
+     * @param {boolean} options.expose - Whether to expose the deployment.
+     * @param {boolean} options.cert - Whether to create certificates for the deployment.
+     * @param {string} options.certHosts - Comma-separated list of hosts for which to create certificates.
      * @param {string} options.versions - Comma-separated list of versions to deploy.
      * @param {string} options.image - Docker image for the deployment.
-     * @param {string} options.traffic - Current traffic status for the deployment.
+     * @param {string} options.traffic - Traffic status for the deployment.
      * @param {string} options.replicas - Number of replicas for the deployment.
      * @param {string} options.node - Node name for resource allocation.
-     * @param {string} options.restoreHosts - Whether to restore hosts.
-     * @param {string} options.disableUpdateDeployment - Whether to disable updating the deployment.
-     * @param {string} options.disableUpdateProxy - Whether to disable updating the proxy.
-     * @param {string} options.status - Whether to display status host machine server and traffic information.
-     * @param {string} options.etcHosts - Whether to update /etc/hosts.
-     * @returns {Promise<void>} - Promise that resolves when the callback is complete.
+     * @param {boolean} options.restoreHosts - Whether to restore the hosts file.
+     * @param {boolean} options.disableUpdateDeployment - Whether to disable deployment updates.
+     * @param {boolean} options.disableUpdateProxy - Whether to disable proxy updates.
+     * @param {boolean} options.disableDeploymentProxy - Whether to disable deployment proxy.
+     * @param {boolean} options.status - Whether to display deployment status.
+     * @param {boolean} options.etcHosts - Whether to display the /etc/hosts file.
+     * @param {boolean} options.disableUpdateUnderpostConfig - Whether to disable Underpost config updates.
+     * @returns {Promise<void>} - Promise that resolves when the deployment process is complete.
      * @memberof UnderpostDeploy
      */
     async callback(
@@ -376,8 +390,10 @@ spec:
         restoreHosts: false,
         disableUpdateDeployment: false,
         disableUpdateProxy: false,
+        disableDeploymentProxy: false,
         status: false,
         etcHosts: false,
+        disableUpdateUnderpostConfig: false,
       },
     ) {
       if (options.infoUtil === true)
@@ -473,7 +489,7 @@ EOF`);
         logger.info('router', await UnderpostDeploy.API.routerFactory(deployList, env));
         return;
       }
-      UnderpostDeploy.API.configMap(env);
+      if (!options.disableUpdateUnderpostConfig) UnderpostDeploy.API.configMap(env);
       let renderHosts = '';
       let etcHosts = [];
       if (options.restoreHosts === true) {
@@ -789,37 +805,35 @@ ${renderHosts}`,
           }))
           .filter((o) => o.image);
       }
-      if (node === 'kind-worker') {
-        const raw = shellExec(`docker exec -i ${node} crictl images`, {
-          stdout: true,
-          silent: true,
-        });
+      const raw = shellExec(node === 'kind-worker' ? `docker exec -i ${node} crictl images` : `crictl images`, {
+        stdout: true,
+        silent: true,
+      });
+
+      const heads = raw
+        .split(`\n`)[0]
+        .split(' ')
+        .filter((_r) => _r.trim());
+
+      const pods = raw
+        .split(`\n`)
+        .filter((r) => !r.match('IMAGE'))
+        .map((r) => r.split(' ').filter((_r) => _r.trim()));
 
-        const heads = raw
-          .split(`\n`)[0]
-          .split(' ')
-          .filter((_r) => _r.trim());
+      const result = [];
 
-        const pods = raw
-          .split(`\n`)
-          .filter((r) => !r.match('IMAGE'))
-          .map((r) => r.split(' ').filter((_r) => _r.trim()));
-
-        const result = [];
-
-        for (const row of pods) {
-          if (row.length === 0) continue;
-          const pod = {};
-          let index = -1;
-          for (const head of heads) {
-            if (head in pod) continue;
-            index++;
-            pod[head] = row[index];
-          }
-          result.push(pod);
+      for (const row of pods) {
+        if (row.length === 0) continue;
+        const pod = {};
+        let index = -1;
+        for (const head of heads) {
+          if (head in pod) continue;
+          index++;
+          pod[head] = row[index];
         }
-        return result;
+        result.push(pod);
       }
+      return result;
     },
   };
 }

package/src/cli/index.js

@@ -162,6 +162,7 @@ program
   .option('--worker', 'Sets the context for a worker node.')
   .option('--chown', 'Sets the appropriate ownership for Kubernetes kubeconfig files.')
   .option('--k3s', 'Initializes the cluster using K3s (Lightweight Kubernetes).')
+  .option('--hosts <hosts>', 'A comma-separated list of cluster hostnames or IP addresses.')
   .action(Underpost.cluster.init)
   .description('Manages Kubernetes clusters, defaulting to Kind cluster initialization.');
 
@@ -191,6 +192,7 @@ program
   .option('--traffic <traffic-versions>', 'A comma-separated list of custom deployment traffic weights.')
   .option('--disable-update-deployment', 'Disables updates to deployments.')
   .option('--disable-update-proxy', 'Disables updates to proxies.')
+  .option('--disable-deployment-proxy', 'Disables proxies of deployments.')
   .option(
     '--status',
     'Retrieves current network traffic data from resource deployments and the host machine network configuration.',
@@ -198,6 +200,7 @@ program
   .option('--kubeadm', 'Enables the kubeadm context for deployment operations.')
   .option('--etc-hosts', 'Enables the etc-hosts context for deployment operations.')
   .option('--restore-hosts', 'Restores default `/etc/hosts` entries.')
+  .option('--disable-update-underpost-config', 'Disables updates to Underpost configuration during deployment.')
   .description('Manages application deployments, defaulting to deploying development pods.')
   .action(Underpost.deploy.callback);
 
@@ -379,7 +382,10 @@ program
   .option('--dev', 'Sets the development context environment for the script.')
   .option('--build', 'Set builder context runner')
   .option('--replicas <replicas>', 'Sets a custom number of replicas for deployment.')
-  .option('--pod-name <pod-name>', 'Optional: Specifies the pod name for test execution.')
+  .option('--pod-name <pod-name>', 'Optional: Specifies the pod name for execution.')
+  .option('--node-name <node-name>', 'Optional: Specifies the node name for execution.')
+  .option('--port <port>', 'Optional: Specifies the port for execution.')
+  .option('--etc-hosts', 'Enables etc-hosts context for the runner execution.')
   .option('--volume-host-path <volume-host-path>', 'Optional: Specifies the volume host path for test execution.')
   .option('--volume-mount-path <volume-mount-path>', 'Optional: Specifies the volume mount path for test execution.')
   .option('--volume-type <volume-type>', 'Optional: Specifies the volume type for test execution.')

package/src/cli/run.js

@@ -42,6 +42,9 @@ class UnderpostRun {
    * @type {Object}
    * @property {boolean} dev - Whether to run in development mode.
    * @property {string} podName - The name of the pod to run.
+   * @property {string} nodeName - The name of the node to run.
+   * @property {number} port - Custom port to use.
+   * @property {boolean} etcHosts - Whether to modify /etc/hosts.
    * @property {string} volumeHostPath - The host path for the volume.
    * @property {string} volumeMountPath - The mount path for the volume.
    * @property {string} imageName - The name of the image to run.
@@ -65,6 +68,8 @@ class UnderpostRun {
   static DEFAULT_OPTION = {
     dev: false,
     podName: '',
+    nodeName: '',
+    port: 0,
     volumeHostPath: '',
     volumeMountPath: '',
     imageName: '',
@@ -216,13 +221,66 @@ class UnderpostRun {
         );
         shellExec(`${baseCommand} cluster${options.dev ? ' --dev' : ''} --valkey --pull-image`);
       }
-      shellExec(`${baseCommand} deploy --expose mongo`, { async: true });
-      shellExec(`${baseCommand} deploy --expose valkey`, { async: true });
+      shellExec(`${baseCommand} deploy --expose --disable-update-underpost-config mongo`, { async: true });
+      shellExec(`${baseCommand} deploy --expose --disable-update-underpost-config valkey`, { async: true });
       {
         const hostListenResult = UnderpostDeploy.API.etcHostFactory(mongoHosts);
         logger.info(hostListenResult.renderHosts);
       }
     },
+
+    /**
+     * @method metadata
+     * @description Generates metadata for the specified path after exposing the development cluster.
+     * @param {string} path - The input value, identifier, or path for the operation.
+     * @param {Object} options - The default underpost runner options for customizing workflow
+     * @memberof UnderpostRun
+     */
+    metadata: async (path, options = UnderpostRun.DEFAULT_OPTION) => {
+      const ports = '6379,27017';
+      shellExec(`node bin run kill '${ports}'`);
+      shellExec(`node bin run dev-cluster --dev expose`, { async: true });
+      console.log('Loading fordward services...');
+      await timer(5000);
+      shellExec(`node bin metadata --generate ${path}`);
+      shellExec(`node bin run kill '${ports}'`);
+    },
+
+    /**
+     * @method svc-ls
+     * @description Lists systemd services and installed packages, optionally filtering by the provided path.
+     * @param {string} path - The input value, identifier, or path for the operation (used as the optional filter for services and packages).
+     * @param {Object} options - The default underpost runner options for customizing workflow
+     * @memberof UnderpostRun
+     */
+    'svc-ls': (path, options = UnderpostRun.DEFAULT_OPTION) => {
+      const log = shellExec(`systemctl list-units --type=service${path ? ` | grep ${path}` : ''}`, {
+        silent: true,
+        stdout: true,
+      });
+      console.log(path ? log.replaceAll(path, path.red) : log);
+      const log0 = shellExec(`sudo dnf list installed${path ? ` | grep ${path}` : ''}`, {
+        silent: true,
+        stdout: true,
+      });
+      console.log(path ? log0.replaceAll(path, path.red) : log0);
+    },
+
+    /**
+     * @method svc-rm
+     * @description Removes a systemd service by stopping it, disabling it, uninstalling the package, and deleting related files.
+     * @param {string} path - The input value, identifier, or path for the operation (used as the service name).
+     * @param {Object} options - The default underpost runner options for customizing workflow
+     * @memberof UnderpostRun
+     */
+    'svc-rm': (path, options = UnderpostRun.DEFAULT_OPTION) => {
+      shellExec(`sudo systemctl stop ${path}`);
+      shellExec(`sudo systemctl disable --now ${path}`);
+      shellExec(`sudo dnf remove -y ${path}*`);
+      shellExec(`sudo rm -f /usr/lib/systemd/system/${path}.service`);
+      shellExec(`sudo rm -f /etc/yum.repos.d/${path}*.repo`);
+    },
+
     /**
      * @method ssh-cluster-info
      * @description Executes the `ssh-cluster-info.sh` script to display cluster connection information.
@@ -498,7 +556,12 @@ class UnderpostRun {
      * @memberof UnderpostRun
      */
     'ls-images': async (path, options = UnderpostRun.DEFAULT_OPTION) => {
-      console.table(UnderpostDeploy.API.getCurrentLoadedImages('kind-worker', false));
+      console.table(
+        UnderpostDeploy.API.getCurrentLoadedImages(
+          options.nodeName ? options.nodeName : 'kind-worker',
+          path === 'spec' ? true : false,
+        ),
+      );
     },
 
     /**
@@ -883,52 +946,84 @@ class UnderpostRun {
     service: async (path = '', options = UnderpostRun.DEFAULT_OPTION) => {
       const env = options.dev ? 'development' : 'production';
       const baseCommand = options.dev ? 'node bin' : 'underpost';
-      // const baseClusterCommand = options.dev ? ' --dev' : '';
+      const baseClusterCommand = options.dev ? ' --dev' : '';
       shellCd(`/home/dd/engine`);
       let [deployId, serviceId, host, _path, replicas, image, node] = path.split(',');
+      // const confClient = JSON.parse(fs.readFileSync(`./engine-private/conf/${deployId}/conf.client.json`, 'utf8'));
+      const confServer = JSON.parse(fs.readFileSync(`./engine-private/conf/${deployId}/conf.server.json`, 'utf8'));
+      // const confSSR = JSON.parse(fs.readFileSync(`./engine-private/conf/${deployId}/conf.ssr.json`, 'utf8'));
+      // const packageData = JSON.parse(fs.readFileSync(`./engine-private/conf/${deployId}/package.json`, 'utf8'));
       const services = fs.existsSync(`./engine-private/deploy/${deployId}/conf.services.json`)
         ? JSON.parse(fs.readFileSync(`./engine-private/deploy/${deployId}/conf.services.json`, 'utf8'))
         : [];
+      let serviceData = services.findIndex((s) => s.serviceId === serviceId);
+      const payload = {
+        serviceId,
+        path: _path,
+        port: options.port,
+        host,
+      };
+      let podToMonitor;
+      if (!payload.port)
+        switch (serviceId) {
+          case 'mongo-express-service': {
+            payload.port = 8081;
+            break;
+          }
+          case 'grafana': {
+            payload.port = 3000;
+            // payload.pathRewritePolicy = [
+            //   {
+            //     prefix: '/grafana',
+            //     replacement: '/',
+            //   },
+            // ];
+            break;
+          }
+        }
+      if (serviceData == -1) {
+        services.push(payload);
+      } else {
+        services[serviceData] = payload;
+      }
+      fs.writeFileSync(
+        `./engine-private/conf/${deployId}/conf.services.json`,
+        JSON.stringify(services, null, 4),
+        'utf8',
+      );
       switch (serviceId) {
         case 'mongo-express-service': {
-          let serviceData = services.findIndex((s) => s.serviceId === serviceId);
-          const payload = {
-            serviceId,
-            path: _path,
-            port: 8081,
-            host,
-          };
-          if (serviceData == -1) {
-            services.push(payload);
-          } else {
-            services[serviceData] = payload;
-          }
-          fs.writeFileSync(
-            `./engine-private/conf/${deployId}/conf.services.json`,
-            JSON.stringify(services, null, 4),
-            'utf8',
-          );
           shellExec(`kubectl delete svc mongo-express-service --ignore-not-found`);
           shellExec(`kubectl delete deployment mongo-express --ignore-not-found`);
           shellExec(`kubectl apply -f manifests/deployment/mongo-express/deployment.yaml`);
-
-          const success = await UnderpostTest.API.statusMonitor('mongo-express');
-
-          if (success) {
-            const versions = UnderpostDeploy.API.getCurrentTraffic(deployId) || 'blue';
-            if (!node) node = os.hostname();
-            shellExec(
-              `${baseCommand} deploy --kubeadm --build-manifest --sync --info-router --replicas ${
-                replicas ? replicas : 1
-              } --node ${node}${image ? ` --image ${image}` : ''}${versions ? ` --versions ${versions}` : ''} dd ${env}`,
-            );
-            shellExec(
-              `${baseCommand} deploy --kubeadm --disable-update-deployment ${deployId} ${env} --versions ${versions}`,
-            );
-          } else logger.error('Mongo Express deployment failed');
+          podToMonitor = 'mongo-express';
+          break;
+        }
+        case 'grafana': {
+          shellExec(
+            `node bin cluster${baseClusterCommand} --grafana --hosts '${host}' --prom '${Object.keys(confServer)}'`,
+          );
+          podToMonitor = 'grafana';
           break;
         }
       }
+      const success = await UnderpostTest.API.statusMonitor(podToMonitor);
+      if (success) {
+        const versions = UnderpostDeploy.API.getCurrentTraffic(deployId) || 'blue';
+        if (!node) node = os.hostname();
+        shellExec(
+          `${baseCommand} deploy${options.dev ? '' : ' --kubeadm'}${options.devProxyPortOffset ? ' --disable-deployment-proxy' : ''} --build-manifest --sync --info-router --replicas ${
+            replicas ? replicas : 1
+          } --node ${node}${image ? ` --image ${image}` : ''}${versions ? ` --versions ${versions}` : ''} dd ${env}`,
+        );
+        shellExec(
+          `${baseCommand} deploy${options.dev ? '' : ' --kubeadm'}${options.devProxyPortOffset ? ' --disable-deployment-proxy' : ''} --disable-update-deployment ${deployId} ${env} --versions ${versions}`,
+        );
+      } else logger.error('Mongo Express deployment failed');
+      if (options.etcHosts === true) {
+        const hostListenResult = UnderpostDeploy.API.etcHostFactory([host]);
+        logger.info(hostListenResult.renderHosts);
+      }
     },
 
     /**
@@ -938,7 +1033,14 @@ class UnderpostRun {
      * @param {Object} options - The default underpost runner options for customizing workflow
      * @memberof UnderpostRun
      */
-    sh: async (path, options = UnderpostRun.DEFAULT_OPTION) => {
+    sh: async (path = '', options = UnderpostRun.DEFAULT_OPTION) => {
+      let [operator, arg0, arg1] = path.split(',');
+      if (operator == 'copy') {
+        shellExec(
+          `kitty @ get-text ${arg0 === 'all' ? '--match all' : '--self'} --extent all${arg1 === 'ansi' ? ' --ansi yes' : ''} | kitty +kitten clipboard`,
+        );
+        return;
+      }
       shellExec(`kitty -o allow_remote_control=yes`);
     },
 

package/src/client/components/core/Pagination.js

@@ -1,11 +1,11 @@
-import { getQueryParams, setQueryParams } from './Router.js';
+import { getQueryParams, setQueryParams, listenQueryParamsChange } from './Router.js';
 
 class AgPagination extends HTMLElement {
   constructor() {
     super();
     this.attachShadow({ mode: 'open' });
     this._gridId = null;
-    const queryParams = getQueryParams();
+    let queryParams = getQueryParams();
     this._currentPage = parseInt(queryParams.page, 10) || 1;
     this._limit = parseInt(queryParams.limit, 10) || 10;
     this._totalPages = 1;
@@ -13,6 +13,8 @@ class AgPagination extends HTMLElement {
     this._limitOptions = [10, 20, 50, 100]; // Default options
     this.handlePageChange = this.handlePageChange.bind(this);
     this.handleLimitChange = this.handleLimitChange.bind(this);
+
+    this.handleQueryParamsChange = this.handleQueryParamsChange.bind(this);
   }
 
   static get observedAttributes() {
@@ -53,11 +55,43 @@ class AgPagination extends HTMLElement {
   connectedCallback() {
     this.render();
     this.addEventListeners();
-    this.update();
+    // Subscribe to query parameter changes once the component is connected and _gridId is potentially set.
+    listenQueryParamsChange({
+      id: `ag-pagination-${this._gridId || 'default'}`, // Use _gridId for a unique listener ID
+      event: this.handleQueryParamsChange,
+    });
+    // The initial state is already set in the constructor from getQueryParams().
+    // The `listenQueryParamsChange` in `Router.js` will trigger an immediate (setTimeout) call
+    // to `handleQueryParamsChange`, which will re-sync the state if needed and update the component.
+    this.update(); // Keep the initial update for rendering based on constructor's initial state.
   }
 
   disconnectedCallback() {
-    // Event listeners on shadow DOM are garbage collected with the component
+    // If Router.js held strong references to queryParamsChangeListeners, you might need to unsubscribe here.
+    // However, for this example, we'll assume the component's lifecycle or weak references handle cleanup.
+  }
+
+  handleQueryParamsChange(queryParams) {
+    const newPage = parseInt(queryParams.page, 10) || 1;
+    const newLimit = parseInt(queryParams.limit, 10) || 10;
+
+    let shouldUpdate = false;
+
+    if (newPage !== this._currentPage) {
+      this._currentPage = newPage;
+      shouldUpdate = true;
+    }
+    if (newLimit !== this._limit) {
+      this._limit = newLimit;
+      shouldUpdate = true;
+    }
+
+    if (shouldUpdate) {
+      this.update();
+      this.dispatchEvent(
+        new CustomEvent('pagination-query-params-change', { detail: { page: this._currentPage, limit: this._limit } }),
+      );
+    }
   }
 
   handlePageChange(newPage) {
@@ -65,7 +99,7 @@ class AgPagination extends HTMLElement {
       return;
     }
     this._currentPage = newPage;
-    setQueryParams({ page: newPage, limit: this._limit });
+    setQueryParams({ page: newPage, limit: this._limit }, { replace: false }); // Use pushState
     this.dispatchEvent(new CustomEvent('page-change', { detail: { page: newPage } }));
   }
 
@@ -76,7 +110,7 @@ class AgPagination extends HTMLElement {
     }
     this._limit = newLimit;
     this._currentPage = 1; // Reset to first page on limit change
-    setQueryParams({ page: 1, limit: newLimit });
+    setQueryParams({ page: 1, limit: newLimit }, { replace: false }); // Use pushState
     this.dispatchEvent(new CustomEvent('limit-change', { detail: { limit: newLimit } }));
   }
 
@@ -98,7 +132,8 @@ class AgPagination extends HTMLElement {
     this.shadowRoot.querySelector('#page-info').textContent = `Page ${this._currentPage} of ${this._totalPages}`;
 
     const limitSelector = this.shadowRoot.querySelector('#limit-selector');
-    if (limitSelector.value != this._limit) {
+    if (limitSelector && limitSelector.value != this._limit) {
+      // Added null check for limitSelector
       limitSelector.value = this._limit;
     }
 

package/src/client/components/core/Router.js

@@ -19,6 +19,13 @@ const logger = loggerFactory(import.meta, { trace: true });
  */
 const RouterEvents = {};
 
+/**
+ * @type {Object.<string, function>}\n
+ * @description Holds event listeners for query parameter changes.\n
+ * @memberof PwaRouter
+ */
+const queryParamsChangeListeners = {};
+
 /**
  * @type {string[]}
  * @description Array of core UI component IDs that should not trigger modal close route changes.
@@ -227,6 +234,22 @@ const listenQueryPathInstance = ({ id, routeId, event }, queryKey = 'cid') => {
     });
 };
 
+/**
+ * Registers a listener for changes to query parameters.\n
+ * The provided event callback is triggered with the current query parameters object.\n
+ * @param {object} options - The listener options.\n
+ * @param {string} options.id - A unique ID for the listener.\n
+ * @param {function(Object.<string, string>): void} options.event - The callback function to execute with the new query parameters.\n
+ * @memberof PwaRouter
+ */
+const listenQueryParamsChange = ({ id, event }) => {
+  queryParamsChangeListeners[id] = event;
+  // Immediately call with current query params for initial state
+  setTimeout(() => {
+    event(getQueryParams());
+  });
+};
+
 /**
  * Handles the logic for changing the route when a modal is closed. It determines the next URL
  * based on the remaining open modals or falls back to a home URL.
@@ -305,6 +328,13 @@ const setQueryParams = (newParams, options = { replace: true }) => {
   } else {
     history.pushState(history.state, '', newPath);
   }
+
+  const updatedParams = getQueryParams();
+  for (const listenerId in queryParamsChangeListeners) {
+    if (Object.hasOwnProperty.call(queryParamsChangeListeners, listenerId)) {
+      queryParamsChangeListeners[listenerId](updatedParams);
+    }
+  }
 };
 
 export {
@@ -323,4 +353,6 @@ export {
   setPath,
   setQueryParams,
   sanitizeRoute,
+  queryParamsChangeListeners,
+  listenQueryParamsChange,
 };

package/src/index.js

@@ -35,7 +35,7 @@ class Underpost {
    * @type {String}
    * @memberof Underpost
    */
-  static version = 'v2.89.0';
+  static version = 'v2.89.2';
   /**
    * Repository cli API
    * @static

package/src/server/client-build.js

@@ -573,7 +573,7 @@ const buildClient = async (options = { liveClientBuildPaths: [], instances: [] }
                 apiBaseHost,
                 apiBasePath: process.env.BASE_API,
                 version: Underpost.version,
-                dev: isDevelopment,
+                ...(isDevelopment ? { dev: true } : undefined),
               },
               renderApi: {
                 JSONweb,
@@ -667,7 +667,7 @@ Sitemap: https://${host}${path === '/' ? '' : path}/sitemap.xml`,
                   apiBaseHost,
                   apiBasePath: process.env.BASE_API,
                   version: Underpost.version,
-                  dev: isDevelopment,
+                  ...(isDevelopment ? { dev: true } : undefined),
                 },
                 renderApi: {
                   JSONweb,