Skip to content

[RFC-0014] ⚠️ Breaking Changes: Align workload identity and TLS features with RFC-0014 (introduce v1beta2) - #72

Merged
matheuscscp merged 1 commit into
mainfrom
align-cred-api-with-rfc
Oct 29, 2026
Merged

matheuscscp merged 1 commit into
mainfrom
align-cred-api-with-rfc

Conversation

@matheuscscp

@matheuscscp matheuscscp commented Sep 24, 2026 •

Copy link
Copy Markdown
Member

Closes: #71
Part of: fluxcd/flux2#6103

Introduce mirror.plugin.fluxcd.io/v1beta2:

  • Rename credential claims and providers, require credential.type, move hosts[].username under credential, and add hosts[].provider: generic.
  • Replace tls.serverAuth/clientAuth with tls.path, inline ca.crt/tls.crt/tls.key, or tls.spiffe.serverIDs.
  • Convert v1beta1 renames and the TLS shapes that map exactly; decode v1beta1 leniently and print the migration guide when conversion fails.
  • Also stops the envelope transport from rewriting the registry-issued Bearer token for username credentials. Unrelated cleanup; called out here.

@matheuscscp matheuscscp added the enhancement New feature or request label Sep 24, 2026
@matheuscscp
matheuscscp force-pushed the align-cred-api-with-rfc branch 5 times, most recently from f7afa15 to 72d0306 Compare September 25, 2026 00:17
@matheuscscp
matheuscscp marked this pull request as ready for review September 25, 2026 00:27
@matheuscscp

Copy link
Copy Markdown
Member Author

@stefanprodan I did 5 rounds of adversarial reviews.

@matheuscscp

matheuscscp commented Sep 25, 2026 •

Copy link
Copy Markdown
Member Author

Added an API version bump to v1beta2, users with v1beta1 will see the following (soft) warning:

warning: apiVersion "mirror.plugin.fluxcd.io/v1beta1" is deprecated and will be removed in a future release; the config is being migrated to "mirror.plugin.fluxcd.io/v1beta2" in memory.
v1beta2 is a breaking change:
  - credential.type is required (set type: jwt)
  - credential.aud -> credential.audiences
  - credential.iss -> credential.issuer
  - credential.sub -> credential.subject
  - credential.exp -> credential.expiration
  - hosts[].username -> hosts[].credential.username
  - credential provider jwt-svid -> spiffe
  - tls clientAuth/serverAuth provider x509-svid -> spiffe
  - tls serverAuth spiffe authorizeAny is removed (set serverID or trustDomain)
See docs/config.md for the full specification.

@matheuscscp
matheuscscp force-pushed the align-cred-api-with-rfc branch 2 times, most recently from d48e6d4 to ea110f7 Compare September 25, 2026 18:32
@matheuscscp matheuscscp changed the title ⚠️ Breaking Changes: Align workload identity and TLS features with the new Flux RFC ⚠️ Breaking Changes: Align workload identity and TLS features with the new Flux RFC (v1beta2) Sep 25, 2026
Base automatically changed from reject-invalid-config to main September 28, 2026 08:03
@matheuscscp
matheuscscp force-pushed the align-cred-api-with-rfc branch 3 times, most recently from 11ad884 to 9603bf8 Compare September 29, 2026 09:09
@matheuscscp
matheuscscp force-pushed the align-cred-api-with-rfc branch 2 times, most recently from 82d74e7 to 2c4dfc4 Compare October 5, 2026 15:05
@matheuscscp matheuscscp changed the title ⚠️ Breaking Changes: Align workload identity and TLS features with the new Flux RFC (v1beta2) ⚠️ Breaking Changes: [RFC-0014] Align workload identity and TLS features with the RFC (introduce v1beta2) Oct 6, 2026
@matheuscscp matheuscscp changed the title ⚠️ Breaking Changes: [RFC-0014] Align workload identity and TLS features with the RFC (introduce v1beta2) [RFC-0014] ⚠️ Breaking Changes: Align workload identity and TLS features with RFC-0014 (introduce v1beta2) Oct 6, 2026
@matheuscscp
matheuscscp force-pushed the align-cred-api-with-rfc branch from 2c4dfc4 to c018b81 Compare October 6, 2026 12:20
@matheuscscp

Copy link
Copy Markdown
Member Author

The object-level APIs may still change in RFC-0014. Moving this to draft.

@matheuscscp
matheuscscp marked this pull request as draft October 12, 2026 12:53
@matheuscscp
matheuscscp force-pushed the align-cred-api-with-rfc branch from c018b81 to 8a493e7 Compare October 28, 2026 16:36
@matheuscscp
matheuscscp marked this pull request as ready for review October 28, 2026 16:50
@matheuscscp
matheuscscp force-pushed the align-cred-api-with-rfc branch from 8a493e7 to fd9c323 Compare October 29, 2026 08:17
Comment thread docs/report-v1beta2.json Resolved
…res with RFC-0014 (introduce v1beta2)

Signed-off-by: Matheus Pimenta <matheuscscp@gmail.com>
@matheuscscp
matheuscscp force-pushed the align-cred-api-with-rfc branch from fd9c323 to a8caa66 Compare October 29, 2026 09:07

@stefanprodan stefanprodan left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM

Thanks @matheuscscp 🏅

@matheuscscp
matheuscscp merged commit a3c72b6 into main Oct 29, 2026
7 checks passed
@matheuscscp
matheuscscp deleted the align-cred-api-with-rfc branch October 29, 2026 09:37
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

enhancement New feature or request

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[RFC-0014] ⚠️ Breaking Changes: Align workload identity and TLS features with RFC-0014 (introduce v1beta2)

2 participants