From 22f591bc834d87464ff3386c99a10c623854d778 Mon Sep 17 00:00:00 2001
From: Jamie Zieziula <jamie.m.dick@gmail.com>
Date: Mon, 23 Oct 2023 12:17:47 -0400
Subject: [PATCH] multi-worker docs

---
 charts/prefect-worker/README.md        | 19 +++++++++++++++++++
 charts/prefect-worker/README.md.gotmpl | 19 +++++++++++++++++++
 2 files changed, 38 insertions(+)

diff --git a/charts/prefect-worker/README.md b/charts/prefect-worker/README.md
index c74d5cd7..529332cc 100644
--- a/charts/prefect-worker/README.md
+++ b/charts/prefect-worker/README.md
@@ -171,6 +171,25 @@ Workers each have a type corresponding to the execution environment to which the
 
     You should see the Prefect worker pod running
 
+## FAQ
+
+### Deploying multiple workers to a single namespace
+
+If you want to run more than one worker in a single Kubernetes namespace, you will need to specify the `fullnameOveride` parameter at install time of one of the workers.
+
+```yaml
+fullnameOverride: prefect-worker-2
+```
+
+If you want the workers to share a service account, add the following to your `values.yaml`:
+
+```yaml
+fullnameOverride: prefect-worker-2
+serviceAccount:
+  create: false
+  name: "prefect-worker"
+```
+
 ## Maintainers
 
 | Name | Email | Url |
diff --git a/charts/prefect-worker/README.md.gotmpl b/charts/prefect-worker/README.md.gotmpl
index df55e69a..884cce86 100644
--- a/charts/prefect-worker/README.md.gotmpl
+++ b/charts/prefect-worker/README.md.gotmpl
@@ -171,6 +171,25 @@ Workers each have a type corresponding to the execution environment to which the
 
     You should see the Prefect worker pod running
 
+## FAQ
+
+### Deploying multiple workers to a single namespace
+
+If you want to run more than one worker in a single Kubernetes namespace, you will need to specify the `fullnameOveride` parameter at install time of one of the workers.
+
+```yaml
+fullnameOverride: prefect-worker-2
+```
+
+If you want the workers to share a service account, add the following to your `values.yaml`:
+
+```yaml
+fullnameOverride: prefect-worker-2
+serviceAccount:
+  create: false
+  name: "prefect-worker"
+```
+
 {{ template "chart.maintainersSection" . }}
 
 {{ template "chart.requirementsSection" . }}