Skip to content

Docs (migration sync): port PR6540#110782

Merged
Blargian merged 1 commit into
masterfrom
mintlify/e024eb8c
Jul 17, 2026
Merged

Docs (migration sync): port PR6540#110782
Blargian merged 1 commit into
masterfrom
mintlify/e024eb8c

Conversation

@mintlify

@mintlify mintlify Bot commented Jul 17, 2026

Copy link
Copy Markdown
Contributor

Ports clickhouse/clickhouse-docs#6540 — re-land of ClickPipes AWS IAM DB authentication docs (originally #6458, reverted in #6539).

Changes

  • docs/integrations/clickpipes/postgres/auth.mdx — replaced with the re-landed source content: adds "Before you start" section (enable IAM auth in RDS; set up DB user with links to per-source setup guides), moves "Obtaining the RDS/Aurora Resource ID" under "Setting up the IAM role". Removed the pre-existing Mintlify-only Warning callout so the doc matches the source of truth.
  • docs/integrations/clickpipes/postgres/source/rds.mdx — new Using IAM authentication (optional) subsection under Configure database user, with a Note about rds.iam_auth_for_replication and PG 11+ requirement.
  • docs/integrations/clickpipes/postgres/source/aurora.mdx — new Using IAM authentication (optional) subsection under Configure database user.
  • docs/integrations/clickpipes/mysql/source/rds.mdx — new Using IAM authentication (optional) subsection under Configure a database user.
  • docs/integrations/clickpipes/mysql/source/aurora.mdx — new Using IAM authentication (optional) subsection under Configure a database user.

Docusaurus → Mintlify transforms applied: :::note<Note>, relative ./ and ../ links → root-relative slugs, no other structural changes. i18n directories intentionally not updated.

Notes / ambiguity

  • The existing Mintlify postgres/auth.mdx diverged from the Docusaurus source (it contained an extra <Warning> about Initial Load Only and a reorganized Configuring the RDS/Aurora instance section with per-DB user setup snippets). Since Adaptive granularity with enable_mixed_granularity_parts and mutations. #6540 is the authoritative source, this PR restores the auth doc to match it exactly. If the Warning callout was intentional Mintlify-only content that should be preserved, please flag on review.
  • Source PR is currently in draft on the upstream repo pending the feature going live — hold merge here until the upstream PR is marked ready.

cc @Blargian for review.

Changelog category (leave one):

  • Documentation (changelog entry is not required)

Version info

  • Merged into: 26.7.1.1084 (included in 26.7 and later)

@clickhouse-gh

clickhouse-gh Bot commented Jul 17, 2026

Copy link
Copy Markdown
Contributor

Workflow [PR], commit [edb74ac]

Summary:


AI Review

Summary

This PR syncs the ClickPipes AWS IAM DB authentication docs from clickhouse-docs, adding IAM-auth setup guidance to the source-specific RDS/Aurora pages and restructuring the shared auth page. The sync is mostly consistent, but the Aurora PostgreSQL guide drops an important support caveat, so I would request a small doc fix before merge.

Findings

⚠️ Majors

  • [docs/integrations/clickpipes/postgres/source/aurora.mdx:97] The new Aurora IAM-auth subsection implies that enabling rds.iam_auth_for_replication is enough on any Aurora PostgreSQL cluster. Aurora only supports IAM authentication for logical replication from PostgreSQL 11 onward, so users on older Aurora PostgreSQL versions will follow these steps and expect CDC to work even though they are still limited to Initial Load Only. Suggested fix: add the same version / Initial Load Only note that the RDS guide already contains, or move that caveat into the shared auth page so both paths surface it.
Final Verdict
  • Status: ⚠️ Request changes

@clickhouse-gh clickhouse-gh Bot added the pr-documentation Documentation PRs for the specific code PR label Jul 17, 2026
@mintlify

mintlify Bot commented Jul 17, 2026

Copy link
Copy Markdown
Contributor Author

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
ClickHouse-docs 🟢 Ready View Preview Jul 17, 2026, 6:34 AM

Comment thread docs/integrations/clickpipes/postgres/source/aurora.mdx
@Blargian
Blargian added this pull request to the merge queue Jul 17, 2026
Merged via the queue into master with commit 35b650d Jul 17, 2026
178 checks passed
@Blargian
Blargian deleted the mintlify/e024eb8c branch July 17, 2026 10:49
@robot-ch-test-poll2 robot-ch-test-poll2 added the pr-synced-to-cloud The PR is synced to the cloud repo label Jul 17, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

pr-documentation Documentation PRs for the specific code PR pr-synced-to-cloud The PR is synced to the cloud repo

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants