Skip to content

Commit 1e70c4c

Browse files
committed
Dropped default registries in crossplane v2
Signed-off-by: Philippe Scorsolini <[email protected]>
1 parent 3ca6127 commit 1e70c4c

File tree

1 file changed

+17
-0
lines changed

1 file changed

+17
-0
lines changed

content/v2.0-preview/whats-new/_index.md

Lines changed: 17 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -221,6 +221,7 @@ Crossplane v2 makes the following breaking changes:
221221
* It removes native patch and transform composition.
222222
* It removes the `ControllerConfig` type.
223223
* It removes support for external secret stores.
224+
* It removes the default registry for Crossplane Packages.
224225

225226
Crossplane deprecated native patch and transform composition in Crossplane
226227
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
231232
Crossplane added external secret stores in v1.7. External secret stores have
232233
remained in alpha for over two years and are now unmaintained.
233234

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+
234244
{{<hint "important">}}
235245
As long as you're not using these deprecated or alpha features, Crossplane v2 is
236246
backward compatible with Crossplane v1.x.
237247
{{</hint>}}
238248

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+
239256
<!-- vale gitlab.FutureTense = NO -->
240257
Crossplane v2 supports legacy v1-style XRs and MRs. Most users will be able to
241258
upgrade from v1.x to Crossplane v2 without breaking changes.

0 commit comments

Comments
 (0)