Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
112 changes: 112 additions & 0 deletions .github/workflows/update-property-docs.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,112 @@
---
name: Generate Property Docs

on:
workflow_dispatch:
inputs:
tag:
description: "Tag to use for property doc generation"
required: true
type: string
repository_dispatch:
types: [trigger-property-docs-generation]

jobs:
generate-property-docs:
runs-on: ubuntu-24.04
permissions:
id-token: write
contents: write
pull-requests: write

steps:
- name: Configure AWS credentials
uses: aws-actions/configure-aws-credentials@v4
with:
aws-region: ${{ vars.RP_AWS_CRED_REGION }}
role-to-assume: arn:aws:iam::${{ secrets.RP_AWS_CRED_ACCOUNT_ID }}:role/${{ vars.RP_AWS_CRED_BASE_ROLE_NAME }}${{ github.event.repository.name }}

- name: Get secrets from AWS Secrets Manager
uses: aws-actions/aws-secretsmanager-get-secrets@v2
with:
secret-ids: |
,sdlc/prod/github/actions_bot_token
parse-json-secrets: true

- name: Checkout the repository
uses: actions/checkout@v4
with:
ref: main
token: ${{ env.ACTIONS_BOT_TOKEN }}

- name: Set up Node.js
uses: actions/setup-node@v4
with:
node-version: 20

- name: Install dependencies
run: npm ci

- name: Determine tag
id: tag
run: |
if [ -n "${{ github.event.inputs.tag }}" ]; then
echo "tag=${{ github.event.inputs.tag }}" >> $GITHUB_OUTPUT
elif [ -n "${{ github.event.client_payload.tag }}" ]; then
echo "tag=${{ github.event.client_payload.tag }}" >> $GITHUB_OUTPUT
else
echo "❌ No tag provided via input or dispatch payload" >&2
exit 1
fi

- name: Check if tag is newer than antora.yml latest
id: version_check
run: |
set -euo pipefail
TAG="${{ steps.tag.outputs.tag }}"
CURRENT=$(grep 'latest-redpanda-tag:' antora.yml | awk '{print $2}' | tr -d '"')

echo "📄 Current latest-redpanda-tag in antora.yml: $CURRENT"
echo "🔖 Incoming tag: $TAG"

# Strip leading 'v' for numeric comparison
CUR_NUM=$(echo "$CURRENT" | sed 's/^v//')
NEW_NUM=$(echo "$TAG" | sed 's/^v//')

# Compare semver using sort -V
if [ "$(printf "%s\n%s" "$CUR_NUM" "$NEW_NUM" | sort -V | tail -n1)" = "$NEW_NUM" ] && [ "$CUR_NUM" != "$NEW_NUM" ]; then
echo "$TAG is newer than $CURRENT"
echo "is_newer=true" >> $GITHUB_OUTPUT
else
echo "$TAG is not newer than $CURRENT — skipping doc generation"
echo "is_newer=false" >> $GITHUB_OUTPUT
fi

- name: Generate property docs
if: steps.version_check.outputs.is_newer == 'true'
run: |
set -euo pipefail
echo "Running doc generation for: ${{ steps.tag.outputs.tag }}"
npx doc-tools generate property-docs \
--tag "${{ steps.tag.outputs.tag }}" \
--generate-partials \
--cloud-support \
--overrides docs-data/property-overrides.json
env:
GITHUB_TOKEN: ${{ env.ACTIONS_BOT_TOKEN }}

- name: Create pull request
if: steps.version_check.outputs.is_newer == 'true'
uses: peter-evans/create-pull-request@v6
with:
token: ${{ env.ACTIONS_BOT_TOKEN }}
commit-message: "auto-docs: Update property docs for ${{ steps.tag.outputs.tag }}"
branch: update-property-docs-${{ steps.tag.outputs.tag }}
title: "auto-docs: Update property docs for tag ${{ steps.tag.outputs.tag }}"
body: |
This PR auto-generates updated Redpanda property documentation for **${{ steps.tag.outputs.tag }}**.
labels: auto-docs

- name: Skip notice
if: steps.version_check.outputs.is_newer != 'true'
run: echo "🟡 Skipping doc generation — tag is not newer than latest-redpanda-tag in antora.yml."
119 changes: 57 additions & 62 deletions antora.yml
Original file line number Diff line number Diff line change
Expand Up @@ -3,45 +3,40 @@ title: Self-Managed
version: 25.2
start_page: home:index.adoc
nav:
- modules/ROOT/nav.adoc
- modules/ROOT/nav.adoc
asciidoc:
attributes:
# Date of release in the format YYYY-MM-DD
page-release-date: 2025-07-31
# Only used in the main branch (latest version)
page-release-date: 2025-07-31T00:00:00.000Z
page-header-data:
order: 2
color: '#107569'
# Name of the Redpanda UI used in single-sourced content with Redpanda Cloud.
ui: Redpanda Console@
# Fallback versions
# We try to fetch the latest versions from GitHub at build time
# --
full-version: 25.2.1
latest-redpanda-tag: 'v25.2.1'
latest-console-tag: 'v2.8.5'
latest-release-commit: '68c64fd'
latest-operator-version: 'v2.3.8-24.3.6'
operator-beta-tag: 'v25.1.1-beta1'
helm-beta-tag: 'v25.1.1-beta1'
latest-redpanda-tag: v25.2.10
latest-console-tag: v2.8.5
latest-release-commit: 68c64fd
latest-operator-version: v2.3.8-24.3.6
operator-beta-tag: v25.1.1-beta1
helm-beta-tag: v25.1.1-beta1
Comment on lines +15 to +20
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

