From 0ca57561a6a10689c47e52f623978deb57d1f889 Mon Sep 17 00:00:00 2001 From: Guanzhou Song <26541184+GuanzhouSong@users.noreply.github.com> Date: Fri, 9 Oct 2026 23:54:24 +0000 Subject: [PATCH 1/3] Serve the RC2 installer Merge only after the v1.0-RC2 release is published: until then its install.sh returns 404 and build:installer fails. Signed-off-by: Guanzhou Song <26541184+GuanzhouSong@users.noreply.github.com> --- scripts/publish-installer.mjs | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/scripts/publish-installer.mjs b/scripts/publish-installer.mjs index 0ca8d0e..cfaa351 100644 --- a/scripts/publish-installer.mjs +++ b/scripts/publish-installer.mjs @@ -3,11 +3,11 @@ import { mkdir, writeFile } from 'node:fs/promises'; import { resolve } from 'node:path'; import { pathToFileURL } from 'node:url'; -// v0.117-0 ships no installer; RC1's installs from the stable repository. +// v0.117-0 ships no installer; RC2's installs from the stable repository. // Release assets can be replaced, so the digest is pinned too. export const installerSource = { - release: 'v1.0-RC1', - sha256: 'dfacd0cd85ad23de191dee9d39b8fc5b4abe9cf1da7db75ea539ad487a2e9f34', + release: 'v1.0-RC2', + sha256: 'b9d16b3b86d3b1541e701be0ce38086dcb0bc904f761a36c7ede9fefe91d45f2', }; export async function publishInstaller(outputDirectory = 'out') { From 4e978ab59f3a9c8e38c0b046ca7192ef76f68c7e Mon Sep 17 00:00:00 2001 From: Guanzhou Song <26541184+GuanzhouSong@users.noreply.github.com> Date: Fri, 9 Oct 2026 23:54:24 +0000 Subject: [PATCH 2/3] Point RC testers at v1.0-RC2 and its telemetry opt-out The RC2 documentdb-local image sends anonymous usage telemetry by default; 0.117 images don't. Signed-off-by: Guanzhou Song <26541184+GuanzhouSong@users.noreply.github.com> --- PACKAGE-INSTALL.md | 14 ++++++++------ app/services/articleService.ts | 11 ++++++----- tests/packageArticles.test.ts | 5 +++-- 3 files changed, 17 insertions(+), 13 deletions(-) diff --git a/PACKAGE-INSTALL.md b/PACKAGE-INSTALL.md index d2b6afe..98b631a 100644 --- a/PACKAGE-INSTALL.md +++ b/PACKAGE-INSTALL.md @@ -2,8 +2,8 @@ Repository-backed installation commands for DocumentDB. -> This repository serves v0.117-0. v1.0-RC1 is for testing only, gets no fixes (those go into -> RC2 or 1.0), has no upgrade path, and isn't in this repository; see +> This repository serves v0.117-0. v1.0-RC2 is for testing only, gets no fixes (those go into +> a later RC or 1.0), has no upgrade path, and isn't in this repository; see > [Try the 1.0 release candidate](https://documentdb.io/docs/getting-started/release-candidate/). ## Clean-host installer @@ -16,10 +16,12 @@ sudo sh documentdb-install.sh ``` This installs v0.117-0 from this repository on PostgreSQL 18; add `--pg-major 17` -for 17. To try RC1, add `--version v1.0-RC1`, or use the `pgNN-1.0-rc1` container image. The installer then -downloads this host's packages from the -[v1.0-RC1 release](https://github.com/documentdb/documentdb/releases/tag/v1.0-RC1), -verifies them against its `SHA256SUMS`, and doesn't use this repository. See the +for 17. To try RC2, add `--version v1.0-RC2`. The installer then downloads this host's +packages from the +[v1.0-RC2 release](https://github.com/documentdb/documentdb/releases/tag/v1.0-RC2), +verifies them against its `SHA256SUMS`, and doesn't use this repository. The +`pgNN-1.0-rc2` container image also runs RC2; it sends anonymous usage telemetry by default +(opt out with `-e DOCUMENTDB_USAGE_TELEMETRY=false`). See the [RC guide](https://documentdb.io/docs/getting-started/release-candidate/). The site serves the `install.sh` attached to the release named in diff --git a/app/services/articleService.ts b/app/services/articleService.ts index 8f929db..0b0007d 100644 --- a/app/services/articleService.ts +++ b/app/services/articleService.ts @@ -191,7 +191,7 @@ The current official release publishes the full stack — extension, gateway, se > Need another distribution or PostgreSQL major? We welcome community builds. Check out the matching release tag and use the version-parameterized [packaging scripts](https://github.com/documentdb/documentdb/blob/v0.117-0/packaging/README.md). \`build_packages.sh\` builds the extension, \`gateway/build_gateway_packages.sh\` builds the gateway, and \`build_extra_packages.sh\` builds the common, tools, stand-alone, and meta packages. PostgreSQL 15 is extension-only because the setup tools require PostgreSQL 16 or newer. These builds are on demand and are not official release assets hosted by documentdb.io. > [!NOTE] -> Want to try DocumentDB 1.0? [v1.0-RC1](/docs/getting-started/release-candidate) is for testing only, gets no fixes (those go into RC2 or 1.0) and has no upgrade path. It isn't in the package repository, so the commands below install v0.117-0. +> Want to try DocumentDB 1.0? [v1.0-RC2](/docs/getting-started/release-candidate) is for testing only, gets no fixes (those go into a later RC or 1.0) and has no upgrade path. It isn't in the package repository, so the commands below install v0.117-0. You do not need PostgreSQL already installed — the setup wizard creates and manages its own instance. The install does add the PGDG repository and pull PostgreSQL, PostGIS and around 160 packages (about 140 MB), so pick a host you are willing to have PGDG on. @@ -205,9 +205,10 @@ sudo sh documentdb-install.sh \`\`\` This installs v0.117-0 from the package repository on PostgreSQL 18; add \`--pg-major 17\` for 17. -To try RC1, run \`sudo sh documentdb-install.sh --version v1.0-RC1\` instead, or use the \`pgNN-1.0-rc1\` container image. -It downloads this host's packages from the [v1.0-RC1 release](https://github.com/documentdb/documentdb/releases/tag/v1.0-RC1), verifies them against its \`SHA256SUMS\` and doesn't use the package repository. See the [RC guide](/docs/getting-started/release-candidate). -RC1 gets no fixes and has no upgrade path, so use a clean host. +To try RC2, run \`sudo sh documentdb-install.sh --version v1.0-RC2\` instead. +It downloads this host's packages from the [v1.0-RC2 release](https://github.com/documentdb/documentdb/releases/tag/v1.0-RC2), verifies them against its \`SHA256SUMS\` and doesn't use the package repository. +The \`pgNN-1.0-rc2\` container image also runs RC2; it sends anonymous usage telemetry by default (opt out with \`-e DOCUMENTDB_USAGE_TELEMETRY=false\`). See the [RC guide](/docs/getting-started/release-candidate). +RC2 gets no fixes and has no upgrade path, so use a clean host. ## Install @@ -1258,7 +1259,7 @@ The \`latest\` tag is a convenience alias. Pin an explicit tag for anything repr | \`ghcr.io/documentdb/documentdb/documentdb-local:pg18-0.117.0\` | DocumentDB 0.117.0 on PostgreSQL 18 | | \`…:pg17-0.117.0\` | DocumentDB 0.117.0 on PostgreSQL 17 | | \`…:pg16-0.117.0\` · \`…:pg15-0.117.0\` | PostgreSQL 16 and 15 | -| \`…:pg15-1.0-rc1\` · \`…:pg16-1.0-rc1\` · \`…:pg17-1.0-rc1\` · \`…:pg18-1.0-rc1\` | [v1.0-RC1](https://github.com/documentdb/documentdb/releases/tag/v1.0-RC1), for testing only, with [no fixes to RC1 and no upgrade path](/docs/getting-started/release-candidate). No date for 1.0 yet. Use a new, empty data volume. | +| \`…:pg15-1.0-rc2\` · \`…:pg16-1.0-rc2\` · \`…:pg17-1.0-rc2\` · \`…:pg18-1.0-rc2\` | [v1.0-RC2](https://github.com/documentdb/documentdb/releases/tag/v1.0-RC2), for testing only, with [no fixes to RC2 and no upgrade path](/docs/getting-started/release-candidate). No date for 1.0 yet. Use a new, empty data volume. Sends anonymous usage telemetry by default; see the [privacy statement](https://github.com/documentdb/documentdb/blob/v1.0-RC2/documentdb-local/PRIVACY.md) to opt out. | | \`…:latest\` | Currently identical to \`pg17-0.117.0\` | > \`latest\` tracks **PostgreSQL 17**, while the \`documentdb\` package on Linux pins diff --git a/tests/packageArticles.test.ts b/tests/packageArticles.test.ts index fab3bb7..1f96eab 100644 --- a/tests/packageArticles.test.ts +++ b/tests/packageArticles.test.ts @@ -283,11 +283,12 @@ describe('Linux package articles', () => { expect(new Set(tags)).toEqual(new Set([FALLBACK_RELEASE.tagName])); }); - it('serves the stable installer and selects RC1 only with --version', () => { + it('serves the stable installer and selects RC2 only with --version', () => { expect(linuxPackagesGuideContent).toContain('https://documentdb.io/install.sh'); expect(linuxPackagesGuideContent).toContain('installs v0.117-0 from the package repository'); - expect(linuxPackagesGuideContent).toContain('sh documentdb-install.sh --version v1.0-RC1'); + expect(linuxPackagesGuideContent).toContain('sh documentdb-install.sh --version v1.0-RC2'); expect(linuxPackagesGuideContent).toContain("doesn't use the package repository"); + expect(linuxPackagesGuideContent).toContain('DOCUMENTDB_USAGE_TELEMETRY=false'); }); it('uses the current release package guide and artifact version', () => { From e9ef62b16011c8c244828629052a18f2e17b52a8 Mon Sep 17 00:00:00 2001 From: Guanzhou Song <26541184+GuanzhouSong@users.noreply.github.com> Date: Fri, 9 Oct 2026 23:54:24 +0000 Subject: [PATCH 3/3] Point the versioning post's RC install steps at RC2 Signed-off-by: Guanzhou Song <26541184+GuanzhouSong@users.noreply.github.com> --- blogs/_posts/2026-10-01-versioning.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/blogs/_posts/2026-10-01-versioning.md b/blogs/_posts/2026-10-01-versioning.md index 5fc13ec..efa79d4 100644 --- a/blogs/_posts/2026-10-01-versioning.md +++ b/blogs/_posts/2026-10-01-versioning.md @@ -27,6 +27,8 @@ These experimental versions are not intended for long-term use, nor will they be ### Release candidate installation +> **Update:** [v1.0-RC2](https://github.com/documentdb/documentdb/releases/tag/v1.0-RC2) replaces RC1 for testing. Use `rc2` and `v1.0-RC2` in place of `rc1` and `v1.0-RC1` below. The RC2 image sends anonymous usage telemetry by default; add `-e DOCUMENTDB_USAGE_TELEMETRY=false` to opt out. + With Docker: ```bash