Skip to content

pipelines: Scope PostgreSQL support boundaries in KFP database guide - #4438

Draft
kaikaila wants to merge 1 commit into
kubeflow:masterfrom
kaikaila:docs/add-database-config
Draft

pipelines: Scope PostgreSQL support boundaries in KFP database guide#4438
kaikaila wants to merge 1 commit into
kubeflow:masterfrom
kaikaila:docs/add-database-config

Conversation

@kaikaila

@kaikaila kaikaila commented Jul 27, 2026

Copy link
Copy Markdown
Contributor

Description of Changes

Documents the database backend options for Kubeflow Pipelines, and declares explicitly which PostgreSQL deployment configurations are supported.

KFP can be deployed with PostgreSQL as its database backend, but that support is deliberately scoped to the core deployment path. Without an explicit statement of that boundary, operators have no way to tell which combinations are tested and which are merely untried. This adds that statement to the operator-facing documentation.

New page: Database Configuration (operator-guides/configure-database.md)

  • Documents MySQL as the default backend, and the overlays that assume it.
  • Adds a support scope section for PostgreSQL: the supported configuration, and a table of the combinations that have no corresponding PostgreSQL overlay and are therefore unsupported. Those combinations are also rejected explicitly by the CI deployment script, so they are not exercised in testing.
  • Documents the multi-user PostgreSQL overlay (platform-agnostic-multi-user-postgresql), which was not previously covered.
  • Clarifies that pod-to-pod TLS has no PostgreSQL overlay, and that the absence of a multi-user TLS overlay is not specific to PostgreSQL.
  • Provides a pre-release deployment path using a wrapper overlay, since the released images do not yet include PostgreSQL support.

Installation guide (operator-guides/installation/_index.md)

  • Adds a short PostgreSQL section after the pod-to-pod TLS section, summarising the support scope and linking to the new page.

Related Issues

Related: kubeflow/pipelines#13822

This supersedes #4304, which was closed by the stale bot without receiving a review. That PR could not be reopened because the branch has since been rebased onto current master, which orphaned its recorded head commit.

Note on timing

The PostgreSQL deployment instructions describe the state after the PostgreSQL integration lands on master. Until then, the overlays referenced here are not available at the tags the commands resolve to.

Please hold merging until kubeflow/pipelines#13822 is merged.

Checklist

@google-oss-prow google-oss-prow Bot added size/L area/pipelines AREA: Kubeflow Pipelines labels Jul 27, 2026
@google-oss-prow
google-oss-prow Bot requested review from hbelmiro and mprahl July 27, 2026 18:50
@kaikaila
kaikaila marked this pull request as draft July 27, 2026 18:51
Signed-off-by: Yunkai Li <yunli@redhat.com>
Signed-off-by: kaikaila <lyk2772@126.com>
@kaikaila
kaikaila force-pushed the docs/add-database-config branch from 8d03a9e to 23af462 Compare July 27, 2026 18:55
@google-oss-prow

Copy link
Copy Markdown

[APPROVALNOTIFIER] This PR is NOT APPROVED

This pull-request has been approved by:
Once this PR has been reviewed and has the lgtm label, please ask for approval from rimolive. For more information see the Kubernetes Code Review Process.

The full list of commands accepted by this bot can be found here.

Details Needs approval from an approver in each of these files:

Approvers can indicate their approval by writing /approve in a comment
Approvers can cancel approval by writing /approve cancel in a comment

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants