Merge branch 'claude/migrate-to-bun-N6zGf' into 'master'

Migrate to Bun + Upgrade Docusaurus to 3.9.2

Closes #157

See merge request postgres-ai/docs!848

Author: NikolayS

.ci/validate-feeds.sh

@@ -4,7 +4,7 @@
 set -e
 
 echo "Building site to generate feeds..."
-npm run build
+bun run build
 
 echo ""
 echo "Validating RSS/Atom feeds..."

.gitlab-ci.yml

@@ -25,11 +25,11 @@ variables:
 # Validate RSS/Atom feeds before building and deploying
 validate_feeds:
   stage: validate
-  image: node:18
+  image: oven/bun:1.3-debian
   before_script:
     # Install xmllint for XML validation
     - apt-get update && apt-get install -y libxml2-utils jq
-    - npm ci
+    - bun install --frozen-lockfile
   script:
     - bash .ci/validate-feeds.sh
   artifacts:
@@ -39,8 +39,7 @@ validate_feeds:
       - build/blog/*.json
     expire_in: 1 week
   only:
-    - merge_requests
-    - master
+    - branches
 
 # Stages templates.
 .job_template: &build_and_push_definition

Dockerfile

@@ -1,4 +1,8 @@
-FROM node:18.20
+FROM oven/bun:1.3-debian
+
+# Install only libvips runtime (not -dev) so sharp uses prebuilt binaries
+# This is much faster than compiling from source (~2 min saved)
+RUN apt-get update && apt-get install -y --no-install-recommends libvips42 && rm -rf /var/lib/apt/lists/*
 
 ARG ARG_REACT_APP_API_SERVER
 ENV REACT_APP_API_SERVER=$ARG_REACT_APP_API_SERVER
@@ -26,15 +30,11 @@ ENV UMAMI_SCRIPT_URL=$ARG_UMAMI_SCRIPT_URL
 
 WORKDIR /docs
 
-COPY package.json ./
-COPY package-lock.json ./
-RUN npm ci
+COPY package.json bun.lock ./
+RUN bun install --frozen-lockfile
 
 COPY . .
-# Make cache folder if not exists.
-RUN mkdir -p .cache
-RUN mv .cache node_modules
-RUN npm run build
+RUN bun run build
 
 EXPOSE 3000
-CMD ["npm", "run", "serve"]
+CMD ["bun", "run", "serve"]

README.md

@@ -13,18 +13,18 @@ Learn more: https://documentation.divio.com/
 
 ## Engine
 
-This website is built using [Docusaurus 2](https://v2.docusaurus.io/), a modern static website generator.
+This website is built using [Docusaurus 3](https://docusaurus.io/), a modern static website generator.
 
-### Installation / Build
+### Installation
 
 ```shell
-$ npm install
+bun install
 ```
 
 ### Local Development
 
 ```shell
-$ npm run start
+bun start
 ```
 
-This command starts a local development server and open up a browser window. Most changes are reflected live without having to restart the server.
+This command starts a local development server and opens a browser window. Most changes are reflected live without having to restart the server.

blog/20250721-dblab-engine-4-0-released.mdx

@@ -226,7 +226,7 @@ When creating a branch or a clone takes a second and costs nothing extra, teams
 ## Performance at scale
 
 Testing with production workloads demonstrates:
-- **Clone creation**: <2 seconds for any database, regardless of size (even if it's 50 TiB!)
+- **Clone creation**: &lt;2 seconds for any database, regardless of size (even if it's 50 TiB!)
 - **Snapshot creation**: O(1) operation regardless of database size
 - **Branch switching**: Instant (pointer update only)
 - **Concurrent users**: 15 users on 10 TiB database with 30-second clone creation under load

blog/20251105-postgres-marathon-2-012.mdx

@@ -150,7 +150,7 @@ time pgbackrest \
 # Start with --process-max=8 for a balance of speed and resource usage
 # Increase to 16-32 for maximum speed on fast networks (10+ Gbps)
 # Network compression (--compress-level-network=1) provides minimal benefit 
-# on fast networks (<6% improvement) but is useful for slower networks (<10 Gbps)
+# on fast networks (&lt;6% improvement) but is useful for slower networks (&lt;10 Gbps)
 ```
 
 If CPU resources are constrained on the source server, reduce priority for pgBackRest processes on the primary:
@@ -297,7 +297,7 @@ For production deployments:
 
 1. Start with `--process-max=$(($(nproc)/2))` to balance performance with system load
 2. Monitor CPU usage on both source and destination during backup
-3. Network compression (`--compress-level-network=1`) doesn't seem to be providing a significant improvement on fast networks (10+ Gbps). Use it for slower networks (<10 Gbps) where it can be more beneficial
+3. Network compression (`--compress-level-network=1`) doesn't seem to be providing a significant improvement on fast networks (10+ Gbps). Use it for slower networks (&lt;10 Gbps) where it can be more beneficial
 4. Consider using `renice` on the source server if CPU contention affects production workload
 5. Ensure sufficient I/O capacity on the destination to handle parallel writes
 6. For high parallelism (64+), increase SSH limits: `MaxStartups=200:30:300` and `MaxSessions=200` in `/etc/ssh/sshd_config`. Alternatively, SSH ControlMaster creates a single persistent connection that all subsequent SSH sessions multiplex through — we haven't tested this approach yet, but it's worth exploring for reducing connection overhead at high parallelism levels

bun.lock

@@ -56,8 +56,8 @@ Replacement rules are applied to all log fields of the incoming PostgreSQL CSV l
 ## Regular expressions
 The syntax of the regular expressions accepted is the same general syntax used by Perl, Python, and other languages.  You can find syntax details here: https://github.com/google/re2/wiki/Syntax.
 
-In a template, a variable is denoted by a substring of the form $name or ${name}, where name is a non-empty sequence of letters, digits, and underscores. 
-A purely numeric name like `$1` refers to a submatch with the corresponding index; other names refer to capturing parentheses named with the `(?P<name>...)` syntax. 
+In a template, a variable is denoted by a substring of the form `$name` or `${name}`, where name is a non-empty sequence of letters, digits, and underscores.
+A purely numeric name like `$1` refers to a submatch with the corresponding index; other names refer to capturing parentheses named with the `(?P<name>...)` syntax.
 A reference to an out-of-range or unmatched index or a name that is not present in the regular expression is replaced by an empty string.
 
 To insert a literal `$` in the output, use `$$` in the template.

docs/dblab-howtos/administration/ci-observer-postgres-log-masking.md

@@ -29,7 +29,7 @@ The clone's container name is associated with its port number, such as `dblab_cl
 
 #### Container labels 
 - `dblab_clone`
-- <pool_name>
+- `<pool_name>`
 
 #### Responsibility
 - Provides a thin clone: an independent PostgreSQL database server with thinly cloned / branched data directory

docs/reference-guides/database-lab-engine-components.md

@@ -40,6 +40,11 @@ module.exports = {
   organizationName: 'postgres-ai',
   projectName: 'docs',
 
+  // Use CommonMark for .md files to avoid MDX parsing issues
+  markdown: {
+    format: 'detect',
+  },
+
   customFields: {
     signInUrl: SIGN_IN_URL,
     apiUrlPrefix: API_URL_PREFIX,
@@ -376,14 +381,29 @@ module.exports = {
     },
 
     prism: {
-      theme: require('prism-react-renderer/themes/nightOwlLight'),
-      darkTheme: require('prism-react-renderer/themes/nightOwl'),
+      theme: require('prism-react-renderer').themes.nightOwlLight,
+      darkTheme: require('prism-react-renderer').themes.nightOwl,
     },
   },
 
   clientModules: [],
 
   plugins: [
+    // Fix cytoscape module resolution for mermaid
+    function () {
+      return {
+        name: 'webpack-cytoscape-fix',
+        configureWebpack() {
+          return {
+            resolve: {
+              alias: {
+                'cytoscape/dist/cytoscape.umd.js': require.resolve('cytoscape'),
+              },
+            },
+          };
+        },
+      };
+    },
     [
       '@docusaurus/plugin-ideal-image',
       {
@@ -587,6 +607,7 @@ module.exports = {
           showReadingTime: true,
           editUrl: 'https://gitlab.com/postgres-ai/docs/-/edit/master/',
           path: 'blog',
+          onInlineTags: 'ignore',
           routeBasePath: 'blog',
           postsPerPage: 10,
           blogSidebarTitle: 'Categories',