Skip to content

[DPE-10887] refactor(relations): adopt the single-kernel client relation - #1900

Draft
marceloneppel wants to merge 3 commits into
16/edgefrom
skl-02-adopt-database-provider
Draft

[DPE-10887] refactor(relations): adopt the single-kernel client relation#1900
marceloneppel wants to merge 3 commits into
16/edgefrom
skl-02-adopt-database-provider

Conversation

@marceloneppel

@marceloneppel marceloneppel commented Aug 17, 2026

Copy link
Copy Markdown
Member

Issue

src/relations/postgresql_provider.py (645 lines) is a near-copy of the K8s charm's version of the same file, and the library now owns the postgresql-client relation. Keeping both means two implementations of one databag contract drifting apart — which is where the doubled-port read-only URI the library fixes came from.

Solution

Deletes the charm's provider and its tests, and constructs single_kernel_postgresql.events.database.DatabaseEventsHandler instead. The remaining call sites move to the manager it builds: oversee_users() now takes the PostgreSQL client, update_endpoints() takes an optional relation id rather than an event.

Two seams close with it:

  • refresh_endpoints is gone. ConfigManager holds the database manager and refreshes endpoints itself.
  • update_config no longer takes a user hash. _collect_user_relations delegates to the manager, and the hash is derived from the same relation data the user-databases map comes from, so generate_user_hash had nothing left to do.

relations_user_databases_map stays here — its computation diverges between the substrates and belongs to the core event-loop phase.

Behaviour is unchanged on this substrate. The library keeps VM's relation-<id> role names, its Patroni-member endpoint derivation, its createdb extra-user-role allowance, and its PostgreSQLBaseError catch, all substrate-gated.

Checklist

  • I have added or updated any relevant documentation.
  • I have cleaned any remaining cloud resources from my accounts.

@marceloneppel
marceloneppel force-pushed the skl-02-adopt-database-provider branch from 6ddf535 to f18998d Compare August 17, 2026 19:47
@github-actions github-actions Bot added the Libraries: Out of sync The charm libs used are out-of-sync label Aug 18, 2026
@marceloneppel
marceloneppel force-pushed the skl-01-adopt-update-config branch 2 times, most recently from 43dac9e to 429abf3 Compare August 18, 2026 21:20
@marceloneppel
marceloneppel force-pushed the skl-02-adopt-database-provider branch from b7e5521 to 2ee2329 Compare August 18, 2026 21:34
Base automatically changed from skl-01-adopt-update-config to 16/edge August 19, 2026 21:07
@marceloneppel marceloneppel added the not bug or enhancement PR is not 'bug' or 'enhancement'. For release notes label Aug 20, 2026
@marceloneppel marceloneppel changed the title [DPE-10844] refactor(relations): adopt the single-kernel client relation [DPE-10887] refactor(relations): adopt the single-kernel client relation Aug 20, 2026
Migrate the charm's update_config, resource introspection, and TLS
reload onto the single-kernel library, now published as 16.3.5: the
charm delegates Patroni config re-render to the lib's ConfigManager,
reads available resources through the lib, and observes the lib's
tls_files_pushed event for the TLS reload bridge. Drops the charm's
now-redundant patroni.yml.j2 template and update_config tests.

The pin moves from the pre-merge archive-URL SHA to the published 16.3.5
release (extras: postgresql, vm) -- same lib tree, now sourced from
PyPI; the adoption code is unchanged.

Signed-off-by: Marcelo Henrique Neppel <marcelo.neppel@canonical.com>
Move the database (client) relation provider into the single-kernel library:
delete the charm's src/relations/postgresql_provider.py and its tests, and
wire the provider events through the lib's DatabaseManager. The charm
implements get_resource_provider so the lib's ConfigManager reads substrate
resources via the resource_provider injection contract (lib #215) on the
db-provider lib branch.

Pin the lib at the rebased test/02-db-events tip (archive-URL SHA, since the
db-provider stack is not yet published to PyPI), stacked on the skl-01 16.3.5
update_config adoption.

Signed-off-by: Marcelo Henrique Neppel <marcelo.neppel@canonical.com>
@marceloneppel
marceloneppel force-pushed the skl-02-adopt-database-provider branch from 72954e6 to 90720c8 Compare August 20, 2026 18:00
The pinned archive moves from 335f89b to 41009a8 so the charm picks up
the port review's rework: all status writes now route through the
refresh-gated set_unit_status, K8s keeps its whole-relation endpoint
refresh and its own defer wording, the user hash freezes per hook, the
failed-init blocking message converges on the clearer wording with the
unblock substring widened to match, and the lib version advances to
16.3.6 so the release ships the complete database subsystem.

Signed-off-by: Marcelo Henrique Neppel <marcelo.neppel@canonical.com>
@marceloneppel
marceloneppel force-pushed the skl-02-adopt-database-provider branch from 90720c8 to 065e94d Compare August 20, 2026 20:09
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Libraries: Out of sync The charm libs used are out-of-sync not bug or enhancement PR is not 'bug' or 'enhancement'. For release notes

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant