underpost 2.8.641 → 2.8.651

package/.vscode/extensions.json

@@ -6,7 +6,6 @@
         "esbenp.prettier-vscode",
         "foxundermoon.shell-format",
         "github.vscode-github-actions",
-        "mintlify.document",
         "ms-python.black-formatter",
         "ms-python.debugpy",
         "ms-python.python",

package/README.md

@@ -38,7 +38,7 @@ Develop, build, deploy, test, monitor, and manage multiple runtime applications
 <!-- https://kapasia-dev-ed.my.site.com/Badges4Me/s/ -->
 <!-- https://simpleicons.org/ -->
 
-#### Create a new project
+## Create a new project
 
 ```bash
 npm install -g underpost
@@ -50,7 +50,7 @@ underpost new app-name
 
 After template installation, the server will be running on [http://localhost:4001](http://localhost:4001)
 
-#### Usage
+## Usage
 
 ```bash
 cd app-name
@@ -67,3 +67,41 @@ Run dev client server
 ```bash
 npm run dev
 ```
+<!-- -->
+## underpost ci/cd cli v2.8.651
+
+### Usage: `underpost [options] [command]`
+  ```
+ Options:
+  -V, --version                                              output the version number
+  -h, --help                                                 display help for command
+
+Commands:
+  new <app-name>                                             Create a new project
+  start [options] <deploy-id> [env]                          Start up server, build pipelines, or services
+  clone [options] <uri>                                      Clone github repository
+  pull <path> <uri>                                          Pull github repository
+  cmt [options] <path> <commit-type> [module-tag] [message]  Commit github repository
+  push [options] <path> <uri>                                Push github repository
+  env <deploy-id> [env]                                      Set environment variables files and conf related to <deploy-id>
+  config <operator> [key] [value]                            Manage configuration, operators
+  root                                                       Get npm root path
+  cluster [options] [pod-name]                               Manage cluster, for default initialization base kind cluster
+  deploy [options] <deploy-list> [env]                       Manage deployment, for default deploy development pods
+  secret [options] <platform>                                Manage secrets
+  dockerfile-image-build [options]                           Build image from Dockerfile
+  dockerfile-pull-base-images                                Pull underpost dockerfile images requirements
+  install                                                    Fast import underpost npm dependencies
+  db [options] <deploy-list>                                 Manage databases
+  script [options] <operator> <script-name> [script-value]   Supports a number of built-in underpost global scripts and their preset life cycle events as well as arbitrary scripts
+  cron [options] [deploy-list] [job-list]                    Cron jobs management
+  fs [options] [path]                                        File storage management, for default upload file
+  test [options] [deploy-list]                               Manage Test, for default run current underpost default test
+  monitor [options] <deploy-id> [env]                        Monitor health server management
+  help [command]                                             display help for command
+ 
+```
+      
+<a target="_top" href="https://github.com/underpostnet/pwa-microservices-template/blob/master/cli.md">See complete CLI Docs here.</a>
+      
+

package/bin/deploy.js

@@ -36,6 +36,7 @@ import { JSONweb } from '../src/server/client-formatted.js';
 
 import { Xampp } from '../src/runtime/xampp/Xampp.js';
 import { ejs } from '../src/server/json-schema.js';
+import { buildCliDoc } from '../src/cli/index.js';
 
 const logger = loggerFactory(import.meta);
 
@@ -729,7 +730,7 @@ try {
         fs.readFileSync(`./src/index.js`, 'utf8').replaceAll(`${version}`, `${newVersion}`),
         'utf8',
       );
-
+      shellExec(`node bin/deploy cli-docs`);
       shellExec(`node bin/deploy update-dependencies`);
       shellExec(`auto-changelog`);
       shellExec(`node bin/build dd`);
@@ -1049,6 +1050,48 @@ ${shellExec(`git log | grep Author: | sort -u`, { stdout: true }).split(`\n`).jo
       break;
     }
 
