docs icon indicating copy to clipboard operation
docs copied to clipboard

Update the Kubernetes Hosting documentation

Open msfussell opened this issue 4 years ago • 2 comments

The Kubernetes hosting documentation needs a review. Things that need to be addressed for example

  • [x] Determine which is preferred: Dapr CLI or Helm: Across the all topics under hosting/kubernetes - There is conflicting advice between installing/upgrading production clusters with Helm or CLI. We should be clear on what is preferred for production
  • [x] https://docs.dapr.io/operations/hosting/kubernetes/kubernetes-production/#tracing-and-metrics-configuration section is very sparse and does not provide guidance
  • [ ] Also include this issue Updating K8s guidance to include app rollout step for when a cluster is completely restarted #1072
  • [ ] The K8s overview topic and the control plane https://docs.dapr.io/operations/hosting/kubernetes/kubernetes-overview/ need improved wording on how they work and there are broken links in this topic
  • [ ] Ideally there should be a script for installing Dapr with production guidance, similar to this https://github.com/mchmarny/dapr-demos/tree/master/setup

msfussell avatar Feb 05 '21 20:02 msfussell

kubernetes-deploy/#install-in-highly-available-mode - This sentence is wrong. Placement is now HA "You can run Dapr with 3 replicas of each control plane pod with the exception of the Placement pod in the dapr-system namespace for production scenarios."

This is fixed with https://github.com/dapr/docs/pull/1220

kubernetes-production/ topic

Does not mention HA mode as being preferred for production.

This is mentioned here: https://v1-rc3.docs.dapr.io/operations/hosting/kubernetes/kubernetes-production/#cluster-capacity-requirements

Also include this issue Updating K8s guidance to include app rollout step for when a cluster is completely restarted #1072

This is mentioned as the last step here: https://v1-rc3.docs.dapr.io/operations/hosting/kubernetes/kubernetes-upgrade/

yaron2 avatar Feb 15 '21 19:02 yaron2

Also see https://github.com/dapr/docs/issues/1506

msfussell avatar May 22 '21 19:05 msfussell

This issues is now complete. It is too opinionated to have a one size fits all for the production guidance.

msfussell avatar Aug 22 '23 05:08 msfussell