Deploy OneAgent Operator on Kubernetes (deprecated)

Create the necessary objects for OneAgent Operator.

OneAgent Operator acts on its separate namespace dynatrace. It holds the operator deployment and all dependent objects like permissions, custom resources and the corresponding DaemonSet. You can also observe the logs of OneAgent Operator.

kubectl create namespace dynatrace

kubectl apply -f https://github.com/Dynatrace/dynatrace-oneagent-operator/releases/latest/download/kubernetes.yaml

kubectl -n dynatrace logs -f deployment/dynatrace-oneagent-operator

Create the secret holding API and PaaS tokens for authentication to the Dynatrace Cluster.

The name of the secret is important in a later step when you configure the custom resource (.spec.tokens). In the following code-snippet the name is oneagent. Be sure to replace API_TOKEN and PAAS_TOKEN with the values explained in the prerequisites.

kubectl -n dynatrace create secret generic oneagent --from-literal="apiToken=API_TOKEN" --from-literal="paasToken=PAAS_TOKEN"

Save custom resource.

The rollout of Dynatrace OneAgent is governed by a custom resource of type OneAgent. Retrieve the cr.yaml file from the GitHub repository.

curl -o cr.yaml https://raw.githubusercontent.com/Dynatrace/dynatrace-oneagent-operator/master/deploy/cr.yaml

Adapt the values of the custom resource as indicated below.

args:
  - "--set-proxy="

env:
- name: ONEAGENT_ENABLE_VOLUME_STORAGE
  value: "true"

env:
- name: ONEAGENT_ENABLE_VOLUME_STORAGE
  value: "true"
- name: ONEAGENT_CONTAINER_STORAGE_PATH
  value: /var/vcap/store

env:
- name: ONEAGENT_ENABLE_VOLUME_STORAGE
  value: "true"
- name: ONEAGENT_CONTAINER_STORAGE_PATH
  value: /opt

env:
- name: ONEAGENT_ENABLE_VOLUME_STORAGE
  value: "true"

Create the custom resource.

kubectl apply -f cr.yaml

optional Configure proxy.

There are two ways to provide the proxy, depending on whether or not your proxy uses credentials.

apiVersion: dynatrace.com/v1alpha1
kind: OneAgent
metadata:
  name: oneagent
  namespace: dynatrace
spec:
  apiUrl: https://environmentid.dynatrace.com/api
  tolerations:
  - effect: NoSchedule
    key: node-role.kubernetes.io/master
    operator: Exists
  args: []
  enableIstio: true
  proxy:
    value: http://mysuperproxy

optional Configure network zones.

You can configure network zones by setting the following argument:

args:
  - --set-network-zone=<your.network.zone>

See network zones for more information.

Add the Dynatrace OneAgent Helm repository.

helm repo add dynatrace \
https://raw.githubusercontent.com/Dynatrace/helm-charts/master/repos/stable

Create a Dynatrace namespace.

The Dynatrace OneAgent Operator acts on its separate namespace called dynatrace, which holds the operator deployment and all dependent objects like permissions, custom resources, and corresponding DaemonSets.

kubectl create namespace dynatrace

Create the custom resource definitions.

Create a values.yaml file with the following content.

platform: "kubernetes"
operator:
  image: ""
oneagent:
  name: "oneagent"
  apiUrl: "https://ENVIRONMENTID.live.dynatrace.com/api"
  image: ""
  args: {}
  env: {}
  nodeSelector: {}
  labels: {}
  skipCertCheck: false
  disableAgentUpdate: false
  enableIstio: false
  dnsPolicy: ""
  resources: {}
  waitReadySeconds: null
  priorityClassName: ""
  serviceAccountName: ""
  proxy: ""
  trustedCAs: ""
secret:
  apiToken: "DYNATRACE_API_TOKEN"
  paasToken: "PLATFORM_AS_A_SERVICE_TOKEN"

env:
    - name: ONEAGENT_ENABLE_VOLUME_STORAGE
      value: "true"

env:
    - name: ONEAGENT_ENABLE_VOLUME_STORAGE
      value: "true"
    - name: ONEAGENT_CONTAINER_STORAGE_PATH
      value: /var/vcap/store

env:
    - name: ONEAGENT_ENABLE_VOLUME_STORAGE
      value: "true"
    - name: ONEAGENT_CONTAINER_STORAGE_PATH
      value: /opt

optional Configure network zones.

You can configure network zones by setting the following argument:

args:
  - --set-network-zone=<your.network.zone>

See network zones for more information.

To apply the YAML parameters, run the following command:

helm install dynatrace-oneagent-operator \
dynatrace/dynatrace-oneagent-operator -n\
dynatrace --values values.yaml

Remove OneAgent custom resources and clean up all remaining OneAgent Operator–specific objects.

kubectl delete -n dynatrace oneagent --all
kubectl delete -f https://github.com/Dynatrace/dynatrace-oneagent-operator/releases/latest/download/kubernetes.yaml

optional After deleting OneAgent Operator, the OneAgent binary remains on the node in an inactive state. To uninstall it completely, run the uninstall.sh script and delete logs and configuration files.
See Linux related information.