Migration of DynaKube v1beta1 to v1beta5

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

Support lifecycle

v1beta1

Introduced in: Dynatrace Operator version 0.3.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

Dedicated `metadataEnrichment` section

The feature-flag for enabling metadata-enrichment (feature.dynatrace.com/metadata-enrichment: true/false) was moved to a dedicated field:

apiVersion: dynatrace.com/v1beta5
kind: DynaKube
metadata:
  name: example
  namespace: dynatrace
spec:
   metadataEnrichment:
     enabled: true # replaces feature.dynatrace.com/metadata-enrichment: true
  #...

Dedicated `dynatraceApiRequestThreshold` field

The feature-flag for controlling how often Dynatrace Operator can ping the Dynatrace API (feature.dynatrace.com/dynatrace-api-request-threshold: <number>) was moved to a dedicated field:

apiVersion: dynatrace.com/v1beta5
kind: DynaKube
metadata:
  name: example
  namespace: dynatrace
spec:
   dynatraceApiRequestThreshold: 10 # replaces feature.dynatrace.com/dynatrace-api-request-threshold: "10"
  #...

Dedicated `secCompProfile` field for OneAgent

The feature flag that controls which seccomp profile the OneAgent DaemonSet uses (feature.dynatrace.com/oneagent-seccomp-profile:example) has been moved to a dedicated field:

apiVersion: dynatrace.com/v1beta5
kind: DynaKube
metadata:
  name: example
  namespace: dynatrace
spec:
  oneAgent:
    hostMonitoring:
      secCompProfile: example # replaces feature.dynatrace.com/oneagent-seccomp-profile: "example"
  #...

apiVersion: dynatrace.com/v1beta5
kind: DynaKube
metadata:
  name: example
  namespace: dynatrace
spec:
  oneAgent:
    classicFullStack:
      secCompProfile: example # replaces feature.dynatrace.com/oneagent-seccomp-profile: "example"
  #...

apiVersion: dynatrace.com/v1beta5
kind: DynaKube
metadata:
  name: example
  namespace: dynatrace
spec:
  oneAgent:
    cloudNativeFullstack:
      secCompProfile: example # replaces feature.dynatrace.com/oneagent-seccomp-profile: "example"
  #...

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"

Moved fields

`spec.namespaceSelector`

The spec.namespaceSelector was moved to each feature subsection that it affects.

apiVersion: dynatrace.com/v1beta5
kind: DynaKube
metadata:
  name: example
  namespace: dynatrace
spec:
  oneAgent:
    cloudNativeFullstack:
      namespaceSelector: ... # replaces spec.namespaceSelector
   # ...

apiVersion: dynatrace.com/v1beta5
kind: DynaKube
metadata:
  name: example
  namespace: dynatrace
spec:
  oneAgent:
    applicationMonitoring:
      namespaceSelector: ... # replaces spec.namespaceSelector
    # ...

apiVersion: dynatrace.com/v1beta5
kind: DynaKube
metadata:
  name: example
  namespace: dynatrace
spec:
  metadataEnrichment:
    namespaceSelector: ... # replaces spec.namespaceSelector
    # ...

Deprecated fields

OneAgent `autoUpdate`

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

We recommend the following:

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 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: ... # replaces 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.

`spec.kubernetesMonitoring`

The deprecated field spec.kubernetesMonitoring was removed in favor of using the current spec.activeGate section. Here are an example that shows you before and after:

Before

apiVersion: dynatrace.com/v1beta1
kind: DynaKube
metadata:
  name: example
  namespace: dynatrace
spec:
  kubernetesMonitoring:
    enabled: true
    replicas: ...
    image: ...
    group: ...
    customProperties: ...
    resources: ...
    nodeSelector: ...
    tolerations: ...
    labels: ...
    env: ...
  #...

After

apiVersion: dynatrace.com/v1beta5
kind: DynaKube
metadata:
  name: example
  namespace: dynatrace
spec:
  activeGate:
    capabilities:
      - kubernetes-monitoring #<-- explicitly enable Kubernetes monitoring
    replicas: ...
    image: ...
    group: ...
    customProperties: ...
    resources: ...
    nodeSelector: ...
    tolerations: ...
    labels: ...
    env: ...
  #...

`spec.routing`

The deprecated field spec.routing was removed in favor of using the current spec.activeGate section. Here is an example that shows you before and after: