Merge branch 'fix-blog-pgbackrest-credit' into 'master'

atom/rss quickfix, CI to auto-test rss/atom correctness, and misc improvements

See merge request postgres-ai/docs!805

Author: bogdan-ts

.ci/validate-feeds.sh

@@ -0,0 +1,57 @@
+#!/bin/bash
+# Validate RSS and Atom feeds for XML correctness
+
+set -e
+
+echo "Building site to generate feeds..."
+npm run build
+
+echo ""
+echo "Validating RSS/Atom feeds..."
+
+BUILD_DIR="build"
+FEEDS=("$BUILD_DIR/blog/rss.xml" "$BUILD_DIR/blog/atom.xml" "$BUILD_DIR/blog/feed.json")
+
+EXIT_CODE=0
+
+for feed in "${FEEDS[@]}"; do
+  if [ ! -f "$feed" ]; then
+    echo "❌ Feed not found: $feed"
+    EXIT_CODE=1
+    continue
+  fi
+  
+  # For XML feeds (rss.xml, atom.xml), validate with xmllint
+  if [[ "$feed" == *.xml ]]; then
+    echo "Validating XML: $feed"
+    if xmllint --noout "$feed" 2>&1; then
+      echo "✅ Valid XML: $feed"
+    else
+      echo "❌ Invalid XML: $feed"
+      echo "Showing first 50 lines around errors:"
+      xmllint --noout "$feed" 2>&1 | head -20
+      EXIT_CODE=1
+    fi
+  fi
+  
+  # For JSON feed, validate with jq
+  if [[ "$feed" == *.json ]]; then
+    echo "Validating JSON: $feed"
+    if jq empty "$feed" 2>&1; then
+      echo "✅ Valid JSON: $feed"
+    else
+      echo "❌ Invalid JSON: $feed"
+      EXIT_CODE=1
+    fi
+  fi
+done
+
+echo ""
+if [ $EXIT_CODE -eq 0 ]; then
+  echo "✅ All feeds are valid!"
+else
+  echo "❌ Feed validation failed!"
+fi
+
+exit $EXIT_CODE
+

.gitignore

@@ -14,9 +14,10 @@
 .env.development.local
 .env.test.local
 .env.production.local
+static/raw
 
 npm-debug.log*
 yarn-debug.log*
 yarn-error.log*
 
-.idea/
+.idea/

.gitlab-ci.yml

@@ -3,6 +3,7 @@
 image: docker:20.10.12
 
 stages:
+  - validate
   - prepare_image
   - deploy
 
@@ -14,6 +15,26 @@ variables:
   TAG_LATEST: "${REGISTRY}:${NAMESPACE}-latest"
   DOCS_NAME: "docs"
 
+# Validate RSS/Atom feeds before building and deploying
+validate_feeds:
+  stage: validate
+  image: node:18
+  before_script:
+    # Install xmllint for XML validation
+    - apt-get update && apt-get install -y libxml2-utils jq
+    - npm ci
+  script:
+    - bash .ci/validate-feeds.sh
+  artifacts:
+    when: on_failure
+    paths:
+      - build/blog/*.xml
+      - build/blog/*.json
+    expire_in: 1 week
+  only:
+    - merge_requests
+    - master
+
 # Stages templates.
 .job_template: &build_and_push_definition
   stage: prepare_image

blog/20210728-code-and-data.mdx

@@ -8,7 +8,7 @@ description: 'Comprehensive Testing Covers Code AND Data'
 weight: 0
 image: /assets/thumbnails/dle-generic-blog.png
 tags:
-  - Guides & best practices
+  - Guides and best practices
   - Postgres.ai
   - Database Lab
   - Software Testing

blog/20210923-zero-downtime-postgres-schema-migrations-lock-timeout-and-retries.mdx

@@ -9,7 +9,7 @@ description: 'Deploying DB schema changes in heavily loaded systems is challengi
 weight: 0
 image: /assets/thumbnails/graceful-db-migrations.png
 tags:
-  - Guides & best practices
+  - Guides and best practices
   - database migrations
   - database schema migrations
   - DDL

blog/20220525-common-db-schema-change-mistakes.mdx

@@ -8,7 +8,7 @@ description: "Common DB schema change mistakes and how to avoid them in PostgreS
 weight: 0
 image: /assets/thumbnails/20220525-common-db-schema-change-mistakes_thumbnail.jpg
 tags:
-  - Guides & best practices
+  - Guides and best practices
   - Schema migrations
 ---
 

blog/20221125-cheaper-faster.mdx

@@ -8,7 +8,7 @@ description: 'Test environments that are 10x cheaper and 10x faster than RDS clo
 weight: 0
 image: /assets/thumbnails/elephants-in-sky-painting2.jpg
 tags:
-  - Guides & best practices
+  - Guides and best practices
   - Postgres.ai
   - Database Lab
   - Software Testing

blog/20230722-10-postgres-tips-for-beginners.mdx

@@ -10,7 +10,7 @@ description: "<div><img src=\"/assets/thumbnails/20230722-10-postgres-tips-for-b
 weight: 0
 image: /assets/thumbnails/20230722-10-postgres-tips-for-beginners-3.jpg
 tags:
-  - Guides & best practices
+  - Guides and best practices
   - Postgres tips
 ---
 

blog/20250724-postgres-howtos-launch.md

@@ -4,7 +4,7 @@ date: 2025-07-24 20:00:00
 publishDate: 2025-07-24 20:00:00
 authors: [nik]
 image: /assets/thumbnails/20250724-postgres-howtos-launch.png
-tags: [Guides & best practices, Launch Week, postgres, howtos, documentation]
+tags: [Guides and best practices, Launch Week, postgres, howtos, documentation]
 ---
 
 # Introducing Postgres how-tos: practical guides for real-world database challenges

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

@@ -1,6 +1,7 @@
 ---
 title: "#PostgresMarathon 2-012: Ultra-fast replica creation with pgBackRest"
 date: 2025-11-05 23:59:59
+slug: 20251105-postgres-marathon-2-012-ultra-fast-replica-creation-pgbackrest
 authors: [nik, maxim]
 tags: [Postgres insights, PostgresMarathon, cloning, pgBackRest, performance]
 ---
@@ -39,7 +40,7 @@ Multi-threaded pg_basebackup has been a recurring topic on pgsql-hackers over th
 
 ## Alternative: pgBackRest 
 
-pgBackRest is a direct replacement that becomes efficient with `--process-max=8` or higher. The setup requires no special configuration on the source database — neither Postgres nor pgBackRest need to be pre-configured on the primary server.
+pgBackRest is primarily a backup and restore tool for Postgres, but nothing prevents using it to copy a data directory from one server to another — which is exactly what we need for replica creation. This approach becomes highly efficient with `--process-max=8` or higher. The setup requires no special configuration on the source database — neither Postgres nor pgBackRest need to be pre-configured on the primary server.
 
 ### Prerequisites