Skip to content

docs(adr): Align KCP runtime design with deployment mode - #212

Open
ifdotpy wants to merge 3 commits into
openmcp-project:mainfrom
ifdotpy:feat/adr-kcp-runtime-export-metadata
Open

ifdotpy wants to merge 3 commits into
openmcp-project:mainfrom
ifdotpy:feat/adr-kcp-runtime-export-metadata

Conversation

@ifdotpy

@ifdotpy ifdotpy commented Sep 10, 2026

Copy link
Copy Markdown

The ADR now separates the proposed APIExport discovery path from the deployed Secret-backed shared onboarding path. The deployment selects the manager when it starts. ProviderConfig does not select the mode.

For the APIExport path, the platform owns the APIResourceSchema and APIExport. The shared Flux and External Secrets providers instead watch account kubeconfig Secrets. Both paths use the common ClusterContext and access deletion step.

Validation: npm run build passed. Docusaurus reported an existing broken anchor in /users/concepts/providers.

Two additions to the kcp-aware Service Provider Runtime ADR:

1. Provisioning: the Provisionable configuration can carry optional labels
and annotations for the generated APIExport, stamped by the runtime at
provisioning time. Gives embedding platforms a declarative source for their
marker labels (e.g. Platform Mesh's ui.platform-mesh.io/content-for) with the
runtime as the single writer. Verified live: an externally added label on a
provider APIExport is stripped within a minute today, so platforms re-apply
theirs in a loop.

2. Open question 4 (singleton): proposed resolution keeps the existing name
convention as the rule - a service object binds to the same-named
ControlPlane, so per-target uniqueness comes free from name uniqueness, with
no API change and no enforcement code. Hard requirement: no matching
ControlPlane means a visible Progressing condition, never silent ignoring.
An explicit targetRef (defaulting to metadata.name) remains a compatible
later extension.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01LTnkmXa3XLTxGMmfZayFV2
Signed-off-by: Igor Fominykh <ihor.fominykh@sap.com>
@ifdotpy
ifdotpy force-pushed the feat/adr-kcp-runtime-export-metadata branch from cda0ef2 to cb247e6 Compare September 22, 2026 18:16
Signed-off-by: Igor Fominykh <ihor.fominykh@sap.com>
@ifdotpy ifdotpy changed the title docs(adr): APIExport metadata passthrough and name-bound service targets docs(adr): Align KCP runtime design with deployment mode Sep 23, 2026
Signed-off-by: Igor Fominykh <ihor.fominykh@sap.com>

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant