diff --git a/src/current/_data/supported_versions.csv b/src/current/_data/supported_versions.csv deleted file mode 100644 index f3c991fb942..00000000000 --- a/src/current/_data/supported_versions.csv +++ /dev/null @@ -1,6 +0,0 @@ -major_version,release_date,maint_supp_exp_date,asst_supp_exp_date,last_ga_patch,initial_lts_patch,initial_lts_release_date,lts_maint_supp_exp_date,lts_asst_supp_exp_date,previous_version,crdb_branch_name -v23.2,2024-02-05,2025-02-05,2025-08-05,23.2.6,23.2.7,2024-07-08,2025-07-08,2026-07-08,v23.1,release-23.2 -v24.1,2024-05-20,2025-05-20,2025-11-20,24.1.5,24.1.6,2024-10-21,2025-10-21,2026-10-21,v23.2,release-24.1 -v24.2,2024-08-12,2025-02-12,N/A,N/A,N/A,N/A,N/A,N/A,v24.1,release-24.2 -v24.3,2024-11-18,2025-11-18,2026-05-18,N/A,N/A,N/A,N/A,N/A,v24.2,release-24.3 -v25.1,N/A,N/A,N/A,N/A,N/A,N/A,N/A,N/A,v24.2,release-24.3 \ No newline at end of file diff --git a/src/current/_data/unsupported_versions.csv b/src/current/_data/unsupported_versions.csv deleted file mode 100644 index 0412ade54a7..00000000000 --- a/src/current/_data/unsupported_versions.csv +++ /dev/null @@ -1,14 +0,0 @@ -major_version,release_date,maint_supp_exp_date,asst_supp_exp_date,last_ga_patch,initial_lts_patch,initial_lts_release_date,lts_maint_supp_exp_date,lts_asst_supp_exp_date,previous_version,crdb_branch_name -v1.0,2017-05-10,2018-05-10,2018-11-10,N/A,N/A,N/A,N/A,N/A,N/A,release-1.0 -v1.1,2017-10-12,2018-10-12,2019-04-12,N/A,N/A,N/A,N/A,N/A,v1.0,release-1.1 -v2.0,2018-04-04,2019-04-04,2019-10-04,N/A,N/A,N/A,N/A,N/A,v1.1,release-2.0 -v2.1,2018-10-30,2019-10-30,2020-04-30,N/A,N/A,N/A,N/A,N/A,v2.0,release-2.1 -v19.1,2019-04-30,2020-04-30,2020-10-30,N/A,N/A,N/A,N/A,N/A,v2.1,release-19.1 -v19.2,2019-11-12,2020-11-12,2021-05-12,N/A,N/A,N/A,N/A,N/A,v19.1,release-19.2 -v20.1,2020-05-12,2021-05-12,2021-11-12,N/A,N/A,N/A,N/A,N/A,v19.2,release-20.1 -v20.2,2020-11-10,2021-11-10,2022-05-10,N/A,N/A,N/A,N/A,N/A,v20.1,release-20.2 -v21.1,2021-05-18,2022-05-18,2022-11-18,N/A,N/A,N/A,N/A,N/A,v20.2,release-21.1 -v21.2,2021-11-16,2022-11-16,2023-05-16,N/A,N/A,N/A,N/A,N/A,v21.1,release-21.2 -v22.1,2022-05-24,2023-05-24,2023-11-24,N/A,N/A,N/A,N/A,N/A,v21.2,release-22.1 -v22.2,2022-12-05,2023-12-05,2024-06-05,N/A,N/A,N/A,N/A,N/A,v22.1,release-22.2 -v23.1,2023-05-15,2024-05-15,2024-11-15,23.1.11,23.1.12,2023-11-13,2024-11-13,2025-11-13,v22.2,release-23.1 \ No newline at end of file diff --git a/src/current/_data/versions.csv b/src/current/_data/versions.csv index 6f68e7f25aa..bf81e3b4187 100644 --- a/src/current/_data/versions.csv +++ b/src/current/_data/versions.csv @@ -1,19 +1,19 @@ -major_version,release_date,maint_supp_exp_date,asst_supp_exp_date,last_ga_patch,initial_lts_patch,initial_lts_release_date,lts_maint_supp_exp_date,lts_asst_supp_exp_date,previous_version,crdb_branch_name -v1.0,2017-05-10,2018-05-10,2018-11-10,N/A,N/A,N/A,N/A,N/A,N/A,release-1.0 -v1.1,2017-10-12,2018-10-12,2019-04-12,N/A,N/A,N/A,N/A,N/A,v1.0,release-1.1 -v2.0,2018-04-04,2019-04-04,2019-10-04,N/A,N/A,N/A,N/A,N/A,v1.1,release-2.0 -v2.1,2018-10-30,2019-10-30,2020-04-30,N/A,N/A,N/A,N/A,N/A,v2.0,release-2.1 -v19.1,2019-04-30,2020-04-30,2020-10-30,N/A,N/A,N/A,N/A,N/A,v2.1,release-19.1 -v19.2,2019-11-12,2020-11-12,2021-05-12,N/A,N/A,N/A,N/A,N/A,v19.1,release-19.2 -v20.1,2020-05-12,2021-05-12,2021-11-12,N/A,N/A,N/A,N/A,N/A,v19.2,release-20.1 -v20.2,2020-11-10,2021-11-10,2022-05-10,N/A,N/A,N/A,N/A,N/A,v20.1,release-20.2 -v21.1,2021-05-18,2022-05-18,2022-11-18,N/A,N/A,N/A,N/A,N/A,v20.2,release-21.1 -v21.2,2021-11-16,2022-11-16,2023-05-16,N/A,N/A,N/A,N/A,N/A,v21.1,release-21.2 -v22.1,2022-05-24,2023-05-24,2023-11-24,N/A,N/A,N/A,N/A,N/A,v21.2,release-22.1 -v22.2,2022-12-05,2023-12-05,2024-06-05,N/A,N/A,N/A,N/A,N/A,v22.1,release-22.2 -v23.1,2023-05-15,2024-05-15,2024-11-15,23.1.11,23.1.12,2023-11-13,2024-11-13,2025-11-13,v22.2,release-23.1 -v23.2,2024-02-05,2025-02-05,2025-08-05,23.2.6,23.2.7,2024-07-08,2025-07-08,2026-07-08,v23.1,release-23.2 -v24.1,2024-05-20,2025-05-20,2025-11-20,24.1.5,24.1.6,2024-10-21,2025-10-21,2026-10-21,v23.2,release-24.1 -v24.2,2024-08-12,2025-02-12,N/A,N/A,N/A,N/A,N/A,N/A,v24.1,release-24.2 -v24.3,2024-11-18,2025-11-18,2026-05-18,N/A,N/A,N/A,N/A,N/A,v24.2,release-24.3 -v25.1,2025-02-18,2026-08-18,N/A,N/A,N/A,N/A,N/A,N/A,v24.3,release-25.1 +major_version,release_date,maint_supp_exp_date,asst_supp_exp_date,last_ga_patch,initial_lts_patch,initial_lts_release_date,lts_maint_supp_exp_date,lts_asst_supp_exp_date,previous_version,crdb_branch_name,binaries_unsupported_date +v1.0,2017-05-10,2018-05-10,2018-11-10,N/A,N/A,N/A,N/A,N/A,N/A,release-1.0,2024-01-01 +v1.1,2017-10-12,2018-10-12,2019-04-12,N/A,N/A,N/A,N/A,N/A,v1.0,release-1.1,2024-01-01 +v2.0,2018-04-04,2019-04-04,2019-10-04,N/A,N/A,N/A,N/A,N/A,v1.1,release-2.0,2024-01-01 +v2.1,2018-10-30,2019-10-30,2020-04-30,N/A,N/A,N/A,N/A,N/A,v2.0,release-2.1,2024-01-01 +v19.1,2019-04-30,2020-04-30,2020-10-30,N/A,N/A,N/A,N/A,N/A,v2.1,release-19.1,2024-01-01 +v19.2,2019-11-12,2020-11-12,2021-05-12,N/A,N/A,N/A,N/A,N/A,v19.1,release-19.2,2024-01-01 +v20.1,2020-05-12,2021-05-12,2021-11-12,N/A,N/A,N/A,N/A,N/A,v19.2,release-20.1,2025-05-12 +v20.2,2020-11-10,2021-11-10,2022-05-10,N/A,N/A,N/A,N/A,N/A,v20.1,release-20.2,2025-05-12 +v21.1,2021-05-18,2022-05-18,2022-11-18,N/A,N/A,N/A,N/A,N/A,v20.2,release-21.1,2025-05-18 +v21.2,2021-11-16,2022-11-16,2023-05-16,N/A,N/A,N/A,N/A,N/A,v21.1,release-21.2,2025-11-16 +v22.1,2022-05-24,2023-05-24,2023-11-24,N/A,N/A,N/A,N/A,N/A,v21.2,release-22.1,2026-05-24 +v22.2,2022-12-05,2023-12-05,2024-06-05,N/A,N/A,N/A,N/A,N/A,v22.1,release-22.2,2026-12-05 +v23.1,2023-05-15,2024-05-15,2024-11-15,23.1.11,23.1.12,2023-11-13,2024-11-13,2025-11-13,v22.2,release-23.1,N/A +v23.2,2024-02-05,2025-02-05,2025-08-05,23.2.6,23.2.7,2024-07-08,2025-07-08,2026-07-08,v23.1,release-23.2,N/A +v24.1,2024-05-20,2025-05-20,2025-11-20,24.1.5,24.1.6,2024-10-21,2025-10-21,2026-10-21,v23.2,release-24.1,N/A +v24.2,2024-08-12,2025-02-12,N/A,N/A,N/A,N/A,N/A,N/A,v24.1,release-24.2,2028-08-12 +v24.3,2024-11-18,2025-11-18,2026-05-18,N/A,N/A,N/A,N/A,N/A,v24.2,release-24.3,N/A +v25.1,2025-02-18,2026-08-18,N/A,N/A,N/A,N/A,N/A,N/A,v24.3,release-25.1,N/A diff --git a/src/current/_includes/sidebar-all-releases.json b/src/current/_includes/sidebar-all-releases.json index d4df619a262..6074a7d3679 100644 --- a/src/current/_includes/sidebar-all-releases.json +++ b/src/current/_includes/sidebar-all-releases.json @@ -69,7 +69,7 @@ ] }, { - "title": "Unsupported versions", + "title": "Unsupported Versions", "urls": [ "/releases/unsupported-versions.html" ] diff --git a/src/current/_includes/sidebar-releases.json b/src/current/_includes/sidebar-releases.json index 0df726ab7c8..1484fbae75b 100644 --- a/src/current/_includes/sidebar-releases.json +++ b/src/current/_includes/sidebar-releases.json @@ -81,7 +81,7 @@ ] }, { - "title": "Unsupported versions", + "title": "Unsupported Versions", "urls": [ "/releases/unsupported-versions.html" ] diff --git a/src/current/releases/index.md b/src/current/releases/index.md index 1bc052c654c..9d4417be120 100644 --- a/src/current/releases/index.md +++ b/src/current/releases/index.md @@ -114,10 +114,9 @@ As of 2024, CockroachDB is released under a staged delivery process. New release | Version | Release Type | GA date | | :---: | :---: | :---: | | [v24.3](#v24-3) | Regular | 2024-11-18 | -| [v24.2](#v24-2) | Innovation | 2024-08-12 | | [v24.1](#v24-1) | Regular | 2024-05-20 | | [v23.2](#v23-2) | Regular | 2024-02-05 | -| [v23.1](https://www.cockroachlabs.com/docs/releases/unsupported-versions#v23-1) | Regular | 2023-05-15 | +| [v23.1](#v23-1) | Regular | 2023-05-15 | ### Upcoming releases @@ -130,6 +129,7 @@ The following releases and their descriptions represent proposed plans that are | v25.3 | Innovation | 2025 Q3 | | v25.4 | Regular | 2025 Q4 | + ## Downloads {{ experimental_js_warning }} @@ -140,7 +140,7 @@ The following releases and their descriptions represent proposed plans that are {% assign released_versions = site.data.releases | map: "major_version" | uniq | reverse %} {% comment %} Fetch the list of the major versions of all releases that currently exist {% endcomment %} -{% assign versions = site.data.supported_versions | where_exp: "versions", "released_versions contains versions.major_version" | sort: "release_date" | reverse %} +{% assign versions = site.data.versions | where_exp: "versions", "released_versions contains versions.major_version" | sort: "release_date" | reverse %} {% comment %} Fetch all major versions (e.g., v21.2), sorted in reverse chronological order. {% endcomment %} {% assign latest_hotfix = site.data.releases | where_exp: "latest_hotfix", "latest_hotfix.major_version == site.versions['stable']" | where_exp: "latest_hotfix", "latest_hotfix.withdrawn != true" | sort: "release_date" | reverse | first %} @@ -151,32 +151,65 @@ The following releases and their descriptions represent proposed plans that are {% capture onclick_string %}onclick="{{ experimental_download_js }}"{% endcapture %} {% assign is_not_downloadable_message = "No longer available for download." %} +{% assign current_date = 'now' | date: '%Y-%m-%d' %} {% for v in versions %} {% comment %} Iterate through all major versions {% endcomment %} {% comment %} - Determine if the major version is LTS and the patch component of the initial LTS patch, - or the major version is a skippable innovation release + Determine if the major version is supported and if it has LTS releases {% endcomment %} {% assign released = false %} {% assign has_lts_releases = false %} - {% assign lts_link_linux = '' %} + {% assign lts_link = '' %} {% assign lts_patch = nil %} - {% assign in_lts = false %} - {% assign comparison = nil %} - {% assign skippable = false %} + {% assign is_supported = false %} + {% assign is_innovation = false %} + {% assign in_lts_period = false %} + {% assign ga_support_expired = false %} + + {% comment %} Check if the version has been released {% endcomment %} {% if v.release_date != "N/A" and v.maint_supp_exp_date != "N/A" %} {% assign released = true %} + + {% comment %} Check if this is an innovation release {% endcomment %} {% if v.asst_supp_exp_date == "N/A" %} - {% assign skippable = true %} - {% elsif v.initial_lts_patch != "N/A" %} - {% assign has_lts_releases = true %} - {% assign lts_link = ' (LTS) ' %} - {% capture lts_patch_string %}{{ v.initial_lts_patch | split: '.' | shift | shift }}{% endcapture %} - {% assign lts_patch = lts_patch_string | times: 1 %}{% comment %}Cast string to integer {% endcomment %} + {% assign is_innovation = true %} + + {% comment %} For innovation releases, check if still in maintenance support {% endcomment %} + {% if v.maint_supp_exp_date > current_date %} + {% assign is_supported = true %} + {% endif %} + {% else %} + {% comment %} For regular releases, check if in maintenance or assistance support {% endcomment %} + {% if v.asst_supp_exp_date > current_date %} + {% assign is_supported = true %} + {% else %} + {% assign ga_support_expired = true %} + {% endif %} + + {% comment %} Check if this version has LTS releases {% endcomment %} + {% if v.initial_lts_patch != "N/A" %} + {% assign has_lts_releases = true %} + {% assign lts_link = ' (LTS) ' %} + {% capture lts_patch_string %}{{ v.initial_lts_patch | split: '.' | shift | shift }}{% endcapture %} + {% assign lts_patch = lts_patch_string | times: 1 %} + + {% comment %} Check if we're in the LTS period for this version {% endcomment %} + {% if v.initial_lts_release_date != "N/A" and v.initial_lts_release_date <= current_date %} + {% assign in_lts_period = true %} + {% endif %} + + {% comment %} For LTS versions, update support based on LTS dates {% endcomment %} + {% if v.lts_asst_supp_exp_date != "N/A" and v.lts_asst_supp_exp_date > current_date %} + {% assign is_supported = true %} + {% endif %} + {% endif %} {% endif %} {% endif %} +{% comment %} Only display supported versions {% endcomment %} +{% if is_supported %} + ### {{ v.major_version }} {% if DEBUG == true %} @@ -189,17 +222,19 @@ The following releases and their descriptions represent proposed plans that are has_lts_releases: {{ has_lts_releases }}
v.release_date: {{ v.release_date }}
v.initial_lts_release_date: {{ v.initial_lts_release_date }}
- skippable: {{ skippable }}

+ is_innovation: {{ is_innovation }}
+ in_lts_period: {{ in_lts_period }}
+ ga_support_expired: {{ ga_support_expired }}

{% endif %} {% if released == false %} CockroachDB {{ page.major_version }} is in active development and is not yet supported. 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 %} -CockroachDB {{ v.major_version }} is {% if skippable == true %}an [Innovation release]({% link releases/release-support-policy.md %}#innovation-releases) that is optional for CockroachDB {{ site.data.products.advanced }}, CockroachDB {{ site.data.products.standard }}, and CockroachDB {{ site.data.products.core }} but required for CockroachDB {{ site.data.products.basic }}.{% else %}a required [Regular release]({% link releases/release-support-policy.md %}#regular-releases).{% endif %}{% if released == false %} It is still in development and not yet supported.{% endif %}{% unless latest_full_production_version.release_name != v.major_version %} CockroachDB {{ latest_full_production_version.release_name }} is the latest supported version.{% endunless %} To learn more, refer to [CockroachDB {{ latest.major_version }} Release Notes]({% link releases/{{ v.major_version }}.md %}). +CockroachDB {{ v.major_version }} is {% if is_innovation == true %}an [Innovation release]({% link releases/release-support-policy.md %}#innovation-releases) that is optional for CockroachDB {{ site.data.products.advanced }}, CockroachDB {{ site.data.products.standard }}, and CockroachDB {{ site.data.products.core }} but required for CockroachDB {{ site.data.products.basic }}.{% else %}a required [Regular release]({% link releases/release-support-policy.md %}#regular-releases).{% endif %}{% if released == false %} It is still in development and not yet supported.{% endif %}{% unless latest_full_production_version.release_name != v.major_version %} CockroachDB {{ latest_full_production_version.release_name }} is the latest supported version.{% endunless %} To learn more, refer to [CockroachDB {{ latest.major_version }} Release Notes]({% link releases/{{ v.major_version }}.md %}). + {% endif %} Refer to [Major release types](#major-releases) before installing or upgrading for release support details. -{% comment %}Some old pages don't have feature highlights and won't get LTS{% endcomment %} {% unless v.major_version == 'v1.0' or v.major_version == 'v1.1' or v.major_version == 'v2.0' or @@ -213,7 +248,7 @@ Refer to [Major release types](#major-releases) before installing or upgrading f v.major_version == 'v22.1' or v.major_version == 'v22.2' or released == false %} -To learn what’s new in this release, refer to [Feature Highlights]({% link releases/{{ v.major_version }}.md %}#feature-highlights). +To learn what's new in this release, refer to [Feature Highlights]({% link releases/{{ v.major_version }}.md %}#feature-highlights). {% endunless %}
@@ -228,10 +263,51 @@ To learn what’s new in this release, refer to [Feature Highlights]({% link rel {% assign releases = site.data.releases | where_exp: "releases", "releases.major_version == v.major_version" | where_exp: "releases", "releases.release_type == s" | sort: "release_date" | reverse %} {% comment %} Fetch all releases for that major version based on release type (Production/Testing). {% endcomment %} -{% comment %}Do a separate loop through the releases and for each release, copy some fields into some local v_ variables to use when we are not in a loop below{% endcomment %} + {% comment %} Filter the releases to only include supported ones {% endcomment %} + {% assign supported_releases = "" | split: "" %} + {% for r in releases %} + {% assign is_release_supported = false %} + + {% comment %} For versions with LTS {% endcomment %} + {% if has_lts_releases and s == "Production" %} + {% capture current_patch_string %}{{ r.release_name | split: '.' | shift | shift }}{% endcapture %} + {% assign current_patch = current_patch_string | times: 1 %} + + {% if in_lts_period and ga_support_expired %} + {% comment %} We are in LTS period, only show LTS releases {% endcomment %} + {% if current_patch >= lts_patch %} + {% comment %} This is an LTS release, check against LTS dates {% endcomment %} + {% if v.lts_asst_supp_exp_date > current_date %} + {% assign is_release_supported = true %} + {% endif %} + {% endif %} + {% else %} + {% comment %} Not yet in LTS period, check regular support dates {% endcomment %} + {% if v.asst_supp_exp_date > current_date %} + {% assign is_release_supported = true %} + {% endif %} + {% endif %} + {% elsif is_innovation %} + {% comment %} For innovation releases, only show if within maintenance support {% endcomment %} + {% if v.maint_supp_exp_date > current_date %} + {% assign is_release_supported = true %} + {% endif %} + {% else %} + {% comment %} For regular releases, show if within assistance support {% endcomment %} + {% if v.asst_supp_exp_date > current_date %} + {% assign is_release_supported = true %} + {% endif %} + {% endif %} + + {% comment %} Don't include withdrawn releases in the supported list {% endcomment %} + {% if r.withdrawn != true and is_release_supported %} + {% assign supported_releases = supported_releases | push: r %} + {% endif %} + {% endfor %} + {% comment %}Do a separate loop through the filtered releases and for each release, copy some fields into some local v_ variables to use when we are not in a loop below{% endcomment %} {% assign v_linux_arm = false %} - {% for r in releases %} + {% for r in supported_releases %} {% if r.linux.linux_arm == true %} {% assign v_linux_arm = true %} {% break %} @@ -239,7 +315,7 @@ To learn what’s new in this release, refer to [Feature Highlights]({% link rel {% endfor %} {% assign v_mac_arm = false %} - {% for r in releases %} + {% for r in supported_releases %} {% if r.mac.mac_arm == true %} {% assign v_mac_arm = true %} {% break %} @@ -247,14 +323,14 @@ To learn what’s new in this release, refer to [Feature Highlights]({% link rel {% endfor %} {% assign v_docker_arm = false %} - {% for r in releases %} - {% if r.docker.docker_arm == true %} + {% for r in supported_releases %} + {% if r.docker.docker_arm == true %} {% assign v_docker_arm = true %} {% break %} {% endif %} {% endfor %} - {% if releases[0] %} + {% if supported_releases.size > 0 %} #### {{ s }} Releases @@ -272,7 +348,7 @@ To learn what’s new in this release, refer to [Feature Highlights]({% link rel - {% for r in releases %} + {% for r in supported_releases %} {% assign current_patch_string = '' %} {% assign current_patch = nil %} @@ -295,20 +371,20 @@ To learn what’s new in this release, refer to [Feature Highlights]({% link rel {% comment %} Add "Latest" class to release if it's the latest release. {% endcomment %} - {{ r.release_name }}{% if in_lts == true %}{{ lts_link }}{% endif %}{% comment %} Add link to each release r, decorate with link about LTS if applicable. {% endcomment %} + {{ r.release_name }}{% if in_lts %}{{ lts_link }}{% endif %}{% comment %} Add link to each release r, decorate with link about LTS if applicable. {% endcomment %} {% if r.release_name == latest_hotfix.release_name %} Latest {% comment %} Add "Latest" badge to release if it's the latest release. {% endcomment %} {% endif %} {{ r.release_date }} {% comment %} Release date of the release. {% endcomment %} {% if r.withdrawn == true %} {% comment %} Suppress download links for withdrawn releases. {% endcomment %} - Withdrawn{% comment %}covers both Intel and ARM columns {% endcomment %} + Withdrawn{% comment %}covers both Intel and ARM columns {% endcomment %} {% continue %} {% elsif r.cloud_only == true %} {% comment %} Suppress download links for Cloud-first releases {% endcomment %} - {{ r.cloud_only_message_short }} + {{ r.cloud_only_message_short }} {% continue %} {% elsif r.is_not_downloadable == true %} {% comment %} Suppress download links for outdated versions. {% endcomment %} - {{ is_not_downloadable_message }} + {{ is_not_downloadable_message }} {% continue %} {% else %} {% comment %} Add download links for all non-withdrawn versions. {% endcomment %} @@ -317,7 +393,7 @@ To learn what’s new in this release, refer to [Feature Highlights]({% link rel
SQL Shell Binary{% if r.has_sha256sum == true %} (SHA256{% endif %})
{% comment %} If a sha256sum is available for a particular release, we display a link to the file containing the sha256sum alongside the download link of the release. {% endcomment %} {% endif %} {% endif %} - {% if r.linux.linux_arm == true %} + {% if r.linux.linux_arm == true and v_linux_arm == true %} {% comment %}Don't print column because of previous colspan=2{% endcomment %} {% if r.withdrawn == true or r.cloud_only == true or r.is_not_downloadable == true %} {% break %} @@ -353,24 +429,35 @@ macOS downloads are **experimental**. Experimental downloads are not yet qualifi - {% for r in releases %} + {% for r in supported_releases %} + {% assign current_patch_string = '' %} + {% assign current_patch = nil %} + {% assign in_lts = false %} + {% if has_lts_releases == true and s == "Production" %} + {% capture current_patch_string %}{{ r.release_name | split: '.' | shift | shift }}{% endcapture %} + {% assign current_patch = current_patch_string | times: 1 %} + {% assign comparison = current_patch | minus: lts_patch %} + {% unless comparison < 0 %} + {% assign in_lts = true %} + {% endunless %} + {% endif %} {% comment %} Add "Latest" class to release if it's the latest release. {% endcomment %} - {{ r.release_name }} {% comment %} Add link to each release r. {% endcomment %} - {% if r.release_name == latest_hotfix.release_name %} + {{ r.release_name }}{% if in_lts %}{{ lts_link }}{% endif %} {% comment %} Add link to each release r and LTS indicator if applicable. {% endcomment %} + {% if r.release_name == latest_hotfix.release_name %} Latest {% comment %} Add "Latest" badge to release if it's the latest release. {% endcomment %} - {% endif %} + {% endif %} {{ r.release_date }} {% comment %} Release date of the release. {% endcomment %} {% if r.withdrawn == true %} {% comment %} Suppress withdrawn releases. {% endcomment %} - Withdrawn{% comment %}covers both Intel and ARM columns {% endcomment %} + Withdrawn{% comment %}covers both Intel and ARM columns {% endcomment %} {% continue %} {% elsif r.cloud_only == true %} {% comment %} Suppress download links for Cloud-first releases {% endcomment %} - {{ r.cloud_only_message_short }} + {{ r.cloud_only_message_short }} {% continue %} {% elsif r.is_not_downloadable == true %} {% comment %} Suppress download links for outdated versions. {% endcomment %} - {{ is_not_downloadable_message }} + {{ is_not_downloadable_message }} {% continue %} {% else %} {% comment %} Add download links for all non-withdrawn versions. {% endcomment %} @@ -379,7 +466,7 @@ macOS downloads are **experimental**. Experimental downloads are not yet qualifi
SQL shell Binary{% if r.has_sha256sum == true %} (SHA256){% endif %}
{% comment %} If a sha256sum is available for a particular release, we display a link to the file containing the sha256sum alongside the download link of the release. {% endcomment %} {% endif %} {% endif %} - {% if r.mac.mac_arm == true %} + {% if r.mac.mac_arm == true and v_mac_arm == true %} {% comment %}Don't print column because of previous colspan=2{% endcomment %} {% if r.withdrawn == true or r.cloud_only == true or r.is_not_downloadable == true %} {% break %} @@ -411,25 +498,35 @@ macOS downloads are **experimental**. Experimental downloads are not yet qualifi - {% for r in releases %} - + {% for r in supported_releases %} + {% assign current_patch_string = '' %} + {% assign current_patch = nil %} + {% assign in_lts = false %} + {% if has_lts_releases == true and s == "Production" %} + {% capture current_patch_string %}{{ r.release_name | split: '.' | shift | shift }}{% endcapture %} + {% assign current_patch = current_patch_string | times: 1 %} + {% assign comparison = current_patch | minus: lts_patch %} + {% unless comparison < 0 %} + {% assign in_lts = true %} + {% endunless %} + {% endif %} {% comment %} Add "Latest" class to release if it's the latest release. {% endcomment %} - {{ r.release_name }} {% comment %} Add link to each release r. {% endcomment %} + {{ r.release_name }}{% if in_lts %}{{ lts_link }}{% endif %} {% comment %} Add link to each release r and LTS indicator if applicable. {% endcomment %} {% if r.release_name == latest_hotfix.release_name %} Latest {% comment %} Add "Latest" badge to release if it's the latest release. {% endcomment %} {% endif %} {{ r.release_date }} {% comment %} Release date of the release. {% endcomment %} {% if r.withdrawn == true %} {% comment %} Suppress withdrawn releases. {% endcomment %} - Withdrawn{% comment %}covers both Intel and ARM columns {% endcomment %} + Withdrawn {% continue %} {% elsif r.cloud_only == true %} {% comment %} Suppress download links for Cloud-first releases {% endcomment %} - {{ r.cloud_only_message_short }} + {{ r.cloud_only_message_short }} {% continue %} {% elsif r.is_not_downloadable == true %} {% comment %} Suppress download links for outdated versions. {% endcomment %} - {{ is_not_downloadable_message }} + {{ is_not_downloadable_message }} {% continue %} {% else %} {% comment %} Add download links for all non-withdrawn versions. {% endcomment %} @@ -477,14 +574,14 @@ macOS downloads are **experimental**. Experimental downloads are not yet qualifi - {% for r in releases %} + {% for r in supported_releases %} {% assign current_patch_string = '' %} {% assign current_patch = nil %} {% assign in_lts = false %} {% if has_lts_releases == true and s == "Production" %} {% capture current_patch_string %}{{ r.release_name | split: '.' | shift | shift }}{% endcapture %} - {% assign current_patch = current_patch_string | times: 1 %}{% comment %}Cast string to integer {% endcomment %} + {% assign current_patch = current_patch_string | times: 1 %} {% if current_patch == nil %} Error: Could not determine the current patch. Giving up.
{% break %}{% break %} @@ -500,7 +597,7 @@ macOS downloads are **experimental**. Experimental downloads are not yet qualifi {% comment %}Version column{% endcomment %} {{ r.release_name }}{% if in_lts == true %}{{ lts_link }}{% endif %}{% comment %} Add link to each release r.{% endcomment %} +".", "-" }}" class="binary-link">{{ r.release_name }}{% if in_lts %}{{ lts_link }}{% endif %}{% comment %} Add link to each release r with LTS indicator if applicable.{% endcomment %} {% if r.release_name == latest_hotfix.release_name %} Latest {% comment %} Add "Latest" badge to release if it's the latest release. {% endcomment %} {% endif %} @@ -557,11 +654,22 @@ macOS downloads are **experimental**. Experimental downloads are not yet qualifi - {% for r in releases %} + {% for r in supported_releases %} + {% assign current_patch_string = '' %} + {% assign current_patch = nil %} + {% assign in_lts = false %} + {% if has_lts_releases == true and s == "Production" %} + {% capture current_patch_string %}{{ r.release_name | split: '.' | shift | shift }}{% endcapture %} + {% assign current_patch = current_patch_string | times: 1 %} + {% assign comparison = current_patch | minus: lts_patch %} + {% unless comparison < 0 %} + {% assign in_lts = true %} + {% endunless %} + {% endif %} {% comment %} Add "Latest" class to release if it's the latest release. {% endcomment %} - {{ r.release_name }}{% comment %} Add link to each release r {% endcomment %} + {{ r.release_name }}{% if in_lts %}{{ lts_link }}{% endif %}{% comment %} Add link to each release r and LTS indicator if applicable {% endcomment %} {% if r.release_name == latest_hotfix.release_name %} Latest {% comment %} Add "Latest" badge to release if it's the latest release. {% endcomment %} {% endif %} @@ -592,8 +700,9 @@ macOS downloads are **experimental**. Experimental downloads are not yet qualifi - {% endif %} {% comment %}if releases[0]{% endcomment %} + {% endif %} {% comment %}if supported_releases.size > 0{% endcomment %} {% endfor %} {% comment %}for s in sections {% endcomment %} +{% endif %} {% comment %}if is_supported{% endcomment %} {% endfor %} {% comment %}for v in versions{% endcomment %} ## Licenses @@ -605,5 +714,6 @@ All binaries available on this page released prior to the release date of 24.3.0 To review the CCL, refer to the [CockroachDB Community License](https://www.cockroachlabs.com/cockroachdb-community-license) page. You can find the applicable Business Source License or third party licenses by reviewing these in the `licenses` folder for the applicable version of CockroachDB in the GitHub repository [cockroachdb/cockroach](https://github.com/cockroachdb/cockroach). See individual files for details. ## Unsupported versions -[Here]({% link releases/unsupported-versions.md %}) are the versions of CockroachDB that are no longer supported + +Release notes for unsupported CockroachDB versions are found on [Unsupported Versions]({% link releases/unsupported-versions.md %}). diff --git a/src/current/releases/release-support-policy.md b/src/current/releases/release-support-policy.md index 74781c72fc1..af1e2b61833 100644 --- a/src/current/releases/release-support-policy.md +++ b/src/current/releases/release-support-policy.md @@ -15,7 +15,7 @@ This page explains Cockroach Labs' policy for supporting [production releases]({ There are two major release types: [Regular and Innovation releases]({% link releases/index.md %}#release-types). Each offers a unique set of Support Types, which define the durations for each [support phase](#support-phases). -## Support Phases +## Support phases - **Maintenance Support**: Begins for a CockroachDB major version upon its [GA release]({% link releases/index.md %}#patch-releases). During this phase: - Cockroach Labs will produce regular patch releases that include critical security fixes and resolutions to problems identified by users. @@ -32,7 +32,7 @@ There are two major release types: [Regular and Innovation releases]({% link rel - A Regular release reaches unsupported at the Assistance Support phase's end date. - An Innovation release reaches unsupported at the Maintenance Support phase's end date. -## Support Types +## Support types ### Regular releases diff --git a/src/current/releases/unsupported-versions.md b/src/current/releases/unsupported-versions.md index 1e8cf9560b2..d39081eda35 100644 --- a/src/current/releases/unsupported-versions.md +++ b/src/current/releases/unsupported-versions.md @@ -1,10 +1,12 @@ --- -title: Unsupported versions +title: Unsupported Versions summary: Versions of CockroachDB that are no longer supported toc: true docs_area: releases --- - +{{site.data.alerts.callout_danger}} +The CockroachDB versions on this page are no longer supported. For more information, refer to [Release Support Policy]({% link releases/release-support-policy.md %}#unsupported-versions). To download and learn about currently supported CockroachDB versions, refer to [CockroachDB Releases]({% link releases/index.md %}). +{{site.data.alerts.end}} ## Downloads {{ experimental_js_warning }} @@ -15,7 +17,7 @@ docs_area: releases {% assign released_versions = site.data.releases | map: "major_version" | uniq | reverse %} {% comment %} Fetch the list of the major versions of all releases that currently exist {% endcomment %} -{% assign versions = site.data.unsupported_versions | where_exp: "versions", "released_versions contains versions.major_version" | sort: "release_date" | reverse %} +{% assign versions = site.data.versions | where_exp: "versions", "released_versions contains versions.major_version" | sort: "release_date" | reverse %} {% comment %} Fetch all major versions (e.g., v21.2), sorted in reverse chronological order. {% endcomment %} {% assign latest_hotfix = site.data.releases | where_exp: "latest_hotfix", "latest_hotfix.major_version == site.versions['stable']" | where_exp: "latest_hotfix", "latest_hotfix.withdrawn != true" | sort: "release_date" | reverse | first %} @@ -26,70 +28,84 @@ docs_area: releases {% capture onclick_string %}onclick="{{ experimental_download_js }}"{% endcapture %} {% assign is_not_downloadable_message = "No longer available for download." %} +{% assign current_date = 'now' | date: '%Y-%m-%d' %} {% for v in versions %} {% comment %} Iterate through all major versions {% endcomment %} {% comment %} - Determine if the major version is LTS and the patch component of the initial LTS patch, - or the major version is a skippable innovation release + Determine if the major version is unsupported or has unsupported releases {% endcomment %} {% assign released = false %} {% assign has_lts_releases = false %} - {% assign lts_link_linux = '' %} + {% assign lts_link = '' %} {% assign lts_patch = nil %} - {% assign in_lts = false %} - {% assign comparison = nil %} - {% assign skippable = false %} + {% assign is_unsupported = false %} + {% assign has_unsupported_releases = false %} + {% assign is_innovation = false %} + {% assign in_lts_period = false %} + {% assign ga_support_expired = false %} + {% assign version_past_unsupported_date = false %} + + {% comment %} Check if the version is past its unsupported date {% endcomment %} + {% if v.binaries_unsupported_date != "N/A" and v.binaries_unsupported_date <= current_date %} + {% assign version_past_unsupported_date = true %} + {% endif %} + + {% comment %} Check if the version has been released {% endcomment %} {% if v.release_date != "N/A" and v.maint_supp_exp_date != "N/A" %} {% assign released = true %} + + {% comment %} Check if this is an innovation release {% endcomment %} {% if v.asst_supp_exp_date == "N/A" %} - {% assign skippable = true %} - {% elsif v.initial_lts_patch != "N/A" %} - {% assign has_lts_releases = true %} - {% assign lts_link = ' (LTS) ' %} - {% capture lts_patch_string %}{{ v.initial_lts_patch | split: '.' | shift | shift }}{% endcapture %} - {% assign lts_patch = lts_patch_string | times: 1 %}{% comment %}Cast string to integer {% endcomment %} + {% assign is_innovation = true %} + + {% comment %} For innovation releases, check if past maintenance support {% endcomment %} + {% if v.maint_supp_exp_date <= current_date %} + {% assign is_unsupported = true %} + {% endif %} + {% else %} + {% comment %} For regular releases, check if past assistance support {% endcomment %} + {% if v.asst_supp_exp_date <= current_date %} + {% assign ga_support_expired = true %} + + {% comment %} If no LTS or LTS has also expired, it's completely unsupported {% endcomment %} + {% if v.lts_asst_supp_exp_date == "N/A" or v.lts_asst_supp_exp_date <= current_date %} + {% assign is_unsupported = true %} + {% endif %} + {% endif %} + + {% comment %} Check if this version has LTS releases {% endcomment %} + {% if v.initial_lts_patch != "N/A" %} + {% assign has_lts_releases = true %} + {% assign lts_link = ' (LTS) ' %} + {% capture lts_patch_string %}{{ v.initial_lts_patch | split: '.' | shift | shift }}{% endcapture %} + {% assign lts_patch = lts_patch_string | times: 1 %} + + {% comment %} Check if we're in the LTS period for this version {% endcomment %} + {% if v.initial_lts_release_date != "N/A" and v.initial_lts_release_date <= current_date %} + {% assign in_lts_period = true %} + + {% comment %} In LTS period with expired GA support means pre-LTS patches are unsupported {% endcomment %} + {% if ga_support_expired %} + {% assign has_unsupported_releases = true %} + {% endif %} + {% endif %} + {% endif %} {% endif %} {% endif %} - + + {% comment %} Only handle released versions (ignore future versions) {% endcomment %} + {% if released %} + {% comment %} Show this major version if it's unsupported or has unsupported releases {% endcomment %} + {% if is_unsupported or has_unsupported_releases %} + ### {{ v.major_version }} -{% if DEBUG == true %} - released: {{ released }}
- has_lts_releases: {{ has_lts_releases }}
- lts_patch_string: {{ lts_patch_string }}
- lts_patch: {{ lts_patch }}
- v.initial_lts_patch: {{ v.initial_lts_patch }}
- v.major_version: {{ v.major_version }}
- has_lts_releases: {{ has_lts_releases }}
- v.release_date: {{ v.release_date }}
- v.initial_lts_release_date: {{ v.initial_lts_release_date }}
- skippable: {{ skippable }}

-{% endif %} - -{% if released == false %} -CockroachDB {{ page.major_version }} is in active development and is not yet supported. 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 %} -CockroachDB {{ v.major_version }} is {% if skippable == true %}an [Innovation release]({% link releases/release-support-policy.md %}#innovation-releases) that is optional for CockroachDB {{ site.data.products.advanced }}, CockroachDB {{ site.data.products.standard }}, and CockroachDB {{ site.data.products.core }} but required for CockroachDB {{ site.data.products.basic }}.{% else %}a required [Regular release]({% link releases/release-support-policy.md %}#regular-releases).{% endif %}{% if released == false %} It is still in development and not yet supported.{% endif %}{% unless latest_full_production_version.release_name != v.major_version %} CockroachDB {{ latest_full_production_version.release_name }} is the latest supported version.{% endunless %} To learn more, refer to [CockroachDB {{ latest.major_version }} Release Notes]({% link releases/{{ v.major_version }}.md %}). -{% endif %} - -Refer to [Major release types](https://www.cockroachlabs.com/docs/releases#major-releases) before installing or upgrading for release support details. -{% comment %}Some old pages don't have feature highlights and won't get LTS{% endcomment %} -{% unless v.major_version == 'v1.0' or - v.major_version == 'v1.1' or - v.major_version == 'v2.0' or - v.major_version == 'v2.1' or - v.major_version == 'v19.1' or - v.major_version == 'v19.2' or - v.major_version == 'v20.1' or - v.major_version == 'v20.2' or - v.major_version == 'v21.1' or - v.major_version == 'v21.2' or - v.major_version == 'v22.1' or - v.major_version == 'v22.2' or - released == false %} -To learn what’s new in this release, refer to [Feature Highlights]({% link releases/{{ v.major_version }}.md %}#feature-highlights). -{% endunless %} + {% if is_unsupported %} +CockroachDB {{ v.major_version }} is completely unsupported. {% if is_innovation %}This was an Innovation release{% else %}This was a Regular release{% endif %} that reached end-of-support on {% if is_innovation %}{{ v.maint_supp_exp_date }}{% else %}{{ v.asst_supp_exp_date }}{% endif %}. + {% else %} +CockroachDB {{ v.major_version }} is partially supported. Pre-LTS patches (before {{ v.initial_lts_patch }}) are no longer supported, but LTS patches ({{ v.initial_lts_patch }} and later) are still covered under the LTS support policy until {{ v.lts_asst_supp_exp_date }}. + {% endif %}
@@ -99,38 +115,61 @@ To learn what’s new in this release, refer to [Feature Highlights]({% link rel
- {% for s in sections %} {% comment %} For each major version, iterate through the sections. {% endcomment %} - - {% assign releases = site.data.releases | where_exp: "releases", "releases.major_version == v.major_version" | where_exp: "releases", "releases.release_type == s" | sort: "release_date" | reverse %} {% comment %} Fetch all releases for that major version based on release type (Production/Testing). {% endcomment %} - -{% comment %}Do a separate loop through the releases and for each release, copy some fields into some local v_ variables to use when we are not in a loop below{% endcomment %} - - {% assign v_linux_arm = false %} - {% for r in releases %} - {% if r.linux.linux_arm == true %} - {% assign v_linux_arm = true %} - {% break %} - {% endif %} - {% endfor %} - - {% assign v_mac_arm = false %} - {% for r in releases %} - {% if r.mac.mac_arm == true %} - {% assign v_mac_arm = true %} - {% break %} - {% endif %} - {% endfor %} - - {% assign v_docker_arm = false %} - {% for r in releases %} - {% if r.docker.docker_arm == true %} - {% assign v_docker_arm = true %} - {% break %} - {% endif %} - {% endfor %} - - {% if releases[0] %} - + {% for s in sections %} {% comment %} For each major version, iterate through the sections. {% endcomment %} + + {% assign releases = site.data.releases | where_exp: "releases", "releases.major_version == v.major_version" | where_exp: "releases", "releases.release_type == s" | sort: "release_date" | reverse %} {% comment %} Fetch all releases for that major version based on release type (Production/Testing). {% endcomment %} + + {% comment %} Filter the releases to only include unsupported ones {% endcomment %} + {% assign unsupported_releases = "" | split: "" %} + {% for r in releases %} + {% assign is_release_unsupported = false %} + + {% if is_unsupported %} + {% comment %} If the whole version is unsupported, all releases are unsupported {% endcomment %} + {% assign is_release_unsupported = true %} + {% elsif has_lts_releases and s == "Production" and in_lts_period and ga_support_expired %} + {% capture current_patch_string %}{{ r.release_name | split: '.' | shift | shift }}{% endcapture %} + {% assign current_patch = current_patch_string | times: 1 %} + + {% if current_patch < lts_patch %} + {% comment %} Pre-LTS patches are unsupported in LTS period if GA support expired {% endcomment %} + {% assign is_release_unsupported = true %} + {% endif %} + {% endif %} + + {% comment %} Don't include withdrawn releases in the unsupported list {% endcomment %} + {% if r.withdrawn != true and is_release_unsupported %} + {% assign unsupported_releases = unsupported_releases | push: r %} + {% endif %} + {% endfor %} + + {% comment %}Do a separate loop through the filtered releases and for each release, copy some fields into some local v_ variables to use when we are not in a loop below{% endcomment %} + {% assign v_linux_arm = false %} + {% for r in unsupported_releases %} + {% if r.linux.linux_arm == true %} + {% assign v_linux_arm = true %} + {% break %} + {% endif %} + {% endfor %} + + {% assign v_mac_arm = false %} + {% for r in unsupported_releases %} + {% if r.mac.mac_arm == true %} + {% assign v_mac_arm = true %} + {% break %} + {% endif %} + {% endfor %} + + {% assign v_docker_arm = false %} + {% for r in unsupported_releases %} + {% if r.docker.docker_arm == true %} + {% assign v_docker_arm = true %} + {% break %} + {% endif %} + {% endfor %} + + {% if unsupported_releases.size > 0 %} + #### {{ s }} Releases
@@ -139,6 +178,7 @@ To learn what’s new in this release, refer to [Feature Highlights]({% link rel Version + Date Intel 64-bit Downloads {% if v_linux_arm == true %} @@ -147,326 +187,354 @@ To learn what’s new in this release, refer to [Feature Highlights]({% link rel - {% for r in releases %} - - {% assign current_patch_string = '' %} - {% assign current_patch = nil %} - {% assign in_lts = false %} - {% if has_lts_releases == true and s == "Production" %} - {% capture current_patch_string %}{{ r.release_name | split: '.' | shift | shift }}{% endcapture %} - {% assign current_patch = current_patch_string | times: 1 %}{% comment %}Cast string to integer {% endcomment %} - {% if current_patch == nil %} - Error: Could not determine the current patch. Giving up.
- {% break %}{% break %} - {% endif %} - - {% assign comparison = current_patch | minus: lts_patch %} - {% unless comparison < 0 %} - {% assign in_lts = true %} - {% endunless %} + {% for r in unsupported_releases %} + + {% assign current_patch_string = '' %} + {% assign current_patch = nil %} + {% assign in_lts = false %} + {% if has_lts_releases == true and s == "Production" %} + {% capture current_patch_string %}{{ r.release_name | split: '.' | shift | shift }}{% endcapture %} + {% assign current_patch = current_patch_string | times: 1 %}{% comment %}Cast string to integer {% endcomment %} + {% if current_patch == nil %} + Error: Could not determine the current patch. Giving up.
+ {% break %}{% break %} + {% endif %} + + {% assign comparison = current_patch | minus: lts_patch %} + {% unless comparison < 0 %} + {% assign in_lts = true %} + {% endunless %} + {% endif %} + + + + {{ r.release_name }}{% if in_lts %}{{ lts_link }}{% endif %} + + + {{ r.release_date }} {% comment %} Release date of the release. {% endcomment %} + {% if r.withdrawn == true %} {% comment %} Suppress download links for withdrawn releases. {% endcomment %} + Withdrawn{% comment %}covers both Intel and ARM columns {% endcomment %} + {% continue %} + {% elsif r.cloud_only == true %} {% comment %} Suppress download links for Cloud-first releases {% endcomment %} + {{ r.cloud_only_message_short }} + {% continue %} + {% elsif version_past_unsupported_date == true %} {% comment %} Suppress download links for outdated versions or if past unsupported date. {% endcomment %} + {{ is_not_downloadable_message }} + {% continue %} + {% else %} {% comment %} Add download links for all non-withdrawn versions. {% endcomment %} + +
Full Binary{% if r.has_sha256sum == true %} (SHA256){% endif %}
{% comment %} If a sha256sum is available for a particular release, we display a link to the file containing the sha256sum alongside the download link of the release. {% endcomment %} + {% if r.has_sql_only == true %} +
SQL Shell Binary{% if r.has_sha256sum == true %} (SHA256{% endif %})
{% comment %} If a sha256sum is available for a particular release, we display a link to the file containing the sha256sum alongside the download link of the release. {% endcomment %} + {% endif %} + {% endif %} + {% if r.linux.linux_arm == true and v_linux_arm == true %} + {% comment %}Don't print column because of previous colspan=2{% endcomment %} + {% if r.withdrawn == true or r.cloud_only == true or version_past_unsupported_date == true %} + {% break %} + {% else %} + + {% if r.linux.linux_arm_experimental == true %}Experimental:{% endif %} +
Full Binary{% if r.has_sha256sum == true %} (SHA256{% endif %})
{% comment %} If a sha256sum is available for a particular release, we display a link to the file containing the sha256sum alongside the download link of the release. {% endcomment %} + {% if r.has_sql_only == true %} +
SQL shell Binary{% if r.has_sha256sum == true %} (SHA256){% endif %}
{% comment %} If a sha256sum is available for a particular release, we display a link to the file containing the sha256sum alongside the download link of the release. {% endcomment %} + {% endif %} + + {% endif %} + {% endif %} + + {% endfor %} {% comment %}Releases {% endcomment %} + + +
+ +
+ + macOS downloads are **experimental**. Experimental downloads are not yet qualified for production use and not eligible for support or uptime SLA commitments, whether they are for testing releases or production releases. + + + + + + + + + {% if v_mac_arm == true %} + {% endif %} - - {% if DEBUG == true %}{% endif %} - - {% comment %} Add "Latest" class to release if it's the latest release. {% endcomment %} - + + + {% for r in unsupported_releases %} + {% assign current_patch_string = '' %} + {% assign current_patch = nil %} + {% assign in_lts = false %} + {% if has_lts_releases == true and s == "Production" %} + {% capture current_patch_string %}{{ r.release_name | split: '.' | shift | shift }}{% endcapture %} + {% assign current_patch = current_patch_string | times: 1 %} + {% assign comparison = current_patch | minus: lts_patch %} + {% unless comparison < 0 %} + {% assign in_lts = true %} + {% endunless %} + {% endif %} + + + + + {% comment %} Release date of the release. {% endcomment %} + {% if r.withdrawn == true %} {% comment %} Suppress withdrawn releases. {% endcomment %} + {% comment %}covers both Intel and ARM columns {% endcomment %} + {% continue %} + {% elsif r.cloud_only == true %} {% comment %} Suppress download links for Cloud-first releases {% endcomment %} + + {% continue %} + {% elsif version_past_unsupported_date == true %} {% comment %} Suppress download links for outdated versions or if past unsupported date. {% endcomment %} + + {% continue %} + {% else %} {% comment %} Add download links for all non-withdrawn versions. {% endcomment %} + + {% endif %} + {% endif %} + + {% endfor %} + +
VersionDateIntel 64-bit (Experimental) DownloadsARM 64-bit (Experimental) Downloads
current_patch: {{ current_patch }}
lts_patch: {{ lts_patch }}
r.release_name: {{ r.release_name }}
lts_link: {{ lts_link }}
in_lts: {{ in_lts }}
- {{ r.release_name }}{% if in_lts == true %}{{ lts_link }}{% endif %}{% comment %} Add link to each release r, decorate with link about LTS if applicable. {% endcomment %} - {% if r.release_name == latest_hotfix.release_name %} - Latest {% comment %} Add "Latest" badge to release if it's the latest release. {% endcomment %} +
+ {{ r.release_name }}{% if in_lts %}{{ lts_link }}{% endif %} + {{ r.release_date }}Withdrawn{{ r.cloud_only_message_short }}{{ is_not_downloadable_message }} +
Full Binary{% if r.has_sha256sum == true %} (SHA256){% endif %}
{% comment %} If a sha256sum is available for a particular release, we display a link to the file containing the sha256sum alongside the download link of the release. {% endcomment %} + {% if r.has_sql_only == true %} +
SQL shell Binary{% if r.has_sha256sum == true %} (SHA256){% endif %}
{% comment %} If a sha256sum is available for a particular release, we display a link to the file containing the sha256sum alongside the download link of the release. {% endcomment %} + {% endif %} + {% endif %} + {% if r.mac.mac_arm == true and v_mac_arm == true %} + {% comment %}Don't print column because of previous colspan=2{% endcomment %} + {% if r.withdrawn == true or r.cloud_only == true or version_past_unsupported_date == true %} + {% break %} + {% else %} + 		+
Full Binary{% if r.has_sha256sum == true %} (SHA256){% endif %}
+ {% if r.has_sql_only == true %} +
SQL shell Binary{% if r.has_sha256sum == true %} (SHA256){% endif %}
+ {% endif %} +
+ +
+ +
+ Windows 8 or higher is required. Windows downloads are **experimental**. Experimental downloads are not yet qualified for production use and not eligible for support or uptime SLA commitments, whether they are for testing releases or production releases. + + + + + + + + + + + + {% for r in unsupported_releases %} + {% assign current_patch_string = '' %} + {% assign current_patch = nil %} + {% assign in_lts = false %} + {% if has_lts_releases == true and s == "Production" %} + {% capture current_patch_string %}{{ r.release_name | split: '.' | shift | shift }}{% endcapture %} + {% assign current_patch = current_patch_string | times: 1 %} + {% assign comparison = current_patch | minus: lts_patch %} + {% unless comparison < 0 %} + {% assign in_lts = true %} + {% endunless %} + {% endif %} + + + + + {% comment %} Release date of the release. {% endcomment %} + {% if r.withdrawn == true %} {% comment %} Suppress withdrawn releases. {% endcomment %} + + {% continue %} + {% elsif r.cloud_only == true %} {% comment %} Suppress download links for Cloud-first releases {% endcomment %} + + {% continue %} + {% elsif version_past_unsupported_date == true %} {% comment %} Suppress download links for outdated versions or if past unsupported date. {% endcomment %} + + {% continue %} + {% else %} {% comment %} Add download links for all non-withdrawn versions. {% endcomment %} + + + {% endfor %} + +
VersionDateIntel 64-bit (Experimental) Downloads
+ {{ r.release_name }}{% if in_lts %}{{ lts_link }}{% endif %} + {{ r.release_date }}Withdrawn{{ r.cloud_only_message_short }}{{ is_not_downloadable_message }} + {% if r.windows == true %} +
Full Binary{% if r.has_sha256sum == true %} (SHA256){% endif %}
{% comment %} If a sha256sum is available for a particular release, we display a link to the file containing the sha256sum alongside the download link of the release. {% endcomment %} + {% if r.has_sql_only == true %} +
SQL shell Binary{% if r.has_sha256sum == true %} (SHA256){% endif %}
{% comment %} If a sha256sum is available for a particular release, we display a link to the file containing the sha256sum alongside the download link of the release. {% endcomment %} + {% endif %} + {% else %} + N/A + {% endif %} + {% endif %} +
+
+ +
+ + {% comment %}Prepare to show the Notes column in v22.2 and v23.1{% endcomment %} + {% assign show_notes_column = false %} + {% if v.major_version == "v23.1" or v.major_version == "v22.2" %} + {% assign show_notes_column = true %} {% endif %} - - {{ r.release_date }} {% comment %} Release date of the release. {% endcomment %} - {% if r.withdrawn == true %} {% comment %} Suppress download links for withdrawn releases. {% endcomment %} - Withdrawn{% comment %}covers both Intel and ARM columns {% endcomment %} - {% continue %} - {% elsif r.cloud_only == true %} {% comment %} Suppress download links for Cloud-first releases {% endcomment %} - {{ r.cloud_only_message_short }} - {% continue %} - {% elsif r.is_not_downloadable == true %} {% comment %} Suppress download links for outdated versions. {% endcomment %} - {{ is_not_downloadable_message }} - {% continue %} - {% else %} {% comment %} Add download links for all non-withdrawn versions. {% endcomment %} - -
Full Binary{% if r.has_sha256sum == true %} (SHA256){% endif %}
{% comment %} If a sha256sum is available for a particular release, we display a link to the file containing the sha256sum alongside the download link of the release. {% endcomment %} - {% if r.has_sql_only == true %} -
SQL Shell Binary{% if r.has_sha256sum == true %} (SHA256{% endif %})
{% comment %} If a sha256sum is available for a particular release, we display a link to the file containing the sha256sum alongside the download link of the release. {% endcomment %} + + {% if s == "Production" %}{% comment %}Print this only for the Production section{% endcomment %} + Docker images for CockroachDB are published on [Docker Hub](https://hub.docker.com/r/cockroachdb/cockroach/tags). + + {% if show_notes_column == true %} + [Multi-platform images](https://docs.docker.com/build/building/multi-platform/) include support for both Intel and ARM. + {% else %} + All Docker images for {{ v.major_version }} are [Multi-platform images](https://docs.docker.com/build/building/multi-platform/) with support for both Intel and ARM. {% endif %} {% endif %} - {% if r.linux.linux_arm == true %} - {% comment %}Don't print column because of previous colspan=2{% endcomment %} - {% if r.withdrawn == true or r.cloud_only == true or r.is_not_downloadable == true %} - {% break %} + + + + + + + + + {% if show_notes_column == true %}{% endif %} + + + + {% for r in unsupported_releases %} + + {% assign current_patch_string = '' %} + {% assign current_patch = nil %} + {% assign in_lts = false %} + {% if has_lts_releases == true and s == "Production" %} + {% capture current_patch_string %}{{ r.release_name | split: '.' | shift | shift }}{% endcapture %} + {% assign current_patch = current_patch_string | times: 1 %} + {% if current_patch == nil %} + Error: Could not determine the current patch. Giving up.
+ {% break %}{% break %} + {% endif %} + + {% assign comparison = current_patch | minus: lts_patch %} + {% unless comparison < 0 %} + {% assign in_lts = true %} + {% endunless %} + {% endif %} + + + + {% comment %}Version column{% endcomment %} + + + {% comment %}Support Status column{% endcomment %} + + + {% comment %}Release Date column{% endcomment %} + {% comment %} Release date of the release. {% endcomment %} + + {% comment %}Docker Image Tag column{% endcomment %} + {% comment %} Suppress download links for withdrawn releases, spans Intel and ARM columns {% endcomment %} + {% elsif r.cloud_only == true %} {% comment %} Suppress download links for Cloud-first releases, spans Intel and ARM columns {% endcomment %} + {{ r.cloud_only_message_short }} + {% elsif version_past_unsupported_date == true %} {% comment %} Suppress download links for outdated versions or if past unsupported date. {% endcomment %} + {{ is_not_downloadable_message }} + {% continue %} {% else %} - {% endif %} - {% endif %} - - {% endfor %} {% comment %}Releases {% endcomment %} - -
VersionDateDocker image tagNotes
{{ r.release_name }}{% if in_lts %}{{ lts_link }}{% endif %} + {{ r.release_date }} + {% if r.withdrawn == true %} + Withdrawn - {% if r.linux.linux_arm_experimental == true %}Experimental:{% endif %} -
Full Binary{% if r.has_sha256sum == true %} (SHA256{% endif %})
{% comment %} If a sha256sum is available for a particular release, we display a link to the file containing the sha256sum alongside the download link of the release. {% endcomment %} - {% if r.has_sql_only == true %} -
SQL shell Binary{% if r.has_sha256sum == true %} (SHA256){% endif %}
{% comment %} If a sha256sum is available for a particular release, we display a link to the file containing the sha256sum alongside the download link of the release. {% endcomment %} + {% if r.source == false %} + N/A + {% else %} + {% if show_notes_column == true %}{% comment %}Show Intel and ARM details only for major versions with a mix{% endcomment %} + {% if r.docker.docker_arm == false %}Intel:
{% else %}Multi-platform:
{% endif %} + {% endif %}{{ r.docker.docker_image }}:{{ r.release_name }} {% endif %} -
-
- -
- -macOS downloads are **experimental**. Experimental downloads are not yet qualified for production use and not eligible for support or uptime SLA commitments, whether they are for testing releases or production releases. - - - - - - - - {% if v_mac_arm == true %} - - {% endif %} - - - - {% for r in releases %} - - {% comment %} Add "Latest" class to release if it's the latest release. {% endcomment %} - - {% comment %} Release date of the release. {% endcomment %} - {% if r.withdrawn == true %} {% comment %} Suppress withdrawn releases. {% endcomment %} - {% comment %}covers both Intel and ARM columns {% endcomment %} - {% continue %} - {% elsif r.cloud_only == true %} {% comment %} Suppress download links for Cloud-first releases {% endcomment %} - - {% continue %} - {% elsif r.is_not_downloadable == true %} {% comment %} Suppress download links for outdated versions. {% endcomment %} - - {% continue %} - {% else %} {% comment %} Add download links for all non-withdrawn versions. {% endcomment %} - + {% if show_notes_column == true %} + {% comment %}Notes column{% endcomment %} + {% endif %} - {% endif %} - {% if r.mac.mac_arm == true %} - {% comment %}Don't print column because of previous colspan=2{% endcomment %} - {% if r.withdrawn == true or r.cloud_only == true or r.is_not_downloadable == true %} - {% break %} - {% else %} - + {% endfor %} + +
VersionDateIntel 64-bit (Experimental) DownloadsARM 64-bit (Experimental) Downloads
- {{ r.release_name }} {% comment %} Add link to each release r. {% endcomment %} - {% if r.release_name == latest_hotfix.release_name %} - Latest {% comment %} Add "Latest" badge to release if it's the latest release. {% endcomment %} - {% endif %} - {{ r.release_date }}Withdrawn{{ r.cloud_only_message_short }}{{ is_not_downloadable_message }} -
Full Binary{% if r.has_sha256sum == true %} (SHA256){% endif %}
{% comment %} If a sha256sum is available for a particular release, we display a link to the file containing the sha256sum alongside the download link of the release. {% endcomment %} - {% if r.has_sql_only == true %} -
SQL shell Binary{% if r.has_sha256sum == true %} (SHA256){% endif %}
{% comment %} If a sha256sum is available for a particular release, we display a link to the file containing the sha256sum alongside the download link of the release. {% endcomment %} + 		+ {% if r.docker.docker_arm_limited_access == true %} + **Intel**: Production
**ARM**: Limited Access + {% elsif r.docker.docker_arm_experimental == true %} + **Intel**: Production
**ARM**: Experimental + {% else %} + Production + {% endif %} + 		-
Full Binary{% if r.has_sha256sum == true %} (SHA256){% endif %}
- {% if r.has_sql_only == true %} -
SQL shell Binary{% if r.has_sha256sum == true %} (SHA256){% endif %}
+
+
+ +
+

The source code for CockroachDB is hosted in the cockroachdb/cockroach repository on Github.

+ + + + + + + + + + + {% for r in unsupported_releases %} + {% assign current_patch_string = '' %} + {% assign current_patch = nil %} + {% assign in_lts = false %} + {% if has_lts_releases == true and s == "Production" %} + {% capture current_patch_string %}{{ r.release_name | split: '.' | shift | shift }}{% endcapture %} + {% assign current_patch = current_patch_string | times: 1 %} + {% assign comparison = current_patch | minus: lts_patch %} + {% unless comparison < 0 %} + {% assign in_lts = true %} + {% endunless %} {% endif %} - - {% endif %} - {% endif %} - - {% endfor %} - -
VersionDateSource
- -
- -
- Windows 8 or higher is required. Windows downloads are **experimental**. Experimental downloads are not yet qualified for production use and not eligible for support or uptime SLA commitments, whether they are for testing releases or production releases. - - - - - - - - - - - {% for r in releases %} - - - {% comment %} Add "Latest" class to release if it's the latest release. {% endcomment %} - - {% comment %} Release date of the release. {% endcomment %} - {% if r.withdrawn == true %} {% comment %} Suppress withdrawn releases. {% endcomment %} - {% comment %}covers both Intel and ARM columns {% endcomment %} - {% continue %} - {% elsif r.cloud_only == true %} {% comment %} Suppress download links for Cloud-first releases {% endcomment %} - - {% continue %} - {% elsif r.is_not_downloadable == true %} {% comment %} Suppress download links for outdated versions. {% endcomment %} - - {% continue %} - {% else %} {% comment %} Add download links for all non-withdrawn versions. {% endcomment %} - + + + {% comment %} Release date of the release. {% endcomment %} + {% if r.withdrawn == true %} {% comment %} Suppress withdrawn releases. {% endcomment %} + + {% continue %} + {% elsif r.cloud_only == true %} {% comment %} Suppress download links for Cloud-first releases {% endcomment %} + + {% continue %} + {% elsif version_past_unsupported_date == true %} {% comment %} Suppress download links for outdated versions or if past unsupported date. {% endcomment %} + + {% continue %} + {% else %} {% comment %} Add download links for all non-withdrawn versions. {% endcomment %} + {% endif %} - {% endif %} - - - {% endfor %} - -
VersionDateIntel 64-bit (Experimental) Downloads
- {{ r.release_name }} {% comment %} Add link to each release r. {% endcomment %} - {% if r.release_name == latest_hotfix.release_name %} - Latest {% comment %} Add "Latest" badge to release if it's the latest release. {% endcomment %} - {% endif %} - {{ r.release_date }}Withdrawn{{ r.cloud_only_message_short }}{{ is_not_downloadable_message }} - {% if r.windows == true %} -
Full Binary{% if r.has_sha256sum == true %} (SHA256){% endif %}
{% comment %} If a sha256sum is available for a particular release, we display a link to the file containing the sha256sum alongside the download link of the release. {% endcomment %} - {% if r.has_sql_only == true %} -
SQL shell Binary{% if r.has_sha256sum == true %} (SHA256){% endif %}
{% comment %} If a sha256sum is available for a particular release, we display a link to the file containing the sha256sum alongside the download link of the release. {% endcomment %} + +
+ {{ r.release_name }}{% if in_lts %}{{ lts_link }}{% endif %} + {{ r.release_date }}Withdrawn{{ r.cloud_only_message_short }}{{ is_not_downloadable_message }} + {% if r.source == true %} + View on Github + {% else %} + N/A {% endif %} - {% else %} - N/A +
-
- -
- - {% comment %}Prepare to show the Notes column in v22.2 and v23.1{% endcomment %} - {% assign show_notes_column = false %} - {% if v.major_version == "v23.1" or v.major_version == "v22.2" %} - {% assign show_notes_column = true %} - {% endif %} - - {% if s == "Production" %}{% comment %}Print this only for the Production section{% endcomment %} - Docker images for CockroachDB are published on [Docker Hub](https://hub.docker.com/r/cockroachdb/cockroach/tags). - - {% if show_notes_column == true %} - [Multi-platform images](https://docs.docker.com/build/building/multi-platform/) include support for both Intel and ARM. - {% else %} - All Docker images for {{ v.major_version }} are [Multi-platform images](https://docs.docker.com/build/building/multi-platform/) with support for both Intel and ARM. - {% endif %} - {% endif %} - - - - - - - - {% if show_notes_column == true %}{% endif %} - - - - {% for r in releases %} - - {% assign current_patch_string = '' %} - {% assign current_patch = nil %} - {% assign in_lts = false %} - {% if has_lts_releases == true and s == "Production" %} - {% capture current_patch_string %}{{ r.release_name | split: '.' | shift | shift }}{% endcapture %} - {% assign current_patch = current_patch_string | times: 1 %}{% comment %}Cast string to integer {% endcomment %} - {% if current_patch == nil %} - Error: Could not determine the current patch. Giving up.
- {% break %}{% break %} - {% endif %} - - {% assign comparison = current_patch | minus: lts_patch %} - {% unless comparison < 0 %} - {% assign in_lts = true %} - {% endunless %} - {% endif %} - - {% comment %} Add "Latest" class to release if it's the latest release. {% endcomment %} - - {% comment %}Version column{% endcomment %} - - - {% comment %}Release Date column{% endcomment %} - {% comment %} Release date of the release. {% endcomment %} - - {% comment %}Docker Image Tag column{% endcomment %} - {% comment %} Suppress download links for withdrawn releases, spans Intel and ARM columns {% endcomment %} - {% elsif r.cloud_only == true %} {% comment %} Suppress download links for Cloud-first releases, spans Intel and ARM columns {% endcomment %} - {{ r.cloud_only_message_short }} - {% elsif r.is_not_downloadable == true %} {% comment %} Suppress download links for outdated versions. {% endcomment %} - {{ is_not_downloadable_message }} - {% continue %} - {% else %} - {% if r.source == false %} - N/A - {% else %} - {% if show_notes_column == true %}{% comment %}Show Intel and ARM details only for major versions with a mix{% endcomment %} - {% if r.docker.docker_arm == false %}Intel:
{% else %}Multi-platform:
{% endif %} - {% endif %}{{ r.docker.docker_image }}:{{ r.release_name }} - {% endif %} - {% endif %} - - {% if show_notes_column == true %} - {% comment %}Notes column{% endcomment %} - - {% endif %} - - {% endfor %} - -
VersionDateDocker image tagNotes
{{ r.release_name }}{% if in_lts == true %}{{ lts_link }}{% endif %}{% comment %} Add link to each release r.{% endcomment %} - {% if r.release_name == latest_hotfix.release_name %} - Latest {% comment %} Add "Latest" badge to release if it's the latest release. {% endcomment %} - {% endif %} - {{ r.release_date }} - {% if r.withdrawn == true %} - Withdrawn - {% if r.docker.docker_arm_limited_access == true %} - **Intel**: Production
**ARM**: Limited Access - {% elsif r.docker.docker_arm_experimental == true %} - **Intel**: Production
**ARM**: Experimental - {% else %} - Production - {% endif %} -
-
- -
-

The source code for CockroachDB is hosted in the cockroachdb/cockroach repository on Github.

- - - - - - - - - - {% for r in releases %} - - {% comment %} Add "Latest" class to release if it's the latest release. {% endcomment %} - - {% comment %} Release date of the release. {% endcomment %} - {% if r.withdrawn == true %} {% comment %} Suppress withdrawn releases. {% endcomment %} - - {% continue %} - {% elsif r.cloud_only == true %} {% comment %} Suppress download links for Cloud-first releases {% endcomment %} - - {% continue %} - {% elsif r.is_not_downloadable == true %} {% comment %} Suppress download links for outdated versions. {% endcomment %} - - {% continue %} - {% else %} {% comment %} Add download links for all non-withdrawn versions. {% endcomment %} - - {% endif %} - - {% endfor %} {% comment %}for release in releases{% endcomment %} - -
VersionDateSource
- {{ r.release_name }}{% comment %} Add link to each release r {% endcomment %} - {% if r.release_name == latest_hotfix.release_name %} - Latest {% comment %} Add "Latest" badge to release if it's the latest release. {% endcomment %} - {% endif %} - {{ r.release_date }}Withdrawn{{ r.cloud_only_message_short }}{{ is_not_downloadable_message }} - {% if r.source == true %} - View on Github - {% else %} - N/A - {% endif %} -
-
- - - {% endif %} {% comment %}if releases[0]{% endcomment %} - {% endfor %} {% comment %}for s in sections {% endcomment %} -{% endfor %} {% comment %}for v in versions{% endcomment %} + + {% endfor %} {% comment %}for release in releases{% endcomment %} + + + + + + {% endif %} {% comment %}if unsupported_releases.size > 0{% endcomment %} + {% endfor %} {% comment %}for s in sections {% endcomment %} + {% endif %} {% comment %}if is_unsupported or has_unsupported_releases{% endcomment %} + {% endif %} {% comment %}if released{% endcomment %} +{% endfor %} {% comment %}for v in versions{% endcomment %} \ No newline at end of file