deploy

/deploy — Quay RC Deployment Pipeline

Deploy a Quay release candidate from a Konflux FBC build onto an ephemeral OpenShift cluster. One state machine from cluster claim to verified, frontend- tested Quay instance.

---

Execution Model

Parse $ARGUMENTS: the first token is the FBC image reference (required). Remaining tokens are parsed for flags.

FBC_IMAGE  = first token of $ARGUMENTS (required)
CHANNEL    = --channel value or auto-detected from image ref
OCP_VERSION = --ocp-version value or "4.18"
KUBECONFIG_PATH = --kubeconfig value or "/tmp/k"
FEATURE    = --feature value or empty (file path or JIRA ticket)
MODE       = "manual" if --manual present, else "auto"

Derive a DEPLOY_ID from the image digest: take the first 12 chars after @sha256:. Example: deploy-f7f0740742d6.

Initialize or Resume

bash .claude/scripts/deploy-state.sh init $DEPLOY_ID \
  --fbc-image "$FBC_IMAGE" \
  --channel "$CHANNEL" \
  --ocp-version "$OCP_VERSION" \
  --kubeconfig "$KUBECONFIG_PATH" \
  --feature "$FEATURE" \
  --mode "$MODE"

If state already exists, this prints the current state and resumes from there.

Resuming After Context Compaction

If context was compacted and you no longer know the DEPLOY_ID, discover it:

bash .claude/scripts/deploy-state.sh list

This lists all active deployments with their ID, state, and FBC image. Pick the active (non-COMPLETE) deployment and read its full state:

bash .claude/scripts/deploy-state.sh read <DEPLOY_ID>

The state file contains ALL variables needed to resume: fbc_image, channel, ocp_version, kubeconfig_path, feature_path, mode, and all recorded cluster/operator/route details. Parse these from the state JSON and continue the loop from the current state.

The State Loop

while state != COMPLETE:
    1. READ   — bash .claude/scripts/deploy-state.sh read $DEPLOY_ID
    2. ACT    — execute the handler for the current state (below)
    3. WRITE  — bash .claude/scripts/deploy-state.sh advance $DEPLOY_ID <NEXT_STATE>
    4. PAUSE  — if manual mode: ask user [c]ontinue / [s]kip / [i]nspect / [a]bort
    5. LOOP   — go back to step 1