registry + k3s + HelmLocal Kubernetes
The project generates one local k3s environment and one registry, then installs every service through its independent Helm chart.
When to use
Use this reference when generating, reviewing or operating a Service Architect project.
Behavior
- docker-compose.kubernetes.yml starts the local OCI registry, k3s server and isolated Helm client.
- Runtime images are built and pushed to the local registry without using latest tags.
- The orchestration waits for k3s readiness before installing infrastructure and services.
- Generated charts are linted/rendered and releases are verified through probes and metrics.
- The same service charts can target production clusters with operator-provided registry, resources, ingress, policies and secrets.
Kubernetes commands
Complete generated Kubernetes command surface.
make kubernetes-upWorkspaceBuild runtime images, start local registry and k3s, deploy Helm releases and verify rollouts.
make kubernetes-buildWorkspaceBuild minimal runtime images and publish them to the local OCI registry.
make kubernetes-deployWorkspaceInstall project infrastructure and all service Helm releases.
make kubernetes-testWorkspaceVerify rollouts, probes, metrics and the generated cross-service scenario.
make kubernetes-statusWorkspaceShow nodes, pods, Services and Helm releases.
make kubernetes-downWorkspaceStop local Kubernetes while preserving cluster and registry volumes.
make kubernetes-cleanWorkspaceRemove the cluster, registry and all project cluster volumes.
make k8s-{up,build,deploy,test,status,down,clean}AliasShort aliases for the corresponding kubernetes-* targets.
Local cluster workflow
make kubernetes-up
make kubernetes-status
make kubernetes-test
make kubernetes-down