Merge remote-tracking branch 'origin/cloud-2.0' into DOC-8579

src/current/_config_base.yml

@@ -1,9 +1,11 @@
 algolia:
   application_id: 7RXZLDVR5F
   files_to_exclude:
-  - index.html
-  - index.md
-  - search.html
+    - index.html
+    - index.md
+    - search.html
+    - src/current/v23.1/**
+    - v23.1/**
   index_name: cockroachcloud_docs
   search_api_key: 372a10456f4ed7042c531ff3a658771b
   settings:

src/current/_data/cloud_releases.csv

@@ -75,3 +75,6 @@ date,sha
 2023-12-19,null
 2023-12-21,null
 2024-01-17,null
+2024-01-29,null
+2024-02-05,null
+2024-02-06,null

src/current/_data/products.yml

@@ -2,10 +2,16 @@ serverless: Serverless
 
 dedicated: Dedicated
 
-core: Self-Hosted
-
 dedicated-advanced: Dedicated advanced
 
+core: Self-Hosted
+
 enterprise: Enterprise
 
 cloud: Cloud
+
+basic: Basic
+
+standard: Standard
+
+advanced: Advanced

src/current/_data/redirects.yml

@@ -167,7 +167,7 @@
 
 - destination: cockroach-sql.md
   sources: ['use-the-built-in-sql-client.md']
-  versions: ['v19.2', 'v20.1', 'v20.2', 'v21.1']
+  versions: ['v19.2', 'v20.1', 'v20.2', 'v21.1', 'v21.2', 'v21.2', 'v22.2', 'v23.1', 'v23.2']
 
 - destination: cockroach-sqlfmt.md
   sources: ['use-the-query-formatter.md']
@@ -943,7 +943,7 @@
 - destination: movr-flask-use-case.md
   sources: ['multi-region-use-case.md']
   versions: ['v21.1', 'v21.2', 'v22.1', 'v22.2']
-  
+
 - destination: serverless-resource-usage.md
   sources: ['optimize-serverless-workload.md']
   versions: ['cockroachcloud']

src/current/_data/releases.yml

@@ -5382,18 +5382,10 @@
 
 - release_name: v23.2.0
   major_version: v23.2
-  release_date: '2024-01-17'
+  release_date: '2024-02-05'
   release_type: Production
-  cloud_only: true
-  cloud_only_message_short: 'Available in CockroachDB Dedicated. Self-hosted binaries <a href="https://www.cockroachlabs.com/docs/releases/v23.2#v23-2-0">available February 5</a>.'
-  cloud_only_message: >
-    CockroachDB v23.2 is now generally available for CockroachDB Dedicated,
-    and is scheduled to be made available for CockroachDB Self-Hosted on February 5, 2024.
-    For more information, refer to
-    <a href="https://www.cockroachlabs.com/docs/cockroachcloud/create-your-cluster">Create a CockroachDB Dedicated Cluster</a> or
-    <a href="https://www.cockroachlabs.com/docs/cockroachcloud/upgrade-to-v23.2">Upgrade to CockroachDB v23.2</a>.
   go_version: go1.21
-  sha: c8ffbdc4eeb3f656085edc33d6965b8f30cd7514
+  sha: 8f14432835d667982828b5319cfd130991fbf80c
   has_sql_only: true
   has_sha256sum: true
   mac:
@@ -5408,9 +5400,97 @@
     linux_intel_fips: true
     linux_arm_fips: false
   docker:
-    docker_image: cockroachdb/cockroach-unstable
+    docker_image: cockroachdb/cockroach
     docker_arm: true
     docker_arm_experimental: false
     docker_arm_limited_access: false
   source: true
   previous_release: v23.2.0-rc.2
+
+- release_name: v22.2.18
+  major_version: v22.2
+  release_date: '2024-02-08'
+  release_type: Production
+  go_version: go1.21
+  sha: 7c7aabc375626620cc7374eb6c155d251bc1f528
+  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: false
+    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: v22.2.17
+
+- release_name: v23.2.1
+  major_version: v23.2
+  release_date: '2024-02-20'
+  release_type: Production
+  go_version: go1.21
+  sha: 898cd6a363fd47bb92a03bac216f9bed0f64bc08
+  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.0
+  cloud_only: false
+  cloud_only_message_short: 'Available only to select CockroachDB Cloud clusters'
+  cloud_only_message: >
+      This version is currently available only to select
+      CockroachDB Cloud clusters. To request to upgrade
+      a CockroachDB Self-Hosted cluster to this version,
+      [contact Support](https://support.cockroachlabs.com/hc/en-us/requests/new).
+      
+- release_name: v23.1.15
+  major_version: v23.1
+  release_date: '2024-02-20'
+  release_type: Production
+  go_version: go1.21
+  sha: 69a32fafce429e5b75dba8f339ea15922286a0ba
+  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.1.14

src/current/_data/versions.csv

@@ -12,4 +12,4 @@ v21.2,2021-11-16,2022-11-16,2023-05-16,v21.1,release-21.2
 v22.1,2022-05-24,2023-05-24,2023-11-24,v21.2,release-22.1
 v22.2,2022-12-05,2023-12-05,2024-06-05,v22.1,release-22.2
 v23.1,2023-05-15,2024-05-15,2024-11-15,v22.2,release-23.1
-v23.2,2024-01-17,2025-01-17,2025-07-17,v23.1,release-23.2
+v23.2,2024-02-05,2025-02-05,2025-08-05,v23.1,release-23.2

src/current/_includes/cockroachcloud/quickstart/create-a-free-cluster.md

@@ -3,7 +3,11 @@
 1. If you haven't already, <a href="https://cockroachlabs.cloud/signup?referralId={{page.referral_id}}" rel="noopener" target="_blank">sign up for a CockroachDB {{ site.data.products.cloud }} account</a>.
 1. [Log in](https://cockroachlabs.cloud/) to your CockroachDB {{ site.data.products.cloud }} account.
 1. On the **Clusters** page, click **Create Cluster**.
-1. On the **Create your cluster** page, select **Serverless**.
-1. Click **Create cluster**.
+1. On the **Select a plan** page, select **Serverless**.
+1. On the **Cloud & Regions** page, select a cloud provider (GCP or AWS) in the **Cloud provider** section. 
+1. In the **Regions** section, select a region for the cluster. Refer to [CockroachDB {{ site.data.products.cloud }} Regions]({% link cockroachcloud/regions.md %}) for the regions where CockroachDB {{ site.data.products.serverless }} clusters can be deployed. To create a multi-region cluster, click **Add region** and select additional regions. A cluster can have at most six regions.
+1. Click **Next: Capacity**.
+1. On the **Capacity** page, select **Start for free**. Click **Next: Finalize**.
+1. On the **Finalize** page, click **Create cluster**.
 
     Your cluster will be created in a few seconds and the **Create SQL user** dialog will display.

src/current/_includes/cockroachcloud/serverless-usage.md

@@ -1,3 +1,3 @@
-The best way to estimate your resource usage is to [set resource limits]({% link cockroachcloud/serverless-cluster-management.md %}#edit-your-resource-limits) you're comfortable with and run your workload. You can see the RUs and storage your cluster has used in the **Usage this month** section of the [**Cluster Overview**]({% link cockroachcloud/serverless-cluster-management.md %}#view-cluster-overview) page. Once enough usage data is available, you can also see a graph of your monthly resource usage and recommended spend limit on the [**Edit cluster**]({% link cockroachcloud/serverless-cluster-management.md %}#edit-your-resource-limits) page.
+The best way to estimate your resource usage is to [set resource limits]({% link cockroachcloud/serverless-cluster-management.md %}#edit-cluster-capacity) you're comfortable with and run your workload. You can see the RUs and storage your cluster has used in the **Usage this month** section of the [**Cluster Overview**]({% link cockroachcloud/serverless-cluster-management.md %}#view-cluster-overview) page. Once enough usage data is available, you can also see a graph of your monthly resource usage and recommended spend limit on the [**Edit cluster**]({% link cockroachcloud/serverless-cluster-management.md %}#edit-cluster-capacity) page.
 
 A typical `SELECT` query consumes between 1 and 15 RUs, depending on the amount of data it scans and returns. A typical `INSERT` or `UPDATE` statement consumes between 10 and 25 RUs, depending on the amount of data it inserts or updates. To estimate the RU consumption of individual SQL statements, you can use the [`EXPLAIN ANALYZE`](https://www.cockroachlabs.com/docs/{{site.current_cloud_version}}/explain-analyze) SQL statement. For an example, see [Example Request Unit calculation]({% link cockroachcloud/serverless-resource-usage.md %}#example-request-unit-calculation).

src/current/_includes/releases/cloud/2023-08-01.md

@@ -2,4 +2,4 @@
 
 <h3> General changes </h3>
 
-- {{ site.data.products.serverless }} pricing changes that went into effect for newly-created organizations beginning on  [May 1, 2023](#may-1-2023) are now in effect for all organizations. Review the [new pricing](../cockroachcloud/plan-your-cluster-serverless.html#pricing), and review your current [resource limits](../cockroachcloud/serverless-cluster-management.html#edit-your-resource-limits) to prevent disruptions to your service.
+- {{ site.data.products.serverless }} pricing changes that went into effect for newly-created organizations beginning on  [May 1, 2023](#may-1-2023) are now in effect for all organizations. Review the [new pricing](../cockroachcloud/plan-your-cluster-serverless.html#pricing), and review your current [resource limits](../cockroachcloud/serverless-cluster-management.html#edit-cluster-capacity) to prevent disruptions to your service.

src/current/_includes/releases/cloud/2024-01-25.md

@@ -0,0 +1,5 @@
+## January 25, 2024
+
+<h3 id="2024-01-17-general-updates"> General updates </h3>
+
+- The single-page CockroachDB Cloud [Create cluster](https://www.cockroachlabs.com/docs/cockroachcloud/create-a-serverless-cluster) and [Edit cluster](https://www.cockroachlabs.com/docs/cockroachcloud/serverless-cluster-management) have been updated to use multi-step wizards.

src/current/_includes/releases/cloud/2024-01-29.md

@@ -0,0 +1,5 @@
+## January 29, 2024
+
+<h3 id="2024-01-29-general-updates"> General updates </h3>
+
+- CockroachDB {{ site.data.products.dedicated }} clusters now [export metrics]({% link cockroachcloud/export-metrics.md %}#the-metricexport-endpoint) to third-party monitoring tool [Prometheus]({% link cockroachcloud/export-metrics.md %}?filters=prometheus-metrics-export). This feature is available in [preview]({% link {{site.current_cloud_version}}/cockroachdb-feature-availability.md %}).

src/current/_includes/releases/cloud/2024-02-05.md

@@ -0,0 +1,5 @@
+## February 5, 2024
+
+<h3 id="2024-02-05-console-changes"> Console changes </h3>
+
+- CockroachDB {{ site.data.products.dedicated }} clusters now have a [**Metrics** page]({% link cockroachcloud/metrics-page.md %}) in the Console with charts to **Monitor SQL Activity** and **Identify SQL Problems**. On the **Metrics** page, a **Custom** tab takes you to the [**Custom Metrics Chart** page]({% link cockroachcloud/custom-metrics-chart-page.md %}) (available in [preview]({% link {{site.current_cloud_version}}/cockroachdb-feature-availability.md %})) where you can create custom charts showing the time series data for an available metric or combination of metrics.

src/current/_includes/releases/cloud/2024-02-06.md

@@ -0,0 +1,5 @@
+## February 6, 2024
+
+<h3 id="2024-02-06-general-updates"> General updates </h3>
+
+- Folder names can now include apostrophes. For details about folder naming, refer to [Folder Naming]({% link cockroachcloud/folders.md %}#folder-naming).

src/current/_includes/releases/v22.2/v22.2.18.md

@@ -0,0 +1,22 @@
+## v22.2.18
+
+Release Date: February 8, 2024
+
+{% include releases/release-downloads-docker-image.md release=include.release %}
+
+<h3 id="v22-2-18-bug-fixes">Bug fixes</h3>
+
+- Fixed a bug that could cause [`DELETE`](https://www.cockroachlabs.com/docs/v22.2/delete.html) queries sent by the [row-level TTL job](https://www.cockroachlabs.com/docs/v22.2/row-level-ttl.html) to use a [secondary index](https://www.cockroachlabs.com/docs/v22.2/schema-design-indexes.html) rather than the [primary index](https://www.cockroachlabs.com/docs/v22.2/indexes.html) to find the rows to delete. This could lead to some `DELETE` operations taking longer than expected. This bug was present since v22.2.0. [#118420][#118420]
+- Fixed a bug where a [changefeed](https://www.cockroachlabs.com/docs/v22.2/change-data-capture-overview.html) could omit events in rare cases, logging the error `cdc ux violation: detected timestamp ... that is less or equal to the local frontier`. This could happen in the following scenario:
+    1. A [rangefeed](https://www.cockroachlabs.com/docs/v22.2/create-and-configure-changefeeds.html#enable-rangefeeds) runs on a follower [replica](https://www.cockroachlabs.com/docs/v22.2/architecture/glossary#cockroachdb-architecture-terms) that lags significantly behind the [leaseholder](https://www.cockroachlabs.com/docs/v22.2/architecture/glossary#cockroachdb-architecture-terms).
+    1. A transaction commits and removes its transaction record before its [intent](https://www.cockroachlabs.com/docs/v22.2/architecture/transaction-layer#writing) resolution is applied on the follower.
+    1. The follower's [closed timestamp](https://www.cockroachlabs.com/docs/v22.2/architecture/transaction-layer#closed-timestamps) has advanced past the transaction commit timestamp.
+    1. The rangefeed attempts to push the transaction to a new timestamp (at least 10 seconds after the transaction began).
+    1. This may cause the rangefeed to prematurely emit a checkpoint before emitting writes at lower timestamps, which in turn may cause the [changefeed](https://www.cockroachlabs.com/docs/v22.2/change-data-capture-overview#how-does-an-enterprise-changefeed-work) to drop these events entirely, never emitting them. [#118633][#118633]
+
+<h3 id="v22-2-18-contributors">Contributors</h3>
+
+This release includes 7 merged PRs by 3 authors.
+
+[#118420]: https://github.com/cockroachdb/cockroach/pull/118420
+[#118633]: https://github.com/cockroachdb/cockroach/pull/118633