From 95132082e12ee870c5fc777511102c9b5a2c498a Mon Sep 17 00:00:00 2001 From: Marc 'risson' Schmitt Date: Mon, 18 Dec 2023 11:02:08 +0100 Subject: [PATCH] website/docs: add operations category Signed-off-by: Marc 'risson' Schmitt --- .../air-gapped.md | 0 .../automated-install.md | 0 .../dashboard.png | Bin .../monitoring.md | 0 .../postgres_upgrade_kubernetes.md} | 4 ++++ website/docs/releases/2023/v2023.8.md | 4 ++-- website/netlify.toml | 22 ++++++++++++++++++ website/sidebars.js | 19 ++++++++------- 8 files changed, 39 insertions(+), 10 deletions(-) rename website/docs/{installation => operations}/air-gapped.md (100%) rename website/docs/{installation => operations}/automated-install.md (100%) rename website/docs/{installation => operations}/dashboard.png (100%) rename website/docs/{installation => operations}/monitoring.md (100%) rename website/docs/{troubleshooting/postgres/upgrade_kubernetes.md => operations/postgres_upgrade_kubernetes.md} (96%) diff --git a/website/docs/installation/air-gapped.md b/website/docs/operations/air-gapped.md similarity index 100% rename from website/docs/installation/air-gapped.md rename to website/docs/operations/air-gapped.md diff --git a/website/docs/installation/automated-install.md b/website/docs/operations/automated-install.md similarity index 100% rename from website/docs/installation/automated-install.md rename to website/docs/operations/automated-install.md diff --git a/website/docs/installation/dashboard.png b/website/docs/operations/dashboard.png similarity index 100% rename from website/docs/installation/dashboard.png rename to website/docs/operations/dashboard.png diff --git a/website/docs/installation/monitoring.md b/website/docs/operations/monitoring.md similarity index 100% rename from website/docs/installation/monitoring.md rename to website/docs/operations/monitoring.md diff --git a/website/docs/troubleshooting/postgres/upgrade_kubernetes.md b/website/docs/operations/postgres_upgrade_kubernetes.md similarity index 96% rename from website/docs/troubleshooting/postgres/upgrade_kubernetes.md rename to website/docs/operations/postgres_upgrade_kubernetes.md index 5aac94235..70041c240 100644 --- a/website/docs/troubleshooting/postgres/upgrade_kubernetes.md +++ b/website/docs/operations/postgres_upgrade_kubernetes.md @@ -2,6 +2,10 @@ title: Upgrade PostgreSQL on Kubernetes --- +::::note +The following instructions are for upgrading from PostgreSQL major version 11 to 15. Adapt as needed. +:::: + ## Preparation - `authentik-postgresql-0` is the Kubernetes Pod running PostgreSQL. diff --git a/website/docs/releases/2023/v2023.8.md b/website/docs/releases/2023/v2023.8.md index 476a03caa..f0d2e659e 100644 --- a/website/docs/releases/2023/v2023.8.md +++ b/website/docs/releases/2023/v2023.8.md @@ -11,7 +11,7 @@ slug: "/releases/2023.8" This does not affect docker-compose installations (as these already ship with PostgreSQL 12), however it is still recommended to upgrade to a newer version when convenient. - For Kubernetes install, a manual one-time migration has to be done: [Upgrading PostgreSQL on Kubernetes](../../troubleshooting/postgres/upgrade_kubernetes.md) + For Kubernetes install, a manual one-time migration has to be done: [Upgrading PostgreSQL on Kubernetes](../../operations/postgres_upgrade_kubernetes.md) - Changed nested Group membership behaviour @@ -33,7 +33,7 @@ slug: "/releases/2023.8" ## Upgrading -This release changes the PostgreSQL dependency to require Version 12 or later, which only affects Kubernetes installs. See [here](../../troubleshooting/postgres/upgrade_kubernetes.md) for more info on upgrading. +This release changes the PostgreSQL dependency to require Version 12 or later, which only affects Kubernetes installs. See [here](../../operations/postgres_upgrade_kubernetes.md) for more info on upgrading. ### docker-compose diff --git a/website/netlify.toml b/website/netlify.toml index bf3fd1a38..31c632847 100644 --- a/website/netlify.toml +++ b/website/netlify.toml @@ -29,6 +29,28 @@ status = 301 force = true +# URL retro-compatibility +[[redirects]] + from = "/docs/installation/air-gapped" + to = "/docs/operations/air-gapped" + status = 301 + force = true +[[redirects]] + from = "/docs/installation/automated-install" + to = "/docs/operations/automated-install" + status = 301 + force = true +[[redirects]] + from = "/docs/installation/monitoring" + to = "/docs/operations/monitoring" + status = 301 + force = true +[[redirects]] + from = "/docs/troubleshooting/postgres/upgrade_kubernetes" + to = "/docs/operations/postgres_upgrade_kubernetes" + status = 301 + force = true + # Container registry [[redirects]] from = "/v2" diff --git a/website/sidebars.js b/website/sidebars.js index fe1b6725e..60553df21 100644 --- a/website/sidebars.js +++ b/website/sidebars.js @@ -24,9 +24,17 @@ const docsSidebar = { "installation/beta", "installation/configuration", "installation/reverse-proxy", - "installation/automated-install", - "installation/air-gapped", - "installation/monitoring", + ], + }, + { + type: "category", + label: "Operations", + collapsed: true, + items: [ + "operations/automated-install", + "operations/air-gapped", + "operations/monitoring", + "operations/postgres_upgrade_kubernetes", ], }, { @@ -382,11 +390,6 @@ const docsSidebar = { "Steps to help debug forward auth setups with various reverse proxies.", }, }, - { - type: "category", - label: "PostgreSQL", - items: ["troubleshooting/postgres/upgrade_kubernetes"], - }, "troubleshooting/access", "troubleshooting/login", "troubleshooting/image_upload",