我的书签
添加书签
移除书签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 inputkubectl get deploy -l app=node -o yaml | dapr annotate -k - | kubectl apply -f -# Annotate multiple deployments by name in a chainkubectl 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 namedapr annotate -k -r nodeapp -n namespace mydeploy.yaml | kubectl apply -f -# Annotate deployment from url by namedapr annotate -k -r nodeapp --log-level debug https://raw.githubusercontent.com/dapr/quickstarts/master/tutorials/hello-kubernetes/deploy/node.yaml | kubectl apply -f -
Last modified October 11, 2024: Fixed typo (#4389) (fe17926)
