docs icon indicating copy to clipboard operation
docs copied to clipboard

Add deployment and upgrade guidelines for self-hosted mode

Open yaron2 opened this issue 5 years ago • 3 comments

When running Dapr in a self-hosted environment such as IoT Edge, it's beneficial for users to know how to install and upgrade the following system components:

  1. Sentry for mTLS
  2. Placement service for actors

Install and upgrade instructions are needed for the following two modes of distribution:

  1. Process
  2. Container

It's important to remember that things like high availability and zero downtime upgrades are concerns of the hosting platform, and as such, general instead of specific guidelines need be given. (eg. to achieve high availability for Sentry, your should run 3 instances of the process/container behind a load balancer).

yaron2 avatar Aug 20 '20 21:08 yaron2

Current doc is to uninstall and reinstall: https://v1-rc2.docs.dapr.io/operations/hosting/self-hosted/self-hosted-upgrade/

Needs to be updated for zero downtime

AaronCrawfis avatar Dec 17 '20 00:12 AaronCrawfis

Current page is here: https://docs.dapr.io/operations/hosting/self-hosted/self-hosted-upgrade/, which still directs to do a full uninstall and reinstall. Need to write docs on zero-downtime upgrades (if possible)

AaronCrawfis avatar Apr 14 '21 22:04 AaronCrawfis

@yaron2 - I feel like this information is already covered (albeit implicitly) in the self-hosted-with-docker page. Do you think we need to be more specific/explicit about installing and upgrading the Sentry and Placement Service components?

(it also looks like relevant docker images are provided per component/binary to allow users to selectively install the needed components)

(for reference too, here is some documentation we have on high availability mode in Kubernetes

willtsai avatar Sep 03 '21 19:09 willtsai