underpost 2.99.6 → 2.99.7

package/bin/deploy.js

@@ -468,10 +468,9 @@ try {
       shellExec(`node bin new --deploy-id dd-default`);
       console.log(fs.existsSync(`./engine-private/conf/dd-default`));
       shellExec(`sudo rm -rf ./engine-private/conf/dd-default`);
-      shellExec(
-        `node bin cron --cmd 'cd /home/dd/engine && node bin run secret && node bin env dd-cron production' --git --kubeadm --dev --setup-start`,
-      );
+      shellExec(`node bin cron --dev --setup-start`);
       shellExec(`node bin/deploy build-envs`);
+      shellExec(`node bin cmt --changelog-build`);
       break;
     }
 
@@ -1125,6 +1124,17 @@ nvidia/gpu-operator \
       break;
     }
 
+    case 'sync-start': {
+      const originPackageJson = JSON.parse(fs.readFileSync(`./package.json`, 'utf8'));
+      for (const deployId of fs.readFileSync(`./engine-private/deploy/dd.router`, 'utf8').split(',')) {
+        const packageJsonPath = `./engine-private/conf/${deployId}/package.json`;
+        const packageJson = JSON.parse(fs.readFileSync(packageJsonPath, 'utf8'));
+        packageJson.scripts.start = `${originPackageJson.scripts.start} ${deployId}`;
+        fs.writeFileSync(packageJsonPath, JSON.stringify(packageJson, null, 4), 'utf8');
+      }
+      break;
+    }
+
     case 'sync-envs': {
       for (const deployId of ['dd-cron'].concat(
         fs.readFileSync(`./engine-private/deploy/dd.router`, 'utf8').split(','),

package/cli.md

@@ -1,4 +1,4 @@
-## underpost ci/cd cli v2.99.6
+## underpost ci/cd cli v2.99.7
 
 ### Usage: `underpost [options] [command]`
   ```
@@ -29,7 +29,7 @@ Commands:
   fs [options] [path]                                        Manages file storage, defaulting to file upload operations.
   test [options] [deploy-list]                               Manages and runs tests, defaulting to the current Underpost default test suite.
   monitor [options] <deploy-id> [env]                        Manages health server monitoring for specified deployments.
-  ssh [options]
+  ssh [options]                                              Manages SSH credentials and sessions for remote access to cluster nodes or services.
   run [options] <runner-id> [path]                           Runs specified scripts using various runners.
   lxd [options]                                              Manages LXD containers and virtual machines.
   baremetal [options] [workflow-id]                          Manages baremetal server operations, including installation, database setup, commissioning, and user management.
@@ -142,33 +142,46 @@ Manages commits to a GitHub repository, supporting various commit types and
 options.
 
 Arguments:
-  path                     The absolute or relative directory path of the
-                           repository.
-  commit-type              The type of commit to perform. Options: feat, fix,
-                           docs, style, refactor, perf, ci, cd, infra, build,
-                           test, chore, revert, backup.
-  module-tag               Optional: Sets a specific module tag for the commit.
-  message                  Optional: Provides an additional custom message for
-                           the commit.
+  path                               The absolute or relative directory path of
+                                     the repository.
+  commit-type                        The type of commit to perform. Options:
+                                     feat, fix, docs, style, refactor, perf,
+                                     ci, cd, infra, build, test, chore, revert,
+                                     backup.
+  module-tag                         Optional: Sets a specific module tag for
+                                     the commit.
+  message                            Optional: Provides an additional custom
+                                     message for the commit.
 
 Options:
-  --log <latest-n>         Shows commit history from the specified number of
-                           latest n path commits.
-  --last-msg <latest-n>    Displays the last n commit message.
-  --empty                  Allows committing with empty files.
-  --copy                   Copies the generated commit message to the
-                           clipboard.
-  --info                   Displays information about available commit types.
-  --diff                   Shows the current git diff changes.
-  --edit                   Edit last commit.
-  --msg <msg>              Sets a custom commit message.
-  --deploy-id <deploy-id>  Sets the deployment configuration ID for the commit
-                           context.
-  --cached                 Commit staged changes only or context.
-  --hashes <hashes>        Comma-separated list of specific file hashes of
-                           commits.
-  --extension <extension>  specific file extensions of commits.
-  -h, --help               display help for command
+  --log <latest-n>                   Shows commit history from the specified
+                                     number of latest n path commits.
+  --last-msg <latest-n>              Displays the last n commit message.
+  --empty                            Allows committing with empty files.
+  --copy                             Copies the generated commit message to the
+                                     clipboard.
+  --info                             Displays information about available
+                                     commit types.
+  --diff                             Shows the current git diff changes.
+  --edit                             Edit last commit.
+  --deploy-id <deploy-id>            Sets the deployment configuration ID for
+                                     the commit context.
+  --cached                           Commit staged changes only or context.
+  --hashes <hashes>                  Comma-separated list of specific file
+                                     hashes of commits.
+  --extension <extension>            specific file extensions of commits.
+  --changelog [latest-n]             Print plain the changelog of the specified
+                                     number of latest n commits, if no number
+                                     is provided it will get the changelog to
+                                     latest ci integration
+  --changelog-build                  Builds a CHANGELOG.md file based on the
+                                     commit history
+  --changelog-min-version <version>  Sets the minimum version limit for
+                                     --changelog-build (default: 2.85.0)
+  --changelog-no-hash                Excludes commit hashes from the generated
+                                     changelog entries (used with
+                                     --changelog-build).
+  -h, --help                         display help for command
  
 ```
   
@@ -664,6 +677,8 @@ Options:
   --dry-run                  Preview cron jobs without executing them.
   --create-job-now           After applying manifests, immediately create a Job
                              from each CronJob (requires --apply).
+  --ssh                      Execute backup commands via SSH on the remote node
+                             instead of locally.
   -h, --help                 display help for command
  
 ```
@@ -766,6 +781,9 @@ Options:
 ```
  Usage: underpost ssh [options]
 
+Manages SSH credentials and sessions for remote access to cluster nodes or
+services.
+
 Options:
   --deploy-id <deploy-id>  Sets deploy id context for ssh operations.
   --generate               Generates new ssh credential and stores it in
@@ -811,7 +829,7 @@ Options:
 Runs specified scripts using various runners.
 
 Arguments:
-  runner-id                                       The runner ID to run. Options: dev-cluster,metadata,svc-ls,svc-rm,ssh-deploy-info,dev-hosts-expose,dev-hosts-restore,cluster-build,template-deploy,template-deploy-image,clean,pull,release-deploy,ssh-deploy,ide,crypto-policy,sync,stop,ssh-deploy-stop,ssh-deploy-db-rollback,ssh-deploy-db,ssh-deploy-db-status,tz,cron,get-proxy,instance-promote,instance,ls-deployments,host-update,dd-container,ip-info,db-client,git-conf,promote,metrics,cluster,deploy,disk-clean,disk-devices,disk-usage,dev,service,etc-hosts,sh,log,ps,ptls,release-cmt,deploy-test,sync-replica,tf-vae-test,spark-template,rmi,kill,secret,underpost-config,gpu-env,tf-gpu-test,deploy-job.
+  runner-id                                       The runner ID to run. Options: dev-cluster,metadata,svc-ls,svc-rm,ssh-deploy-info,dev-hosts-expose,dev-hosts-restore,cluster-build,template-deploy,template-deploy-image,clean,pull,release-deploy,ssh-deploy,ide,crypto-policy,sync,stop,ssh-deploy-stop,ssh-deploy-db-rollback,ssh-deploy-db,ssh-deploy-db-status,tz,get-proxy,instance-promote,instance,ls-deployments,host-update,dd-container,ip-info,db-client,git-conf,promote,metrics,cluster,deploy,disk-clean,disk-devices,disk-usage,dev,service,etc-hosts,sh,log,ps,ptls,release-cmt,deploy-test,sync-replica,tf-vae-test,spark-template,rmi,kill,secret,underpost-config,gpu-env,tf-gpu-test,deploy-job.
   path                                            The input value, identifier, or path for the operation.
 
 Options:

package/jsdoc.json

@@ -3,10 +3,11 @@
     "allowUnknownTags": true,
     "dictionaries": ["jsdoc"]
   },
+  "categoryfile": "./jsdoc-categories.json",
   "source": {
-    "include": ["./src", "./package.json", "./README.md"],
+    "include": ["./src", "./package.json", "./README.md", "./CHANGELOG.md"],
     "includePattern": ".js$",
-    "excludePattern": "(node_modules/|docs)"
+    "excludePattern": "(node_modules/|/docs/)"
   },
   "plugins": ["plugins/markdown", "plugins/summarize", "plugins/shout"],
   "opts": {
@@ -14,6 +15,7 @@
     "readme": "./README.md",
     "recurse": true,
     "destination": "./public/www.nexodev.org/docs/",
+    "tutorials": "./src/client/public/nexodev/docs/references",
     "encoding": "utf8",
     "verbose": true,
     "theme_opts": {
@@ -21,9 +23,28 @@
       "search": true,
       "title": "Nexodev - ERP, CRM Development & Cloud DevOps Services",
       "homepageTitle": "Docs",
-      "favicon": "./public/www.nexodev.org/"
-    },
-    "tutorials": "./public/www.nexodev.org/docs/references"
+      "favicon": "./public/www.nexodev.org/",
+      "displayModuleHeader": true,
+      "includeFilesListInHomepage": true,
+      "sections": ["Modules", "Classes", "Namespaces", "Tutorials", "Events", "Interfaces", "Global"],
+      "meta": [
+        {
+          "name": "author",
+          "content": "Nexodev - underpostnet"
+        },
+        {
+          "name": "description",
+          "content": "Underpost Engine - End2end CI/CD cloud to applications federation tools documentation"
+        },
+        {
+          "name": "keywords",
+          "content": "underpost, engine, erp, crm, devops, cloud, kubernetes, documentation, jsdoc"
+        }
+      ],
+      "footer": "<div style='text-align:center;margin:1rem 0;font-size:0.85rem;'>&copy; Nexodev / underpostnet — <a href='https://github.com/underpostnet/engine' target='_blank'>Engine</a> | <a href='https://www.npmjs.com/package/underpost' target='_blank'>npm</a></div>",
+      "create_style": ".jsdoc-category-badge{display:inline-block;padding:2px 8px;border-radius:4px;background:#e3f2fd;color:#1565c0;font-size:0.82em;font-weight:600;margin-bottom:0.4em;border:1px solid #90caf9}.jsdoc-category{margin-bottom:0.5em}#sidebar-classes,#sidebar-classes+.sidebar-section-children-container{display:none !important}",
+      "add_scripts": ""
+    }
   },
   "markdown": {
     "hardwrap": false,

package/manifests/cronjobs/dd-cron/dd-cron-backup.yaml

@@ -23,18 +23,25 @@ spec:
         spec:
           containers:
             - name: dd-cron-backup
-              image: underpost/underpost-engine:v2.99.6
+              image: underpost/underpost-engine:v2.99.7
               command:
                 - /bin/sh
                 - -c
                 - >
-                  cd /home/dd/engine && node bin run secret && node bin env dd-cron production && node bin cron --git --dev dd-lampp,dd-cyberia,dd-core,dd-test backup
+                   cd /home/dd/engine && node bin env dd-cron production && node bin cron --git --dev --ssh dd-lampp,dd-cyberia,dd-core,dd-test backup
               volumeMounts:
                 - mountPath: /home/dd/engine
                   name: underpost-cron-container-volume
+                - mountPath: /usr/lib/node_modules/underpost/.env
+                  name: underpost-share-env
+                  subPath: .env
           volumes:
             - hostPath:
                 path: /home/dd/engine
                 type: Directory
               name: underpost-cron-container-volume
+            - hostPath:
+                path: /root/.nvm/versions/node/v24.10.0/lib/node_modules/underpost
+                type: DirectoryOrCreate
+              name: underpost-share-env
           restartPolicy: OnFailure

package/manifests/cronjobs/dd-cron/dd-cron-dns.yaml

@@ -23,18 +23,25 @@ spec:
         spec:
           containers:
             - name: dd-cron-dns
-              image: underpost/underpost-engine:v2.99.6
+              image: underpost/underpost-engine:v2.99.7
               command:
                 - /bin/sh
                 - -c
                 - >
-                  cd /home/dd/engine && node bin run secret && node bin env dd-cron production && node bin cron --git --dev dd-cron dns
+                   cd /home/dd/engine && node bin env dd-cron production && node bin cron --git --dev --ssh dd-cron dns
               volumeMounts:
                 - mountPath: /home/dd/engine
                   name: underpost-cron-container-volume
+                - mountPath: /usr/lib/node_modules/underpost/.env
+                  name: underpost-share-env
+                  subPath: .env
           volumes:
             - hostPath:
                 path: /home/dd/engine
                 type: Directory
               name: underpost-cron-container-volume
+            - hostPath:
+                path: /root/.nvm/versions/node/v24.10.0/lib/node_modules/underpost
+                type: DirectoryOrCreate
+              name: underpost-share-env
           restartPolicy: OnFailure

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.99.6
+          image: localhost/rockylinux9-underpost:v2.99.7
           #          resources:
           #            requests:
           #              memory: "124Ki"
@@ -100,7 +100,7 @@ spec:
     spec:
       containers:
         - name: dd-default-development-green
-          image: localhost/rockylinux9-underpost:v2.99.6
+          image: localhost/rockylinux9-underpost:v2.99.7
           #          resources:
           #            requests:
           #              memory: "124Ki"

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

@@ -18,7 +18,7 @@ spec:
     spec:
       containers:
         - name: dd-test-development-blue
-          image: localhost/rockylinux9-underpost:v2.99.6
+          image: localhost/rockylinux9-underpost:v2.99.7
 
           command:
             - /bin/sh
@@ -103,7 +103,7 @@ spec:
     spec:
       containers:
         - name: dd-test-development-green
-          image: localhost/rockylinux9-underpost:v2.99.6
+          image: localhost/rockylinux9-underpost:v2.99.7
 
           command:
             - /bin/sh

package/package.json

@@ -2,7 +2,7 @@
     "type": "module",
     "main": "src/index.js",
     "name": "underpost",
-    "version": "2.99.6",
+    "version": "2.99.7",
     "description": "pwa api rest template",
     "scripts": {
         "start": "env-cmd -f .env.production node --max-old-space-size=8192 src/server",
@@ -17,7 +17,6 @@
         "docs": "jsdoc -c jsdoc.json",
         "install-global": "npm install -g jsdoc && npm install -g prettier && npm install -g env-cmd",
         "install-test": "npm install -g mocha && npm install -g c8 && npm install -g coveralls",
-        "install-underpost": "cp -a $(npm root -g)/underpost/node_modules ./node_modules && npm install --only=dev --ignore-scripts",
         "install": "npm run install-global && npm run install-test",
         "prettier": "prettier --write .",
         "fix": "npm audit fix --force && npm audit",