OCP Dev Days dry-run feedback triage — 2026-07-30

dry-run-feedback-triage-2026-07-30.md

Dry-Run Feedback Triage -- 2026-07-30

Multi-user dry run of the OCP Dev Days lab. Feedback categorized by priority, repo ownership, and actionable fixes.

Repos

Repo	Description	PR
gitops (ocp-dev-days-rdshw-gitops)	Lab infrastructure provisioning	rhpds/ocp-dev-days-rdshw-gitops#12
showroom (ocp-dev-days-rdshw-showroom)	Tutorial content (AsciiDoc)	rhpds/ocp-dev-days-rdshw-showroom#7
rhdh-templates (openshift-dev-days/rhdh-templates)	Backstage scaffolder templates	openshift-dev-days/rhdh-templates#1

---

CRITICAL -- Bugs / Blockers

#	Issue	Repo	Root Cause	Fix	Status
1	Workspace Image Build timeout -- image build failed, workspaces can't start	gitops	job-pipelinerun-cekit-builder.yaml fires a single PipelineRun with no status polling or retry; if it fails, workspaces never come up	Add loop that polls PipelineRun status and retries up to 3 times on failure. Add to pre-flight checklist.	DONE
2	Bug: User Cannot View Feature Branch NS -- userX-claims-stats not visible in OCP Console	rhdh-templates	Feature-branch namespace (e.g. user1-claims-stats) is created by the scaffolder template (rhdh-templates repo, manifests/helm/templates/namespace.yaml) but no RoleBinding existed for the user. pipeline-sa.yaml only binds the build SA, not the user.	Added rolebinding-tenant-user.yaml to manifests/helm/templates/ binding the user to the tenant-user ClusterRole in the feature-branch namespace.	DONE
3	Pipeline is missing (Section 6 after merge)	gitops + showroom	After merging the feature branch MR, the main-branch pipeline may not trigger if the GitLab webhook for main isn't configured, or the pipeline isn't visible in the RHDH CI tab for the main component.	Investigate webhook config for main branch pushes. Ensure showroom content clarifies which component to check for the post-merge pipeline.	TODO -- investigate

---

HIGH -- Performance

#	Issue	Repo	Root Cause	Fix	Status
4	CI Takes too long	gitops + manifests	Pipeline stages (clone, sonar-scan, build-push, redeploy) run sequentially. SonarQube cold start and S2I builds are main bottlenecks.	Profile PipelineRun durations. Consider running sonar-scan in parallel with build. Pre-warm SonarQube. Use pre-built base image layers.	TODO -- profile first
5	Per Container LimitRange too aggressive (1Gi memory)	gitops	tenant/parasol-insurance-tenant/values.yaml sets default memory limit to 1Gi. Java/Quarkus apps + pipeline tasks easily need more.	Bumped to 2Gi default limit, 256Mi default request. Consider bumping ResourceQuota if needed.	DONE

File changes (Performance):

• tenant/parasol-insurance-tenant/values.yaml -- limitRange.default.memory: 1Gi -> 2Gi, limitRange.defaultRequest.memory: 128Mi -> 256Mi

---

MEDIUM -- UX / Content Improvements

#	Issue	Repo	Root Cause	Fix	Status
6	"Where is the MR to manifest for PROD?" -- confusing	showroom	Section 6 Exercise 3 tells users to navigate to parasol-insurance-manifests but doesn't provide a direct link or clear enough breadcrumb instructions.	Add direct URL link to the manifests repo. Add TIP callout explaining the two-repo model (source vs manifests).	DONE
7	ClaimsStatsResource filepath unclear	showroom	Lines 251-253 say "navigate to src/main/java/com/parasol/" then "right-click on parasol" -- users may create the file at the wrong level.	Add explicit full path callout and WARNING about wrong directory causing route/build failures.	DONE
8	Username/Password hard to find	showroom	Credentials only shown in 02-details.adoc and inline in the module. No persistent reference.	Add credentials to index.adoc welcome page. Add credential reminder at each section header.	DONE
9	Add Dev Spaces tab to Showroom	showroom	ui-config.yml has 4 tabs but no Dev Spaces.	Add 5th tab: - name: Dev Spaces / url: 'https://devspaces.${DOMAIN}'.	DONE
10	Terminal Embed not Working -- not logged in	showroom + infra	Wetty terminal not logged into user's SA.	Either fix wetty login or remove Terminal tab until fixed. Decision: remove and add note.	DONE
11	Live Reload not working (Exercise 3)	showroom	Users add the file but Quarkus dev mode doesn't hot-reload. Content doesn't mention explicit save (Ctrl+S).	Add TIP about saving files and troubleshooting live reload.	DONE

---

LOW -- Nice-to-Have / External

#	Issue	Repo	Root Cause	Fix	Status
12	Showroom scroll breaks on layout toggle	showroom (theme)	Upstream Showroom theme bug in split/instructions view switching.	Report upstream to rhpds/rhdp_showroom_theme. Add workaround NOTE.	DONE (workaround)
13	Tab split mode loses scroll position	showroom (theme)	Same upstream theme issue -- persist_url_state doesn't preserve scroll offset.	Report upstream.	TODO -- upstream
14	Error navigating to API catalog	gitops (RHDH)	scaffolder.task fetch failed -- TypeError: fetch failed in GitLab Backstage plugin. Network timeout or DNS between RHDH and GitLab.	Check RHDH->GitLab connectivity. May need increased fetch timeouts in developer-hub/ chart.	TODO -- investigate
15	AI assistant issues (Exercise 5.1)	infra (LLM)	Zoo Code may have connectivity issues to hosted LLM or model unresponsive.	Ensure LLM backend stability. Add fallback instruction: "If the AI is unresponsive, manually apply the code below."	DONE (fallback added)

---

Pre-Flight Checklist (new items)

• Verify workspace image build PipelineRun completes successfully before opening lab to users
• Verify wetty terminal auto-login works (or disable Terminal tab)
• Verify SonarQube is warm and responding before first pipeline run
• Verify GitLab webhooks fire for both feature-branch and main-branch pushes
• Verify feature-branch namespace RBAC allows user visibility in OCP Console
• Verify LLM backend for Zoo Code is reachable from Dev Spaces pods

---

File Changes Summary

gitops repo -- PR #12

File	Change
tenant/parasol-insurance-tenant/values.yaml	Memory limit 1Gi -> 2Gi, request 128Mi -> 256Mi
cluster/workspace-images/templates/job-pipelinerun-cekit-builder.yaml	Added PipelineRun status polling and retry (3 attempts)

showroom repo -- PR #7

File	Change
ui-config.yml	Added Dev Spaces tab, removed broken Terminal tab
content/modules/ROOT/pages/index.adoc	Added credentials section
content/modules/ROOT/pages/03-module-01-developer-experience.adoc	Improved filepath guidance with WARNING, added live reload TIP, added credential reminders at section headers, clarified manifests repo MR navigation, added AI fallback instructions, added scroll workaround NOTE

rhdh-templates repo -- PR #1

File	Change
templates/parasol-dev-environment/manifests/helm/templates/rolebinding-tenant-user.yaml	NEW -- RoleBinding granting user tenant-user ClusterRole in the feature-branch namespace

Items Requiring External Action

1. Showroom scroll/layout bugs -- report upstream to rhpds/rhdp_showroom_theme
2. RHDH API catalog error -- investigate RHDH->GitLab network connectivity
3. CI performance -- profile pipeline durations in the manifests repo pipeline definitions