Summary
Deployment knowledge is scattered across multiple files:
docs/demo/README.md — demo walkthrough
examples/nps-explorer/README.md — NPS-specific deploy steps
examples/skill-playground/README.md — playground-specific steps
docs/demo/image-volume-scc.yaml — SCC for image volumes
docs/demo/llm-secret.yaml — LLM secret template
A new user has to piece together information from all of these to
deploy an agent on OpenShift. The SCC setup is a recurring pain point
that trips up anyone starting in a new namespace.
Proposed
Create docs/openshift-deploy-guide.md covering the full path:
- Namespace setup — create project, set context
- SCC configuration — when needed (image volumes), how to apply,
which ServiceAccount to bind
- LLM secret — provider options (Anthropic/OpenAI/LiteLLM)
- Agent deployment — ConfigMap, skills, Deployment, Service, Route
- Verification — health check, test request, a2a CLI
- Troubleshooting — common issues (SCC denied, missing secret,
image pull errors, timeout on LLM calls)
Depends on #80 (simplified args make the deployment steps cleaner).
Summary
Deployment knowledge is scattered across multiple files:
docs/demo/README.md— demo walkthroughexamples/nps-explorer/README.md— NPS-specific deploy stepsexamples/skill-playground/README.md— playground-specific stepsdocs/demo/image-volume-scc.yaml— SCC for image volumesdocs/demo/llm-secret.yaml— LLM secret templateA new user has to piece together information from all of these to
deploy an agent on OpenShift. The SCC setup is a recurring pain point
that trips up anyone starting in a new namespace.
Proposed
Create
docs/openshift-deploy-guide.mdcovering the full path:which ServiceAccount to bind
image pull errors, timeout on LLM calls)
Depends on #80 (simplified args make the deployment steps cleaner).