not using ' anymore?

latest-redpanda-helm-chart-version: 5.10.1
redpanda-beta-version: '25.1.1-rc3'
redpanda-beta-tag: '25.1.1-rc3'
console-beta-version: '3.0.0-beta.1'
console-beta-tag: 'v3.0.0-beta.1'
# --
redpanda-beta-version: 25.1.1-rc3
redpanda-beta-tag: 25.1.1-rc3
console-beta-version: 3.0.0-beta.1
console-beta-tag: v3.0.0-beta.1
supported-kubernetes-version: 1.27.0-0
supported-helm-version: 3.10.0
supported-rhel-required: '8'
supported-rhel-recommended: '9+'
supported-ubuntu-required: '20.04 LTS'
supported-ubuntu-recommended: '22.04+'
badge-deprecated: 'image:https://img.shields.io/badge/-Deprecated-red.svg[xref=upgrade:deprecated/index.adoc]'
supported-rhel-recommended: 9+
supported-ubuntu-required: 20.04 LTS
supported-ubuntu-recommended: 22.04+
badge-deprecated: image:https://img.shields.io/badge/-Deprecated-red.svg[xref=upgrade:deprecated/index.adoc]
removals-without-aliases:
- page: reference/rpk/rpk-cloud/
reason: Pages moved to Redpanda Cloud. # https://github.com/redpanda-data/docs-site/pull/75
reason: Pages moved to Redpanda Cloud.
- page: upgrade/deprecated/cluster-resource/
reason: The cluster resource was deprecated in version 23.2. We no longer need a page dedicated to migration in this version.
reason: >-
The cluster resource was deprecated in version 23.2. We no longer need a page dedicated to migration in this
version.
- page: develop/chat-room/
reason: Page moved to Redpanda Labs.
- page: develop/chat-room-docker/
Expand Down Expand Up @@ -86,43 +81,43 @@ asciidoc:
page-home-intro-learn-more: get-started:intro-to-events.adoc
page-home-primary-row-title: Deploy
page-home-primary-row:
- title: 'Docker quickstart'
description: 'Start using Redpanda in a self-managed environment.'
url: 'get-started:quick-start.adoc'
link-text: 'Get started'
- title: 'Kubernetes'
description: 'Learn how to deploy Redpanda on Kubernetes.'
url: 'deploy:deployment-option/self-hosted/kubernetes/index.adoc'
link-text: 'Get started'
- title: 'Linux'
description: 'Learn how to deploy Redpanda on Linux.'
url: 'deploy:deployment-option/self-hosted/manual/index.adoc'
link-text: 'Get started'
- title: Docker quickstart
description: Start using Redpanda in a self-managed environment.
url: get-started:quick-start.adoc
link-text: Get started
- title: Kubernetes
description: Learn how to deploy Redpanda on Kubernetes.
url: deploy:deployment-option/self-hosted/kubernetes/index.adoc
link-text: Get started
- title: Linux
description: Learn how to deploy Redpanda on Linux.
url: deploy:deployment-option/self-hosted/manual/index.adoc
link-text: Get started
page-home-secondary-row-title: Popular topics
page-home-secondary-row:
- title: "What's new"
description: 'Explore new features in this release.'
url: 'get-started:whats-new.adoc'
link-text: 'Learn more'
- title: 'Data transforms'
description: 'Get started with data transforms.'
url: 'develop:data-transforms/run-transforms-index.adoc'
link-text: 'Learn more'
- title: 'Monitor'
description: 'Configure monitoring to optimize performance.'
url: 'manage:monitoring.adoc'
link-text: 'Learn more'
- title: 'rpk commands'
description: 'Redpanda CLI reference for Self-Managed Redpanda.'
url: 'reference:rpk/index.adoc'
link-text: 'Learn more'
page-home-tertiary-row-title: 'Labs'
- title: What's new
description: Explore new features in this release.
url: get-started:whats-new.adoc
link-text: Learn more
- title: Data transforms
description: Get started with data transforms.
url: develop:data-transforms/run-transforms-index.adoc
link-text: Learn more
- title: Monitor
description: Configure monitoring to optimize performance.
url: manage:monitoring.adoc
link-text: Learn more
- title: rpk commands
description: Redpanda CLI reference for Self-Managed Redpanda.
url: reference:rpk/index.adoc
link-text: Learn more
page-home-tertiary-row-title: Labs
page-home-tertiary-row:
- title: 'Set up Postgres CDC with Debezium and Redpanda'
url: 'redpanda-labs:docker-compose:cdc-postgres-json.adoc'
- title: 'Redact information in JSON messages'
url: 'redpanda-labs:data-transforms:redaction-go.adoc'
- title: 'Stream text embeddings with Redpanda, OpenAI, and MongoDB'
url: 'redpanda-labs:redpanda-connect:openai.adoc'
- title: 'Build a chat room application with Redpanda and Rust'
url: 'redpanda-labs:clients:docker-rust.adoc'
- title: Set up Postgres CDC with Debezium and Redpanda
url: redpanda-labs:docker-compose:cdc-postgres-json.adoc
- title: Redact information in JSON messages
url: redpanda-labs:data-transforms:redaction-go.adoc
- title: Stream text embeddings with Redpanda, OpenAI, and MongoDB
url: redpanda-labs:redpanda-connect:openai.adoc
- title: Build a chat room application with Redpanda and Rust
url: redpanda-labs:clients:docker-rust.adoc
Loading