Container images¶
Status: Alpha Last Updated: 2026-05-30
Docker Hub¶
Published images:
| Repository | Tags |
|---|---|
docker.io/vworkspace/vworkspace-operator |
:latest (main branch), :<git-sha>, :v<semver> (git tags v*, e.g. :v0.0.6) |
Helm chart and kubectl manifests¶
On every v* git tag, CI attaches to the GitHub Release:
| Asset | Purpose |
|---|---|
vworkspace-operator-X.Y.Z.tgz |
helm install without cloning the repo |
crds.yaml |
CRDs only (kubectl apply) |
operator.yaml |
Namespace, RBAC, Deployment (kubectl apply after CRDs) |
SHA256SUMS |
Verify downloads |
See helm.md for install commands.
Build locally:
make docker-build IMG=docker.io/vworkspace/vworkspace-operator:$(git describe --tags --always)
make docker-push IMG=docker.io/vworkspace/vworkspace-operator:$(git describe --tags --always)
Deploy with kustomize:
make deploy IMG=docker.io/vworkspace/vworkspace-operator:v0.0.1
CI publishing¶
On push to main or tags matching v*, the docker job in .github/workflows/ci.yml builds and pushes to Docker Hub.
Required GitHub repository secrets:
| Secret | Purpose |
|---|---|
DOCKERHUB_USERNAME |
Docker Hub user or organization name (vworkspace) |
DOCKERHUB_TOKEN |
Docker Hub access token with push permission |
See ../development/release-process.md for the full release flow.