Skip to content

Consolidated OpenShift deployment guide #81

@pavelanni

Description

@pavelanni

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:

  1. Namespace setup — create project, set context
  2. SCC configuration — when needed (image volumes), how to apply,
    which ServiceAccount to bind
  3. LLM secret — provider options (Anthropic/OpenAI/LiteLLM)
  4. Agent deployment — ConfigMap, skills, Deployment, Service, Route
  5. Verification — health check, test request, a2a CLI
  6. Troubleshooting — common issues (SCC denied, missing secret,
    image pull errors, timeout on LLM calls)

Depends on #80 (simplified args make the deployment steps cleaner).

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type
    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions