Skip to content

Commit

Permalink
Merge branch 'main' into sass_warning_fix
Browse files Browse the repository at this point in the history
  • Loading branch information
mohini-crl authored Nov 4, 2024
2 parents 0a91532 + 53b2b76 commit e77683d
Show file tree
Hide file tree
Showing 195 changed files with 2,674 additions and 2,643 deletions.
8 changes: 8 additions & 0 deletions src/current/_data/redirects.yml
Original file line number Diff line number Diff line change
Expand Up @@ -195,6 +195,10 @@
sources: ['create-a-free-cluster.md']
versions: ['cockroachcloud']

- destination: demo-cockroachdb-resilience.md
sources: ['demo-fault-tolerance-and-recovery.md']
versions: ['v24.2', 'v24.3']

- destination: demo-low-latency-multi-region-deployment.md
sources: ['demo-geo-partitioning.md']
versions: ['v19.2', 'v20.1', 'v20.2', 'v21.1']
Expand Down Expand Up @@ -687,6 +691,10 @@
- destination: cockroachcloud/serverless-resource-usage.md
sources: ['cockroachcloud/serverless-benchmarking.md']

- destination: cockroachcloud/upgrade-cockroach-version.md
sources: ['cockroachcloud/upgrade-to-v*.md']
versions: [cockroachcloud]

- destination: community-tooling.md
sources:
- build-a-c++-app-with-cockroachdb.md
Expand Down
56 changes: 56 additions & 0 deletions src/current/_data/releases.yml
Original file line number Diff line number Diff line change
Expand Up @@ -7024,3 +7024,59 @@
docker_arm_limited_access: false
source: true
previous_release: v24.3.0-alpha.2


- release_name: v24.3.0-beta.2
major_version: v24.3
release_date: '2024-10-28'
release_type: Testing
go_version: go1.22.5
sha: 36f5b311f33775bbeb26d56003f6831ec9ddd837
has_sql_only: true
has_sha256sum: true
mac:
mac_arm: true
mac_arm_experimental: true
mac_arm_limited_access: false
windows: true
linux:
linux_arm: true
linux_arm_experimental: false
linux_arm_limited_access: false
linux_intel_fips: true
linux_arm_fips: false
docker:
docker_image: cockroachdb/cockroach-unstable
docker_arm: true
docker_arm_experimental: false
docker_arm_limited_access: false
source: true
previous_release: v24.3.0-beta.1

- release_name: v23.2.14
major_version: v23.2
release_date: '2024-10-31'
release_type: Production
go_version: go1.22.5
sha: de12bb882dd1a9d55484b8c45829dbd51f0345bb
has_sql_only: true
has_sha256sum: true
mac:
mac_arm: true
mac_arm_experimental: true
mac_arm_limited_access: false
windows: true
linux:
linux_arm: true
linux_arm_experimental: false
linux_arm_limited_access: false
linux_intel_fips: true
linux_arm_fips: false
docker:
docker_image: cockroachdb/cockroach
docker_arm: true
docker_arm_experimental: false
docker_arm_limited_access: false
source: true
previous_release: v23.2.13

2 changes: 1 addition & 1 deletion src/current/_data/versions.csv
Original file line number Diff line number Diff line change
Expand Up @@ -15,4 +15,4 @@ v23.1,2023-05-15,2024-05-15,2024-11-15,23.1.11,23.1.12,2023-11-13,2024-11-13,202
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,N/A,N/A,N/A,N/A,N/A,N/A,N/A,N/A,v24.2,master
v24.3,N/A,N/A,N/A,N/A,N/A,N/A,N/A,N/A,v24.2,master
2 changes: 1 addition & 1 deletion src/current/_includes/cockroachcloud/app/see-also-links.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@ You might also be interested in the following pages:

- [Client Connection Parameters]({% link {{site.current_cloud_version}}/connection-parameters.md %})
- [Data Replication]({% link {{site.current_cloud_version}}/demo-data-replication.md %})
- [Fault Tolerance & Recovery]({% link {{site.current_cloud_version}}/demo-fault-tolerance-and-recovery.md %})
- [CockroachDB Resilience]({% link {{site.current_cloud_version}}/demo-cockroachdb-resilience.md %})
- [Automatic Rebalancing]({% link {{site.current_cloud_version}}/demo-automatic-rebalancing.md %})
- [Cross-Cloud Migration]({% link {{site.current_cloud_version}}/demo-automatic-cloud-migration.md %})
- [Automated Operations]({% link {{site.current_cloud_version}}/orchestrate-a-local-cluster-with-kubernetes-insecure.md %})
4 changes: 2 additions & 2 deletions src/current/_includes/nav-customers.html
Original file line number Diff line number Diff line change
Expand Up @@ -17,11 +17,11 @@
<div class="col-md-4">

<div class="nav-img-holder">
<a href="https://www.cockroachlabs.com/img/roachfest/">
<a href="https://www.cockroachlabs.com/roachfest/2024/route/">
<img class="img-fluid" src="https://www.cockroachlabs.com/_next/image/?url=https%3A%2F%2Fimages.ctfassets.net%2F00voh0j35590%2F6Hygwj2aq4FNoh33KsYxbW%2F5a88d4b5fd2c194728406f46eda43b03%2FRoute_nav_ad.png&w=1920&q=75" alt="Roachfest"/>
</a>
</div>

</div>
</div>
</div>
</div>
6 changes: 3 additions & 3 deletions src/current/_includes/releases/testing-release-details.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,3 @@
- For **CockroachDB {{ site.data.products.core }}**: All {{ include.major_version.major_version }} testing binaries and Docker images are available for download.
- For **CockroachDB {{ site.data.products.dedicated }}**: {% if page.pre_production_preview == 'true' %}Until the {{ include.major_version.major_version }}.0 GA release, a {{ include.major_version.major_version }} beta or release candidate (RC) testing release is available as part of a series of [Pre-Production Preview](http://cockroachlabs.com/docs/cockroachcloud/upgrade-policy#pre-production-preview) releases.{% else %}{{ include.major_version.major_version }} testing releases are not available.{% endif %}
- For **CockroachDB {{ site.data.products.serverless }}**: {{ include.major_version.major_version }} testing releases are not available.
- **CockroachDB {{ site.data.products.core }}**: All {{ include.major_version.major_version }} testing binaries and Docker images are available for download.
- **CockroachDB {{ site.data.products.advanced }}**: {% if page.pre_production_preview == 'true' %}Until the {{ include.major_version.major_version }}.0 GA release, a series of {{ include.major_version.major_version }} beta and release candidate (RC) testing releases are available as [Pre-Production Preview]({% link cockroachcloud/upgrade-policy.md %}#pre-production-preview) releases.{% else %}{{ include.major_version.major_version }} testing releases are not yet available.{% endif %}
- **CockroachDB {{ site.data.products.standard }}** and **{{ site.data.products.basic }}**: {{ include.major_version.major_version }} testing releases are not available.
2 changes: 1 addition & 1 deletion src/current/_includes/releases/testing-release-notice.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,6 +5,6 @@ The releases on this page are testing releases, not supported or intended for pr

{% include releases/testing-release-details.md %}

When a {{ include.major_version.major_version }} release becomes Generally Available, a new {{ include.major_version.major_version }}.0 section on this page will describe key features and additional upgrade considerations.
When {{ include.major_version.major_version }} becomes Generally Available (GA), a new {{ include.major_version.major_version }}.0 section on this page will describe key features and additional upgrade considerations.
{{site.data.alerts.end}}
{% endif %}
11 changes: 11 additions & 0 deletions src/current/_includes/releases/v23.2/v23.2.14.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,11 @@
## v23.2.14

Release Date: October 31, 2024

{% include releases/new-release-downloads-docker-image.md release=include.release %}

<h3 id="v23-2-14-general-changes">General changes</h3>

- Added internal client name options to distinguish backup data transfer bytes from those of other clients, such as changefeeds, for updated CockroachDB Cloud [billing metrics](https://www.cockroachlabs.com/docs/cockroachcloud/costs). [#133753][#133753]

[#133753]: https://github.com/cockroachdb/cockroach/pull/133753
3 changes: 3 additions & 0 deletions src/current/_includes/releases/v24.1/upgrade-finalization.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
During a major-version upgrade, certain features and performance improvements may not be available until the upgrade is finalized.

- {% include v24.1/finalization-required/119894.md version="v24.1" %}
5 changes: 5 additions & 0 deletions src/current/_includes/releases/v24.1/v24.1.0.md
Original file line number Diff line number Diff line change
Expand Up @@ -22,6 +22,7 @@ This section summarizes the most significant user-facing changes in v24.1.0 and
- **Additional information**
- [Backward-incompatible changes](#v24-1-0-backward-incompatible-changes)
- [Deprecations](#v24-1-0-deprecations)
- [Features that require upgrade finalization](#features-that-require-upgrade-finalization)
- [Known limitations](#v24-1-0-known-limitations)
- [Additional resources](#v24-1-0-additional-resources)

Expand Down Expand Up @@ -478,6 +479,10 @@ Before [upgrading to CockroachDB v24.1]({% link v24.1/upgrade-cockroach-version.
- The [`READ COMMITTED`]({% link v24.1/read-committed.md %}) isolation level now requires the cluster to have a valid [enterprise license](https://cockroachlabs.com/docs/v24.1/licensing-faqs#obtain-a-license). Otherwise, transactions which are configured to run as `READ COMMITTED` will be upgraded to [`SERIALIZABLE`]({% link v24.1/demo-serializable.md %}), as described in the next note. [#120154](https://github.com/cockroachdb/cockroach/pull/120154)
- <a id="read-committed-transaction-upgrade"></a>The `sql.txn.read_committed_isolation.enabled` [cluster setting]({% link v24.1/cluster-settings.md %}) is now `true` by default. As a result for enterprise users, [`READ COMMITTED`]({% link v24.1/read-committed.md %}) transactions are **not** automatically upgraded to [`SERIALIZABLE`]({% link v24.1/demo-serializable.md %}), and will run as `READ COMMITTED` by default. On v23.2, refer to the [Upgrades of SQL Transaction Isolation Level]({% link v24.1/ui-sql-dashboard.md %}#upgrades-of-sql-transaction-isolation-level) graph in the DB Console to check whether any transaction is being upgraded from a weaker isolation level to `SERIALIZABLE`, and could therefore run differently on v24.1. [#118479](https://github.com/cockroachdb/cockroach/pull/118479)

<h4 id="features-that-require-upgrade-finalization">Features that require upgrade finalization</h4>

{% include releases/v24.1/upgrade-finalization.md %}

<h4 id="v24-1-0-cluster-settings">Key Cluster Setting Changes</h4>

The following changes should be reviewed prior to upgrading. Default cluster settings will be used unless you have manually set a value for a setting. This can be confirmed by checking the `system.settings` table (`select * from system.settings`) to view the non-default settings.
Expand Down
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
During a major-version upgrade, certain features and performance improvements may not be available until the upgrade is finalized. However, when upgrading to v24.2, all features are available immediately, and no features require finalization.
5 changes: 5 additions & 0 deletions src/current/_includes/releases/v24.2/v24.2.0.md
Original file line number Diff line number Diff line change
Expand Up @@ -19,6 +19,7 @@ This section summarizes the most significant user-facing changes in v24.2.0 and

- **Additional information**
- [Backward-incompatible changes and deprecations](#v24-2-0-backward-incompatible-changes-and-deprecations)
- [Features that require upgrade finalization](#features-that-require-upgrade-finalization)
- [Key cluster setting changes](#v24-2-0-key-cluster-setting-changes)
- [Known limitations](#v24-2-0-known-limitations)
- [Additional resources](#v24-2-0-additional-resources)
Expand Down Expand Up @@ -60,6 +61,10 @@ In CockroachDB Self-Hosted, all available features are free to use unless their

CockroachDB v24.2.0 includes no backward-incompatible changes or deprecations.

<h4 id="features-that-require-upgrade-finalization">Features that require upgrade finalization</h4>

{% include releases/v24.2/upgrade-finalization.md %}

<a name="v24-2-0-cluster-settings"></a>

<h4 id="v24-2-0-key-cluster-setting-changes">Key Cluster Setting Changes</h4>
Expand Down
10 changes: 10 additions & 0 deletions src/current/_includes/releases/v24.3/backward-incompatible.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,10 @@
Before [upgrading to CockroachDB v24.3]({% link v24.3/upgrade-cockroach-version.md %}), be sure to review the following backward-incompatible changes, as well as [key cluster setting changes](#v24-3-0-cluster-settings), and adjust your deployment as necessary.

If you plan to upgrade to v24.3 directly from v24.1 and skip v24.2, be sure to also review the [v24.2 release notes]({% link releases/v24.2.md %}) for backward-incompatible changes from v24.1.

- Upgrading to v24.3 is blocked if no [license]({% link v24.3/licensing-faqs.md %}) is installed, or if a trial/free license is installed with telemetry disabled. [#130576][#130576]

[#130576]: https://github.com/cockroachdb/cockroach/pull/130576

{% comment %}Remove this anchor when it is added to the v24.3.0 GA release notes{% endcomment %}
<a id="v24-3-0-cluster-settings"></a>
5 changes: 5 additions & 0 deletions src/current/_includes/releases/v24.3/deprecations.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
The following deprecations are announced in v24.3. If you plan to upgrade to v24.3 directly from v24.1 and skip v24.2, be sure to also review the [v24.2 release notes]({% link releases/v24.2.md %}) for deprecations.

- The session variable [`enforce_home_region_follower_reads_enabled`]({% link v24.3/session-variables.md %}#enforce-home-region-follower-reads-enabled) is now deprecated, and will be removed in a future release. The related session variable [`enforce_home_region`]({% link v24.3/session-variables.md %}#enforce-home-region) is **not** deprecated. [#129024][#129024]

[#129024]: https://github.com/cockroachdb/cockroach/pull/129024
4 changes: 4 additions & 0 deletions src/current/_includes/releases/v24.3/upgrade-finalization.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,4 @@
During a major-version upgrade, certain features and performance improvements may not be available until the upgrade is finalized.

- A cluster must have an [Enterprise license]({% link {{ page.version.version }}/licensing-faqs.md %}#set-a-license) or a [trial license]({% link {{ page.version.version }}/licensing-faqs.md %}#obtain-a-license) set before an upgrade to {{ page.version.version }} can be finalized.
- New clusters that are initialized for the first time on {{ page.version.version }}, and clusters that are upgraded to {{ page.version.version }} will now have a [zone config]({% link {{ page.version.version }}/configure-zone.md %}) defined for the `timeseries` range if it does not already exist, which specifies the value for `gc.ttlseconds`, but inherits all other attributes from the zone config for the `default` range.
2 changes: 1 addition & 1 deletion src/current/_includes/releases/v24.3/v24.3.0-beta.1.md
Original file line number Diff line number Diff line change
Expand Up @@ -34,7 +34,7 @@ Release Date: October 24, 2024
<h3 id="v24-3-0-beta-1-db-console-changes">DB Console changes</h3>

- The value of the automatic [statistics]({% link v24.3/cost-based-optimizer.md %}#table-statistics) collection cluster setting [`sql.stats.automatic_collection.enabled`]({% link v24.3/cluster-settings.md %}#setting-sql-stats-automatic-collection-enabled) is now in the top right corner of the [**Databases**]({% link v24.3/ui-databases-page.md %}) overview page. [#132269][#132269]
- In the new [**Databases**]({% link v24.3/ui-databases-page.md %}) and [**Tables**]({% link v24.3/ui-databases-page.md %}#tables-view) pages, when cached data is being refreshed, the refresh button will be disabled and its tooltip text will display, `Data is currently refreshing`. [#132462][#132462]
- In the new [**Databases**]({% link v24.3/ui-databases-page.md %}) and [**Tables**]({% link v24.3/ui-databases-page.md %}#tables-list-tab) pages, when cached data is being refreshed, the refresh button will be disabled and its tooltip text will display, `Data is currently refreshing`. [#132462][#132462]

<h3 id="v24-3-0-beta-1-bug-fixes">Bug fixes</h3>

Expand Down
33 changes: 33 additions & 0 deletions src/current/_includes/releases/v24.3/v24.3.0-beta.2.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,33 @@
## v24.3.0-beta.2

Release Date: October 28, 2024

{% include releases/new-release-downloads-docker-image.md release=include.release %}

<h3 id="v24-3-0-beta-2-sql-language-changes">SQL language changes</h3>

- If a table is the destination of a logical data replication stream, then only schema change statements that are deemed safe are allowed on the table. Safe statements are those that do not result in a rebuild of the primary [index]({% link v24.3/indexes.md %}) and do not create an index on a virtual [computed column]({% link v24.3/computed-columns.md %}). [#133266][#133266]

<h3 id="v24-3-0-beta-2-operational-changes">Operational changes</h3>

- The two new metrics `sql.crud_query.count` and `sql.crud_query.started.count` measure the number of [`INSERT`]({% link v24.3/insert.md %})/[`UPDATE`]({% link v24.3/update.md %})/[`DELETE`]({% link v24.3/delete.md %})/[`SELECT`]({% link v24.3/selection-queries.md %}) queries executed and started respectively. [#133198][#133198]
- When creating a logical data replication stream, any [user-defined types]({% link v24.3/create-type.md %}) in the source and destination are now checked for equivalency. This allows for creating a stream that handles user-defined types without needing to use the `WITH SKIP SCHEMA CHECK` option as long as the stream uses `mode = immediate`. [#133274][#133274]
- Logical data replication streams that reference tables with [user-defined types]({% link v24.3/create-type.md %}) can now be created with the `mode = immediate` option. [#133295][#133295]

<h3 id="v24-3-0-beta-2-db-console-changes">DB Console changes</h3>

- The [**SQL Statements**]({% link v24.3/ui-overview-dashboard.md %}#sql-statements) graph on the [**Overview**]({% link v24.3/ui-overview-dashboard.md %}) and [**SQL**]({% link v24.3/ui-sql-dashboard.md %}) dashboard pages in DB Console now show **Total Queries** as a general Queries Per Second (QPS) metric. [#133198][#133198]
- Due to the inaccuracy of the **Range Count** column on the [**Databases** page]({% link v24.3/ui-databases-page.md %}) and the cost incurred to fetch the correct range count for every database in a cluster, this data will no longer be visible. This data is still available via a [`SHOW RANGES`]({% link v24.3/show-ranges.md %}) query. [#133267][#133267]

<h3 id="v24-3-0-beta-2-bug-fixes">Bug fixes</h3>

- Users with the [`admin` role]({% link v24.3/security-reference/authorization.md %}#admin-role) can now run [`ALTER DEFAULT PRIVILEGES FOR target_role ...`]({% link v24.3/alter-default-privileges.md %}) on any `target_role`. Previously, this could result in a privilege error, which is incorrect as `admin`s are allowed to perform any operation. [#133072][#133072]
- [`REASSIGN OWNED BY current_owner_role ...`]({% link v24.3/reassign-owned.md %}) will now transfer ownership of the `public` schema. Previously, it would always skip over the `public` schema even if it was owned by the `current_owner_role`. [#133072][#133072]


[#133072]: https://github.com/cockroachdb/cockroach/pull/133072
[#133198]: https://github.com/cockroachdb/cockroach/pull/133198
[#133266]: https://github.com/cockroachdb/cockroach/pull/133266
[#133267]: https://github.com/cockroachdb/cockroach/pull/133267
[#133274]: https://github.com/cockroachdb/cockroach/pull/133274
[#133295]: https://github.com/cockroachdb/cockroach/pull/133295
30 changes: 6 additions & 24 deletions src/current/_includes/sidebar-data-cockroachcloud.json
Original file line number Diff line number Diff line change
Expand Up @@ -266,30 +266,12 @@
"/cockroachcloud/upgrade-policy.html"
]
},
{
"title": "Upgrade to v21.2",
"urls": [
"/cockroachcloud/upgrade-to-v21.2.html"
]
},
{
"title": "Upgrade to v21.1",
"urls": [
"/cockroachcloud/upgrade-to-v21.1.html"
]
},
{
"title": "Upgrade to v20.2",
"urls": [
"/cockroachcloud/upgrade-to-v20.2.html"
]
},
{
"title": "Upgrade to v20.1",
"urls": [
"/cockroachcloud/upgrade-to-v20.1.html"
]
}
{
"title": "Upgrade a cluster",
"urls": [
"/cockroachcloud/upgrade-cockroach-version.html"
]
}
]
}
]
Expand Down
1 change: 1 addition & 0 deletions src/current/_includes/sidebar-data-v24.3.json
Original file line number Diff line number Diff line change
Expand Up @@ -9,6 +9,7 @@
{% include_cached v24.3/sidebar-data/get-started.json %},
{% include_cached v24.3/sidebar-data/releases.json %},
{% include_cached v24.3/sidebar-data/feature-overview.json %},
{% include_cached v24.3/sidebar-data/resilience.json %},
{% include_cached v24.3/sidebar-data/connect-to-cockroachdb.json %},
{% include_cached v24.3/sidebar-data/migrate.json %},
{% include_cached v24.3/sidebar-data/cloud-deployments.json %},
Expand Down
26 changes: 4 additions & 22 deletions src/current/_includes/v21.2/sidebar-data/manage.json
Original file line number Diff line number Diff line change
Expand Up @@ -429,28 +429,10 @@
]
},
{
"title": "Upgrade to v21.2",
"urls": [
"/cockroachcloud/upgrade-to-v21.2.html"
]
},
{
"title": "Upgrade to v21.1",
"urls": [
"/cockroachcloud/upgrade-to-v21.1.html"
]
},
{
"title": "Upgrade to v20.2",
"urls": [
"/cockroachcloud/upgrade-to-v20.2.html"
]
},
{
"title": "Upgrade to v20.1",
"urls": [
"/cockroachcloud/upgrade-to-v20.1.html"
]
"title": "Upgrade a cluster",
"urls": [
"/cockroachcloud/upgrade-cockroach-version.html"
]
}
]
},
Expand Down
Loading

0 comments on commit e77683d

Please sign in to comment.