// This assembly is included in the following assemblies:
//
// // assembly-upgrade.adoc

[id='assembly-upgrade-resources-{context}']
= {ProductName} resource upgrades

The `{KafkaApiVersionPrev}` API version is deprecated.
Resources that use the API version `{KafkaApiVersionPrev}` must be updated to use `{KafkaApiVersion}`.

This section describes the upgrade steps for the resources.

IMPORTANT: The upgrade of resources _must_ be performed after xref:assembly-upgrade-{context}[upgrading the Cluster Operator], so the Cluster Operator can understand the resources.

.What if the resource upgrade does not take effect?
If the upgrade does not take effect, a warning is given in the logs on reconciliation to indicate that the resource cannot be updated until the `apiVersion` is updated.

To trigger the update, make a cosmetic change to the custom resource, such as adding an annotation.

Example annotation:

[source,shell,subs="+quotes,attributes"]
----
metadata:
  # ...
  annotations:
    upgrade: "Upgraded to {KafkaApiVersion}"
----

include::modules/proc-upgrade-kafka-resources.adoc[leveloffset=+1]
include::modules/proc-upgrade-kafka-connect-resources.adoc[leveloffset=+1]
include::modules/proc-upgrade-kafka-connect-s2i-resources.adoc[leveloffset=+1]
include::modules/proc-upgrade-kafka-mirror-maker-resources.adoc[leveloffset=+1]
include::modules/proc-upgrade-kafka-topic-resources.adoc[leveloffset=+1]
include::modules/proc-upgrade-kafka-user-resources.adoc[leveloffset=+1]
