SolidOps.SubZero.Tool 1.3.14

SubZero.Tool (sub-zero)

A unified .NET CLI tooling suite for Burgr projects: scaffolding, managing dependencies/versions, and setting up self-hosted servers.

dotnet tool install --global SolidOps.SubZero.Tool
sub-zero --help

Requires the .NET 10 SDK.

What it does

sub-zero automates the full lifecycle of a Burgr project from a single CLI:

• Scaffold a complete DDD-layered project (Angular + .NET host + DDD layers + burgr YAML models) from embedded templates.
• Provision a hardened Debian/Ubuntu server (Docker, nginx-proxy + Let's Encrypt, monitoring, firewall) and deploy containerised apps over SSH.
• Manage dependencies and versions across a multi-project solution.

Most commands read a config.json from the working directory for the solution name, version, debug/local flags, project list, dependencies, and outputs. Commands that take parameters directly accept them as options.

Commands

Run sub-zero <command> --help for the full option list of any command.

Scaffolding — init-repo

sub-zero init-repo ./my-app --project Mpc
sub-zero init-repo ./my-app --project Mpc --module Recipes --namespace Acme

Generates an Angular workspace (app + library), a .NET host, the DDD layer projects (Domain, Application, Contracts, Infrastructure, Presentation, Tests), burgr YAML model stubs, and the devops files (Dockerfile, docker-compose.yml, init-server.sh, deploy scripts) used by the publish server commands.

Publish — publish

Provision a self-hosted server and deploy containerised apps over SSH (files generated by init-repo under src/devops/subzero/):

# Provision a hardened server.
sub-zero publish init-server --host 1.2.3.4 --user admin

# Build a Docker image and deploy a containerised app (docker save | ssh docker load).
sub-zero publish app myapp

The former package/app publishing subcommands (package, app, local-package, ts, service, web, old) have been archived to SubZero.Tool.Archive and are no longer part of the CLI.

Monitor — monitor

Read-only observation of a live server. The SSH connection is resolved from config.secrets.json (Server.*), with --host/--user/--port overrides on every subcommand:

sub-zero monitor container-status        # docker ps (add -a for stopped)
sub-zero monitor logs --app myapp -f     # tail/follow container logs
sub-zero monitor env --app myapp         # printenv inside the app container
sub-zero monitor health                  # HTTP status of every configured app
sub-zero monitor resources               # df -h + docker system df + docker stats
sub-zero monitor tunnel netdata -o       # SSH tunnel to Netdata/Uptime Kuma + open browser

Dependencies & versioning

sub-zero update            # download/refresh dependency archives into dependencies/
sub-zero update deps       # update dotnet tools and NuGet references across *.csproj
sub-zero version check     # verify config.json version vs build output

Token replacement in templates

init-repo expands {{TOKEN}} placeholders in embedded templates. Common tokens: {{PROJECT}}, {{project}} (lowercase), {{MODULE}}, {{NAMESPACE}}, {{PREFIX}}, {{USER}}, {{DOMAIN}}.

Links

• Repository: https://github.com/SolidOps/burgr
• Author: Damien Lechat — Solid Ops