Release 1.31.0 (#995)

Katie Horne · web-flow · commit 12f90f7c37be · 2022-05-25T15:21:54.000-05:00
* chore: add changelog template

* remove alpha flags

* chore: update Docker versions

* chore: update K8s chart

* chore: add changelog

* chore: update versions array
diff --git a/admin/registries/azure.md b/admin/registries/azure.md
@@ -39,7 +39,7 @@ username and password and proceed to **step 2** of this guide.
 
 > This is currently an **alpha** feature. To use this feature, enable the
 > feature flag under
-> `Manage > Admin > Infrastructure > Azure Registry Authentication`.
+> `Manage > Admin > Infrastructure > Azure Container Registry authentication`.
 
 AAD Pod Identity allows you to assign an AAD identity to pods in your Azure
 Kubernetes (AKS) cluster. You can assign Coder an AAD identity with pull access
diff --git a/admin/workspace-management/cvms/management.md b/admin/workspace-management/cvms/management.md
@@ -26,14 +26,12 @@ built as a CVM or not.
 If you would like all newly created workspaces to be CVMs, toggle **Default to
 container-based virtual machines** to **On**.
 
-> While this toggle changes the default workspace creation setting, users can still
-> override this setting. For example, if you enable CVMS and set them as the
-> default, a user can still create non-CVM workspaces (and vice versa).
+> While this toggle changes the default workspace creation setting, users can
+> still override this setting. For example, if you enable CVMS and set them as
+> the default, a user can still create non-CVM workspaces (and vice versa).
 
 ## Caching
 
-> Cached CVMs are currently an **alpha** feature.
-
 To improve the startup time for CVM-based workspaces, you can enable caching.
 
 Cached CVMs require the `shiftfs` kernel to be present on the node. Some
@@ -50,8 +48,6 @@ install `shiftfs` on your behalf.**
 
 ## Self-contained workspace builds
 
-> Self-contained workspace builds are currently an **alpha** feature.
-
 By default, Coder initializes workspaces by running commands inside the
 container. Workspaces, however, control the initialization sequence instead when
 you enable [self-contained workspace builds]. This enables cluster operations
@@ -62,17 +58,13 @@ as the `kubectl exec` command.
 
 ## Workspace process logging
 
-> Workspace process logging is currently an **alpha** feature.
-
 [Workspace process logging] enables auditing of commands executed inside the
 workspace container.
 
 [workspace process logging]: ../process-logging.md
 
 ## TUN device
 
-> TUN devices currently an **alpha** feature.
-
 Coder allows the creation of custom network interfaces using the Linux TUN
 device. When using the **Enable TUN device** setting, Coder workspaces will have
 a `/dev/net/tun` device mounted into the workspace at build time. VPN usage
@@ -95,8 +87,6 @@ any data outside the home volume is cleared when the workspace is rebuilt.
 
 ## FUSE device
 
-> FUSE devices are currently an **alpha** feature.
-
 Coder allows the creation of custom filesystems using the Linux FUSE userspace
 filesystem device. By enabling the **Enable FUSE device** setting, Coder
 workspaces will have a `/dev/fuse` device mounted into the workspace at build
diff --git a/changelog/1.31.0.md b/changelog/1.31.0.md
@@ -0,0 +1,52 @@
+---
+title: "1.31.0"
+description: "Released on 05/26/2022"
+---
+
+### Breaking changes ❗
+
+There are no breaking changes in 1.31.0.
+
+### Features ✨
+
+- web: moved the following features and settings from alpha/beta to general
+  availability; these features and settings are now available by default instead
+  of requiring users to toggle a feature flag:
+  - Autostart
+  - Workspace container runtime settings:
+    - Cached CVMs
+    - Auto-loading of the `shiftfs` kernel module
+    - Self-contained workspace builds
+    - Workspace process logging
+    - TUN devices
+
+### Bug fixes 🐛
+
+- web: fixed issue where audit logs were not written if a request context was
+  canceled.
+- web: fixed issue with dev URL endpoint to improve the way `coderd` retrieves
+  status information regarding dev URLs.
+- web: fixed issue where users cannot update user account details if the
+  dotfiles URI is blank.
+- infra: Coder tunnel no longer exits after a single connection.
+- infra: fixed issue where a lower MTU caused connections to break.
+- infra: fixed issue where `coderd` attempts to connect to workspaces that have
+  been deleted.
+- infra: added automatic reconnection if the web terminal disconnects.
+
+### Security updates 🔐
+
+There are no security updates in 1.31.0.
+
+### Known issues 🔧
+
+- web: the service banner (if enabled) reappears for all users, even if they've
+  previously dismissed it.
+- web: using the web terminal in Coder can occasionally result in the connection
+  being reset and needing to be restarted.
+- web: the **Switch workspace** drop-down menu shows a workspace's status as
+  **Building** even though the build process is completed.
+- web: users upgrading to v1.24 (or later) into an air-gapped environment cannot
+  upload their license when prompted.
+- web: by default, Coder workspace builds are self-contained; as such, images
+  that do _not_ contain `curl` will result in the workspace failing to build.
diff --git a/manifest.json b/manifest.json
@@ -1,5 +1,5 @@
 {
-  "versions": ["v1.30", "v1.29", "v1.28", "v1.27", "v1.26"],
+  "versions": ["v1.31", "v1.30", "v1.29", "v1.28", "v1.27", "v1.26"],
   "routes": [
     {
       "path": "./index.md",
@@ -561,6 +561,9 @@
     {
       "path": "./changelog/index.md",
       "children": [
+        {
+          "path": "./changelog/1.31.0.md"
+        },
         {
           "path": "./changelog/1.30.0.md",
           "children": [
diff --git a/setup/coder-for-docker/local.md b/setup/coder-for-docker/local.md
@@ -52,7 +52,7 @@ Coder for Docker works with the following platforms:
       -p 7080:7080 \
       -v /var/run/docker.sock:/var/run/docker.sock \
       -v ~/.coder:/var/run/coder \
-      codercom/coder:1.30.0
+      codercom/coder:1.31.0
    ```
 
    When this process is complete, Coder will print the URL you can use to access
@@ -103,7 +103,7 @@ DEVURL_HOST="*.mycompany.com"
 For example:
 
 ```console
-docker run --rm -it -p 7080:7080 -v /var/run/docker.sock:/var/run/docker.sock -v ~/.coder:/var/run/coder -e DEVURL_HOST="*.mycompany.com" codercom/coder:1.30.0
+docker run --rm -it -p 7080:7080 -v /var/run/docker.sock:/var/run/docker.sock -v ~/.coder:/var/run/coder -e DEVURL_HOST="*.mycompany.com" codercom/coder:1.31.0
 ```
 
 ## Use an external PostgreSQL database
@@ -140,7 +140,7 @@ To do so:
    version: "3.5"
    services:
    coder:
-     image: docker.io/codercom/coder:1.30.0
+     image: docker.io/codercom/coder:1.31.0
      container_name: coderd
      restart: unless-stopped
      ports:
diff --git a/setup/coder-for-docker/upgrade.md b/setup/coder-for-docker/upgrade.md
@@ -7,7 +7,7 @@ This guide will show you how to upgrade your Coder for Docker deployment.
 
 To upgrade, run the following command to download the resources you need,
 including the latest images (ensure that you're providing the correct version
-number in the command, e.g., `1.30.0`):
+number in the command, e.g., `1.31.0`):
 
 ```console
 docker run --rm -it \
@@ -27,7 +27,7 @@ If you use Docker Compose to run Coder, here's how to upgrade your deployment:
    # ...
    services:
    coder:
-     image: docker.io/codercom/coder:1.30.0
+     image: docker.io/codercom/coder:1.31.0
      # ...
    ```
 
diff --git a/setup/kubernetes/index.md b/setup/kubernetes/index.md
@@ -29,17 +29,14 @@ deprecated features before they are removed from new versions of Kubernetes.
 
 <!-- markdownlint-disable -->
 
-|              | Kubernetes `1.23` | Kubernetes `1.22` | Kubernetes `1.21` | Kubernetes `1.20` | Kubernetes `1.19` | Kubernetes `1.18` |
-| ------------ | ----------------- | ----------------- | ----------------- | ----------------- | ----------------- | ----------------- |
-| Coder `1.30` | ✅                | ✅                | ✅                |                   |                   |                   |
-| Coder `1.29` | ✅                | ✅                | ✅                |                   |                   |                   |
-| Coder `1.28` | ✅                | ✅                | ✅                |                   |                   |                   |
-| Coder `1.27` | ✅                | ✅                | ✅                |                   |                   |                   |
-| Coder `1.26` |                   | ✅                | ✅                | ✅                |                   |                   |
-| Coder `1.25` |                   | ✅                | ✅                | ✅                |                   |                   |
-| Coder `1.24` |                   |                   | ✅                | ✅                | ✅                |                   |
-| Coder `1.23` |                   |                   | ✅                | ✅                | ✅                |                   |
-| Coder `1.22` |                   |                   |                   | ✅                | ✅                | ✅                |
+|              | Kubernetes `1.24` | Kubernetes `1.23` | Kubernetes `1.22` | Kubernetes `1.21` | Kubernetes `1.20` | Kubernetes `1.19` | Kubernetes `1.18` |
+| ------------ | ----------------- | ----------------- | ----------------- | ----------------- | ----------------- | ----------------- | ----------------- |
+| Coder `1.31` | ✅                | ✅                | ✅                |                   |                   |                   |                   |
+| Coder `1.30` |                   | ✅                | ✅                | ✅                |                   |                   |                   |
+| Coder `1.29` |                   | ✅                | ✅                | ✅                |                   |                   |                   |
+| Coder `1.28` |                   | ✅                | ✅                | ✅                |                   |                   |                   |
+| Coder `1.27` |                   | ✅                | ✅                | ✅                |                   |                   |                   |
+| Coder `1.26` |                   |                   | ✅                | ✅                | ✅                |                   |                   |
 
 [compatible kubernetes cluster]: ../requirements.md
 [kubernetes upstream version support policy]:

Original file line number	Diff line number	Diff line change
`@@ -1,5 +1,5 @@`
`1`	`1`	`{`
`2`		`- "versions": ["v1.30", "v1.29", "v1.28", "v1.27", "v1.26"],`
	`2`	`+ "versions": ["v1.31", "v1.30", "v1.29", "v1.28", "v1.27", "v1.26"],`
`3`	`3`	`"routes": [`
`4`	`4`	`{`
`5`	`5`	`"path": "./index.md",`
`@@ -561,6 +561,9 @@`
`561`	`561`	`{`
`562`	`562`	`"path": "./changelog/index.md",`
`563`	`563`	`"children": [`
	`564`	`+ {`
	`565`	`+ "path": "./changelog/1.31.0.md"`
	`566`	`+ },`
`564`	`567`	`{`
`565`	`568`	`"path": "./changelog/1.30.0.md",`
`566`	`569`	`"children": [`