@@ -66,6 +66,31 @@ The Flux custom media types used for OCI artifacts produced by the Flux CLI are
6666-  config media type ` application/vnd.cncf.flux.config.v1+json ` 
6767-  content media type ` application/vnd.cncf.flux.content.v1.tar+gzip ` 
6868
69+ ### Breaking changes  
70+ 
71+ Prior to ` v2.6.0 ` , the ` OCIRepository `  and ` ImageRepository `  APIs allowed the ` spec.provider `  field
72+ to be set to a value that did not necessarily match the repository URL. In these cases the controllers
73+ would simply ignore the ` spec.provider ` , not configuring OIDC authentication for the repository.
74+ 
75+ For example, the repository ` public.ecr.aws/aws-controllers-k8s `  never matched Flux's regular expression
76+ for the ` aws `  provider, but the controller would still allow the ` spec.provider `  to be set to ` aws `  in
77+ this case and would simply ignore it. This specific configuration would work correctly because this
78+ particular repository is public and does not require authentication.
79+ 
80+ Similarly, a private repository that did not match any of Flux's validations for the three container
81+ registry providers (` aws ` , ` azure ` , ` gcp ` ) would also work with the ` spec.provider `  set to one of
82+ these values, as long as it was also configured with one of the ` spec.secretRef `  or
83+ ` spec.serviceAccountName `  fields for using image pull secrets. In these cases, the controller
84+ would simply ignore the ` spec.provider `  and use the image pull secret instead.
85+ 
86+ Starting with ` v2.6.0 ` , Flux is fixing this behavior. The repository URL must now match the provider
87+ set in ` spec.provider ` , otherwise the controller will reject the configuration and return an error.
88+ For automatic OIDC authentication, the ` spec.provider `  must be set to one of the three container
89+ registry providers (` aws ` , ` azure ` , ` gcp ` ). For public repositories or authentication using image
90+ pull secrets, the ` spec.provider `  must not be set, or set to ` generic ` . These configuration
91+ instructions were explicit in the Flux docs since many releases, but are only now in ` v2.6.0 ` 
92+ being strictly enforced by the controllers.
93+ 
6994## Image Automation Digest Pinning  
7095
7196In Flux v2.6, the image automation has been enhanced to support digest pinning
0 commit comments