@underpostnet/underpost 2.96.0 → 2.97.0

package/src/cli/db.js

@@ -725,8 +725,14 @@ class UnderpostDB {
      * @param {string} [options.paths=''] - Comma-separated list of paths to filter databases
      * @param {boolean} [options.allPods=false] - Whether to target all pods in deployment
      * @param {boolean} [options.primaryPod=false] - Whether to target MongoDB primary pod only
+     * @param {string} [options.primaryPodEnsure=''] - Pod name to ensure MongoDB primary pod is running
      * @param {boolean} [options.stats=false] - Whether to display database statistics
      * @param {number} [options.macroRollbackExport=1] - Number of commits to rollback in macro export
+     * @param {boolean} [options.forceClone=false] - Whether to force re-clone Git repository
+     * @param {boolean} [options.dev=false] - Development mode flag
+     * @param {boolean} [options.k3s=false] - k3s cluster flag
+     * @param {boolean} [options.kubeadm=false] - kubeadm cluster flag
+     * @param {boolean} [options.kind=false] - kind cluster flag
      * @returns {Promise<void>} Resolves when operation is complete
      * @memberof UnderpostDB
      */
@@ -746,9 +752,14 @@ class UnderpostDB {
         paths: '',
         allPods: false,
         primaryPod: false,
+        primaryPodEnsure: '',
         stats: false,
         macroRollbackExport: 1,
         forceClone: false,
+        dev: false,
+        k3s: false,
+        kubeadm: false,
+        kind: false,
       },
     ) {
       const newBackupTimestamp = new Date().getTime();
@@ -763,6 +774,17 @@ class UnderpostDB {
         export: options.export,
       });
 
+      if (options.primaryPodEnsure) {
+        const primaryPodName = UnderpostDB.API.getMongoPrimaryPodName({ namespace, podName: options.primaryPodEnsure });
+        if (!primaryPodName) {
+          const baseCommand = options.dev ? 'node bin' : 'underpost';
+          const baseClusterCommand = options.dev ? ' --dev' : '';
+          let clusterFlag = options.k3s ? ' --k3s' : options.kubeadm ? ' --kubeadm' : '';
+          shellExec(`${baseCommand} cluster${baseClusterCommand}${clusterFlag} --mongodb`);
+        }
+        return;
+      }
+
       // Track processed repositories to avoid duplicate Git operations
       const processedRepos = new Set();
       // Track processed host+path combinations to avoid duplicates

package/src/cli/deploy.js

@@ -106,12 +106,13 @@ class UnderpostDeploy {
      * @memberof UnderpostDeploy
      */
     deploymentYamlPartsFactory({ deployId, env, suffix, resources, replicas, image, namespace, volumes, cmd }) {
+      const baseCommand = env === 'development' ? 'node bin' : 'underpost';
       if (!cmd)
         cmd = [
           `npm install -g npm@11.2.0`,
           `npm install -g underpost`,
-          `underpost secret underpost --create-from-file /etc/config/.env.${env}`,
-          `underpost start --build --run ${deployId} ${env}`,
+          `${baseCommand} secret underpost --create-from-file /etc/config/.env.${env}`,
+          `${baseCommand} start --build --run ${deployId} ${env}`,
         ];
       const packageJson = JSON.parse(fs.readFileSync('./package.json', 'utf8'));
       if (!volumes)
@@ -221,6 +222,7 @@ ${UnderpostDeploy.API.deploymentYamlPartsFactory({
   replicas,
   image,
   namespace: options.namespace,
+  cmd: options.cmd ? options.cmd.split(',').map((c) => c.trim()) : undefined,
 }).replace('{{ports}}', buildKindPorts(fromPort, toPort))}
 `;
         }
@@ -389,6 +391,7 @@ spec:
      * @param {string} [options.namespace] - Kubernetes namespace for the deployment.
      * @param {string} [options.kindType] - Type of Kubernetes resource to retrieve information for.
      * @param {number} [options.port] - Port number for exposing the deployment.
+     * @param {string} [options.cmd] - Custom initialization command for deploymentYamlPartsFactory (comma-separated commands).
      * @returns {Promise<void>} - Promise that resolves when the deployment process is complete.
      * @memberof UnderpostDeploy
      */
@@ -420,6 +423,7 @@ spec:
         namespace: '',
         kindType: '',
         port: 0,
+        cmd: '',
       },
     ) {
       const namespace = options.namespace ? options.namespace : 'default';

package/src/cli/image.js

@@ -119,6 +119,7 @@ class UnderpostImage {
       } = options;
       if (!path) path = '.';
       if (!imageName) imageName = `rockylinux9-underpost:${Underpost.version}`;
+      if (!imagePath) imagePath = '.';
       if (!version) version = 'latest';
       version = imageName && imageName.match(':') ? '' : `:${version}`;
       const podManImg = `localhost/${imageName}${version}`;

package/src/cli/index.js

@@ -10,7 +10,6 @@ import UnderpostRun from './run.js';
 import Dns from '../server/dns.js';
 import UnderpostStatic from './static.js';
 
-// Load environment variables from .env file
 const underpostRootPath = getUnderpostRootPath();
 fs.existsSync(`${underpostRootPath}/.env`)
   ? dotenv.config({ path: `${underpostRootPath}/.env`, override: true })
@@ -18,10 +17,8 @@ fs.existsSync(`${underpostRootPath}/.env`)
 
 const program = new Command();
 
-// Set up the main program information
 program.name('underpost').description(`underpost ci/cd cli ${Underpost.version}`).version(Underpost.version);
 
-// 'new' command: Create a new project
 program
   .command('new')
   .argument('[app-name]', 'The name of the new project.')
@@ -39,7 +36,6 @@ program
   .description('Initializes a new Underpost project, service, or configuration.')
   .action(Underpost.repo.new);
 
-// 'start' command: Start application servers, build pipelines, or services
 program
   .command('start')
   .argument('<deploy-id>', 'The unique identifier for the deployment configuration.')
@@ -49,10 +45,10 @@ program
   )
   .option('--run', 'Starts application servers and monitors their health.')
   .option('--build', 'Triggers the client-side application build process.')
+  .option('--underpost-quickly-install', 'Uses Underpost Quickly Install for dependency installation.')
   .action(Underpost.start.callback)
   .description('Initiates application servers, build pipelines, or other defined services based on the deployment ID.');
 
-// 'clone' command: Clone a GitHub repository
 program
   .command('clone')
   .argument(`<uri>`, 'The URI of the GitHub repository (e.g., "username/repository").')
@@ -61,7 +57,6 @@ program
   .description('Clones a specified GitHub repository into the current directory.')
   .action(Underpost.repo.clone);
 
-// 'pull' command: Pull updates from a GitHub repository
 program
   .command('pull')
   .argument('<path>', 'The absolute or relative directory path where the repository is located.')
@@ -70,7 +65,6 @@ program
   .option('-g8', 'Uses the g8 repository extension for pulling.')
   .action(Underpost.repo.pull);
 
-// 'cmt' command: Commit changes to a GitHub repository
 program
   .command('cmt')
   .argument('[path]', 'The absolute or relative directory path of the repository.')
@@ -92,7 +86,6 @@ program
   .description('Manages commits to a GitHub repository, supporting various commit types and options.')
   .action(Underpost.repo.commit);
 
-// 'push' command: Push changes to a GitHub repository
 program
   .command('push')
   .argument('<path>', 'The absolute or relative directory path of the repository.')
@@ -102,7 +95,6 @@ program
   .description('Pushes committed changes from a local repository to a remote GitHub repository.')
   .action(Underpost.repo.push);
 
-// 'env' command: Manage environment variables
 program
   .command('env')
   .argument(
@@ -122,7 +114,6 @@ program
     loadConf(deployId, subConf);
   });
 
-// 'static' command: Manage static configurations
 program
   .command('static')
   .option('--page <ssr-component-path>', 'Build custom static pages.')
@@ -139,21 +130,17 @@ program
   .option('--locale <locale>', 'Page locale (default: en-US).')
   .option('--site-name <name>', 'Site name for Open Graph.')
 
-  // Script and style options
   .option('--head-scripts <paths>', 'Comma-separated paths to scripts for head section.')
   .option('--body-scripts <paths>', 'Comma-separated paths to scripts for body section.')
   .option('--styles <paths>', 'Comma-separated paths to stylesheets.')
 
-  // Icon options
   .option('--favicon <path>', 'Favicon path.')
   .option('--apple-touch-icon <path>', 'Apple touch icon path.')
   .option('--manifest <path>', 'Web manifest path.')
 
-  // Component options
   .option('--head-components <paths>', 'Comma-separated SSR head component paths.')
   .option('--body-components <paths>', 'Comma-separated SSR body component paths.')
 
-  // Build options
   .option('--deploy-id <deploy-id>', 'Build static assets for a specific deployment ID.')
   .option('--build', 'Triggers the static build process for the specified deployment ID.')
   .option('--build-host <build-host>', 'Sets a custom build host for static documents or assets.')
@@ -162,11 +149,9 @@ program
   .option('--minify', 'Minify HTML output (default: true for production).')
   .option('--no-minify', 'Disable HTML minification.')
 
-  // Config file options
   .option('--config-file <path>', 'Path to JSON configuration file.')
   .option('--generate-config [path]', 'Generate a template configuration file.')
 
-  // Other options
   .option('--lang <lang>', 'HTML lang attribute (default: en).')
   .option('--dir <dir>', 'HTML dir attribute (default: ltr).')
   .option('--dev', 'Sets the development cli context')
@@ -174,7 +159,6 @@ program
   .description(`Manages static build of page, bundles, and documentation with comprehensive customization options.`)
   .action(UnderpostStatic.API.callback);
 
-// 'config' command: Manage Underpost configurations
 program
   .command('config')
   .argument('operator', `The configuration operation to perform. Options: ${Object.keys(Underpost.env).join(', ')}.`)
@@ -185,7 +169,6 @@ program
   .description(`Manages Underpost configurations using various operators.`)
   .action((...args) => Underpost.env[args[0]](args[1], args[2], args[3]));
 
-// 'root' command: Get npm root path
 program
   .command('root')
   .description('Displays the root path of the npm installation.')
@@ -194,6 +177,7 @@ program
 program
   .command('ip')
   .argument('[ips]', 'Optional args comma-separated list of IP to process.')
+  .option('--dhcp', 'Fetches and displays the current Dynamic Host Configuration Protocol server IP address.')
   .option('--copy', 'Copies the IP addresses to the clipboard.')
   .option('--ban-ingress-add', 'Adds IP addresses to banned ingress list.')
   .option('--ban-ingress-remove', 'Removes IP addresses from banned ingress list.')
@@ -208,7 +192,6 @@ program
   .description('Displays the current public machine IP addresses.')
   .action(Dns.ipDispatcher);
 
-// 'cluster' command: Manage Kubernetes clusters
 program
   .command('cluster')
   .argument('[pod-name]', 'Optional: Filters information by a specific pod name.')
@@ -257,7 +240,6 @@ program
   .action(Underpost.cluster.init)
   .description('Manages Kubernetes clusters, defaulting to Kind cluster initialization.');
 
-// 'deploy' command: Manage deployments
 program
   .command('deploy')
   .argument('[deploy-list]', 'A comma-separated list of deployment IDs (e.g., "default-a,default-b").')
@@ -295,10 +277,10 @@ program
   .option('--namespace <namespace>', 'Kubernetes namespace for deployment operations (defaults to "default").')
   .option('--kind-type <kind-type>', 'Specifies the Kind cluster type for deployment operations.')
   .option('--port <port>', 'Sets up port forwarding from local to remote ports.')
+  .option('--cmd <cmd>', 'Custom initialization command for deployment (comma-separated commands).')
   .description('Manages application deployments, defaulting to deploying development pods.')
   .action(Underpost.deploy.callback);
 
-// 'secret' command: Manage secrets
 program
   .command('secret')
   .argument('<platform>', `The secret management platform. Options: ${Object.keys(Underpost.secret).join(', ')}.`)
@@ -312,7 +294,6 @@ program
     if (args[1].init) return Underpost.secret[args[0]].init();
   });
 
-// 'image'
 program
   .command('image')
   .option(
@@ -348,7 +329,6 @@ program
       Underpost.image.pullDockerHubImage({ ...options, dockerhubImage: options.pullDockerhub });
   });
 
-// 'install' command: Fast import npm dependencies
 program
   .command('install')
   .description('Quickly imports Underpost npm dependencies by copying them.')
@@ -356,10 +336,9 @@ program
     fs.copySync(`${underpostRootPath}/node_modules`, './node_modules');
   });
 
-// 'db' command: Manage databases
 program
   .command('db')
-  .argument('<deploy-list>', 'A comma-separated list of deployment IDs (e.g., "default-a,default-b").')
+  .argument('[deploy-list]', 'A comma-separated list of deployment IDs (e.g., "default-a,default-b").')
   .option('--import', 'Imports container backups from specified repositories.')
   .option('--export', 'Exports container backups to specified repositories.')
   .option(
@@ -368,6 +347,7 @@ program
   )
   .option('--all-pods', 'Target all matching pods instead of just the first one.')
   .option('--primary-pod', 'Automatically detect and use MongoDB primary pod (MongoDB only).')
+  .option('--primary-pod-ensure <pod-name>', 'Ensure setup of MongoDB replica set primary pod before operations.')
   .option('--stats', 'Display database statistics (collection/table names with document/row counts).')
   .option('--collections <collections>', 'Comma-separated list of database collections to operate on.')
   .option('--out-path <out-path>', 'Specifies a custom output path for backups.')
@@ -382,6 +362,10 @@ program
     '--macro-rollback-export <n-commits-reset>',
     'Exports a macro rollback script that reverts the last n commits (Git integration required).',
   )
+  .option('--dev', 'Sets the development cli context')
+  .option('--kubeadm', 'Enables the kubeadm context for database operations.')
+  .option('--kind', 'Enables the kind context for database operations.')
+  .option('--k3s', 'Enables the k3s context for database operations.')
   .description(
     'Manages database operations with support for MariaDB and MongoDB, including import/export, multi-pod targeting, and Git integration.',
   )
@@ -401,7 +385,6 @@ program
   .description('Manages cluster metadata operations, including import and export.')
   .action(Underpost.db.clusterMetadataBackupCallback);
 
-// 'script' command: Execute scripts
 program
   .command('script')
   .argument('operator', `The script operation to perform. Options: ${Object.keys(Underpost.script).join(', ')}.`)
@@ -416,7 +399,6 @@ program
   )
   .action((...args) => Underpost.script[args[0]](args[1], args[2], args[3]));
 
-// 'cron' command: Manage cron jobs
 program
   .command('cron')
   .argument('[deploy-list]', 'A comma-separated list of deployment IDs (e.g., "default-a,default-b").')
@@ -432,7 +414,6 @@ program
   .description('Manages cron jobs, including initialization, execution, and configuration updates.')
   .action(Underpost.cron.callback);
 
-// 'fs' command: File storage management
 program
   .command('fs')
   .argument('[path]', 'The absolute or relative directory path for file operations.')
@@ -446,7 +427,6 @@ program
   .description('Manages file storage, defaulting to file upload operations.')
   .action(Underpost.fs.callback);
 
-// 'test' command: Manage tests
 program
   .command('test')
   .argument('[deploy-list]', 'A comma-separated list of deployment IDs (e.g., "default-a,default-b").')
@@ -459,7 +439,6 @@ program
   .option('--kind-type <kind-type>', 'Optional: Specifies the Kind cluster type for tests.')
   .action(Underpost.test.callback);
 
-// 'monitor' command: Monitor health server
 program
   .command('monitor')
   .argument('<deploy-id>', 'The deployment configuration ID to monitor.')
@@ -477,7 +456,6 @@ program
   .description('Manages health server monitoring for specified deployments.')
   .action(Underpost.monitor.callback);
 
-// 'ssh' command: SSH management
 program
   .command('ssh')
   .option('--deploy-id <deploy-id>', 'Sets deploy id context for ssh operations.')
@@ -503,12 +481,11 @@ program
   .option('--copy', 'Copies the connection URI to clipboard.')
   .action(Underpost.ssh.callback);
 
-// 'run' command: Run a script
 program
   .command('run')
   .argument('<runner-id>', `The runner ID to run. Options: ${Object.keys(UnderpostRun.RUNNERS).join(', ')}.`)
   .argument('[path]', 'The input value, identifier, or path for the operation.')
-  .option('--command <command-array>', 'Array of commands to run.')
+  .option('--cmd <command-list>', 'Comma-separated list of commands to execute.')
   .option('--args <args-array>', 'Array of arguments to pass to the command.')
   .option('--dev', 'Sets the development context environment for the script.')
   .option('--build', 'Set builder context runner')
@@ -565,10 +542,10 @@ program
   .option('--user <user>', 'Sets user context for the runner execution.')
   .option('--hosts <hosts>', 'Comma-separated list of hosts for the runner execution.')
   .option('--instance-id <instance-id>', 'Sets instance id context for the runner execution.')
+  .option('--pid <process-id>', 'Sets process id context for the runner execution.')
   .description('Runs specified scripts using various runners.')
   .action(UnderpostRun.API.callback);
 
-// 'lxd' command: LXD management
 program
   .command('lxd')
   .option('--init', 'Initializes LXD on the current machine.')
@@ -604,13 +581,20 @@ program
   .description('Manages LXD containers and virtual machines.')
   .action(UnderpostLxd.API.callback);
 
-// 'baremetal' command: Baremetal server management
 program
-  .command('baremetal [workflow-id] [hostname] [ip-address]')
+  .command('baremetal [workflow-id] [ip-address] [hostname] [ip-file-server] [ip-config] [netmask] [dns-server]')
   .option('--control-server-install', 'Installs the baremetal control server.')
   .option('--control-server-uninstall', 'Uninstalls the baremetal control server.')
+  .option('--control-server-restart', 'Restarts the baremetal control server.')
   .option('--control-server-db-install', 'Installs up the database for the baremetal control server.')
   .option('--control-server-db-uninstall', 'Uninstalls the database for the baremetal control server.')
+  .option('--create-machine', 'Creates a new baremetal machine entry in the database.')
+  .option(
+    '--mac <mac>',
+    'Specifies the MAC address for baremetal machine operations. Use "random" for random MAC, "hardware" to use device\'s actual MAC (no spoofing), or specify a MAC address.',
+  )
+  .option('--ipxe', 'Chainloads iPXE to normalize identity before commissioning.')
+  .option('--ipxe-rebuild', 'Forces rebuild of iPXE binary with embedded boot script.')
   .option('--install-packer', 'Installs Packer CLI.')
   .option(
     '--packer-maas-image-template <template-path>',
@@ -625,12 +609,32 @@ program
     '--packer-maas-image-upload',
     'Uploads an existing MAAS image artifact without rebuilding for the workflow specified by --packer-workflow-id.',
   )
+  .option(
+    '--packer-maas-image-cached',
+    'Continue last build without removing artifacts (used with --packer-maas-image-build).',
+  )
+  .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-path <path>',
+    'Sets a custom bootstrap HTTP server path for baremetal commissioning.',
+  )
+  .option(
+    '--bootstrap-http-server-port <port>',
+    'Sets a custom bootstrap HTTP server port for baremetal commissioning.',
+  )
+  .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-unmount', 'Unmounts the NFS root filesystem for a workflow id config architecture.')
   .option('--nfs-sh', 'Copies QEMU emulation root entrypoint shell command to the clipboard.')
+  .option('--cloud-init', 'Sets the kernel parameters and sets the necessary seed users on the HTTP server.')
   .option('--cloud-init-update', 'Updates cloud init for a workflow id config architecture.')
+  .option('--ubuntu-tools-build', 'Builds ubuntu tools for chroot environment.')
+  .option('--ubuntu-tools-test', 'Tests ubuntu tools in chroot environment.')
+  .option('--bootcmd <bootcmd-list>', 'Comma-separated list of boot commands to execute.')
+  .option('--runcmd <runcmd-list>', 'Comma-separated list of run commands to execute.')
   .option('--logs <log-id>', 'Displays logs for log id: dhcp, cloud, machine, cloud-config.')
   .option('--dev', 'Sets the development context environment for baremetal operations.')
   .option('--ls', 'Lists available boot resources and machines.')

package/src/cli/run.js

@@ -57,6 +57,7 @@ class UnderpostRun {
    * @property {boolean} force - Whether to force the operation.
    * @property {boolean} reset - Whether to reset the operation.
    * @property {boolean} tls - Whether to use TLS.
+   * @property {string} cmd - The command to run in the container.
    * @property {string} tty - The TTY option for the container.
    * @property {string} stdin - The stdin option for the container.
    * @property {string} restartPolicy - The restart policy for the container.
@@ -87,6 +88,7 @@ class UnderpostRun {
    * @property {string} deployId - The deployment ID.
    * @property {string} instanceId - The instance ID.
    * @property {string} user - The user to run as.
+   * @property {string} pid - The process ID.
    * @memberof UnderpostRun
    */
   static DEFAULT_OPTION = {
@@ -104,6 +106,7 @@ class UnderpostRun {
     force: false,
     reset: false,
     tls: false,
+    cmd: '',
     tty: '',
     stdin: '',
     restartPolicy: '',
@@ -134,6 +137,7 @@ class UnderpostRun {
     deployId: '',
     instanceId: '',
     user: '',
+    pid: '',
   };
   /**
    * @static
@@ -187,6 +191,7 @@ class UnderpostRun {
      * @memberof UnderpostRun
      */
     kill: (path = '', options = UnderpostRun.DEFAULT_OPTION) => {
+      if (options.pid) return shellExec(`sudo kill -9 ${options.pid}`);
       for (const _path of path.split(',')) {
         if (_path.split('+')[1]) {
           let [port, sumPortOffSet] = _path.split('+');
@@ -564,7 +569,7 @@ class UnderpostRun {
       const currentTraffic = isDeployRunnerContext(path, options)
         ? UnderpostDeploy.API.getCurrentTraffic(deployId, { namespace: options.namespace })
         : '';
-      let targetTraffic = currentTraffic ? (currentTraffic === 'blue' ? 'green' : 'blue') : '';
+      let targetTraffic = currentTraffic ? (currentTraffic === 'blue' ? 'green' : 'blue') : 'green';
       if (targetTraffic) versions = targetTraffic;
 
       shellExec(
@@ -574,8 +579,13 @@ class UnderpostRun {
       );
 
       if (isDeployRunnerContext(path, options)) {
+        const cmdString = options.cmd
+          ? ` --cmd ${options.cmd.find((c) => c.match('"')) ? `"${options.cmd}"` : `'${options.cmd}'`}`
+          : '';
         shellExec(
-          `${baseCommand} deploy --kubeadm --disable-update-proxy ${deployId} ${env} --versions ${versions}${options.namespace ? ` --namespace ${options.namespace}` : ''}`,
+          `${baseCommand} deploy --kubeadm${cmdString} --replicas ${
+            replicas
+          } --disable-update-proxy ${deployId} ${env} --versions ${versions}${options.namespace ? ` --namespace ${options.namespace}` : ''}`,
         );
         if (!targetTraffic)
           targetTraffic = UnderpostDeploy.API.getCurrentTraffic(deployId, { namespace: options.namespace });
@@ -1157,6 +1167,7 @@ EOF
      * @memberof UnderpostRun
      */
     cluster: async (path = '', options = UnderpostRun.DEFAULT_OPTION) => {
+      const { underpostRoot } = options;
       const env = options.dev ? 'development' : 'production';
       const baseCommand = options.dev ? 'node bin' : 'underpost';
       const baseClusterCommand = options.dev ? ' --dev' : '';
@@ -1166,12 +1177,16 @@ EOF
       await timer(5000);
       shellExec(`${baseCommand} cluster${baseClusterCommand} --${clusterType}`);
       await timer(5000);
-      let [runtimeImage, deployList] = path.split(',')
-        ? path.split(',')
-        : ['express', fs.readFileSync(`./engine-private/deploy/dd.router`, 'utf8').replaceAll(',', '+')];
+      let [runtimeImage, deployList] =
+        path && path.trim() && path.split(',')
+          ? path.split(',')
+          : [
+              'express',
+              fs.readFileSync(`${underpostRoot}/engine-private/deploy/dd.router`, 'utf8').replaceAll(',', '+'),
+            ];
       shellExec(
-        `${baseCommand} image${baseClusterCommand}${
-          runtimeImage ? ` --pull-base --path /home/dd/engine/src/runtime/${runtimeImage}` : ''
+        `${baseCommand} image${baseClusterCommand} --build ${
+          runtimeImage ? ` --pull-base --path ${underpostRoot}/src/runtime/${runtimeImage}` : ''
         } --${clusterType}`,
       );
       if (!deployList) {
@@ -1246,7 +1261,7 @@ EOF
     'disk-clean': async (path, options = UnderpostRun.DEFAULT_OPTION) => {
       const { underpostRoot } = options;
       shellExec(`chmod +x ${underpostRoot}/scripts/disk-clean.sh`);
-      shellExec(`./scripts/disk-clean.sh --yes --aggressive`);
+      shellExec(`./scripts/disk-clean.sh`);
     },
 
     /**
@@ -1405,7 +1420,7 @@ EOF
         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');
+      } else logger.error(`Service pod ${podToMonitor} failed to start in time.`);
       if (options.etcHosts === true) {
         const hostListenResult = UnderpostDeploy.API.etcHostFactory([host]);
         logger.info(hostListenResult.renderHosts);
@@ -1447,6 +1462,32 @@ EOF
       console.log(result);
     },
 
+    /**
+     * @method ps
+     * @description Displays running processes that match a specified path or keyword.
+     * @param {string} path - The input value, identifier, or path for the operation (used as a keyword to filter processes).
+     * @param {Object} options - The default underpost runner options for customizing workflow
+     * @memberof UnderpostRun
+     */
+    ps: async (path = '', options = UnderpostRun.DEFAULT_OPTION) => {
+      const out = shellExec(`ps aux${path ? `| grep '${path}' | grep -v grep` : ''}`, {
+        stdout: true,
+        silent: true,
+      });
+      console.log(path ? out.replaceAll(path, path.bgYellow.black.bold) : out);
+    },
+
+    /**
+     * @method ptls
+     * @description Set on ~/.bashrc alias: ports <port> Command to list listening ports that match the given keyword.
+     * @param {string} path - The input value, identifier, or path for the operation (used as a keyword to filter listening ports).
+     * @param {Object} options - The default underpost runner options for customizing workflow
+     * @memberof UnderpostRun
+     */
+    ptls: async (path = '', options = UnderpostRun.DEFAULT_OPTION) => {
+      shellExec(`chmod +x ${options.underpostRoot}/scripts/ports-ls.sh`);
+      shellExec(`${options.underpostRoot}/scripts/ports-ls.sh`);
+    },
     /**
      * @method release-cmt
      * @description Commits and pushes a new release for the `engine` repository with a message indicating the new version.
@@ -1462,6 +1503,31 @@ EOF
       shellExec(`underpost push . ${process.env.GITHUB_USERNAME}/engine`, { silent: true });
     },
 
+    /**
+     * @method deploy-test
+     * @description Deploys a test deployment (`dd-test`) in either development or production mode, setting up necessary secrets and starting the deployment.
+     * @param {string} path - The input value, identifier, or path for the operation (used as the deployment ID).
+     * @param {Object} options - The default underpost runner options for customizing workflow
+     * @memberof UnderpostRun
+     */
+    'deploy-test': async (path, options = UnderpostRun.DEFAULT_OPTION) => {
+      // Note: use recomendation empty deploy cluster: node bin --dev cluster
+      const env = options.dev ? 'development' : 'production';
+      const baseCommand = options.dev ? 'node bin' : 'underpost';
+      const baseClusterCommand = options.dev ? ' --dev' : '';
+      const inputs = path ? path.split(',') : [];
+      const deployId = inputs[0] ? inputs[0] : 'dd-test';
+      const cmd = options.cmd
+        ? options.cmd
+        : [
+            `npm install -g npm@11.2.0`,
+            `npm install -g underpost`,
+            `${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}"`);
+    },
+
     /**
      * @method sync-replica
      * @description Syncs a replica for the dd.router
@@ -1597,7 +1663,7 @@ ${hostNetwork ? `  hostNetwork: ${hostNetwork}` : ''}
       imagePullPolicy: ${imagePullPolicy}
       tty: ${tty}
       stdin: ${stdin}
-      command: ${JSON.stringify(options.command ? options.command : ['/bin/bash', '-c'])}
+      command: ${JSON.stringify(options.cmd ? options.cmd : ['/bin/bash', '-c'])}
 ${
   args.length > 0
     ? `      args:
@@ -1649,7 +1715,7 @@ EOF`;
       try {
         const npmRoot = getNpmRootPath();
         const underpostRoot = options?.dev === true ? '.' : `${npmRoot}/underpost`;
-        if (options.command) options.command = options.command.split(',');
+        if (options.cmd) options.cmd = options.cmd.split(',');
         if (options.args) options.args = options.args.split(',');
         if (!options.underpostRoot) options.underpostRoot = underpostRoot;
         if (!options.namespace) options.namespace = 'default';

package/src/cli/ssh.js

@@ -280,7 +280,7 @@ EOF`);
             options.password = confNode.users[options.user].password;
             logger.info(`Using saved password for user ${options.user}`);
           }
-          options.port = confNode.users[options.user].port || options.port;
+          options.port = options.port || confNode.users[options.user].port || 22;
         }
       }
 

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

@@ -162,7 +162,9 @@ const Input = {
           break;
         }
         case 'md':
-          RichText.Tokens[inputData.id].easyMDE.value('');
+          setTimeout(() => {
+            RichText.Tokens[inputData.id].easyMDE.value('');
+          });
           continue;
           break;
         case 'checkbox':