@@ -221,6 +221,7 @@ Crossplane v2 makes the following breaking changes:
221
221
* It removes native patch and transform composition.
222
222
* It removes the `ControllerConfig` type.
223
223
* It removes support for external secret stores.
224
+ * It removes the default registry for Crossplane Packages.
224
225
225
226
Crossplane deprecated native patch and transform composition in Crossplane
226
227
v1.17. It's replaced by composition functions.
@@ -231,11 +232,27 @@ Crossplane deprecated the `ControllerConfig` type in v1.11. It's replaced by the
231
232
Crossplane added external secret stores in v1.7. External secret stores have
232
233
remained in alpha for over two years and are now unmaintained.
233
234
235
+ Crossplane, introduced configurable default registries (`--registry`) in v1.15,
236
+ when the default moved from `index.docker.io` to `xpkg.upbound.io`. In v1.20
237
+ the default changed to `xpkg.crossplane.io`. Crossplane v2 drops the
238
+ ` --registry` flag and requires users to specify a registry URL when installing
239
+ packages, both directly via `spec.package` and indirectly as dependencies.
240
+ Using fully qualified images was already a best practice, but it's now enforced
241
+ to avoid confusion, and ensure users are aware of the registry used by their
242
+ packages.
243
+
234
244
{{<hint "important">}}
235
245
As long as you're not using these deprecated or alpha features, Crossplane v2 is
236
246
backward compatible with Crossplane v1.x.
237
247
{{</hint>}}
238
248
249
+ {{<hint "important">}}
250
+ Before upgrading to Crossplane v2, please ensure all your Packages fully
251
+ qualified images used by running `kubectl get pkg`, looking for non fully
252
+ qualified images, and update, or rebuild, Packages to use fully qualified
253
+ images, as needed.
254
+ {{</hint>}}
255
+
239
256
<!-- vale gitlab.FutureTense = NO -->
240
257
Crossplane v2 supports legacy v1-style XRs and MRs. Most users will be able to
241
258
upgrade from v1.x to Crossplane v2 without breaking changes.
0 commit comments