Skip to content

Reduce confusion on v2 XR connection details #1001

Closed

Description

@jbw976

What's Missing?

There's a bit of confusion, and out of date documentation, for how connection details work for XRs in v2.

Some of the problems are captured in crossplane/crossplane#6837 (comment).

TL;DR, we removed connection details from XRs in v2, but we don't have good documentation and guidance on how to handle that. Nic's suggestion in crossplane/crossplane#6440 is the only "doc" i know of:

I feel comfortable dropping this functionality (from core) for v2 XRs because in v2 you can recreate it using functions - just have your XR compose a secret with the XR's connection details in it.

We should perhaps consider surfacing this more clearly as a breaking change too, depending on the scope of impact once that is better assessed.

Related fixes:

Activity

  1. self-assigned this
    on Dec 4, 2025
  2. moved this from Backlog to In Progress in Crossplane Roadmapon Dec 4, 2025
  3. moved this from In Progress to In Review in Crossplane Roadmapon Jan 7, 2026
  4. jbw976 commented on Jan 12, 2026

    @jbw976
    MemberAuthor

    This effort is now complete, see the checklist of PRs/changes in the issue body.

    XR connection details guide: https://docs.crossplane.io/latest/guides/connection-details-composition/

  5. changed the title [-]Document how XR connection details work in v2[/-] [+]Reduce confusion on v2 XR connection details[/+] on Jan 12, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

Labels

Type

No type

Projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions