Skip to content

Latest commit

 

History

History
116 lines (95 loc) · 6.14 KB

index.md

File metadata and controls

116 lines (95 loc) · 6.14 KB
title summary toc docs_area toc_not_nested
Releases
Release notes for older versions of CockroachDB.
true
releases
true

After downloading your desired release, learn how to install CockroachDB. Also be sure to review Cockroach Labs' Release Support Policy.

{% assign sections = site.data.releases | map: "release_type" | uniq | reverse %} {% comment %} Fetch the list of all release types (currently Testing, Production) {% endcomment %}

{% assign versions = site.data.versions | 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: "withdrawn", "false" | sort: "release_date" | reverse | first %} {% comment %} For the latest GA version, find the latest hotfix that is not withdrawn. {% endcomment %}

{% for v in versions %} {% comment %} Iterate through all major versions {% endcomment %}

{% assign oldreleases = "v1.0,v1.1,v2.0,v2.1,v19.1,v19.2,v20.1" | split: "," %}

{% if oldreleases contains v.major_version %} {% assign old_release_format = "True" %} {% endif %} {% comment %} For all releases prior to and including 20.1, we use different logic to generate the page (vXX.Y.Z.html vs vXX.Y.html#vXX-Y-Z). {% endcomment %}

{{ v.major_version }}

Linux Mac Windows Docker Source
{% comment %} Show warning about Windows being in experimental mode. {% endcomment %} {% include windows_warning.md %}

{% 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 %}

{% if releases[0] %}

{{ s }} 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 %} {% else %} {% comment %} Add download links for all non-withdrawn versions. {% endcomment %} {% endif %} {% endfor %}
Version Date Download
{{ r.version }} {% comment %} Add link to each release r. {% endcomment %} {% if r.version == latest_hotfix.version %} Latest {% comment %} Add "Latest" badge to release if it's the latest release. {% endcomment %} {% endif %} {{ r.release_date }}Withdrawn
Precompiled 64-bit Binary
Precompiled 64-bit Binary
{% if r.no_windows == "true" %} N/A {% else %} Precompiled 64-bit Binary {% endif %}
cockroachdb/cockroach{% if r.version contains "-" %}-unstable{% endif %}:{{ r.version }}
{% if r.no_source == "true" %} N/A {% else %} Source {% endif %}
{% endif %} {% endfor %} {% endfor %}

Release naming

Cockroach Labs uses a three-component calendar versioning scheme to name production releases of CockroachDB. The format is YY.R.PP, where YY indicates the year, R indicates release with “1” for Spring and “2” for Fall, and PP indicates the patch release version. Example: Version 20.1.1 (abbreviated v20.1.1).

{{site.data.alerts.callout_info}} This calendar versioning scheme began with v19.1. Prior releases use a different versioning scheme. {{site.data.alerts.end}}

  • A major release is produced twice a year indicating major enhancements to product functionality. A change in the YY.R component denotes a major release.

  • A patch (or maintenance) release is produced to roll out critical bug and security fixes. A change in the PP component denotes a patch release.