+    case 'update-instances': {
+      shellExec(`node bin deploy dd production --sync --build-manifest --info-router --dashboard-update`);
+      shellExec(`node bin cron --dashboard-update --init`);
+      const deployId = 'dd-core';
+      const host = 'www.nexodev.org';
+      const path = '/';
+
+      {
+        const outputPath = './engine-private/instances';
+        if (fs.existsSync(outputPath)) fs.mkdirSync(outputPath, { recursive: true });
+        const collection = 'instances';
+        if (process.argv.includes('export'))
+          shellExec(
+            `node bin db --export --collections ${collection} --out-path ${outputPath} --hosts ${host} --paths '${path}' ${deployId}`,
+          );
+        if (process.argv.includes('import'))
+          shellExec(
+            `node bin db --import --drop --preserveUUID --out-path ${outputPath} --hosts ${host} --paths '${path}' ${deployId}`,
+          );
+      }
+      {
+        const outputPath = './engine-private/crons';
+        if (fs.existsSync(outputPath)) fs.mkdirSync(outputPath, { recursive: true });
+        const collection = 'crons';
+        if (process.argv.includes('export'))
+          shellExec(
+            `node bin db --export --collections ${collection} --out-path ${outputPath} --hosts ${host} --paths '${path}' ${deployId}`,
+          );
+        if (process.argv.includes('import'))
+          shellExec(
+            `node bin db --import --drop --preserveUUID --out-path ${outputPath} --hosts ${host} --paths '${path}' ${deployId}`,
+          );
+      }
+
+      break;
+    }
+
+    case 'cli-docs': {
+      buildCliDoc();
+      break;
+    }
+
     default:
       break;
   }

package/bin/file.js

@@ -136,6 +136,16 @@ try {
           JSON.stringify(templatePackageLockJson, null, 4),
           'utf8',
         );
+        const splitKeyword = '## underpost ci/cd cli';
+        fs.writeFileSync(
+          `../pwa-microservices-template/README.md`,
+          fs.readFileSync(`../pwa-microservices-template/README.md`, 'utf8').replace(
+            `<!-- -->`,
+            `<!-- -->
+${splitKeyword + fs.readFileSync(`./README.md`, 'utf8').split(splitKeyword)[1]}`,
+            'utf8',
+          ),
+        );
       }
 
       break;

package/bin/index.js

@@ -1,237 +1,5 @@
 #! /usr/bin/env node
 
-import dotenv from 'dotenv';
-import { Command } from 'commander';
-import Underpost from '../src/index.js';
-import { getUnderpostRootPath, loadConf } from '../src/server/conf.js';
-import fs from 'fs-extra';
-import { commitData } from '../src/client/components/core/CommonJs.js';
-
-const underpostRootPath = getUnderpostRootPath();
-fs.existsSync(`${underpostRootPath}/.env`)
-  ? dotenv.config({ path: `${underpostRootPath}/.env`, override: true })
-  : dotenv.config();
-
-const program = new Command();
-
-program.name('underpost').description(`underpost ci/cd cli ${Underpost.version}`).version(Underpost.version);
-
-program
-  .command('new')
-  .argument('<app-name>', 'Application name')
-  .description('Create a new project')
-  .action(Underpost.repo.new);
-
-program
-  .command('clone')
-  .argument(`<uri>`, 'e.g. username/repository')
-  .option('--bare', 'Clone only .git files')
-  .description('Clone github repository')
-  .action(Underpost.repo.clone);
-
-program
-  .command('pull')
-  .argument('<path>', 'Absolute or relative directory')
-  .argument(`<uri>`, 'e.g. username/repository')
-  .description('Pull github repository')
-  .action(Underpost.repo.pull);
-
-program
-  .command('cmt')
-  .argument('<path>', 'Absolute or relative directory')
-  .argument(`<commit-type>`, `Options: ${Object.keys(commitData)}`)
-  .argument(`[module-tag]`, 'Optional set module tag')
-  .argument(`[message]`, 'Optional set additional message')
-  .option('--empty', 'Allow empty files')
-  .option('--copy', 'Copy to clipboard message')
-  .option('--info', 'Info commit types')
-  .description('Commit github repository')
-  .action(Underpost.repo.commit);
-
-program
-  .command('push')
-  .argument('<path>', 'Absolute or relative directory')
-  .argument(`<uri>`, 'e.g. username/repository')
-  .option('-f', 'Force push overwriting repository')
-  .description('Push github repository')
-  .action(Underpost.repo.push);
-
-program
-  .command('env')
-  .argument('<deploy-id>', `deploy configuration id, if 'clean' restore default`)
-  .argument('[env]', 'Optional environment, for default is production')
-  .description('Set environment variables files and conf related to <deploy-id>')
-  .action(loadConf);
-
-program
-  .command('config')
-  .argument('operator', `Options: ${Object.keys(Underpost.env)}`)
-  .argument('[key]', 'Config key')
-  .argument('[value]', 'Config value')
-  .description(`Manage configuration, operators`)
-  .action((...args) => Underpost.env[args[0]](args[1], args[2]));
-
-program
-  .command('root')
-  .description('Get npm root path')
-  .action(() => console.log(getNpmRootPath()));
-
-program
-  .command('cluster')
-  .argument('[pod-name]', 'Optional pod name filter')
-  .option('--reset', `Delete all clusters and prune all data and caches`)
-  .option('--mariadb', 'Init with mariadb statefulset')
-  .option('--mongodb', 'Init with mongodb statefulset')
-  .option('--mongodb4', 'Init with mongodb 4.4 service')
-  .option('--valkey', 'Init with valkey service')
-  .option('--contour', 'Init with project contour base HTTPProxy and envoy')
-  .option('--cert-manager', 'Init with letsencrypt-prod ClusterIssuer')
-  .option('--info', 'Get all kinds objects deployed')
-  .option('--full', 'Init with all statefulsets and services available')
-  .option('--ns-use <ns-name>', 'Switches current context to namespace')
-  .option('--dev', 'init with dev cluster')
-  .option('--list-pods', 'Display list pods information')
-  .action(Underpost.cluster.init)
-  .description('Manage cluster, for default initialization base kind cluster');
-
-program
-  .command('deploy')
-  .argument('<deploy-list>', 'Deploy id list, e.g. default-a,default-b')
-  .argument('[env]', 'Optional environment, for default is development')
-  .option('--remove', 'Delete deployments and services')
-  .option('--sync', 'Sync deployments env, ports, and replicas')
-  .option('--info-router', 'Display router structure')
-  .option('--expose', 'Expose service match deploy-list')
-  .option('--info-util', 'Display kubectl util management commands')
-  .option('--cert', 'Reset tls/ssl certificate secrets')
-  .option('--build-manifest', 'Build kind yaml manifests: deployments, services, proxy and secrets')
-  .option('--dashboard-update', 'Update dashboard instance data with current router config')
-  .option('--version', 'Set custom version')
-  .description('Manage deployment, for default deploy development pods')
-  .action(Underpost.deploy.callback);
-
-program
-  .command('secret')
-  .argument('<platform>', `Options: ${Object.keys(Underpost.secret)}`)
-  .option('--init', 'Init secrets platform environment')
-  .option('--create-from-file <path-env-file>', 'Create secret from env file')
-  .option('--list', 'Lists secrets')
-  // .option('--delete [secret-key]', 'Delete key secret, if not set, are default delete all')
-  // .option('--create [secret-key] [secret-value]', 'Create secret key, with secret value')
-  .description(`Manage secrets`)
-  .action((...args) => {
-    if (args[1].createFromFile) return Underpost.secret[args[0]].createFromEnvFile(args[1].createFromFile);
-    if (args[1].list) return Underpost.secret[args[0]].list();
-    if (args[1].init) return Underpost.secret[args[0]].init();
-  });
-
-program
-  .command('dockerfile-node-script')
-  .argument('<deploy-id>', 'Deploy configuration id')
-  .argument('[env]', 'Optional environment, for default is development')
-  .option('--run', 'Run custom entry point script')
-  .option('--build', 'Build custom image container scripts')
-  .description('Dockerfile custom node build script')
-  .action(Underpost.image.dockerfile.script);
-
-program
-  .command('dockerfile-image-build')
-  .option('--path [path]', 'Dockerfile path')
-  .option('--image-name [image-name]', 'Set image name')
-  .option('--image-path [image-path]', 'Set tar image path')
-  .option('--dockerfile-name [dockerfile-name]', 'set Dockerfile name')
-  .option('--podman-save', 'Export tar file from podman')
-  .option('--kind-load', 'Import tar image to Kind cluster')
-  .option('--secrets', 'Dockerfile env secrets')
-  .option('--secrets-path [secrets-path]', 'Dockerfile custom path env secrets')
-  .option('--no-cache', 'Build without using cache')
-  .description('Build image from Dockerfile')
-  .action(Underpost.image.dockerfile.build);
-
-program
-  .command('dockerfile-pull-base-images')
-  .description('Pull underpost dockerfile images requirements')
-  .action(Underpost.image.dockerfile.pullBaseImages);
-
-program
-  .command('install')
-  .description('Fast import underpost npm dependencies')
-  .action(() => {
-    fs.copySync(`${underpostRootPath}/node_modules`, './node_modules');
-  });
-
-program
-  .command('db')
-  .argument('<deploy-list>', 'Deploy id list, e.g. default-a,default-b')
-  .option('--import', 'Import container backups from repositories')
-  .option('--export', 'Export container backups to repositories')
-  .option('--pod-name <pod-name>', 'Optional pod context')
-  .option('--collection <collection>', 'Collection')
-  .option('--out-path <out-path>', 'Custom out path backup')
-  .option('--drop', 'Drop databases')
-  .option('--preserveUUID', 'Preserve Ids')
-  .option('--git', 'Upload to github')
-  .option('--ns <ns-name>', 'Optional name space context')
-  .description('Manage databases')
-  .action(Underpost.db.callback);
-
-program
-  .command('script')
-  .argument('operator', `Options: ${Object.keys(Underpost.script)}`)
-  .argument('<script-name>', 'Script name')
-  .argument('[script-value]', 'Literal command, or path')
-  .option('--itc', 'Inside container execution context')
-  .option('--itc-path', 'Inside container path options')
-  .option('--ns <ns-name>', 'Options name space context')
-  .option('--pod-name <pod-name>')
-  .description(
-    'Supports a number of built-in underpost global scripts and their preset life cycle events as well as arbitrary scripts',
-  )
-  .action((...args) => Underpost.script[args[0]](args[1], args[2], args[3]));
-
-program
-  .command('cron')
-  .argument('[deploy-list]', 'Deploy id list, e.g. default-a,default-b')
-  .argument('[job-list]', `Deploy id list, e.g. ${Object.keys(Underpost.cron)}, for default all available jobs`)
-  .option('--itc', 'Inside container execution context')
-  .option('--init', 'Init cron jobs for cron job default deploy id')
-  .option('--git', 'Upload to github')
-  .option('--dashboard-update', 'Update dashboard cron data with current jobs config')
-  .description('Cron jobs management')
-  .action(Underpost.cron.callback);
-
-program
-  .command('fs')
-  .argument('[path]', 'Absolute or relative directory')
-  .option('--rm', 'Remove file')
-  .option('--git', 'Current git changes')
-  .option('--recursive', 'Upload files recursively')
-  .option('--deploy-id <deploy-id>', 'Deploy configuration id')
-  .option('--pull', 'Download file')
-  .option('--force', 'Force action')
-  .description('File storage management, for default upload file')
-  .action(Underpost.fs.callback);
-
-program
-  .command('test')
-  .argument('[deploy-list]', 'Deploy id list, e.g. default-a,default-b')
-  .description('Manage Test, for default run current underpost default test')
-  .option('--itc', 'Inside container execution context')
-  .option('--sh', 'Copy to clipboard, container entrypoint shell command')
-  .option('--logs', 'Display container logs')
-  .option('--pod-name <pod-name>')
-  .option('--pod-status <pod-status>')
-  .option('--kind-type <kind-type>')
-  .action(Underpost.test.callback);
-
-program
-  .command('monitor')
-  .argument('<deploy-id>', 'Deploy configuration id')
-  .argument('[env]', 'Optional environment, for default is development')
-  .option('--ms-interval <ms-interval>', 'Custom ms interval delta time')
-  .option('--now', 'Exec immediately monitor script')
-  .option('--single', 'Disable recurrence')
-  .description('Monitor health server management')
-  .action(Underpost.monitor.callback);
+import { program } from '../src/cli/index.js';
 
 program.parse();