Merge branch 'main' into k8s_common_includes

src/current/_config_cockroachdb.yml

@@ -4,4 +4,4 @@ destination: _site/docs
 homepage_title: CockroachDB Docs
 versions:
   stable: v24.2
-  dev: v24.2
+  dev: v24.3

src/current/_data/releases.yml

@@ -6807,3 +6807,56 @@
     docker_arm_limited_access: false
   source: true
   previous_release: v23.2.11
+
+- release_name: v24.3.0-alpha.1
+  major_version: v24.3
+  release_date: '2024-12-31'
+  release_type: Testing
+  go_version: go1.22.0
+  sha: 0123456789abcde0123456789abcde0123456789
+  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
+
+- release_name: v23.1.27
+  major_version: v23.1
+  release_date: '2024-10-03'
+  release_type: Production
+  go_version: go1.22.5
+  sha: a17e74924d09f342415a0ad861f19d221479f489
+  has_sql_only: true
+  has_sha256sum: true
+  mac:
+    mac_arm: true
+    mac_arm_experimental: true
+    mac_arm_limited_access: true
+  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.26

src/current/_data/versions.csv

@@ -15,3 +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,N/A,N/A,N/A,N/A,N/A,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-12-25,2025-06-25,N/A,N/A,N/A,N/A,N/A,N/A,v24.2,master

src/current/_includes/releases/v23.1/v23.1.27.md

