Skip to content

docs: add architecture documentation for dynamic plugin loading and catalog index#4364

Draft
kadel wants to merge 3 commits intoredhat-developer:mainfrom
kadel:arch-docs
Draft

docs: add architecture documentation for dynamic plugin loading and catalog index#4364
kadel wants to merge 3 commits intoredhat-developer:mainfrom
kadel:arch-docs

Conversation

@kadel
Copy link
Copy Markdown
Member

@kadel kadel commented Mar 4, 2026

Add two new documents under docs/architecture/ covering:

  • Dynamic plugin loading: init container pattern, install-dynamic-plugins.py walkthrough, plugin installation mechanics, configuration merging
  • Catalog index build: build pipeline, input sources across repos, individual plugin OCI image builds, runtime consumption flow

Description

Please explain the changes you made here.

Which issue(s) does this PR fix

  • Fixes #?

PR acceptance criteria

Please make sure that the following steps are complete:

  • GitHub Actions are completed and successful
  • Unit Tests are updated and passing
  • E2E Tests are updated and passing
  • Documentation is updated if necessary (requirement for new features)
  • Add a screenshot if the change is UX/UI related

How to test changes / Special notes to the reviewer

…atalog index

Add two new documents under docs/architecture/ covering:
- Dynamic plugin loading: init container pattern, install-dynamic-plugins.py
  walkthrough, plugin installation mechanics, configuration merging
- Catalog index build: build pipeline, input sources across repos,
  individual plugin OCI image builds, runtime consumption flow

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@openshift-ci
Copy link
Copy Markdown

openshift-ci bot commented Mar 4, 2026

Skipping CI for Draft Pull Request.
If you want CI signal for your change, please convert it to an actual PR.
You can still manually trigger a test run with /test all

@github-actions
Copy link
Copy Markdown
Contributor

github-actions bot commented Mar 4, 2026

Image was built and published successfully. It is available at:

…talog coverage

Convert all ASCII art diagrams in architecture docs to Mermaid flowcharts
for better rendering and maintainability. Add rhdh-plugin-catalog as the
named midstream repo (was vaguely "Red Hat Internal CI"), including its
key scripts (sync-midstream.sh, generateCatalogIndex.py), Konflux/Tekton
pipelines, and dual-registry publishing. Expand cross-repo diagrams to
cover all 9 RHDH ecosystem repos and enrich reference tables.

Assisted-by: Claude Code
Signed-off-by: Tomas Kral <tkral@redhat.com>
@github-actions
Copy link
Copy Markdown
Contributor

This PR is stale because it has been open 7 days with no activity. Remove stale label or comment or this will be closed in 21 days.

@github-actions github-actions bot added the Stale label Mar 12, 2026
- Fix .tekton pipeline count (56, not 114+) and workspace count (23, not 24)
- Fix operator line reference (115-119, not 115-120)
- Clarify REGISTRY_AUTH_FILE and NPM_CONFIG_USERCONFIG are consumed by
  skopeo/npm, not the install script
- Distinguish community vs TP/GA plugin build pipelines
- Add PluginCollection kind name to collections description
- Improve readability: warning callout for stale locks, key behavior
  callout for config replacement, ! delimiter explanation, clearer
  registry fallback and cleanup descriptions
- Add cross-reference between the two architecture docs
- Add version alignment table note
@sonarqubecloud
Copy link
Copy Markdown

@github-actions
Copy link
Copy Markdown
Contributor

Image was built and published successfully. It is available at:

@github-actions github-actions bot removed the Stale label Mar 28, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant