shdctl command-line tool

Manage Self-Hosted Deployment releases on customer-operated Kubernetes clusters with the shdctl command-line tool.

阅读时间1 分钟

最后更新于 2 天前

shdctl is the Unity command-line tool that manages Self-Hosted Deployment (SHD) releases on customer-operated Kubernetes clusters. It renders Helm chart values from a single

manifest.yaml

file. It can also pull release archives from the Unity registry, mirror images and ORAS artifacts to your registry, generate Kubernetes Secret manifests, and deploy to your cluster.

shdctl has one required operation,

shdctl release generate

. You decide how much of the rest of the deployment lifecycle shdctl runs, and how much your CI, GitOps controller, or operator workflow handles. For the recommended pipeline and the alternatives, refer to Workflows.

shdctl architecture and security

Learn about shdctl trust boundaries, three usage modes, and what shdctl accesses on the network and in your cluster.

Workflows

Set up the recommended CI and ArgoCD pipeline, or choose another way to run shdctl.

Install shdctl

Install the shdctl command-line tool, configure registry credentials, and review external CLI requirements.

Manifest reference

Review the manifest.yaml schema, with an annotated example, per-chart value overrides, object storage settings, and a custom CA bundle.

shdctl commands

Validate, pull, mirror, and deploy Self-Hosted Deployment releases with shdctl commands.

Troubleshooting

Common shdctl errors and resolutions.