From 5f4363412a80271403bd4c4fb4fa5c7b17f56cff Mon Sep 17 00:00:00 2001 From: Joe Lodin Date: Thu, 26 Feb 2026 17:01:49 -0500 Subject: [PATCH] Rework releases landing page into an overview --- .../_includes/common/upgrade/overview.md | 2 +- .../_includes/releases/whats-new-intro.md | 2 +- .../_includes/sidebar-all-releases.json | 24 +- src/current/cockroachcloud/upgrade-policy.md | 3 +- src/current/releases/index.md | 668 ++---------------- .../restoring-backups-across-versions.md | 3 +- 6 files changed, 62 insertions(+), 640 deletions(-) diff --git a/src/current/_includes/common/upgrade/overview.md b/src/current/_includes/common/upgrade/overview.md index 96c5c422fe6..e1e848751c7 100644 --- a/src/current/_includes/common/upgrade/overview.md +++ b/src/current/_includes/common/upgrade/overview.md @@ -17,7 +17,7 @@ For all CockroachDB {{ site.data.products.cloud }} clusters, production patch releases for a major version are automatically applied until the cluster is upgraded to a new major version. On an {{ site.data.products.advanced }} cluster, you have the option to defer patch updates for 30, 60, or 90 days if you have a [maintenance window]({% link cockroachcloud/advanced-cluster-management.md %}#set-a-maintenance-window) configured. {% endif %} -To learn more about CockroachDB major versions and patches, refer to the [Releases Overview]({% link releases/index.md %}#overview). +To learn more about CockroachDB major versions and patches, refer to the [Releases Overview]({% link releases/index.md %}). {% if page.path contains "cockroachcloud" %} ### Upgrade differences across Cloud plans diff --git a/src/current/_includes/releases/whats-new-intro.md b/src/current/_includes/releases/whats-new-intro.md index 74355c546ea..f66273c0575 100644 --- a/src/current/_includes/releases/whats-new-intro.md +++ b/src/current/_includes/releases/whats-new-intro.md @@ -90,7 +90,7 @@ no_highlights: {{ no_highlights }}
CockroachDB {{ page.major_version }} is in active development, and the following [testing releases]({% link releases/index.md %}#release-types) are intended for testing and experimentation only, and are not qualified for production environments or eligible for support or uptime SLA commitments. When CockroachDB {{ page.major_version }} is Generally Available (GA), production releases will also be announced on this page. {% else %}{% comment %}Begin GA-only content{% endcomment %} {% if skippable == true %} -CockroachDB {{ page.major_version }} is an [Innovation Release]({% link releases/release-support-policy.md %}#support-types), which is optional for CockroachDB {{ site.data.products.advanced }}, CockroachDB {{ site.data.products.standard }}, and CockroachDB {{ site.data.products.core }} clusters but is required for CockroachDB {{ site.data.products.basic }}. +CockroachDB {{ page.major_version }} is an [Innovation Release]({% link releases/release-support-policy.md %}#support-types), which is optional for CockroachDB {{ site.data.products.advanced }} and {{ site.data.products.code }}. Innovation releases including {{ page.major_version }} are unavailable for CockroachDB {{ site.data.products.standard }} and CockroachDB {{ site.data.products.basic }} clusters. {% else %} CockroachDB {{ page.major_version }}{% if lts == true %} [(LTS)]({% link releases/release-support-policy.md %}#support-phases){% endif %} is a required [Regular Release]({% link releases/release-support-policy.md %}#support-types). {% endif %} diff --git a/src/current/_includes/sidebar-all-releases.json b/src/current/_includes/sidebar-all-releases.json index e7937bc8d53..b494554174b 100644 --- a/src/current/_includes/sidebar-all-releases.json +++ b/src/current/_includes/sidebar-all-releases.json @@ -1,27 +1,27 @@ {%- assign versions = site.data.versions | where_exp: "versions", "versions.major_version != site.versions['dev']" | where_exp: "versions", "versions.major_version != site.versions['stable']" | map: "major_version" -%} {%- comment -%} versions iterates through the list of major versions (e.g., v21.2) in _data/versions.csv and returns all releases that are not dev or stable. We then pull only the major version name instead of the whole dictionary with map: "major_version" {%- endcomment -%} { - "title": "Latest Production Release", + "title": "Overview", + "urls": [ + "/releases/index.html", + "/releases/" + {% for v in versions %} + ,"/releases/{{ v }}.html" + {% endfor %} + ] +}, +{ + "title": "Latest Production Release ({{ site.versions["stable"] }})", "urls": [ "/releases/{{ site.versions["stable"] }}.html" ] }{% unless site.versions["stable"] == site.versions["dev"] %}, { - "title": "Latest Testing Release", + "title": "Latest Testing Release ({{ site.versions["dev"] }})", "urls": [ "/releases/{{ site.versions["dev"] }}.html" ] }{% endunless %}, -{ - "title": "CockroachDB Releases", - "urls": [ - "/releases/index.html", - "/releases/" - {% for v in versions %} - ,"/releases/{{ v }}.html" - {% endfor %} - ] -}, { "title": "Staged Release Process", "urls": [ diff --git a/src/current/cockroachcloud/upgrade-policy.md b/src/current/cockroachcloud/upgrade-policy.md index ba30c4ebcaf..385386ac439 100644 --- a/src/current/cockroachcloud/upgrade-policy.md +++ b/src/current/cockroachcloud/upgrade-policy.md @@ -51,8 +51,8 @@ The following table describes currently-supported versions on {{ site.data.produ Version | Release Type | Release date | End-of-support (EOS) date :------:|:------------:|:------------:|:---------: +v26.1 | Innovation | 2026-02-02 | 2026-08-02 v25.4 | Regular | 2025-11-03 | 2026-11-03 -v25.3 | Innovation | 2025-08-04 | 2026-02-04 v25.2 | Regular | 2025-05-09 | 2026-05-12 v24.3 | Regular | 2024-11-18 | 2026-05-05 @@ -75,6 +75,7 @@ The following table describes versions that have reached their EOS dates on {{ s Version | Release Type | Release date | End-of-support (EOS) date :------:|:------------:|:------------:|:--------: +v25.3 | Innovation | 2025-08-04 | 2026-02-04 v25.1 | Innovation | 2025-02-18 | 2025-08-18 v24.1 | Regular | 2024-05-20 | 2025-05-20 v24.2 | Innovation | 2024-08-12 | 2025-02-12 diff --git a/src/current/releases/index.md b/src/current/releases/index.md index 66d8d230024..70876f7ef49 100644 --- a/src/current/releases/index.md +++ b/src/current/releases/index.md @@ -1,5 +1,5 @@ --- -title: CockroachDB Releases +title: CockroachDB Releases Overview summary: Information about CockroachDB releases with an index of available releases and their release notes and binaries. toc: true # toc_not_nested: true @@ -18,51 +18,32 @@ indented in relation to the other Liquid. Please try to keep the indentation con {% assign all_production_releases = site.data.releases | where: "release_type", "Production" | sort: "release_date" | reverse %} {% assign latest_full_production_version = all_production_releases | first %} -{% assign major_versions = all_production_releases | map: "major_version" | uniq | sort | reverse %} -{% assign latest_major_version_with_production = major_versions | first %} +This page describes how CockroachDB handles releases and links to the release notes for all CockroachDB [releases](#supported-releases). -## Overview +## Release types -This page explains the types and naming of CockroachDB releases and provides access to the release notes and downloads for all CockroachDB [releases](#downloads). +A new major version of CockroachDB is released quarterly. After a series of testing releases, each major version receives an initial production release, followed by a series of patch releases. These releases follow a staged process where new versions first roll out to select Cockroach {{ site.data.products.cloud }} organizations, with binaries available for CockroachDB {{ site.data.products.code }} afterwards: -A new major version of CockroachDB is released quarterly. After a series of testing releases, each major version receives an initial production release, followed by a series of patch releases. +- Major releases (x.y.0 GA): Approximately 2 weeks after {{ site.data.products.cloud }} GA. +- Patch releases (x.y.1+): Approximately 1 week after {{ site.data.products.cloud }} availability. Releases are named in the format `vYY.R.PP`, where `YY` indicates the year, `R` indicates the major release starting with `1` each year, and `PP` indicates the patch number, starting with `0`. -For example, the latest production release is `{{ latest_full_production_version.release_name }}`, within major version [`{{ latest_major_version_with_production }}`]({% link releases/{{ latest_major_version_with_production }}.md %}). +For example, the `{{ latest_full_production_version.release_name }}` production release is the latest patch release of major version [`{{ latest_full_production_version.major_version }}`]({% link releases/{{ latest_full_production_version.major_version }}.md %}). -After choosing a version of CockroachDB, learn how to: - -- [Create a cluster in CockroachDB {{ site.data.products.cloud }}]({% link cockroachcloud/create-your-cluster.md %}). -- [Upgrade a cluster in CockroachDB {{ site.data.products.cloud }}]({% link cockroachcloud/upgrade-cockroach-version.md %}). -- [Install CockroachDB {{ site.data.products.core }}]({% link {{site.current_cloud_version}}/install-cockroachdb.md %}) -- [Upgrade a Self-Hosted cluster]({% link {{site.current_cloud_version}}/upgrade-cockroach-version.md %}). - -Be sure to review Cockroach Labs' [Release Support Policy]({% link releases/release-support-policy.md %}) and review information about applicable [software licenses](#licenses). +### Major versions -### Release types +Major versions of CockroachDB alternate between **Regular** and **Innovation** releases: -#### Major releases +- **Regular releases** offer extended support windows for long-term stability and security. This support window is further extended after a patch release is nominated to an **LTS** (long-term support) release. -As of 2024, every second major version is an **Innovation release**. For CockroachDB {{ site.data.products.core }}, CockroachDB {{ site.data.products.standard }}, and CockroachDB {{ site.data.products.advanced }}, these releases offer shorter support windows and can be skipped. Innovation releases are required for CockroachDB {{ site.data.products.basic }}. - -All other major versions are **Regular releases**, which are required upgrades. These versions offer longer support periods, which, for CockroachDB {{ site.data.products.core }} clusters, are further extended when a patch version is announced that begins their **LTS** (Long-Term Support) release series. +- **Innovation releases** offer shorter support windows but include all of the latest features. For details on how LTS impacts support in CockroachDB {{ site.data.products.core }}, refer to [Release Support Policy]({% link releases/release-support-policy.md %}). For details on support per release type in CockroachDB Cloud, refer to [CockroachDB Cloud Support and Upgrade Policy]({% link cockroachcloud/upgrade-policy.md %}). -| Major Release Type | Frequency | Required upgrade | LTS releases and extended support | -| :---: | :---: | :---: | :---: | -| Innovation (e.g. v25.1) | 2x/year | on Basic only | No* | -| Regular (e.g. v25.2) | 2x/year | Yes | Yes | -* Column does not apply to CockroachDB Basic, where clusters are automatically upgraded when a new major version or a patch release is available, ensuring continuous support. - -For a given CockroachDB {{ site.data.products.core }}, CockroachDB {{ site.data.products.standard }}, or CockroachDB {{ site.data.products.advanced }} cluster, customers may choose to exclusively install or upgrade to Regular Releases to benefit from longer testing and support lifecycles, or to also include Innovation Releases, and benefit from earlier access to new features. This choice does not apply to CockroachDB {{ site.data.products.basic }}, where every major release is an automatic upgrade. - -CockroachDB v24.2 is an Innovation release and v24.3 is a Regular release. Starting with v25.1, four major releases are expected per year, where every first and third release of the year is expected to be an Innovation release. For more details, refer to [Upcoming releases](#upcoming-releases). +### Patch releases -#### Patch releases - -A major version has two types of patch releases: a series of **testing releases** followed by a series of **production releases**. A major version’s initial production release is also known as its GA release. +All major versions of CockroachDB receive patch releases that update functionality and fix issues. During the early testing phase a version receives a series of **testing releases** followed by a series of **production releases**. A major version’s initial production release is also known as its GA (generally available) release.