annotate CLI command reference
Add Dapr annotatations to a Kubernetes configuration
Description
Add Dapr annotations to a Kubernetes configuration. This enables you to add/change the Dapr annotations on a deployment files. See Kubernetes annotations for a full description of each annotation available in the following list of flags.
Supported platforms
Usage
dapr annotate [flags] CONFIG-FILE
Flags
| Name | Environment Variable | Default | Description |
|---|---|---|---|
--kubernetes, -k | Apply annotations to Kubernetes resources. Required | ||
--api-token-secret | The secret to use for the API token | ||
--app-id, -a | The app id to annotate | ||
--app-max-concurrency | -1 | The maximum number of concurrent requests to allow | |
--app-port, -p | -1 | The port to expose the app on | |
--app-protocol | The protocol to use for the app: http (default), grpc, https, grpcs, h2c | ||
--app-token-secret | The secret to use for the app token | ||
--config, -c | The config file to annotate | ||
--cpu-limit | The CPU limit to set for the sidecar. See valid values here. | ||
--cpu-request | The CPU request to set for the sidecar. See valid values here. | ||
--dapr-image | The image to use for the dapr sidecar container | ||
--enable-debug | false | Enable debug | |
--enable-metrics | false | Enable metrics | |
--enable-profile | false | Enable profiling | |
--env | Environment variables to set (key value pairs, comma separated) | ||
--graceful-shutdown-seconds | -1 | The number of seconds to wait for the app to shutdown | |
--help, -h | help for annotate | ||
--listen-addresses | The addresses for sidecar to listen on. To listen to all IPv4 addresses, use 0.0.0.0. To listen to all IPv6 addresses, use [::]. | ||
--liveness-probe-delay | -1 | The delay for sidecar to use for the liveness probe. Read more here. | |
--liveness-probe-period | -1 | The period used by the sidecar for the liveness probe. Read more here. | |
--liveness-probe-threshold | -1 | The threshold used by the sidecar for the liveness probe. Read more here. | |
--liveness-probe-timeout | -1 | The timeout used by the sidecar for the liveness probe. Read more here. | |
--log-level | The log level to use | ||
--max-request-body-size | -1 | The maximum request body size to use | |
--http-read-buffer-size | -1 | The maximum size of HTTP header read buffer in kilobytes | |
--memory-limit | The memory limit to set for the sidecar. See valid values here | ||
--memory-request | The memory request to set for the sidecar | ||
--metrics-port | -1 | The port to expose the metrics on | |
--namespace, -n | The namespace the resource target is in (can only be set if --resource is also set) | ||
--readiness-probe-delay | -1 | The delay to use for the readiness probe in the sidecar. Read more here. | |
--readiness-probe-period | -1 | The period to use for the readiness probe in the sidecar. Read more here. | |
--readiness-probe-threshold | -1 | The threshold to use for the readiness probe in the sidecar. Read more here. | |
--readiness-probe-timeout | -1 | The timeout to use for the readiness probe in the sidecar. Read more here. | |
--resource, -r | The Kubernetes resource target to annotate | ||
--enable-api-logging | Enable API logging for the Dapr sidecar | ||
--unix-domain-socket-path | Linux domain socket path to use for communicating with the Dapr sidecar | ||
--volume-mounts | List of pod volumes to be mounted to the sidecar container in read-only mode | ||
--volume-mounts-rw | List of pod volumes to be mounted to the sidecar container in read-write mode | ||
--disable-builtin-k8s-secret-store | Disable the built-in Kubernetes secret store | ||
--placement-host-address | Comma separated list of addresses for Dapr actor placement servers |
Warning
If an application ID is not provided using--app-id, -a, an ID is generated using the format <namespace>-<kind>-<name>.Examples
# Annotate the first deployment found in the input
kubectl get deploy -l app=node -o yaml | dapr annotate -k - | kubectl apply -f -
# Annotate multiple deployments by name in a chain
kubectl get deploy -o yaml | dapr annotate -k -r nodeapp - | dapr annotate -k -r pythonapp - | kubectl apply -f -
# Annotate deployment in a specific namespace from file or directory by name
dapr annotate -k -r nodeapp -n namespace mydeploy.yaml | kubectl apply -f -
# Annotate deployment from url by name
dapr annotate -k -r nodeapp --log-level debug https://raw.githubusercontent.com/dapr/quickstarts/master/tutorials/hello-kubernetes/deploy/node.yaml | kubectl apply -f -
Feedback
Was this page helpful?
Glad to hear it! Please tell us how we can improve.
Sorry to hear that. Please tell us how we can improve.
Last modified May 17, 2023: Document new values for `app-protocol` and deprecation of `app-ssl` (9355e6ba)