website/docs: new upgrade page

[tanberry]

This PR adds a new Upgrade page.
Also:

• adds a link from the Rel Notes template to this Upgrade doc
• adds a Note in Upgrade docs and in Rel Note template about versions must match

I wanted to use a warning within a tab, and Docusaurus and MDX do allow this, but... the local build kept choking on it, so I gave up. Happy to get any advice there.

• The documentation has been updated
• The documentation has been formatted (make website)

[netlify]

✅ Deploy Preview for authentik-docs ready!

Name	Link
🔨 Latest commit	586c682
🔍 Latest deploy log	https://app.netlify.com/sites/authentik-docs/deploys/66b3e7ea2f090a00085d03fe
😎 Deploy Preview	https://deploy-preview-10742--authentik-docs.netlify.app
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.

---

To edit notification comments on pull requests, go to your Netlify site configuration.

[netlify]

✅ Deploy Preview for authentik-storybook canceled.

Name	Link
🔨 Latest commit	586c682
🔍 Latest deploy log	https://app.netlify.com/sites/authentik-storybook/deploys/66b3e7ea7ad9d90008505ca8

[authentik-automation]

Images automagically compressed by Calibre's image-actions ✨

Compression reduced images by 32.5%, saving 21.30 KB.

Filename	Before	After	Improvement	Visual comparison
website/docs/installation/version1.png	65.64 KB	44.34 KB	-32.5%	View diff

156 images did not require optimisation.

[codecov]

Codecov Report

All modified and coverable lines are covered by tests ✅

Project coverage is 92.62%. Comparing base (b9bf01f) to head (586c682).
Report is 55 commits behind head on main.

Additional details and impacted files

@@           Coverage Diff            @@
##             main   #10742    +/-   ##
========================================
  Coverage   92.62%   92.62%            
========================================
  Files         721      734    +13     
  Lines       35359    36039   +680     
========================================
+ Hits        32750    33381   +631     
- Misses       2609     2658    +49     

Flag	Coverage Δ
e2e	49.43% <ø> (-0.32%)	⬇️
integration	25.18% <ø> (-0.18%)	⬇️
unit	90.17% <ø> (+0.12%)	⬆️

Flags with carried forward coverage won't be shown. Click here to find out more.

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

[github-actions]

authentik PR Installation instructions

Instructions for docker-compose

Add the following block to your .env file:

AUTHENTIK_IMAGE=ghcr.io/goauthentik/dev-server
AUTHENTIK_TAG=gh-586c6828429a8a8b939f1af41d8604fe3bc7b667
AUTHENTIK_OUTPOSTS__CONTAINER_IMAGE_BASE=ghcr.io/goauthentik/dev-%(type)s:gh-%(build_hash)s

For arm64, use these values:

AUTHENTIK_IMAGE=ghcr.io/goauthentik/dev-server
AUTHENTIK_TAG=gh-586c6828429a8a8b939f1af41d8604fe3bc7b667-arm64
AUTHENTIK_OUTPOSTS__CONTAINER_IMAGE_BASE=ghcr.io/goauthentik/dev-%(type)s:gh-%(build_hash)s

Afterwards, run the upgrade commands from the latest release notes.

Instructions for Kubernetes

Add the following block to your values.yml file:

authentik:
    outposts:
        container_image_base: ghcr.io/goauthentik/dev-%(type)s:gh-%(build_hash)s
global:
    image:
        repository: ghcr.io/goauthentik/dev-server
        tag: gh-586c6828429a8a8b939f1af41d8604fe3bc7b667

For arm64, use these values:

authentik:
    outposts:
        container_image_base: ghcr.io/goauthentik/dev-%(type)s:gh-%(build_hash)s
global:
    image:
        repository: ghcr.io/goauthentik/dev-server
        tag: gh-586c6828429a8a8b939f1af41d8604fe3bc7b667-arm64

Afterwards, run the upgrade commands from the latest release notes.

[4d62]

little comments to your wip

[kensternberg-authentik]

This looks correct. But it's currently not working for me, and I think it's about the system, not the documentation.

[4d62]

why not use curl for both

[4d62]

github is forcing me to add a comment