Merge branch 'main' of github.com:coder/docs into spike/sql-prom-stats

spikecurtis · spikecurtis · commit a10b5927de66 · 2022-11-28T22:51:05.000Z
diff --git a/changelog/1.37.0.md b/changelog/1.37.0.md
@@ -0,0 +1,44 @@
+---
+title: "1.37.0"
+description: "Released on 11/23/2022"
+---
+
+### Breaking changes ❗
+
+- infra: Workspace statistics were previously stored in a table
+  `environment_stats`. This table is removed in this release. Downgrading from
+  this version to an older version may require manual steps.
+
+### Features ✨
+
+- infra: The database schema name used by Coder can now be changed by setting
+  the `DB_SEARCH_STRING` environment variable.
+- web: The list of organization workspaces is now paginated.
+- infra: The internal bridge network used by CVMs can now be configured under
+  the workspace provider settings page.
+
+### Bug fixes 🐛
+
+- infra: Fixed an issue where workspace builds would fail due to a missing
+  `podSecurityContext`.
+- infra: Fixed an issue where CVMs would not have the correct hostname set.
+- web: Fixed an issue where organizations were not sorted alphabetically in the
+  UI.
+- web: Improved error messaging when importing an image fails.
+- web: Fixed an issue where changing settings under **Admin** would not show up
+  correctly in audit logs.
+- infra: Fixed an issue where Coder services would incorrectly leave out client
+  TLS credentials when communicating with GitLab.
+- infra: Fixed a memory leak that occurs when attempting to update an image with
+  invalid stored credentials.
+- infra: Coder will now propagate its `http_proxy`, `https_proxy`, and
+  `no_proxy` environment variables when building workspaces. This fixes issues
+  when building CVM-enabled workspaces where the workspace image must be
+  accessed through a HTTP proxy.
+
+### Security updates 🔐
+
+- infra: Updates `code-server` to `4.8.3` which includes Visual Studio Code
+  version `1.72.1`. This mitigates `CVE-2022-36067`.
+- infra: Fixed an issue where ordinary users could obtain admin-level
+  credentials from the Coder API.
diff --git a/manifest.json b/manifest.json
@@ -1,5 +1,14 @@
 {
-  "versions": ["v1.36", "v1.35", "v1.34", "v1.33", "v1.32", "v1.31", "v1.30"],
+  "versions": [
+    "v1.37",
+    "v1.36",
+    "v1.35",
+    "v1.34",
+    "v1.33",
+    "v1.32",
+    "v1.31",
+    "v1.30"
+  ],
   "routes": [
     {
       "path": "./index.md",
@@ -590,6 +599,9 @@
       "path": "./changelog/index.md",
       "icon_path": "./assets/images/icons/paper.svg",
       "children": [
+        {
+          "path": "./changelog/1.37.0.md"
+        },
         {
           "path": "./changelog/1.36.0.md",
           "children": [
diff --git a/package.json b/package.json
@@ -39,6 +39,9 @@
     "*.md": [
       "markdownlint --config .markdownlint.jsonc --rules .markdownlint-rules --fix",
       "prettier --write"
+    ],
+    "manifest.json": [
+      "./scripts/validate-manifest.sh"
     ]
   },
   "dependencies": {
diff --git a/scripts/validate-manifest.sh b/scripts/validate-manifest.sh
@@ -0,0 +1,49 @@
+#!/usr/bin/env bash
+#
+# validate-manifest.sh [path/to/manifest.json]
+#
+# Dependencies: bash>=4.x jq tr sort uniq
+#
+# Description: Ensures consistency of versions specified in manifest.json.
+
+set -euo pipefail
+
+if [[ "${BASH_VERSINFO:-0}" -lt 4 ]]; then
+    echo "This script requires at least bash version 4."
+    exit 1
+fi
+
+if ! command -v jq > /dev/null; then
+    echo "This script requires jq to be available."
+    exit 1
+fi
+
+GIT_ROOT=$(cd "$(dirname "$0")" && git rev-parse --show-toplevel)
+MANIFEST_JSON_PATH=${1:-"${GIT_ROOT}/manifest.json"}
+
+declare -a MANIFEST_VERSIONS
+declare -a ROUTE_VERSIONS
+
+# Read the versions array in manifest.json
+readarray -t MANIFEST_VERSIONS < <(jq -r '
+    .versions[]
+    | capture("(?<v>[0-9]+\\.[0-9]+)")
+    | .v' < "${MANIFEST_JSON_PATH}")
+
+# Read all the child paths of changelog/index.md and extract major.minor version
+readarray -t ROUTE_VERSIONS < <(jq -r '
+    .routes[]
+    | select(.path == "./changelog/index.md")
+    | .children[]
+    | .path |
+    capture("(?<v>[0-9]+\\.[0-9]+)")
+    | .v' < "${MANIFEST_JSON_PATH}")
+
+# Compare the two
+DIFF=$(echo "${MANIFEST_VERSIONS[@]}" "${ROUTE_VERSIONS[@]}" | tr ' ' '\n' | sort | uniq -u)
+if [[ -n $DIFF ]]; then
+    echo "manifest.json: missing version for changelog(s): ${DIFF}"
+    exit 1
+fi
+
+exit 0
