Skip to content

Add Hybrid Mesh Platform sandbox pattern#696

Open
maximilianoPizarro wants to merge 9 commits into
validatedpatterns:mainfrom
maximilianoPizarro:hybrid-mesh-platform-vp
Open

Add Hybrid Mesh Platform sandbox pattern#696
maximilianoPizarro wants to merge 9 commits into
validatedpatterns:mainfrom
maximilianoPizarro:hybrid-mesh-platform-vp

Conversation

@maximilianoPizarro

@maximilianoPizarro maximilianoPizarro commented Jun 15, 2026

Copy link
Copy Markdown

Summary

Adds the Hybrid Mesh Platform as a Sandbox-tier Validated Pattern — a hub-spoke multi-cluster GitOps reference architecture on OpenShift that combines Service Mesh, AI-assisted operations, and Industrial Edge factory workloads in a single deployable pattern.

  • Pattern repo: https://github.com/maximilianoPizarro/hybrid-mesh-platform — VP-conformant fork of multicloud-gitops (clustergroup, managedClusterGroups, Vault + External Secrets, pattern.sh install)
  • Tier: Sandbox — community best-effort support (SUPPORT.md)
  • Tested on: OpenShift 4.17+ on AWS (hub + east spoke + west spoke, 3 workers each)

What makes this pattern distinct

The existing catalog covers Service Mesh and Industrial Edge separately. This pattern combines them with AI-assisted operations:

Capability Implementation
Multi-cluster GitOps ACM + dual PUSH/PULL ApplicationSet
Cross-cluster connectivity Skupper VAN (outbound-only mTLS, no VPN)
Ambient Service Mesh OSSM3 ztunnels — L4 encryption without sidecars
AI-assisted operations OpenShift Lightspeed + MCP Gateway (Quarkus + Go SDK) with OLSConfig
AI inference OpenShift AI / MaaS — vLLM serving Qwen3 / Granite
API management Connectivity Link (Kuadrant) — rate limits, API keys, Gateway API
Far-edge extension path Red Hat Device Edge + MicroShift, same ACM placement rules

Documentation added

  • content/patterns/hybrid-mesh-platform/_index.md — Problem→Solution framing, hub-spoke table, products, journey
  • content/patterns/hybrid-mesh-platform/architecture.md — multi-cluster topology with Red Hat branded diagrams, Device Edge extension path
  • content/patterns/hybrid-mesh-platform/getting-started.md — VP install (pattern.sh), prerequisites table (OCP/RHOAI/storage/GPU), secrets table (values-secret.yaml.template), and Verify the installation section with concrete commands
  • content/patterns/hybrid-mesh-platform/cluster-sizing.adoc — generated from pattern-metadata.yaml via utils/flatten_yaml.rb; source link included in the page for reviewer verification
  • content/patterns/hybrid-mesh-platform/demo-scenario.md — explanatory workshop showroom narrative (hands-on lab modules remain in showroom-hybrid-mesh-ai)
  • content/patterns/hybrid-mesh-platform/hub-gateway.md, observability.md, industrial-edge.md, scaffolding.md, ideas-for-customization.md
  • modules/hybrid-mesh-platform/metadata-hybrid-mesh-platform.adoc — generated from pattern-metadata.yaml
  • static/images/hybrid-mesh-platform/ — 40 images (all referenced; 82 orphaned images removed)
  • .wordlist.txt — added: kairos, kaoto, kserve, kuadrant, mailpit, skupper, ztunnel; duplicates removed

Test plan

  • Local Hugo build passes (hugo --minify, 558 pages, 0 errors)
  • All pattern pages return HTTP 200
  • Internal links and image paths validated — all 40 images referenced, no broken refs
  • .wordlist.txt normalized (sort -u, no duplicates)
  • make build via Podman container — Podman Machine requires Hyper-V admin on this workstation; local hugo --minify build is clean with 0 errors, which exercises the same Hugo + Asciidoctor rendering path

Any feedback or suggestions to improve this pattern — content, structure, or alignment with VP standards — are very welcome. Thank you for your time and review!

maximilianoPizarro and others added 5 commits June 15, 2026 20:06
Baseline pattern pages and images for VP-conformant hybrid-mesh-platform
publication on validatedpatterns.io.

Co-authored-by: Cursor <cursoragent@cursor.com>
Sync content from hybrid-mesh-platform repo, add cluster-sizing metadata
module, demo-scenario page with showroom narrative, refreshed images, and
fixed internal/external doc links aligned with validatedpatterns.io journey.

Co-authored-by: Cursor <cursoragent@cursor.com>
Co-authored-by: Cursor <cursoragent@cursor.com>
- Add Problem→Solution table at top of _index.md (Service Mesh + AI ops framing)
- Clarify 3-cluster requirement explicitly (single-cluster not supported)
- Expand prerequisites: OCP version, storage class, RHOAI/GPU, Lightspeed
- Document values-secret.yaml.template secrets table with all 6 secret names
- Add Verify the installation section with concrete oc/bash commands
  (ACM, Skupper, OLSConfig, RHOAI, Industrial Edge, console links)
- Add ASCII topology diagram in architecture.md showing hub+spoke+Skupper VAN

Co-authored-by: Cursor <cursoragent@cursor.com>
- Remove ASCII art diagram from architecture.md (Red Hat branded images already exist)
- Use workshop-hybrid-mesh-arch.png + arch-hub-spoke-flow.png as visual topology
- Expand "Comparison" section to full "Relationship to VP patterns" with MCP/Lightspeed detail
- Add Red Hat Device Edge + MicroShift extension path in architecture.md and ideas-for-customization.md
- Update _index.md summary and Goal framing to include Device Edge extension path

Co-authored-by: Cursor <cursoragent@cursor.com>
@openshift-ci

openshift-ci Bot commented Jun 15, 2026

Copy link
Copy Markdown
Contributor

Hi @maximilianoPizarro. Thanks for your PR.

I'm waiting for a validatedpatterns member to verify that this patch is reasonable to test. If it is, they should reply with /ok-to-test on its own line. Until that is done, I will not automatically test new commits in this PR, but the usual testing commands by org members will still work.

Regular contributors should join the org to skip this step.

Once the patch is verified, the new status will be reflected by the ok-to-test label.

I understand the commands that are listed here.

Details

Instructions for interacting with me using PR comments are available here. If you have questions or suggestions related to my behavior, please file an issue against the kubernetes-sigs/prow repository.

@openshift-ci openshift-ci Bot requested review from beekhof and mbaldessari June 15, 2026 23:30
maximilianoPizarro and others added 4 commits June 15, 2026 20:37
- sort -u .wordlist.txt: remove duplicate entries (api's, backend's, etc.)
- Remove 81 orphaned images (66 numbered workshop module shots + workshop/
  subdirectory duplicates + 15 unreferenced root images)
- Restore Kiali, Kafka Console, Kairos, and connectivity-link screenshots
  to observability.md and hub-gateway.md (were dropped during Jekyll→Hugo port)
- Images reduced from 122 to 40 — all 40 are referenced in doc pages
- Add clarifying note to demo-scenario.md: explanatory content only,
  hands-on lab modules remain in showroom-hybrid-mesh-ai repo

Co-authored-by: Cursor <cursoragent@cursor.com>
Reviewers can verify the generated .adoc is consistent with
https://github.com/maximilianoPizarro/hybrid-mesh-platform/blob/main/pattern-metadata.yaml

Co-authored-by: Cursor <cursoragent@cursor.com>
The pattern repo uses charts/region/hub|east|west/ and charts/all/,
not the App-of-Apps values-hub.yaml / east/ / west/ layout.

- getting-started.md: fix repository layout block, values-hub.yaml →
  charts/region/hub/values.yaml (2 occurrences), ApplicationSet path
  east/ → charts/all/spoke-meta-push (PUSH) + charts/region/east/ (PULL)
- ideas-for-customization.md: fix repo layout block, values table,
  ApplicationSet conceptual YAML, adding-spoke step 3, Regions table entry,
  Device Edge far-edge folder path

Co-authored-by: Cursor <cursoragent@cursor.com>
5 service-interconnect-console-*.png screenshots restored from
hybrid-mesh-platform/docs/assets/images/ and added to observability.md
in a dedicated "Skupper Network Observer" section showing VAN overview,
topology, process detail, and traffic metrics views.

Co-authored-by: Cursor <cursoragent@cursor.com>
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