@underpostnet/underpost 2.99.5 → 2.99.6

package/src/cli/cloud-init.js

@@ -122,8 +122,6 @@ ${Underpost.baremetal.stepsRender(
     `cloud-init modules --mode=config`,
     `sleep 3`,
     `cloud-init modules --mode=final`,
-    `sleep 3`,
-    `/underpost/enlistment.sh`,
   ],
   false,
 )}`,
@@ -190,45 +188,6 @@ cat /etc/default/keyboard`,
           logger.info('Build', `${nfsHostToolsPath}/device_scan.sh`);
           fs.copySync(`${underpostRoot}/scripts/device-scan.sh`, `${nfsHostToolsPath}/device_scan.sh`);
 
-          // Build and write the MAAS enlistment script.
-          logger.info('Build', `${nfsHostToolsPath}/enlistment.sh`);
-          fs.writeFileSync(
-            `${nfsHostToolsPath}/enlistment.sh`,
-            `#!/bin/bash
-set -x
-
-# ------------------------------------------------------------
-# Step: Commission a machine in MAAS using OAuth1 authentication
-# ------------------------------------------------------------
-
-MACHINE_ID=$(cat /underpost/system-id)
-CONSUMER_KEY=$(cat /underpost/consumer-key)
-TOKEN_KEY=$(cat /underpost/token-key)
-TOKEN_SECRET=$(cat /underpost/token-secret)
-
-echo ">>> Starting MAAS machine commissioning for system_id: $MACHINE_ID …"
-
-curl -X POST \\
-  --fail --location --verbose --include --raw --trace-ascii /dev/stdout\\
-  --header "Authorization:\\
-  OAuth oauth_version=1.0,\\
-  oauth_signature_method=PLAINTEXT,\\
-  oauth_consumer_key=$CONSUMER_KEY,\\
-  oauth_token=$TOKEN_KEY,\\
-  oauth_signature=&$TOKEN_SECRET,\\
-  oauth_nonce=$(uuidgen),\\
-  oauth_timestamp=$(date +%s)"\\
-  -F "commissioning_scripts=20-maas-01-install-lldpd"\\
-  -F "enable_ssh=1"\\
-  -F "skip_bmc_config=1"\\
-  -F "skip_networking=1"\\
-  -F "skip_storage=1"\\
-  -F "testing_scripts=none"\\
-  http://${callbackMetaData.runnerHost.ip}:5240/MAAS/api/2.0/machines/$MACHINE_ID/op-commission \\
-  2>&1 | tee /underpost/enlistment.log || echo "ERROR: MAAS commissioning returned code $?"`,
-            'utf8',
-          );
-
           // Import SSH keys for root user.
           logger.info('Import ssh keys');
           shellExec(`sudo rm -rf ${nfsHostPath}/root/.ssh`);
@@ -659,7 +618,30 @@ curl -X POST \\
       }
 
       return yaml.join('\n');
-    } /**
+    },
+
+    /**
+     * @method httpServerStaticFactory
+     * @description Writes cloud-init files (user-data, meta-data, vendor-data) to the bootstrap HTTP server path.
+     * @param {object} params
+     * @param {string} params.bootstrapHttpServerPath
+     * @param {string} params.hostname
+     * @param {string} params.cloudConfigSrc
+     * @param {string} [params.vendorData='']
+     * @memberof UnderpostCloudInit
+     * @returns {void}
+     */
+    httpServerStaticFactory({ bootstrapHttpServerPath, hostname, cloudConfigSrc, vendorData = '' }) {
+      if (!cloudConfigSrc) return;
+      const dir = `${bootstrapHttpServerPath}/${hostname}/cloud-init`;
+      shellExec(`mkdir -p ${dir}`);
+      fs.writeFileSync(`${dir}/user-data`, cloudConfigSrc, 'utf8');
+      fs.writeFileSync(`${dir}/meta-data`, `instance-id: ${hostname}\nlocal-hostname: ${hostname}`, 'utf8');
+      fs.writeFileSync(`${dir}/vendor-data`, vendorData, 'utf8');
+      logger.info(`Cloud-init files written to ${dir}`);
+    },
+
+    /**
      * @method kernelParamsFactory
      * @description Generates the kernel parameters for the target machine's bootloader configuration,
      * including the necessary parameters to enable cloud-init with a specific configuration URL and logging settings.
@@ -670,7 +652,7 @@ curl -X POST \\
      * @param {string} [options.machine.system_id] - The unique identifier of the machine, used to fetch the correct cloud-init preseed configuration from MAAS.
      * @return {array} The modified array of kernel parameters with cloud-init parameters included.
      * @memberof UnderpostCloudInit
-     */,
+     */
     kernelParamsFactory(
       macAddress,
       cmd = [],

package/src/cli/index.js

@@ -150,6 +150,11 @@ program
   .option('--dir <dir>', 'HTML dir attribute (default: ltr).')
   .option('--dev', 'Sets the development cli context')
 
+  .option(
+    '--run-sv [port]',
+    'Start a standalone Express static server to preview the static build (default port: 5000).',
+  )
+
   .description(`Manages static build of page, bundles, and documentation with comprehensive customization options.`)
   .action(Underpost.static.callback);
 
@@ -402,10 +407,26 @@ program
     '[job-list]',
     `A comma-separated list of job IDs. Options: ${Underpost.cron.getJobsIDs()}. Defaults to all available jobs.`,
   )
-  .option('--init-pm2-cronjobs', 'Initializes PM2 cron jobs from configuration for the specified deployment IDs.')
-  .option('--git', 'Uploads cron job configurations to GitHub.')
-  .option('--update-package-scripts', 'Updates package.json start scripts for each deploy-id configuration.')
-  .description('Manages cron jobs, including initialization, execution, and configuration updates.')
+  .option('--generate-k8s-cronjobs', 'Generates Kubernetes CronJob YAML manifests from cron configuration.')
+  .option('--apply', 'Applies generated K8s CronJob manifests to the cluster via kubectl.')
+  .option(
+    '--setup-start [deploy-id]',
+    'Updates deploy-id package.json start script and generates+applies its K8s CronJob manifests.',
+  )
+  .option('--namespace <namespace>', 'Kubernetes namespace for the CronJob resources (default: "default").')
+  .option('--image <image>', 'Custom container image for the CronJob pods.')
+  .option('--git', 'Pass --git flag to cron job execution.')
+  .option('--cmd <cmd>', 'Optional pre-script commands to run before cron execution.')
+  .option('--dev', 'Use local ./ base path instead of global underpost installation.')
+  .option('--k3s', 'Use k3s cluster context (apply directly on host).')
+  .option('--kind', 'Use kind cluster context (apply via kind-worker container).')
+  .option('--kubeadm', 'Use kubeadm cluster context (apply directly on host).')
+  .option('--dry-run', 'Preview cron jobs without executing them.')
+  .option(
+    '--create-job-now',
+    'After applying manifests, immediately create a Job from each CronJob (requires --apply).',
+  )
+  .description('Manages cron jobs: execute jobs directly or generate and apply K8s CronJob manifests.')
   .action(Underpost.cron.callback);
 
 program
@@ -534,7 +555,11 @@ program
   .option('--expose', 'Enables service exposure for the runner execution.')
   .option('--conf-server-path <conf-server-path>', 'Sets a custom configuration server path.')
   .option('--underpost-root <underpost-root>', 'Sets a custom Underpost root path.')
-  .option('--cron-jobs <jobs>', 'Comma-separated list of cron jobs to run before executing the script.')
+  .option('--cmd-cron-jobs <cmd-cron-jobs>', 'Pre-script commands to run before cron job execution.')
+  .option(
+    '--deploy-id-cron-jobs <deploy-id-cron-jobs>',
+    'Specifies deployment IDs to synchronize cron jobs with during execution.',
+  )
   .option('--timezone <timezone>', 'Sets the timezone for the runner execution.')
   .option('--kubeadm', 'Sets the kubeadm cluster context for the runner execution.')
   .option('--k3s', 'Sets the k3s cluster context for the runner execution.')
@@ -567,6 +592,11 @@ program
     '--monitor-status-max-attempts <attempts>',
     'Sets the maximum number of status check attempts (default: 600).',
   )
+  .option('--dry-run', 'Preview operations without executing them.')
+  .option(
+    '--create-job-now',
+    'After applying cron manifests, immediately create a Job from each CronJob (forwarded to cron runner).',
+  )
   .description('Runs specified scripts using various runners.')
   .action(Underpost.run.callback);
 
@@ -650,6 +680,10 @@ program
   .option('--remove-machines <system-ids>', 'Removes baremetal machines by comma-separated system IDs, or use "all"')
   .option('--clear-discovered', 'Clears all discovered baremetal machines from the database.')
   .option('--commission', 'Init workflow for commissioning a physical machine.')
+  .option(
+    '--bootstrap-http-server-run',
+    'Runs a temporary bootstrap HTTP server for generic purposes such as serving iPXE scripts or ISO images during commissioning.',
+  )
   .option(
     '--bootstrap-http-server-path <path>',
     'Sets a custom bootstrap HTTP server path for baremetal commissioning.',
@@ -661,6 +695,7 @@ program
   .option('--iso-url <url>', 'Uses a custom ISO URL for baremetal machine commissioning.')
   .option('--nfs-build', 'Builds an NFS root filesystem for a workflow id config architecture using QEMU emulation.')
   .option('--nfs-mount', 'Mounts the NFS root filesystem for a workflow id config architecture.')
+  .option('--nfs-reset', 'Resets the NFS server completely, closing all connections before reloading exports.')
   .option('--nfs-unmount', 'Unmounts the NFS root filesystem for a workflow id config architecture.')
   .option('--nfs-build-server', 'Builds the NFS server for a workflow id config architecture.')
   .option('--nfs-sh', 'Copies QEMU emulation root entrypoint shell command to the clipboard.')

package/src/cli/kickstart.js

@@ -0,0 +1,149 @@
+/**
+ * Kickstart configuration generator for Underpost Engine
+ * @module src/cli/kickstart.js
+ * @namespace UnderpostKickStart
+ */
+
+import fs from 'fs';
+import path from 'path';
+import { fileURLToPath } from 'url';
+import { loggerFactory } from '../server/logger.js';
+
+const logger = loggerFactory(import.meta);
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+
+class UnderpostKickStart {
+  static API = {
+    /**
+     * @method kickstartHeader
+     * @description Generates the kickstart header section with template variables.
+     * @param {object} options
+     * @param {string} [options.lang='en_US.UTF-8']
+     * @param {string} [options.keyboard='us']
+     * @param {string} [options.timezone='America/New_York']
+     * @param {string} [options.rootPassword]
+     * @memberof UnderpostKickStart
+     * @returns {string}
+     */
+    kickstartHeader: ({ lang = 'en_US.UTF-8', keyboard = 'us', timezone = 'America/New_York', rootPassword = '' }) => {
+      return [
+        '# Rocky Linux 9 Kickstart - Ephemeral Anaconda Live Environment with SSHD',
+        'cmdline',
+        'eula --agreed',
+        `keyboard --vckeymap=${keyboard} --xlayouts='${keyboard}'`,
+        `lang ${lang}`,
+        'network --bootproto=dhcp --device=link --activate --onboot=yes',
+        `timezone ${timezone} --utc`,
+        rootPassword ? `rootpw --plaintext ${rootPassword}` : 'rootpw --lock',
+        'firstboot --disable',
+        'skipx',
+      ].join('\n');
+    },
+
+    /**
+     * @method kickstartPreVariables
+     * @description Generates the variable assignments block for the %pre script.
+     * @param {object} options
+     * @param {string} [options.rootPassword]
+     * @param {string} [options.authorizedKeys]
+     * @param {string} [options.adminUsername]
+     * @memberof UnderpostKickStart
+     * @returns {string}
+     */
+    kickstartPreVariables: ({ rootPassword = '', authorizedKeys = '', adminUsername = '' }) => {
+      const sanitizedKeys = (authorizedKeys || '').trim();
+      return [
+        `ROOT_PASS='${rootPassword || ''}'`,
+        `AUTHORIZED_KEYS='${sanitizedKeys}'`,
+        `ADMIN_USER='${adminUsername || process.env.MAAS_ADMIN_USERNAME || 'maas'}'`,
+      ].join('\n');
+    },
+
+    /**
+     * @method kickstartFactory
+     * @description Generates a complete kickstart configuration by combining the header,
+     * variable assignments, and the rocky-kickstart.sh script body.
+     * @param {object} options
+     * @param {string} [options.lang='en_US.UTF-8']
+     * @param {string} [options.keyboard='us']
+     * @param {string} [options.timezone='America/New_York']
+     * @param {string} [options.rootPassword]
+     * @param {string} [options.authorizedKeys]
+     * @memberof UnderpostKickStart
+     * @returns {string}
+     */
+    kickstartFactory: ({
+      lang = 'en_US.UTF-8',
+      keyboard = 'us',
+      timezone = 'America/New_York',
+      rootPassword = process.env.MAAS_ADMIN_PASS,
+      authorizedKeys = '',
+    }) => {
+      const adminUsername = process.env.MAAS_ADMIN_USERNAME || 'maas';
+      const header = UnderpostKickStart.API.kickstartHeader({ lang, keyboard, timezone, rootPassword });
+      const variables = UnderpostKickStart.API.kickstartPreVariables({ rootPassword, authorizedKeys, adminUsername });
+
+      const scriptPath = path.resolve(__dirname, '../../scripts/rocky-kickstart.sh');
+      const scriptBody = fs.readFileSync(scriptPath, 'utf8');
+
+      return [
+        header,
+        '',
+        '%pre --interpreter=/bin/bash --log=/tmp/ks-pre.log --erroronfail',
+        '#!/bin/bash',
+        variables,
+        '',
+        scriptBody,
+        '%end',
+      ].join('\n');
+    },
+
+    /**
+     * @method kernelParamsFactory
+     * @description Appends kickstart-specific kernel parameters (inst.ks, inst.repo, inst.text, inst.sshd).
+     * @param {string} macAddress - The MAC address of the target machine.
+     * @param {array} cmd - The existing array of kernel parameters.
+     * @param {object} options - Options for generating kernel parameters.
+     * @param {string} options.ipDhcpServer - The IP address of the DHCP server.
+     * @param {number} [options.bootstrapHttpServerPort=8888] - Port for the bootstrap HTTP server.
+     * @param {string} options.hostname - The hostname of the target machine.
+     * @param {string} [options.architecture='amd64'] - The target architecture.
+     * @memberof UnderpostKickStart
+     * @returns {array}
+     */
+    kernelParamsFactory(
+      macAddress,
+      cmd = [],
+      options = { ipDhcpServer: '', bootstrapHttpServerPort: 8888, hostname: '', architecture: 'amd64' },
+    ) {
+      const { ipDhcpServer, bootstrapHttpServerPort, hostname, architecture } = options;
+      const repoArch = architecture && architecture.match('arm64') ? 'aarch64' : 'x86_64';
+      return cmd.concat([
+        `inst.ks=http://${ipDhcpServer}:${bootstrapHttpServerPort}/${hostname}/ks.cfg`,
+        `inst.repo=http://dl.rockylinux.org/pub/rocky/9/BaseOS/${repoArch}/os/`,
+        `inst.text`,
+        `inst.sshd`,
+      ]);
+    },
+
+    /**
+     * @method httpServerStaticFactory
+     * @description Writes kickstart ks.cfg file to the bootstrap HTTP server path.
+     * @param {object} params
+     * @param {string} params.bootstrapHttpServerPath
+     * @param {string} params.hostname
+     * @param {string} params.kickstartSrc
+     * @memberof UnderpostKickStart
+     * @returns {void}
+     */
+    httpServerStaticFactory({ bootstrapHttpServerPath, hostname, kickstartSrc }) {
+      if (!kickstartSrc) return;
+      const dest = `${bootstrapHttpServerPath}/${hostname}/ks.cfg`;
+      fs.writeFileSync(dest, kickstartSrc, 'utf8');
+      logger.info(`Kickstart file written to ${dest}`);
+    },
+  };
+}
+
+export default UnderpostKickStart;

package/src/cli/run.js

@@ -68,7 +68,8 @@ const logger = loggerFactory(import.meta);
  * @property {boolean} etcHosts - Whether to modify /etc/hosts.
  * @property {string} confServerPath - The configuration server path.
  * @property {string} underpostRoot - The root path of the Underpost installation.
- * @property {string} cronJobs - The cron jobs to run.
+ * @property {string} cmdCronJobs - Pre-script commands to run before cron job execution.
+ * @property {string} deployIdCronJobs - The deployment ID for cron jobs.
  * @property {string} timezone - The timezone to set.
  * @property {boolean} kubeadm - Whether to run in kubeadm mode.
  * @property {boolean} kind - Whether to run in kind mode.
@@ -84,6 +85,8 @@ const logger = loggerFactory(import.meta);
  * @property {string} monitorStatusKindType - The monitor status kind type option.
  * @property {string} monitorStatusDeltaMs - The monitor status delta in milliseconds.
  * @property {string} monitorStatusMaxAttempts - The maximum number of attempts for monitor status.
+ * @property {boolean} dryRun - Whether to perform a dry run.
+ * @property {boolean} createJobNow - Whether to create the job immediately.
  * @property {boolean} logs - Whether to enable logs.
  * @memberof UnderpostRun
  */
@@ -127,7 +130,8 @@ const DEFAULT_OPTION = {
   etcHosts: false,
   confServerPath: '',
   underpostRoot: '',
-  cronJobs: '',
+  cmdCronJobs: '',
+  deployIdCronJobs: '',
   timezone: '',
   kubeadm: false,
   kind: false,
@@ -144,6 +148,8 @@ const DEFAULT_OPTION = {
   monitorStatusDeltaMs: '',
   monitorStatusMaxAttempts: '',
   logs: false,
+  dryRun: false,
+  createJobNow: false,
 };
 
 /**
@@ -502,7 +508,21 @@ class UnderpostRun {
           if (!validVersion) throw new Error('Version mismatch');
         }
         if (options.timezone !== 'none') shellExec(`${baseCommand} run${baseClusterCommand} tz`);
-        if (options.cronJobs !== 'none') shellExec(`${baseCommand} run${baseClusterCommand} cron`);
+        if (options.deployIdCronJobs !== 'none') {
+          const cronClusterFlag = options.k3s
+            ? ' --k3s'
+            : options.kind
+              ? ' --kind'
+              : options.kubeadm
+                ? ' --kubeadm'
+                : '';
+          const cronCmdFlag = options.cmdCronJobs ? ` --cmd-cron-jobs "${options.cmdCronJobs}"` : '';
+          const cronCreateJobNowFlag = options.createJobNow ? ' --create-job-now' : '';
+          const cronDryRunFlag = options.dryRun ? ' --dry-run' : '';
+          shellExec(
+            `${baseCommand} run${baseClusterCommand} cron${cronClusterFlag}${cronCmdFlag}${cronCreateJobNowFlag}${cronDryRunFlag}${options.deployIdCronJobs ? ` ${options.deployIdCronJobs}` : ''}`,
+          );
+        }
       }
 
       const currentTraffic = isDeployRunnerContext(path, options)
@@ -710,16 +730,29 @@ class UnderpostRun {
 
     /**
      * @method cron
-     * @description Sets up and starts the `dd-cron` environment by writing environment variables, starting the cron service, and cleaning up.
+     * @description Sets up cron jobs using `underpost cron --setup-start` command, which likely configures scheduled tasks for the application.
      * @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
      */
     cron: (path, options = DEFAULT_OPTION) => {
-      const env = options.dev ? 'development' : 'production';
-      shellExec(`node bin env ${path ? path : 'dd-cron'} ${env}`);
-      shellExec(`npm start`);
-      shellExec(`node bin env clean`);
+      const baseCommand = options.dev ? 'node bin' : 'underpost';
+      const devFlag = options.dev ? ' --dev' : '';
+      const gitFlag = options.git ? ' --git' : '';
+      const namespaceFlag =
+        options.namespace && options.namespace !== 'default' ? ` --namespace ${options.namespace}` : '';
+      const imageFlag = options.image ? ` --image ${options.image}` : '';
+      const cmdFlag = options.cmdCronJobs ? ` --cmd "${options.cmdCronJobs}"` : '';
+      const ddCronPath = './engine-private/deploy/dd.cron';
+      const defaultDeployId = !path && fs.existsSync(ddCronPath) ? fs.readFileSync(ddCronPath, 'utf8').trim() : '';
+      const setupStartId = path || defaultDeployId;
+      const setupStart = setupStartId ? ` --setup-start ${setupStartId} --apply` : '';
+      const clusterFlag = options.k3s ? ' --k3s' : options.kind ? ' --kind' : options.kubeadm ? ' --kubeadm' : '';
+      const createJobNowFlag = options.createJobNow ? ' --create-job-now' : '';
+      const dryRunFlag = options.dryRun ? ' --dry-run' : '';
+      shellExec(
+        `${baseCommand} cron${devFlag}${gitFlag}${namespaceFlag}${imageFlag}${cmdFlag}${clusterFlag}${createJobNowFlag}${dryRunFlag}${setupStart}`,
+      );
     },
 
     /**
@@ -991,7 +1024,7 @@ EOF
         args: [daemonProcess(path ? path : `cd /home/dd/engine && npm install && npm run test`)],
       };
 
-      await Underpost.run.RUNNERS['deploy-job'](path, payload);
+      await Underpost.run.CALL('deploy-job', path, payload);
     },
 
     /**
@@ -1550,7 +1583,7 @@ EOF
             `${baseCommand} secret underpost --create-from-file /etc/config/.env.${env}`,
             `${baseCommand} start --build --run ${deployId} ${env} --underpost-quickly-install`,
           ];
-      shellExec(`node bin run sync${baseClusterCommand} --cron-jobs none dd-test --cmd "${cmd}"`);
+      shellExec(`node bin run sync${baseClusterCommand} --deploy-id-cron-jobs none dd-test --cmd "${cmd}"`);
     },
 
     /**

package/src/cli/static.js

@@ -6,11 +6,12 @@
 
 import fs from 'fs-extra';
 import path from 'path';
+import express from 'express';
 import { ssrFactory } from '../server/ssr.js';
 import { shellExec } from '../server/process.js';
 import Underpost from '../index.js';
 import { JSONweb } from '../server/client-formatted.js';
-import { loggerFactory } from '../server/logger.js';
+import { loggerFactory, loggerMiddleware } from '../server/logger.js';
 
 const logger = loggerFactory(import.meta);
 
@@ -592,6 +593,31 @@ class UnderpostStatic {
           throw error;
         }
       }
+
+      // Start standalone static file server if --run-sv is specified
+      if (options.runSv !== undefined) {
+        const port = typeof options.runSv === 'string' ? parseInt(options.runSv, 10) : 5000;
+        const servePath =
+          options.outputPath && options.outputPath !== '.'
+            ? path.dirname(path.resolve(options.outputPath))
+            : path.resolve('.');
+
+        if (!fs.existsSync(servePath)) {
+          logger.error(`Serve path does not exist: ${servePath}`);
+          return;
+        }
+
+        const app = express();
+
+        app.use(loggerMiddleware(import.meta, 'debug', () => false));
+
+        app.use('/', express.static(servePath));
+
+        app.listen(port, () => {
+          logger.info(`Static file server running at http://localhost:${port}`);
+          logger.info(`Serving files from: ${servePath}`);
+        });
+      }
     },
 
     /**

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

@@ -22,8 +22,9 @@ const Docs = {
         return html`
           <iframe
             class="in iframe-${ModalId}"
-            style="width: 100%; border: none; background: white"
+            style="width: 100%; border: none; background: white; display: block"
             src="${docData.url()}"
+            sandbox="allow-same-origin allow-scripts allow-popups allow-forms allow-popups-to-escape-sandbox"
           >
           </iframe>
         `;
@@ -37,9 +38,27 @@ const Docs = {
       query: true,
       RouterInstance: Modal.Data['modal-docs'].options.RouterInstance,
     });
+    const iframeEl = s(`.iframe-${ModalId}`);
+    if (iframeEl) {
+      iframeEl.addEventListener('load', () => {
+        try {
+          const iframeWin = iframeEl.contentWindow;
+          if (iframeWin) {
+            Object.defineProperty(iframeWin, 'parent', { get: () => iframeWin, configurable: false });
+            Object.defineProperty(iframeWin, 'top', { get: () => iframeWin, configurable: false });
+          }
+        } catch (e) {
+          // cross-origin or security restriction — safe to ignore
+        }
+        window.scrollTo(0, 0);
+      });
+    }
     Modal.Data[ModalId].onObserverListener[ModalId] = () => {
-      if (s(`.iframe-${ModalId}`))
-        s(`.iframe-${ModalId}`).style.height = `${s(`.${ModalId}`).offsetHeight - Modal.headerTitleHeight}px`;
+      if (s(`.iframe-${ModalId}`)) {
+        const barEl = s(`.bar-default-modal-${ModalId}`);
+        const barHeight = barEl ? barEl.offsetHeight : Modal.headerTitleHeight;
+        s(`.iframe-${ModalId}`).style.height = `${s(`.${ModalId}`).offsetHeight - barHeight}px`;
+      }
 
       if (type.match('coverage')) {
         simpleIconsRender(`.doc-icon-coverage`);

package/src/index.js

@@ -6,6 +6,7 @@
 
 import UnderpostBaremetal from './cli/baremetal.js';
 import UnderpostCloudInit from './cli/cloud-init.js';
+import UnderpostKickStart from './cli/kickstart.js';
 import UnderpostCluster from './cli/cluster.js';
 import UnderpostDB from './cli/db.js';
 import UnderpostDeploy from './cli/deploy.js';
@@ -39,7 +40,7 @@ class Underpost {
    * @type {String}
    * @memberof Underpost
    */
-  static version = 'v2.99.5';
+  static version = 'v2.99.6';
 
   /**
    * Required Node.js major version
@@ -179,6 +180,16 @@ class Underpost {
     return UnderpostCloudInit.API;
   }
 
+  /**
+   * KickStart cli API
+   * @static
+   * @type {UnderpostKickStart.API}
+   * @memberof Underpost
+   */
+  static get kickstart() {
+    return UnderpostKickStart.API;
+  }
+
   /**
    * Run cli API
    * @static

package/src/server/backup.js

@@ -1,7 +1,7 @@
 /**
  * Manages backup operations for deployments.
  * @module src/server/backup.js
- * @namespace BackUp
+ * @namespace UnderpostBakcUp
  */
 
 import fs from 'fs-extra';
@@ -16,7 +16,7 @@ const logger = loggerFactory(import.meta);
 /**
  * @class BackUp
  * @description Manages backup operations for deployments.
- * @memberof BackUp
+ * @memberof UnderpostBakcUp
  */
 class BackUp {
   /**
@@ -25,7 +25,10 @@ class BackUp {
    * @param {string} deployList - The list of deployments to backup.
    * @param {Object} options - The options for the backup operation.
    * @param {boolean} options.git - Whether to backup data using Git.
-   * @memberof BackUp
+   * @param {boolean} [options.k3s] - Use k3s cluster context.
+   * @param {boolean} [options.kind] - Use kind cluster context.
+   * @param {boolean} [options.kubeadm] - Use kubeadm cluster context.
+   * @memberof UnderpostBakcUp
    */
   static callback = async function (deployList, options = { git: false }) {
     if ((!deployList || deployList === 'dd') && fs.existsSync(`./engine-private/deploy/dd.router`))
@@ -34,12 +37,16 @@ class BackUp {
     logger.info('init backups callback', deployList);
     await logger.setUpInfo();
 
+    const clusterFlag = options.k3s ? ' --k3s' : options.kind ? ' --kind' : options.kubeadm ? ' --kubeadm' : '';
+
     for (const _deployId of deployList.split(',')) {
       const deployId = _deployId.trim();
       if (!deployId) continue;
 
       logger.info('Executing database export for', deployId);
-      shellExec(`node bin db ${options.git ? '--git ' : ''}--export ${deployId}`);
+      shellExec(
+        `node bin db ${options.git ? '--git --force-clone ' : ''}--export --primary-pod${clusterFlag} ${deployId}`,
+      );
     }
   };
 }

package/src/server/client-build-docs.js

@@ -137,7 +137,7 @@ const buildJsDocs = async ({ host, path, metadata = {} }) => {
 
   jsDocsConfig.opts.destination = `./public/${host}${path === '/' ? path : `${path}/`}docs/`;
   jsDocsConfig.opts.theme_opts.title = metadata?.title ? metadata.title : undefined;
-  jsDocsConfig.opts.theme_opts.favicon = `./public/${host}${path === '/' ? path : `${path}/favicon.ico`}`;
+  jsDocsConfig.opts.theme_opts.favicon = `./public/${host}${path === '/' ? '/' : `${path}/`}favicon.ico`;
 
   fs.writeFileSync(`./jsdoc.json`, JSON.stringify(jsDocsConfig, null, 4), 'utf8');
   logger.warn('build jsdoc view', jsDocsConfig.opts.destination);

package/src/server/conf.js

@@ -1172,14 +1172,6 @@ const getPathsSSR = (conf) => {
  * @memberof ServerConfBuilder
  */
 const Cmd = {
-  /**
-   * @method delete
-   * @description Deletes the deploy.
-   * @param {string} deployId - The deploy ID.
-   * @returns {string} - The delete command.
-   * @memberof Cmd
-   */
-  delete: (deployId) => `pm2 delete ${deployId}`,
   /**
    * @method run
    * @description Runs the deploy.
@@ -1221,20 +1213,6 @@ const Cmd = {
    * @memberof Cmd
    */
   syncPorts: () => `node bin/deploy sync-env-port`,
-  /**
-   * @method cron
-   * @description Creates a cron job.
-   * @param {string} deployList - The deploy list.
-   * @param {string} jobList - The job list.
-   * @param {string} name - The name.
-   * @param {string} expression - The expression.
-   * @param {object} options - The options.
-   * @param {number} instances - The number of PM2 instances (default: 1).
-   * @returns {string} - The cron command.
-   * @memberof Cmd
-   */
-  cron: (deployList, jobList, name, expression, options, instances = 1) =>
-    `pm2 start ./bin/index.js --no-autorestart --instances ${instances} --cron "${expression}" --name ${name} -- cron ${options?.git ? `--git ` : ''}${deployList} ${jobList}`,
 };
 
 /**