type | title | linkTitle | weight | description |
---|---|---|---|---|
docs |
Overview of Dapr on Kubernetes |
Overview |
10000 |
Overview of how to get Dapr running on your Kubernetes cluster |
Dapr can be configured to run on any supported versions of Kubernetes. To achieve this, Dapr begins by deploying the dapr-sidecar-injector
, dapr-operator
, dapr-placement
, and dapr-sentry
Kubernetes services. These provide first-class integration to make running applications with Dapr easy.
- dapr-operator: Manages [component]({{< ref components >}}) updates and Kubernetes services endpoints for Dapr (state stores, pub/subs, etc.)
- dapr-sidecar-injector: Injects Dapr into annotated deployment pods and adds the environment variables
DAPR_HTTP_PORT
andDAPR_GRPC_PORT
to enable user-defined applications to easily communicate with Dapr without hard-coding Dapr port values. - dapr-placement: Used for [actors]({{< ref actors >}}) only. Creates mapping tables that map actor instances to pods
- dapr-sentry: Manages mTLS between services and acts as a certificate authority. For more information read the [security overview]({{< ref "security-concept.md" >}}).
Read [this guide]({{< ref kubernetes-deploy.md >}}) to learn how to deploy Dapr to your Kubernetes cluster.
Deploying and running a Dapr enabled application into your Kubernetes cluster is as simple as adding a few annotations to the deployment schemes. To give your service an id
and port
known to Dapr, turn on tracing through configuration and launch the Dapr sidecar container, you annotate your Kubernetes deployment like this. For more information check [dapr annotations]({{< ref kubernetes-annotations.md >}})
annotations:
dapr.io/enabled: "true"
dapr.io/app-id: "nodeapp"
dapr.io/app-port: "3000"
dapr.io/config: "tracing"
You can see some examples here in the Kubernetes getting started quickstart.
Dapr is tested and supported on the following versions of Kubernetes.
Supported Kubernetes versions |
---|
1.17.x and above |
- [Deploy Dapr to a Kubernetes cluster]({{< ref kubernetes-deploy >}})
- [Upgrade Dapr on a Kubernetes cluster]({{< ref kubernetes-upgrade >}})
- [Production guidelines for Dapr on Kubernetes]({{< ref kubernetes-production.md >}})
- Dapr Kubernetes Quickstart