Workspace

Cloud-native development workspace using Podman, Helm, and preconfigured containerized tools.

The workspace is defined as a Helm chart under infrastructure/, rendered into a Kubernetes manifest, and run locally with podman kube play.

Requirements

• Podman
• make
• Network access for pulling container images

Usage

Generate the Kubernetes manifest:

make kube

Run or replace the local workspace deployment:

make play

Generate the manifest and start the workspace in one step:

make workspace

Stop the deployment and remove the gateway volume:

make down

Open tool shells:

make opencode
make openclaw

Expose the Podman API if tools need Docker-compatible access:

make expose-podman-api

Structure

• infrastructure/ - Helm chart and generated Kubernetes manifest
• infrastructure/values.yaml - workspace configuration values
• infrastructure/templates/secrets/ - secret templates used by the chart
• containers/core/ - core container submodule
• Makefile - local workspace commands

Notes

• infrastructure/kube.yaml is generated by make kube.
• The default namespace is workspace.
• Some commands expect matching pods or local secret files to already exist.