Local Deployment
Use this skill for an explicit request to deploy Bionic services locally or to the k3d development cluster.
Run the bundled script from the repository root:
bashbash .agents/skills/local-deployment/deploy-to-k3d-locally.sh [service ...]
Service names match spec.services in the StackApp. Pass several names to
deploy them together, for example web cli-gateway; omitting names deploys
web. The script builds each local Cargo binary, imports its image into
k3d-bionic, patches that service, and waits for its rollout. Web assets and
the CLI gateway's Typst runtime are packaged automatically.
Web deployments enable Bionic debug logging through LOG_LEVEL and targeted
Rig request and stream tracing through RIG_LOG.
Prerequisites:
- Docker, k3d and kubectl are installed and available as explicit commands.
- The
k3d-bioniccluster exists. - kubectl is using the
k3d-k3d-bioniccontext. - The
bionic-gptnamespace and StackApp are available.
Before deployment, ensure the default kubeconfig has a reachable API server address for the current host. If the context is missing or the API server is unreachable, run the repository's local kubeconfig setup script:
bashbash .agents/skills/k3d-environment/get-config.sh
This writes/merges the k3d-bionic kubeconfig, replaces loopback/wildcard
addresses with the host gateway, and disables TLS verification for local
development. It may install iproute2 using sudo apt-get; review its effects
before running it on a new machine. Then run the deployment script above.
Inspect web traces after deployment with:
bashkubectl logs deployment/bionic-gpt --namespace bionic-gpt --tail=200
Look for agent_runtime debug events, outgoing requests under
rig::completions, and incoming SSE frames under rig::streaming. These
settings are applied by the local deployment script only and are not added to
production StackApp manifests.


