chore: expand upgrade instructions for 1.21 (#523)

Katie Horne · web-flow · commit 03f143c00a29 · 2021-08-10T16:57:34.000-05:00
diff --git a/setup/updating.md b/setup/updating.md
@@ -40,7 +40,49 @@ This guide will show you how to update your Coder deployment.
 
 ## Update Coder
 
-To update Coder, follow these steps:
+1. Retrieve the latest repository information:
+
+   ```console
+   helm repo update
+   ```
+
+1. Export your current Helm chart values into a file:
+
+   ```console
+   helm get values --namespace coder coder > current-values.yaml
+   ```
+
+   > Make sure that your values only contain the changes you want (e.g., if you
+   > see references to a prior version, you may need to remove these).
+
+1. Provide your Helm chart values file and upgrade to the desired version (e.g.,
+   1.21.0):
+
+   _Note: If you omit `--version`, you'll upgrade to the latest version._
+
+   ```console
+   helm upgrade --namespace coder --install --atomic --wait \
+     --version <version> coder coder/coder --values current-values.yaml
+   ```
+
+1. Set Helm value `coderd.serviceNext=true` in your Helm chart. To do so, open
+   up `current-values.yaml` and add the following:
+
+   ```yaml
+   coderd:
+     serviceNext: true
+   ```
+
+1. Update Coder with your new Helm chart:
+
+   ```console
+   helm upgrade coder coder/coder -n coder --version=<VERSION> --values current-values.yaml
+   ```
+
+### Updating Coder when using a custom ingress controller
+
+If you're using a custom ingress controller, the upgrade process from 1.20 to
+1.21 requires a few more steps:
 
 1. Retrieve the latest repository information:
 
@@ -58,15 +100,59 @@ To update Coder, follow these steps:
    > see references to a prior version, you may need to remove these).
 
 1. Provide your Helm chart values file and upgrade to the desired version (e.g.,
-   1.16.1):
+   1.21.0):
 
    _Note: If you omit `--version`, you'll upgrade to the latest version._
 
    ```console
    helm upgrade --namespace coder --install --atomic --wait \
-     --version 1.16.1 coder coder/coder --values current-values.yaml
+     --version <version> coder coder/coder --values current-values.yaml
+
    ```
 
+1. [Update your Helm chart](../guides/admin/helm-charts.md) via the steps below.
+   Refer to the `1.21`
+   [helm chart](https://github.com/cdr/enterprise-helm/blob/main/values.yaml)
+   when making such changes:
+
+   Rename all instances of `cemanager` to `coderd`.
+
+   Redirect all traffic from your custom ingress to `coderd`.
+
+   `coderd` now serves TLS certificates; to upgrade the NGINX ingress
+   controller, set `coderd.serviceNext` to `true`. (See our
+   [TLS certificates](../guides/tls-certificates/index.md) for more information
+   on how to configure Coder to issue and use certificates.)
+
+   > To manage SSH, go to **Manage** > **Providers**. Select the provider you
+   > want to modify, click the **vertical ellipses** to its right, and click
+   > **Edit**. Under **Features**, you can toggle **External Connect** on/off.
+   >
+   > To manage the Access URL, go to **Manage** > **Admin** >
+   > **Infrastructure**.
+
+1. Redirect traffic by updating the following ports:
+
+   Move TCP port `8080` to `80`.
+
+   Move TCP port `8443` to `443`.
+
+1. Update Coder with your new Helm chart values:
+
+   ```console
+   helm upgrade coder coder/coder -n coder --version=<VERSION> --values current-values.yaml
+   ```
+
+1. Upgrade workspaces to use Coder's new Networking v2 functionality.
+
+   If you're using only the built-in provider and don't have additional
+   workspace providers, go to Manage > Providers. Find your provider, click the
+   **vertical ellipses** to its right, and click **Edit**. Toggle **Networking
+   v2** to enable.
+
+   Alternatively, if your workspaces are distributed, migrate the providers to
+   [satellites](../admin/satellites/index.md).
+
 ## Fixing a failed upgrade
 
 While upgrading, the process may fail. You'll see an error message similar to
