CLI & Remote Agents
CLI CI/CD & Environment Promotion
The current CLI command set works well for CI/CD. unmeshed login can run non-interactively.
Authenticate non-interactively
Use one of these patterns in CI/CD:
Use --non-interactive when you want the pipeline to fail immediately if required login inputs are missing.
Deploy process definitions and schedules
For most deployments, the core commands are:
Those commands bulk upsert JSON or YAML files from a file path or a directory.
Upload supporting assets
If your definitions depend on scripts, templates, or payload files stored on the server, upload them first:
Then apply the matching definitions:
Promote one definition from one environment to another
process download-definition is the most direct way to export a definition from one environment into a file that another environment can import.
Example on Linux or macOS using separate home directories:
That pattern works because each HOME points the CLI at a different ~/.unmeshed.ini.
Promote schedules the same way
Schedules are typically promoted from version-controlled files rather than by downloading them from the server. Keep schedule definitions in your deployment artifact, then push them to the target environment with:
Suggested rollout stages
One common sequence is:
- Build and validate your definition and schedule artifacts
- Upload supporting files with
unmeshed upload - Apply process definitions with
unmeshed update pd - Apply schedules with
unmeshed update sch - Run smoke checks with
unmeshed run,unmeshed call, orunmeshed search