@@ -0,0 +1,10 @@
+## v23.1.27
+
+Release Date: October 3, 2024
+
+{% include releases/new-release-downloads-docker-image.md release=include.release %}
+<h3 id="v23-1-27-bug-fixes">Bug fixes</h3>
+
+- Fixed a rare bug where a [lease transfer]({% link v23.1/architecture/replication-layer.md %}#epoch-based-leases-table-data) could lead to a `side-transport update saw closed timestamp regression` panic. The bug could occur when a node was [overloaded]({% link v23.1/ui-overload-dashboard.md %}) and failing to heartbeat its [node liveness]({% link v23.1/cluster-setup-troubleshooting.md %}#node-liveness-issues) record. [#131679][#131679]
+
+[#131679]: https://github.com/cockroachdb/cockroach/pull/131679

src/current/_includes/releases/v23.2/v23.2.7.md

@@ -6,7 +6,7 @@ Release Date: July 2, 2024
 
 <h3 id="v23-2-7-{{-site.data.products.enterprise-}}-edition-changes">{{ site.data.products.enterprise }} edition changes</h3>
 
-- [Changefeeds]({% link v23.2/change-data-capture-overview.md %}) now default to using the bulk oracle for planning, which distributes work evenly across all [replicas]({% link v23.2/architecture/reads-and-writes-overview.md %}#replica) in the locality filter, including followers if enabled. To disable this behavior and use the previous bin-packing oracle, set the [cluster setting]({% link v23.2/cluster-settings.md %}) `changefeed.random_replica_selection.enabled` to `false`. [#124925][#124925]
+- [Changefeeds]({% link v23.2/change-data-capture-overview.md %}) can use the bulk oracle for planning, which distributes work evenly across all [replicas]({% link v23.2/architecture/reads-and-writes-overview.md %}#replica) in the locality filter, including followers if enabled. Set the `changefeed.random_replica_selection.enabled` [cluster setting]({% link v23.2/cluster-settings.md %}) to `true` to enable this planning behavior. To use the previous bin-packing oracle, set the cluster setting `changefeed.random_replica_selection.enabled` to `false`. [#124925][#124925]
 - [`ALTER CHANGEFEED`]({% link v23.2/alter-changefeed.md %}) no longer removes the [CDC query]({% link v23.2/cdc-queries.md %}) when modifying changefeed properties. [#125437][#125437]
 
 <h3 id="v23-2-7-sql-language-changes">SQL language changes</h3>

src/current/_includes/releases/v24.3/v24.3.0-alpha.1.md

@@ -0,0 +1,3 @@
+## v24.3.0-alpha.1
+
+Release Date: TBD

src/current/_includes/sidebar-data-v24.3.json

@@ -0,0 +1,26 @@
+[
+  {
+    "title": "Docs Home",
+    "is_top_level": true,
+    "urls": [
+      "/"
+    ]
+  },
+  {% 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/connect-to-cockroachdb.json %},
+  {% include_cached v24.3/sidebar-data/migrate.json %},
+  {% include_cached v24.3/sidebar-data/cloud-deployments.json %},
+  {% include_cached v24.3/sidebar-data/self-hosted-deployments.json %},
+  {% include_cached v24.3/sidebar-data/schema-design.json %},
+  {% include_cached v24.3/sidebar-data/reads-and-writes.json %},
+  {% include_cached v24.3/sidebar-data/stream-data.json %},
+  {% include_cached v24.3/sidebar-data/multi-region-capabilities.json %},
+  {% include_cached v24.3/sidebar-data/optimize-performance.json %},
+  {% include_cached v24.3/sidebar-data/troubleshooting.json %},
+  {% include_cached v24.3/sidebar-data/sql.json %},
+  {% include_cached v24.3/sidebar-data/reference.json %},
+  {% include_cached v24.3/sidebar-data/faqs.json %},
+  {% include_cached sidebar-data-cockroach-university.json %}
+]

src/current/_includes/v24.2/sidebar-data/stream-data.json

@@ -92,6 +92,12 @@
           "/${VERSION}/connect-to-a-changefeed-kafka-sink-with-oauth-using-okta.html"
         ]
       },
+      {
+        "title": "Stream a Changefeed to Amazon MSK Serverless",
+        "urls": [
+          "/${VERSION}/stream-a-changefeed-to-amazon-msk-serverless.html"
+        ]
+      },
       {
         "title": "Stream a Changefeed from CockroachDB Cloud to Snowflake",
         "urls": [

src/current/_includes/v24.3/app/before-you-begin.md

@@ -0,0 +1,12 @@
+1. [Install CockroachDB]({% link {{ page.version.version }}/install-cockroachdb.md %}).
+1. Start up a [secure]({% link {{ page.version.version }}/secure-a-cluster.md %}) or [insecure]({% link {{ page.version.version }}/start-a-local-cluster.md %}) local cluster.
+1. Choose the instructions that correspond to whether your cluster is secure or insecure:
+
+<div class="filters filters-big clearfix">
+  <button class="filter-button" data-scope="secure">Secure</button>
+  <button class="filter-button" data-scope="insecure">Insecure</button>
+</div>
+
+<section class="filter-content" markdown="1" data-scope="insecure">
+{% include {{ page.version.version }}/prod-deployment/insecure-flag.md %}
+</section>

src/current/_includes/v24.3/app/cc-free-tier-params.md

@@ -0,0 +1,10 @@
+Where:
+
+- `{username}` and `{password}` specify the SQL username and password that you created earlier.
+- `{globalhost}` is the name of the CockroachDB {{ site.data.products.cloud }} free tier host (e.g., `free-tier.gcp-us-central1.cockroachlabs.cloud`).
+- `{path to the CA certificate}` is the path to the `cc-ca.crt` file that you downloaded from the CockroachDB {{ site.data.products.cloud }} Console.
+- `{cluster_name}` is the name of your cluster.
+
+{{site.data.alerts.callout_info}}
+If you are using the connection string that you [copied from the **Connection info** modal](#set-up-your-cluster-connection), your username, password, hostname, and cluster name will be pre-populated.
+{{site.data.alerts.end}}

src/current/_includes/v24.3/app/create-a-database.md

@@ -0,0 +1,54 @@
+<section class="filter-content" markdown="1" data-scope="local">
+
+1. In the SQL shell, create the `bank` database that your application will use:
+
+    {% include_cached copy-clipboard.html %}
+    ~~~ sql
+    > CREATE DATABASE bank;
+    ~~~
+
+1. Create a SQL user for your app:
+
+    {% include_cached copy-clipboard.html %}
+    ~~~ sql
+    > CREATE USER <username> WITH PASSWORD <password>;
+    ~~~
+
+    Take note of the username and password. You will use it in your application code later.
+
+1. Give the user the necessary permissions:
+
+    {% include_cached copy-clipboard.html %}
+    ~~~ sql
+    > GRANT ALL ON DATABASE bank TO <username>;
+    ~~~
+
+</section>
+
+<section class="filter-content" markdown="1" data-scope="cockroachcloud">
+
+1. If you haven't already, [download the CockroachDB binary]({% link {{ page.version.version }}/install-cockroachdb.md %}).
+1. Start the [built-in SQL shell]({% link {{ page.version.version }}/cockroach-sql.md %}) using the connection string you got from the CockroachDB {{ site.data.products.cloud }} Console:
+
+    {% include_cached copy-clipboard.html %}
+    ~~~ shell
+    $ cockroach sql \
+    --url='<connection-string>'
+    ~~~
+
+1. In the SQL shell, create the `bank` database that your application will use:
+
+    {% include_cached copy-clipboard.html %}
+    ~~~ sql
+    > CREATE DATABASE bank;
+    ~~~
+
+1. Exit the SQL shell:
+
+    {% include_cached copy-clipboard.html %}
+    ~~~ sql
+    > \q
+    ~~~
+
+
+</section>

src/current/_includes/v24.3/app/create-maxroach-user-and-bank-database.md

@@ -0,0 +1,32 @@
+Start the [built-in SQL shell]({% link {{ page.version.version }}/cockroach-sql.md %}):
+
+{% include_cached copy-clipboard.html %}
+~~~ shell
+$ cockroach sql --certs-dir=certs
+~~~
+
+In the SQL shell, issue the following statements to create the `maxroach` user and `bank` database:
+
+{% include_cached copy-clipboard.html %}
+~~~ sql
+> CREATE USER IF NOT EXISTS maxroach;
+~~~
+
+{% include_cached copy-clipboard.html %}
+~~~ sql
+> CREATE DATABASE bank;
+~~~
+
+Give the `maxroach` user the necessary permissions:
+
+{% include_cached copy-clipboard.html %}
+~~~ sql
+> GRANT ALL ON DATABASE bank TO maxroach;
+~~~
+
+Exit the SQL shell:
+
+{% include_cached copy-clipboard.html %}
+~~~ sql
+> \q
+~~~

src/current/_includes/v24.3/app/for-a-complete-example-go.md

@@ -0,0 +1,4 @@
+For complete examples, see:
+
+- [Build a Go App with CockroachDB]({% link {{ page.version.version }}/build-a-go-app-with-cockroachdb.md %}) (pgx)
+- [Build a Go App with CockroachDB and GORM]({% link {{ page.version.version }}/build-a-go-app-with-cockroachdb.md %})

src/current/_includes/v24.3/app/for-a-complete-example-java.md

@@ -0,0 +1,4 @@
+For complete examples, see:
+
+- [Build a Java App with CockroachDB]({% link {{ page.version.version }}/build-a-java-app-with-cockroachdb.md %}) (JDBC)
+- [Build a Java App with CockroachDB and Hibernate]({% link {{ page.version.version }}/build-a-java-app-with-cockroachdb-hibernate.md %})

src/current/_includes/v24.3/app/for-a-complete-example-python.md

@@ -0,0 +1,6 @@
+For complete examples, see:
+
+- [Build a Python App with CockroachDB]({% link {{ page.version.version }}/build-a-python-app-with-cockroachdb-psycopg3.md %}) (psycopg3)
+- [Build a Python App with CockroachDB and SQLAlchemy]({% link {{ page.version.version }}/build-a-python-app-with-cockroachdb-sqlalchemy.md %})
+- [Build a Python App with CockroachDB and Django]({% link {{ page.version.version }}/build-a-python-app-with-cockroachdb-django.md %})
+- [Build a Python App with CockroachDB and asyncpg]({% link {{ page.version.version }}/build-a-python-app-with-cockroachdb-asyncpg.md %})

src/current/_includes/v24.3/app/hibernate-dialects-note.md

@@ -0,0 +1,5 @@
+Versions of the Hibernate CockroachDB dialect correspond to the version of CockroachDB installed on your machine. For example, `org.hibernate.dialect.CockroachDB201Dialect` corresponds to CockroachDB v20.1 and later, and `org.hibernate.dialect.CockroachDB192Dialect` corresponds to CockroachDB v19.2 and later.
+
+All dialect versions are forward-compatible (e.g., CockroachDB v20.1 is compatible with `CockroachDB192Dialect`), as long as your application is not affected by any backward-incompatible changes listed in your CockroachDB version's [release notes]({% link releases/index.md %}). In the event of a CockroachDB version upgrade, using a previous version of the CockroachDB dialect will not break an application, but, to enable all features available in your version of CockroachDB, we recommend keeping the dialect version in sync with the installed version of CockroachDB.
+
+Not all versions of CockroachDB have a corresponding dialect yet. Use the dialect number that is closest to your installed version of CockroachDB. For example, use `CockroachDB201Dialect` when using CockroachDB v21.1 and later.

src/current/_includes/v24.3/app/insecure/create-maxroach-user-and-bank-database.md

@@ -0,0 +1,32 @@
+Start the [built-in SQL shell]({% link {{ page.version.version }}/cockroach-sql.md %}):
+
+{% include_cached copy-clipboard.html %}
+~~~ shell
+$ cockroach sql --insecure
+~~~
+
+In the SQL shell, issue the following statements to create the `maxroach` user and `bank` database:
+
+{% include_cached copy-clipboard.html %}
+~~~ sql
+> CREATE USER IF NOT EXISTS maxroach;
+~~~
+
+{% include_cached copy-clipboard.html %}
+~~~ sql
+> CREATE DATABASE bank;
+~~~
+
+Give the `maxroach` user the necessary permissions:
+
+{% include_cached copy-clipboard.html %}
+~~~ sql
+> GRANT ALL ON DATABASE bank TO maxroach;
+~~~
+
+Exit the SQL shell:
+
+{% include_cached copy-clipboard.html %}
+~~~ sql
+> \q
+~~~