Skip to content

Latest commit

 

History

History
41 lines (34 loc) · 3.13 KB

v5-0-migration.md

File metadata and controls

41 lines (34 loc) · 3.13 KB
title description layout permalink
Migrating from v4.7 to v5.0
Migrating from v4.7 to v5.0
docs
/docs/v5-0-migration

Migrating from v4.7 to v5.0

API Tweaks

  1. Result of managed dependent resources is not Optional anymore. In case you use this result, simply use the result objects directly.

  2. EventSourceInitializer is not a separate interface anymore. It is part of the Reconciler interface with a default implementation. You can simply remove this interface from your reconciler. The EventSourceUtils now contains all the utility methods used for event sources naming that were previously defined in the EventSourceInitializer interface.

  3. Updates through UpdateControl now use Server Side Apply (SSA) by default to add the finalizer and for all the patch operations in UpdateControl. The update operations were removed. If you do not wish to use SSA, you can deactivate the feature using ConfigurationService.useSSAToPatchPrimaryResource and related ConfigurationServiceOverrider.withUseSSAToPatchPrimaryResource.

    !!! IMPORTANT !!!

    See known issues with migration from non-SSA to SSA based status updates here: integration test where it is demonstrated. Also, the related part of a workaround.

    Related automatic observed generation handling changes: Automated Observed Generation (see features in docs), is automatically handled for non-SSA, even if the status sub-resource is not instructed to be updated. This is not true for SSA, observed generation is updated only when patch status is instructed by UpdateControl.

  4. ManagedDependentResourceContext has been renamed to ManagedWorkflowAndDependentResourceContext and is accessed via the accordingly renamed managedWorkflowAndDependentResourceContext method.

  5. ResourceDiscriminator was removed. In most of the cases you can just delete the discriminator, everything should work without it by default. To optimize and handle special cases see the relevant section in Dependent Resource documentation.

  6. ConfigurationService.getTerminationTimeoutSeconds and associated overriding mechanism have been removed, use Operator.stop(Duration) instead.

  7. Operator.installShutdownHook() has been removed, use Operator.installShutdownHook(Duration) instead