chore: remove stable release tag (#8885)

# Which Problems Are Solved

The current "stable" release tag was no longer maintained.

# How the Problems Are Solved

Remove the tag from the docs.

# Additional Changes

Update the docs to reflect that test run with Ubuntu 22.04 instead of
20.04.

# Additional Context

- relates to https://github.com/zitadel/zitadel/issues/8884

.github/workflows/release-channels.yml

@@ -1,47 +0,0 @@
-name: ZITADEL Release tags
-
-on:
-  push:
-    branches:
-      - "main"
-    paths:
-      - 'release-channels.yaml'
-  workflow_dispatch:
-
-permissions:
-  contents: write
-  packages: write
-
-jobs:
-  Build:
-    runs-on: ubuntu-20.04
-    env:
-      DOCKER_BUILDKIT: 1
-    steps:
-      - name: Source checkout
-        uses: actions/checkout@v4
-        with:
-          fetch-depth: 0
-      - name: get stable tag
-        run: echo STABLE_RELEASE=$(yq eval '.stable' release-channels.yaml) >> $GITHUB_ENV
-      - name: checkout stable tag
-        uses: actions/checkout@v4
-        with:
-          fetch-depth: 0
-          ref: ${{ env.STABLE_RELEASE }}
-      - name: GitHub Container Registry Login
-        uses: docker/login-action@v3
-        with:
-          registry: ghcr.io
-          username: ${{ github.actor }}
-          password: ${{ secrets.GITHUB_TOKEN }}
-      - name: Google Artifact Registry Login
-        uses: docker/login-action@v3
-        with:
-          registry: europe-docker.pkg.dev
-          username: _json_key_base64
-          password: ${{ secrets.GCR_JSON_KEY_BASE64 }}
-      - name: copy release to stable
-        run: |    
-          skopeo --version
-          skopeo copy --all  docker://ghcr.io/zitadel/zitadel:$STABLE_RELEASE docker://ghcr.io/zitadel/zitadel:stable

README.md

@@ -13,8 +13,6 @@
         <img alt="GitHub Workflow Status (with event)" src="https://img.shields.io/github/actions/workflow/status/zitadel/zitadel/build.yml?event=pull_request"></a>
     <a href="https://zitadel.com/docs/support/software-release-cycles-support" alt="Release">
         <img src="https://badgen.net/github/release/zitadel/zitadel/stable" /></a>
-    <a href="https://github.com/zitadel/zitadel/releases" alt="Release">
-        <img alt="Dynamic YAML Badge" src="https://img.shields.io/badge/dynamic/yaml?url=https%3A%2F%2Fraw.githubusercontent.com%2Fzitadel%2Fzitadel%2Fmain%2Frelease-channels.yaml&query=%24.stable&label=stable"></a>
     <a href="https://goreportcard.com/report/github.com/zitadel/zitadel" alt="Go Report Card">
         <img src="https://goreportcard.com/badge/github.com/zitadel/zitadel" /></a>
     <a href="https://codecov.io/gh/zitadel/zitadel" alt="Code Coverage">

docs/docs/self-hosting/deploy/knative.mdx

@@ -27,7 +27,7 @@ kubectl apply -f https://raw.githubusercontent.com/zitadel/zitadel/main/deploy/k
 
 ```bash
 kn service create zitadel \
---image ghcr.io/zitadel/zitadel:stable \
+--image ghcr.io/zitadel/zitadel:latest \
 --port 8080 \
 --env ZITADEL_DATABASE_COCKROACH_HOST=cockroachdb \
 --env ZITADEL_EXTERNALSECURE=false \

docs/docs/self-hosting/deploy/linux.mdx

@@ -11,7 +11,7 @@ import NoteInstanceNotFound from "./troubleshooting/_note_instance_not_found.mdx
 ## Install PostgreSQL
 
 Download a `postgresql` binary as described [in the PostgreSQL docs](https://www.postgresql.org/download/linux/).
-ZITADEL is tested against PostgreSQL and CockroachDB latest stable tag and Ubuntu 20.04.
+ZITADEL is tested against PostgreSQL and CockroachDB latest stable tag and Ubuntu 22.04.
 
 ## Run PostgreSQL
 

docs/docs/self-hosting/deploy/loadbalancing-example/docker-compose.yaml

@@ -15,7 +15,7 @@ services:
     restart: 'always'
     networks:
       - 'zitadel'
-    image: 'ghcr.io/zitadel/zitadel:stable'
+    image: 'ghcr.io/zitadel/zitadel:latest'
     command: 'start-from-init --config /example-zitadel-config.yaml --config /example-zitadel-secrets.yaml --steps /example-zitadel-init-steps.yaml --masterkey "${ZITADEL_MASTERKEY}" --tlsMode external'
     depends_on:
       db:

docs/docs/self-hosting/deploy/macos.mdx

@@ -11,7 +11,7 @@ import NoteInstanceNotFound from './troubleshooting/_note_instance_not_found.mdx
 ## Install PostgreSQL
 
 Download a `postgresql` binary as described [in the PostgreSQL docs](https://www.postgresql.org/download/macosx/).
-ZITADEL is tested against PostgreSQL and CockroachDB latest stable tag and Ubuntu 20.04.
+ZITADEL is tested against PostgreSQL and CockroachDB latest stable tag and Ubuntu 22.04.
 
 ## Run PostgreSQL
 

docs/docs/self-hosting/manage/configure/docker-compose.yaml

@@ -5,7 +5,7 @@ services:
     restart: "always"
     networks:
       - "zitadel"
-    image: "ghcr.io/zitadel/zitadel:stable"
+    image: "ghcr.io/zitadel/zitadel:latest"
     command: 'start-from-init --config /example-zitadel-config.yaml --config /example-zitadel-secrets.yaml --steps /example-zitadel-init-steps.yaml --masterkey "${ZITADEL_MASTERKEY}" --tlsMode disabled'
     ports:
       - "8080:8080"

docs/docs/support/advisory/a10013.md

@@ -0,0 +1,25 @@
+---
+title: Technical Advisory 10013
+---
+
+## Date
+
+Date: 2024-12-09
+
+## Description
+
+ZITADEL currently provides a "latest" and "stable" release tags as well as maintenance branches, where bug fixes are backported.
+We also publish release candidates regularly.
+
+The "stable" release channel was introduced for users seeking a more reliable and production-ready version of the software.
+However, most customers have their own deployment policies and cycles. 
+Backports and security fixes are currently done as needed or required by customers. 
+zitadel.cloud follows a similar approach, where the latest release is deployed a few days after its creation.
+
+## Mitigation
+
+If you used the "stable" Docker release, please consider switching to a specific version tag and follow the [release notes on GitHub](https://github.com/zitadel/zitadel/releases) for latest changes.
+
+## Impact
+
+The "stable" version will no longer be published or updated, and the corresponding Docker image tag will not be maintained anymore.

docs/docs/support/software-release-cycles-support.md

@@ -82,7 +82,7 @@ Features in General Availability are not marked explicitly.
 
 All release channels receive regular updates and bug fixes.
 However, the timing and frequency of updates may differ between the channels.
-The choice between the "release candidate", "latest" and "stable" release channels depends on the specific requirements, preferences, and risk tolerance of the users.
+The choice between the "release candidate", "latest" and stable release channels depends on the specific requirements, preferences, and risk tolerance of the users.
 
 [List of all releases](https://github.com/zitadel/zitadel/releases)
 
@@ -100,19 +100,6 @@ The "latest" release channel is designed for users who prefer to access the most
 It provides early access to new functionalities and improvements but may involve a higher degree of risk as it is the most actively developed version.
 Users opting for the latest release channel should be aware that occasional bugs or issues may arise due to the ongoing development process.
 
-### Stable
-
-The "stable" release channel is intended for users seeking a more reliable and production-ready version of the software.
-It offers a well-tested and validated release with fewer known issues and a higher level of stability.
-The stable release channel undergoes rigorous quality assurance and testing processes to ensure that it meets the highest standards of reliability and performance.
-It is recommended for users who prioritize stability over immediate access to the latest features.
-
-Current Stable Version:
-
-```yaml reference
-https://github.com/zitadel/zitadel/blob/main/release-channels.yaml
-```
-
 ## Maintenance
 
 ZITADEL Cloud follows a regular deployment cycle to ensure our product remains up-to-date, secure, and provides new features.

docs/docs/support/technical_advisory.mdx

@@ -190,6 +190,30 @@ We understand that these advisories may include breaking changes, and we aim to
     <td>2.59.0</td>
     <td>2024-08-19</td>
   </tr>
+  <tr>
+    <td>
+      <a href="./advisory/a10012">A-10012</a>
+    </td>
+    <td>Tncreased transaction duration for projections</td>
+    <td>Breaking Behavior Change</td>
+    <td>
+        In version 2.63.0 we've increased the transaction duration for projections to resolve outdated projections or dead-locks.
+    </td>
+    <td>2.63.0</td>
+    <td>2024-09-26</td>
+  </tr>
+  <tr>
+    <td>
+      <a href="./advisory/a10013">A-10013</a>
+    </td>
+    <td>Deprecation of "stable" version</td>
+    <td>Breaking Behavior Change</td>
+    <td>
+      The "stable" version will no longer be published or updated, and the corresponding Docker image tag will not be maintained anymore.
+    </td>
+    <td>-</td>
+    <td>2024-12-09</td>
+  </tr>
 </table>
 
 ## Subscribe to our Mailing List

release-channels.yaml

@@ -1 +0,0 @@
-stable: "v2.54.8"