Dapr Operator control plane service overview

    When running Dapr in Kubernetes mode, a pod running the Dapr Operator service manages updates and provides Kubernetes services endpoints for Dapr.

    The operator service is deployed as part of , or via the Dapr Helm charts. For more information on running Dapr on Kubernetes, visit the .

    Additional configuration options

    The operator service includes additional configuration options.

    The operator service includes an injector watchdog feature which periodically polls all pods running in your Kubernetes cluster and confirms that the Dapr sidecar is injected in those which have the dapr.io/enabled=true annotation. It is primarily meant to address situations where the Injector service did not successfully inject the sidecar (the daprd container) into pods.

    • Recovering from a Kubernetes cluster completely stopped. When a cluster is completely stopped and then restarted (including in the case of a total cluster failure), pods are restarted in a random order. If your application is restarted before the Dapr control plane (specifically the Injector service) is ready, the Dapr sidecar may not be injected into your application’s pods, causing your application to behave unexpectedly.

    • Addressing potential random failures with the sidecar injector, such as transient failures within the Injector service.

    If the watchdog detects a pod that does not have a sidecar when it should have had one, it deletes it. Kubernetes will then re-create the pod, invoking the Dapr sidecar injector again.

    The injector watchdog feature is disabled by default.

    • : the injector watchdog is enabled and polls all pods at the given interval; the value for the interval is a string that includes the unit. For example: --watch-interval=10s (every 10 seconds) or --watch-interval=2m (every 2 minutes).
    • : the injector watchdog runs only once when the operator service is started.

    If you’re using Helm, you can configure the injector watchdog with the , which has the same values as the command line flags.

    Watch this video for an overview of the injector watchdog: