cyberia 3.1.3 → 3.2.9

package/CLI-HELP.md

@@ -1,4 +1,4 @@
-## underpost ci/cd cli v3.1.3
+## underpost ci/cd cli v3.2.9
 
 ### Usage: `underpost [options] [command]`
   ```
@@ -34,6 +34,7 @@ Commands:
   run [options] <runner-id> [path]                           Runs specified scripts using various runners.
   lxd [options]                                              Manages LXD virtual machines as K3s nodes (control plane or workers).
   baremetal [options] [workflow-id]                          Manages baremetal server operations, including installation, database setup, commissioning, and user management.
+  release [options] [version]                                Release orchestrator for building new versions and deploying releases of the Underpost CLI.
   help [command]                                             display help for command
  
 ```
@@ -84,18 +85,29 @@ Options:
 Builds client assets, single replicas, and/or syncs environment ports.
 
 Arguments:
-  deploy-id         The deployment ID to build. (default: "dd-default")
-  sub-conf          The sub-configuration for the build. (default: "")
-  host              Comma-separated hosts to filter the build. (default: "")
-  path              Comma-separated paths to filter the build. (default: "")
+  deploy-id                   The deployment ID to build. (default:
+                              "dd-default")
+  sub-conf                    The sub-configuration for the build. (default: "")
+  host                        Comma-separated hosts to filter the build.
+                              (default: "")
+  path                        Comma-separated paths to filter the build.
+                              (default: "")
 
 Options:
-  --sync-env-port   Sync environment port assignments across all deploy IDs
-  --single-replica  Build single replica folders instead of full client
-  --build-zip       Create zip files of the builds
-  --lite-build      Skip full build (default is full build)
-  --icons-build     Build icons
-  -h, --help        display help for command
+  --sync-env-port             Sync environment port assignments across all
+                              deploy IDs
+  --single-replica            Build single replica folders instead of full
+                              client
+  --build-zip                 Create zip files of the builds
+  --split <mb>                Split generated zip files into parts of the
+                              specified size in MB
+  --unzip <build-prefix>      Extract a built client zip or split zip parts
+                              using the given build prefix
+  --merge-zip <build-prefix>  Merge split ZIP parts back into a single ZIP file
+                              for the given build prefix
+  --lite-build                Skip full build (default is full build)
+  --icons-build               Build icons
+  -h, --help                  display help for command
  
 ```
   
@@ -123,6 +135,12 @@ Options:
                                installation.
   --skip-pull-base             Skips cloning repositories, uses current
                                workspace code directly.
+  --skip-full-build            Skips the full client bundle build during
+                               deployment.
+  --pull-bundle                Downloads the pre-built client bundle from
+                               Cloudinary via pull-bundle before starting. Use
+                               together with --skip-full-build to skip the local
+                               build entirely.
   -h, --help                   display help for command
  
 ```
@@ -183,7 +201,7 @@ Arguments:
                                      message for the commit.
 
 Options:
-  --log <latest-n>                   Shows commit history from the specified
+  --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.
@@ -210,7 +228,14 @@ Options:
   --changelog-no-hash                Excludes commit hashes from the generated
                                      changelog entries (used with
                                      --changelog-build).
+  --unpush                           With --log, automatically sets range to
+                                     unpushed commits ahead of remote.
   -b                                 Shows the current Git branch name.
+  -p [branch]                        Shows the reflog for the specified branch.
+  --bc <commit-hash>                 Shows branches that contain the specified
+                                     commit.
+  --is-remote-repo <url-repo>        Checks whether a remote Git repository URL
+                                     is reachable. Prints true or false.
   -h, --help                         display help for command
  
 ```
@@ -313,7 +338,7 @@ Manages Underpost configurations using various operators.
 
 Arguments:
   operator                 The configuration operation to perform. Options: set,
-                           delete, get, list, clean.
+                           delete, get, list, clean, isInsideContainer.
   key                      Optional: The specific configuration key to manage.
   value                    Optional: The value to set for the configuration key.
 
@@ -368,6 +393,7 @@ Options:
                         lists.
   --ban-both-remove     Removes IP addresses from both banned ingress and egress
                         lists.
+  --mac                 Prints the MAC address of the main network interface.
   -h, --help            display help for command
  
 ```
@@ -510,6 +536,12 @@ Options:
                                       machine network configuration.
   --kubeadm                           Enables the kubeadm context for deployment
                                       operations.
+  --k3s                               Enables the k3s context for deployment
+                                      operations.
+  --kind                              Enables the kind context for deployment
+                                      operations.
+  --git-clean                         Runs git clean on volume mount paths
+                                      before copying.
   --etc-hosts                         Enables the etc-hosts context for
                                       deployment operations.
   --restore-hosts                     Restores default `/etc/hosts` entries.
@@ -526,6 +558,13 @@ Options:
                                       auto-detected service port).
   --cmd <cmd>                         Custom initialization command for
                                       deployment (comma-separated commands).
+  --skip-full-build                   Skip client bundle rebuild; container will
+                                      pull pre-built bundle via pull-bundle
+                                      instead.
+  --pull-bundle                       Explicitly pull the pre-built client
+                                      bundle from Cloudinary inside the
+                                      container. Use together with
+                                      --skip-full-build.
   -h, --help                          display help for command
  
 ```
@@ -539,13 +578,17 @@ Manages secrets for various platforms.
 
 Arguments:
   platform                            The secret management platform. Options:
-                                      underpost.
+                                      underpost, globalSecretClean.
 
 Options:
   --init                              Initializes the secrets platform
                                       environment.
   --create-from-file <path-env-file>  Creates secrets from a specified
                                       environment file.
+  --create-from-env                   Creates secrets from container environment
+                                      variables (envFrom: secretRef).
+  --global-clean                      Removes all filesystem traces of secrets
+                                      (engine-private, .env, conf cache).
   --list                              Lists all available secrets for the
                                       platform.
   -h, --help                          display help for command
@@ -645,6 +688,7 @@ Options:
   --kubeadm                                  Enables the kubeadm context for database operations.
   --kind                                     Enables the kind context for database operations.
   --k3s                                      Enables the k3s context for database operations.
+  --repo-backup                              Backs up repositories (git commit+push) inside deployment pods via kubectl exec.
   -h, --help                                 display help for command
  
 ```
@@ -668,6 +712,7 @@ Options:
   --instances  Apply to instance data collection
   --generate   Generate cluster metadata
   --itc        Apply under container execution context
+  --dev        Sets the development cli context
   -h, --help   display help for command
  
 ```
@@ -709,8 +754,6 @@ 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
  
 ```
@@ -731,6 +774,7 @@ Options:
   --recursive                              Uploads files recursively from the specified path.
   --deploy-id <deploy-id>                  Specifies the deployment configuration ID for file operations.
   --pull                                   Downloads the specified file.
+  --omit-unzip                             With --pull, keeps the downloaded .zip file and skips extraction.
   --force                                  Forces the action, overriding any warnings or conflicts.
   --storage-file-path <storage-file-path>  Specifies a custom file storage path.
   -h, --help                               display help for command
@@ -859,7 +903,7 @@ Options:
 Runs specified scripts using various runners.
 
 Arguments:
-  runner-id                                       The runner ID to run. Options: dev-cluster,ipfs-expose,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,pid-info,background,ports,deploy-test,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,ipfs-expose,metadata,svc-ls,svc-rm,ssh-deploy-info,dev-hosts-expose,dev-hosts-restore,cluster-build,template-deploy,template-deploy-local,docker-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,instance-build-manifest,ls-deployments,host-update,install-crio,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,pid-info,background,ports,deploy-test,tf-vae-test,spark-template,pull-rocky-image,rmi,kill,generate-pass,secret,underpost-config,gpu-env,tf-gpu-test,deploy-job,push-bundle,pull-bundle.
   path                                            The input value, identifier, or path for the operation.
 
 Options:
@@ -906,7 +950,7 @@ Options:
   --kubeadm                                       Sets the kubeadm cluster context for the runner execution.
   --k3s                                           Sets the k3s cluster context for the runner execution.
   --kind                                          Sets the kind cluster context for the runner execution.
-  --log-type <log-type>                           Sets the log type for the runner execution.
+  --git-clean                                     Runs git clean on volume mount paths before copying.
   --deploy-id <deploy-id>                         Sets deploy id context for the runner execution.
   --user <user>                                   Sets user context for the runner execution.
   --hosts <hosts>                                 Comma-separated list of hosts for the runner execution.
@@ -926,6 +970,9 @@ Options:
   --from-n-commit <n>                             Number of commits back to use for message propagation in template-deploy (default: 1, last commit only).
   --create-job-now                                After applying cron manifests, immediately create a Job from each CronJob (forwarded to cron runner).
   --host-aliases <host-aliases>                   Adds entries to the Pod /etc/hosts via hostAliases. Format: semicolon-separated entries of "ip=hostname1,hostname2" (e.g., "127.0.0.1=foo.local,bar.local;10.1.2.3=foo.remote,bar.remote").
+  --copy                                          Copies the runner output to the clipboard (supported by: generate-pass, template-deploy-local).
+  --skip-full-build                               Skip client bundle rebuild; triggers pull-bundle in container startup (supported by: sync, template-deploy).
+  --pull-bundle                                   Explicitly download the pre-built client bundle from Cloudinary inside the container (supported by: sync, template-deploy). Use together with --skip-full-build.
   -h, --help                                      display help for command
  
 ```
@@ -1038,4 +1085,34 @@ Options:
   -h, --help                                    display help for command
  
 ```
+  
+
+### `release` :
+```
+ Usage: underpost release [options] [version]
+
+Release orchestrator for building new versions and deploying releases of the
+Underpost CLI.
+
+Arguments:
+  version                The new version string to set (e.g., "3.1.4"). Defaults
+                         to current version.
+
+Options:
+  --build                Builds a new version: tests template, bumps versions,
+                         rebuilds manifests and configs.
+  --deploy               Deploys the release: syncs secrets, commits, and pushes
+                         to remote repositories.
+  --ci-push <deploy-id>  Local equivalent of engine-*.ci.yml: builds
+                         dd-{deploy-id} and pushes to the engine-{deploy-id}
+                         repository. Accepts the suffix (e.g., "cyberia"),
+                         "dd-cyberia", or "engine-cyberia".
+  --message <message>    Commit message for --ci-push or --pwa-build (defaults
+                         to last commit of the engine repository).
+  --pwa-build            Runs the pwa-microservices-template update flow: always
+                         re-clones, syncs engine sources, installs, builds, and
+                         pushes.
+  -h, --help             display help for command
+ 
+```
   

package/Dockerfile

@@ -35,8 +35,6 @@ RUN npm install -g underpost
 RUN underpost --version
 
 # Create working directory
-RUN mkdir /home/dd
-VOLUME /home/dd
 WORKDIR /home/dd
 
 # Expose necessary ports