Migration of DynaKube v1beta2 to v1beta5

This guide will show you how you can manually migrate from apiVersion: dynatrace.com/v1beta2 to apiVersion: dynatrace.com/v1beta5 of the DynaKube.

Support lifecycle

v1beta2

Introduced in: Dynatrace Operator version 1.2.0

Deprecated in: Dynatrace Operator version 1.6.0

Last supported in: Dynatrace Operator version 1.6.2

v1beta5

Introduced in: Dynatrace Operator version 1.6.0

Changes

Reminder

When migrating your DynaKube, remember to update the apiVersion field as well as any other fields that have changed

Replaced feature-flags

New CSI mount timeout feature-flag

The feature flag that controlled how many mount attempts the CSI driver would make before stopping (feature.dynatrace.com/max-csi-mount-attempts: 5) has been replaced with a timeout-based feature flag. This was done due to the difficulty of determining how many attempts equal a given timeout.

feature.dynatrace.com/max-csi-mount-timeout: "8m" # feature.dynatrace.com/max-csi-mount-attempts: "10"

Deprecated fields

OneAgent autoUpdate

The spec.oneAgent.<mode>.autoUpdate: true/false is deprecated in v1beta5, so it shouldn't be used.

The recommendation is:

  • If you want autoUpdate: true, do not set image, codeModulesImage or version
apiVersion: dynatrace.com/v1beta5
kind: DynaKube
metadata:
name: example
namespace: dynatrace
spec:
cloudNativeFullstack: {} # same effect as autoUpdate: true
# ...
  • If you want autoUpdate: false, set image, codeModulesImage or version
apiVersion: dynatrace.com/v1beta5
kind: DynaKube
metadata:
name: example
namespace: dynatrace
spec:
cloudNativeFullstack:
image: # same effect as autoUpdate: false
codeModulesImage: # same effect as autoUpdate: false
# ...
---
apiVersion: dynatrace.com/v1beta5
kind: DynaKube
metadata:
name: example
namespace: dynatrace
spec:
cloudNativeFullstack:
version: ... # same effect as autoUpdate: false
# ...

Removed fields

spec.applicationMonitoring.useCSIDriver

The spec.applicationMonitoring.useCSIDriver: true has been removed.

The CSI driver is now used when installed as part of the Dynatrace Operator installation.