postgresql-charms-single-kernel 16.3.13__tar.gz → 16.3.15__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (78) hide show
  1. {postgresql_charms_single_kernel-16.3.13 → postgresql_charms_single_kernel-16.3.15}/PKG-INFO +2 -1
  2. {postgresql_charms_single_kernel-16.3.13 → postgresql_charms_single_kernel-16.3.15}/pyproject.toml +2 -1
  3. {postgresql_charms_single_kernel-16.3.13 → postgresql_charms_single_kernel-16.3.15}/pyproject.toml.orig +2 -1
  4. {postgresql_charms_single_kernel-16.3.13 → postgresql_charms_single_kernel-16.3.15}/single_kernel_postgresql/charms/abstract_charm.py +83 -5
  5. {postgresql_charms_single_kernel-16.3.13 → postgresql_charms_single_kernel-16.3.15}/single_kernel_postgresql/charms/k8s_charm.py +45 -8
  6. {postgresql_charms_single_kernel-16.3.13 → postgresql_charms_single_kernel-16.3.15}/single_kernel_postgresql/charms/vm_charm.py +45 -7
  7. {postgresql_charms_single_kernel-16.3.13 → postgresql_charms_single_kernel-16.3.15}/single_kernel_postgresql/config/literals.py +20 -0
  8. {postgresql_charms_single_kernel-16.3.13 → postgresql_charms_single_kernel-16.3.15}/single_kernel_postgresql/events/postgresql.py +13 -1
  9. {postgresql_charms_single_kernel-16.3.13 → postgresql_charms_single_kernel-16.3.15}/single_kernel_postgresql/managers/config.py +24 -2
  10. postgresql_charms_single_kernel-16.3.15/single_kernel_postgresql/managers/refresh.py +692 -0
  11. {postgresql_charms_single_kernel-16.3.13 → postgresql_charms_single_kernel-16.3.15}/single_kernel_postgresql/templates/patroni.yml.j2 +6 -2
  12. {postgresql_charms_single_kernel-16.3.13 → postgresql_charms_single_kernel-16.3.15}/single_kernel_postgresql/workload/vm.py +57 -0
  13. {postgresql_charms_single_kernel-16.3.13 → postgresql_charms_single_kernel-16.3.15}/LICENSE +0 -0
  14. {postgresql_charms_single_kernel-16.3.13 → postgresql_charms_single_kernel-16.3.15}/README.md +0 -0
  15. {postgresql_charms_single_kernel-16.3.13 → postgresql_charms_single_kernel-16.3.15}/single_kernel_postgresql/__init__.py +0 -0
  16. {postgresql_charms_single_kernel-16.3.13 → postgresql_charms_single_kernel-16.3.15}/single_kernel_postgresql/charmcraft.yaml +0 -0
  17. {postgresql_charms_single_kernel-16.3.13 → postgresql_charms_single_kernel-16.3.15}/single_kernel_postgresql/charms/__init__.py +0 -0
  18. {postgresql_charms_single_kernel-16.3.13 → postgresql_charms_single_kernel-16.3.15}/single_kernel_postgresql/compat/__init__.py +0 -0
  19. {postgresql_charms_single_kernel-16.3.13 → postgresql_charms_single_kernel-16.3.15}/single_kernel_postgresql/compat/postgresql.py +0 -0
  20. {postgresql_charms_single_kernel-16.3.13 → postgresql_charms_single_kernel-16.3.15}/single_kernel_postgresql/compat/pyproject.toml +0 -0
  21. {postgresql_charms_single_kernel-16.3.13 → postgresql_charms_single_kernel-16.3.15}/single_kernel_postgresql/config/__init__.py +0 -0
  22. {postgresql_charms_single_kernel-16.3.13 → postgresql_charms_single_kernel-16.3.15}/single_kernel_postgresql/config/enums.py +0 -0
  23. {postgresql_charms_single_kernel-16.3.13 → postgresql_charms_single_kernel-16.3.15}/single_kernel_postgresql/config/exceptions.py +0 -0
  24. {postgresql_charms_single_kernel-16.3.13 → postgresql_charms_single_kernel-16.3.15}/single_kernel_postgresql/config/locales.py +0 -0
  25. {postgresql_charms_single_kernel-16.3.13 → postgresql_charms_single_kernel-16.3.15}/single_kernel_postgresql/config/pyproject.toml +0 -0
  26. {postgresql_charms_single_kernel-16.3.13 → postgresql_charms_single_kernel-16.3.15}/single_kernel_postgresql/config/statuses.py +0 -0
  27. {postgresql_charms_single_kernel-16.3.13 → postgresql_charms_single_kernel-16.3.15}/single_kernel_postgresql/core/__init__.py +0 -0
  28. {postgresql_charms_single_kernel-16.3.13 → postgresql_charms_single_kernel-16.3.15}/single_kernel_postgresql/core/config.py +0 -0
  29. {postgresql_charms_single_kernel-16.3.13 → postgresql_charms_single_kernel-16.3.15}/single_kernel_postgresql/core/peer_relation.py +0 -0
  30. {postgresql_charms_single_kernel-16.3.13 → postgresql_charms_single_kernel-16.3.15}/single_kernel_postgresql/core/relation_state.py +0 -0
  31. {postgresql_charms_single_kernel-16.3.13 → postgresql_charms_single_kernel-16.3.15}/single_kernel_postgresql/core/s3.py +0 -0
  32. {postgresql_charms_single_kernel-16.3.13 → postgresql_charms_single_kernel-16.3.15}/single_kernel_postgresql/core/state.py +0 -0
  33. {postgresql_charms_single_kernel-16.3.13 → postgresql_charms_single_kernel-16.3.15}/single_kernel_postgresql/events/__init__.py +0 -0
  34. {postgresql_charms_single_kernel-16.3.13 → postgresql_charms_single_kernel-16.3.15}/single_kernel_postgresql/events/async_replication.py +0 -0
  35. {postgresql_charms_single_kernel-16.3.13 → postgresql_charms_single_kernel-16.3.15}/single_kernel_postgresql/events/backup.py +0 -0
  36. {postgresql_charms_single_kernel-16.3.13 → postgresql_charms_single_kernel-16.3.15}/single_kernel_postgresql/events/database.py +0 -0
  37. {postgresql_charms_single_kernel-16.3.13 → postgresql_charms_single_kernel-16.3.15}/single_kernel_postgresql/events/ldap.py +0 -0
  38. {postgresql_charms_single_kernel-16.3.13 → postgresql_charms_single_kernel-16.3.15}/single_kernel_postgresql/events/tls.py +0 -0
  39. {postgresql_charms_single_kernel-16.3.13 → postgresql_charms_single_kernel-16.3.15}/single_kernel_postgresql/events/tls_transfer.py +0 -0
  40. {postgresql_charms_single_kernel-16.3.13 → postgresql_charms_single_kernel-16.3.15}/single_kernel_postgresql/events/watcher.py +0 -0
  41. {postgresql_charms_single_kernel-16.3.13 → postgresql_charms_single_kernel-16.3.15}/single_kernel_postgresql/lib/charms/data_platform_libs/v0/data_interfaces.py +0 -0
  42. {postgresql_charms_single_kernel-16.3.13 → postgresql_charms_single_kernel-16.3.15}/single_kernel_postgresql/lib/charms/data_platform_libs/v0/s3.py +0 -0
  43. {postgresql_charms_single_kernel-16.3.13 → postgresql_charms_single_kernel-16.3.15}/single_kernel_postgresql/lib/charms/data_platform_libs/v1/data_models.py +0 -0
  44. {postgresql_charms_single_kernel-16.3.13 → postgresql_charms_single_kernel-16.3.15}/single_kernel_postgresql/lib/charms/glauth_k8s/v0/ldap.py +0 -0
  45. {postgresql_charms_single_kernel-16.3.13 → postgresql_charms_single_kernel-16.3.15}/single_kernel_postgresql/managers/__init__.py +0 -0
  46. {postgresql_charms_single_kernel-16.3.13 → postgresql_charms_single_kernel-16.3.15}/single_kernel_postgresql/managers/async_replication.py +0 -0
  47. {postgresql_charms_single_kernel-16.3.13 → postgresql_charms_single_kernel-16.3.15}/single_kernel_postgresql/managers/backup.py +0 -0
  48. {postgresql_charms_single_kernel-16.3.13 → postgresql_charms_single_kernel-16.3.15}/single_kernel_postgresql/managers/base.py +0 -0
  49. {postgresql_charms_single_kernel-16.3.13 → postgresql_charms_single_kernel-16.3.15}/single_kernel_postgresql/managers/cluster.py +0 -0
  50. {postgresql_charms_single_kernel-16.3.13 → postgresql_charms_single_kernel-16.3.15}/single_kernel_postgresql/managers/database.py +0 -0
  51. {postgresql_charms_single_kernel-16.3.13 → postgresql_charms_single_kernel-16.3.15}/single_kernel_postgresql/managers/k8s.py +0 -0
  52. {postgresql_charms_single_kernel-16.3.13 → postgresql_charms_single_kernel-16.3.15}/single_kernel_postgresql/managers/patroni.py +0 -0
  53. {postgresql_charms_single_kernel-16.3.13 → postgresql_charms_single_kernel-16.3.15}/single_kernel_postgresql/managers/restore.py +0 -0
  54. {postgresql_charms_single_kernel-16.3.13 → postgresql_charms_single_kernel-16.3.15}/single_kernel_postgresql/managers/tls.py +0 -0
  55. {postgresql_charms_single_kernel-16.3.13 → postgresql_charms_single_kernel-16.3.15}/single_kernel_postgresql/scripts/authorisation_rules_observer.py +0 -0
  56. {postgresql_charms_single_kernel-16.3.13 → postgresql_charms_single_kernel-16.3.15}/single_kernel_postgresql/scripts/cluster_topology_observer.py +0 -0
  57. {postgresql_charms_single_kernel-16.3.13 → postgresql_charms_single_kernel-16.3.15}/single_kernel_postgresql/scripts/raft_observer.py +0 -0
  58. {postgresql_charms_single_kernel-16.3.13 → postgresql_charms_single_kernel-16.3.15}/single_kernel_postgresql/scripts/rotate_logs.py +0 -0
  59. {postgresql_charms_single_kernel-16.3.13 → postgresql_charms_single_kernel-16.3.15}/single_kernel_postgresql/templates/__init__.py +0 -0
  60. {postgresql_charms_single_kernel-16.3.13 → postgresql_charms_single_kernel-16.3.15}/single_kernel_postgresql/templates/k8s/pgbackrest.conf.j2 +0 -0
  61. {postgresql_charms_single_kernel-16.3.13 → postgresql_charms_single_kernel-16.3.15}/single_kernel_postgresql/templates/k8s/pgbackrest.logrotate.j2 +0 -0
  62. {postgresql_charms_single_kernel-16.3.13 → postgresql_charms_single_kernel-16.3.15}/single_kernel_postgresql/templates/vm/pgbackrest.conf.j2 +0 -0
  63. {postgresql_charms_single_kernel-16.3.13 → postgresql_charms_single_kernel-16.3.15}/single_kernel_postgresql/templates/vm/pgbackrest.logrotate.j2 +0 -0
  64. {postgresql_charms_single_kernel-16.3.13 → postgresql_charms_single_kernel-16.3.15}/single_kernel_postgresql/utils/__init__.py +0 -0
  65. {postgresql_charms_single_kernel-16.3.13 → postgresql_charms_single_kernel-16.3.15}/single_kernel_postgresql/utils/arch.py +0 -0
  66. {postgresql_charms_single_kernel-16.3.13 → postgresql_charms_single_kernel-16.3.15}/single_kernel_postgresql/utils/backup.py +0 -0
  67. {postgresql_charms_single_kernel-16.3.13 → postgresql_charms_single_kernel-16.3.15}/single_kernel_postgresql/utils/filesystem.py +0 -0
  68. {postgresql_charms_single_kernel-16.3.13 → postgresql_charms_single_kernel-16.3.15}/single_kernel_postgresql/utils/postgresql.py +0 -0
  69. {postgresql_charms_single_kernel-16.3.13 → postgresql_charms_single_kernel-16.3.15}/single_kernel_postgresql/utils/s3.py +0 -0
  70. {postgresql_charms_single_kernel-16.3.13 → postgresql_charms_single_kernel-16.3.15}/single_kernel_postgresql/utils/secret.py +0 -0
  71. {postgresql_charms_single_kernel-16.3.13 → postgresql_charms_single_kernel-16.3.15}/single_kernel_postgresql/utils/status.py +0 -0
  72. {postgresql_charms_single_kernel-16.3.13 → postgresql_charms_single_kernel-16.3.15}/single_kernel_postgresql/workload/__init__.py +0 -0
  73. {postgresql_charms_single_kernel-16.3.13 → postgresql_charms_single_kernel-16.3.15}/single_kernel_postgresql/workload/base.py +0 -0
  74. {postgresql_charms_single_kernel-16.3.13 → postgresql_charms_single_kernel-16.3.15}/single_kernel_postgresql/workload/k8s.py +0 -0
  75. {postgresql_charms_single_kernel-16.3.13 → postgresql_charms_single_kernel-16.3.15}/single_kernel_postgresql/workload/paths/__init__.py +0 -0
  76. {postgresql_charms_single_kernel-16.3.13 → postgresql_charms_single_kernel-16.3.15}/single_kernel_postgresql/workload/paths/base.py +0 -0
  77. {postgresql_charms_single_kernel-16.3.13 → postgresql_charms_single_kernel-16.3.15}/single_kernel_postgresql/workload/paths/k8s.py +0 -0
  78. {postgresql_charms_single_kernel-16.3.13 → postgresql_charms_single_kernel-16.3.15}/single_kernel_postgresql/workload/paths/vm.py +0 -0
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.3
2
2
  Name: postgresql-charms-single-kernel
3
- Version: 16.3.13
3
+ Version: 16.3.15
4
4
  Summary: Shared and reusable code for PostgreSQL-related charms
5
5
  Author: Canonical Data Platform
6
6
  Author-email: Canonical Data Platform <data-platform@lists.launchpad.net>
@@ -209,6 +209,7 @@ License:
209
209
  Classifier: Development Status :: 3 - Alpha
210
210
  Classifier: Intended Audience :: Developers
211
211
  Classifier: Operating System :: POSIX :: Linux
212
+ Requires-Dist: cryptography>=42.0.0
212
213
  Requires-Dist: ops>=2.0.0
213
214
  Requires-Dist: tenacity>=9.0.0
214
215
  Requires-Dist: psycopg2>=2.9.10 ; extra == 'db-driver'
@@ -1,7 +1,7 @@
1
1
  [project]
2
2
  name = "postgresql-charms-single-kernel"
3
3
  description = "Shared and reusable code for PostgreSQL-related charms"
4
- version = "16.3.13"
4
+ version = "16.3.15"
5
5
  readme = "README.md"
6
6
  classifiers = [
7
7
  "Development Status :: 3 - Alpha",
@@ -10,6 +10,7 @@ classifiers = [
10
10
  ]
11
11
  requires-python = ">=3.8,<4.0"
12
12
  dependencies = [
13
+ "cryptography>=42.0.0",
13
14
  "ops>=2.0.0",
14
15
  "tenacity>=9.0.0",
15
16
  ]
@@ -4,7 +4,7 @@
4
4
  [project]
5
5
  name = "postgresql-charms-single-kernel"
6
6
  description = "Shared and reusable code for PostgreSQL-related charms"
7
- version = "16.3.13"
7
+ version = "16.3.15"
8
8
  readme = "README.md"
9
9
  license = {file = "LICENSE"}
10
10
  authors = [
@@ -17,6 +17,7 @@ classifiers = [
17
17
  ]
18
18
  requires-python = ">=3.8,<4.0"
19
19
  dependencies = [
20
+ "cryptography>=42.0.0",
20
21
  "ops>=2.0.0",
21
22
  "tenacity>=9.0.0",
22
23
  ]
@@ -9,6 +9,12 @@ from data_platform_helpers.advanced_statuses import StatusHandler
9
9
  from ops import StatusBase
10
10
  from ops.charm import CharmBase
11
11
 
12
+ if TYPE_CHECKING:
13
+ import charm_refresh
14
+
15
+ from single_kernel_postgresql.managers.k8s import K8sManager
16
+
17
+
12
18
  from single_kernel_postgresql.core.state import CharmState
13
19
  from single_kernel_postgresql.events.async_replication import PostgreSQLAsyncReplication
14
20
  from single_kernel_postgresql.events.database import DatabaseEventsHandler
@@ -27,6 +33,7 @@ from single_kernel_postgresql.managers.cluster import ClusterManager
27
33
  from single_kernel_postgresql.managers.config import ConfigManager
28
34
  from single_kernel_postgresql.managers.database import DatabaseManager
29
35
  from single_kernel_postgresql.managers.patroni import PatroniManager
36
+ from single_kernel_postgresql.managers.refresh import RefreshManager
30
37
  from single_kernel_postgresql.managers.tls import TLSManager
31
38
  from single_kernel_postgresql.workload.base import BaseWorkload, ResourceProvider
32
39
 
@@ -34,9 +41,6 @@ from ..config.enums import Substrates
34
41
  from ..config.literals import DATABASE, S3_RELATION_NAME
35
42
  from ..utils.postgresql import PostgreSQL
36
43
 
37
- if TYPE_CHECKING:
38
- from single_kernel_postgresql.managers.k8s import K8sManager
39
-
40
44
 
41
45
  class AbstractPostgreSQLCharm(CharmBase, ABC):
42
46
  """An abstract PostgreSQL charm."""
@@ -125,6 +129,16 @@ class AbstractPostgreSQLCharm(CharmBase, ABC):
125
129
  restart_services=self.restart_services,
126
130
  )
127
131
 
132
+ # The refresh manager owns the charm_refresh integration and the priority gate
133
+ # every unit status write routes through. Constructed before the events handler
134
+ # so the K8s pebble-ready handler can consult the refresh state.
135
+ self.refresh_manager = RefreshManager(
136
+ state=self.state,
137
+ workload=self.workload,
138
+ charm=self,
139
+ set_default_status=self.set_default_unit_status,
140
+ )
141
+
128
142
  # Events Handler
129
143
  self.postgresql_events_handler = PostgreSQLEventsHandler(
130
144
  self,
@@ -134,12 +148,17 @@ class AbstractPostgreSQLCharm(CharmBase, ABC):
134
148
  self.tls_manager,
135
149
  self.config_manager,
136
150
  self.patroni_manager,
151
+ self.refresh_manager,
137
152
  )
138
153
  self.watcher_handler = WatcherEventsHandler(self, self.workload, self.state)
139
154
 
155
+ # Resume or prepare the refresh (the charms' post-construction resume block).
156
+ self.refresh_manager.on_init()
157
+
140
158
  # Status Handler
141
159
  self.status_handler = StatusHandler(
142
160
  self,
161
+ self.refresh_manager,
143
162
  self.cluster_manager,
144
163
  self.tls_manager,
145
164
  self.config_manager,
@@ -199,15 +218,55 @@ class AbstractPostgreSQLCharm(CharmBase, ABC):
199
218
  pass
200
219
 
201
220
  @abstractmethod
202
- def set_unit_status(self, status: StatusBase) -> None:
221
+ def set_unit_status(
222
+ self,
223
+ status: StatusBase,
224
+ /,
225
+ *,
226
+ refresh: "charm_refresh.Machines | charm_refresh.Kubernetes | None" = None,
227
+ ) -> None:
203
228
  """Set the unit status without overriding a higher-priority refresh status."""
204
229
  pass
205
230
 
206
231
  @abstractmethod
207
- def update_config(self) -> bool:
232
+ def set_default_unit_status(self) -> None:
233
+ """Set the unit status that applies when no refresh status is active."""
234
+ pass
235
+
236
+ @abstractmethod
237
+ def update_config(
238
+ self, *, refresh: "charm_refresh.Machines | charm_refresh.Kubernetes | None" = None
239
+ ) -> bool:
208
240
  """Re-render the Patroni configuration and apply it."""
209
241
  pass
210
242
 
243
+ @abstractmethod
244
+ def post_refresh_side_effects(self) -> None:
245
+ """Run the post-snap-refresh side effects owned by not-yet-migrated modules.
246
+
247
+ The VM charm sets up the exporter and pgBackRest exporter, starts/stops the
248
+ pgBackRest service and updates the watcher unit address here.
249
+ """
250
+ pass
251
+
252
+ @abstractmethod
253
+ def has_async_replication_relation(self) -> bool:
254
+ """Whether this unit is related to an async replication partner.
255
+
256
+ Owned by the async-replication module until that phase migrates; the temp
257
+ tablespace migration skips units inside an async cluster.
258
+ """
259
+ pass
260
+
261
+ @abstractmethod
262
+ def update_relation_endpoints(self) -> None:
263
+ """Refresh the client and async relation endpoints after a switchover.
264
+
265
+ Owned by the client-relation and async-replication modules until those
266
+ phases migrate; the VM pre-refresh checks call it after switching primary.
267
+ """
268
+ pass
269
+
211
270
  # Async-replication wiring helpers. The manager is constructed before the handler,
212
271
  # so the framework-facing plumbing is re-exposed through these late-binding bridges;
213
272
  # create_pgdata/fix_leader_annotation are K8s-only and default to no-ops the K8s
@@ -241,3 +300,22 @@ class AbstractPostgreSQLCharm(CharmBase, ABC):
241
300
  def primary_endpoint(self) -> str | None:
242
301
  """Address of the cluster primary, or None when there is not one."""
243
302
  pass
303
+
304
+ @abstractmethod
305
+ def get_async_primary_cluster_endpoint(self) -> str | None:
306
+ """Endpoint of the primary cluster of the async replication partner, if any.
307
+
308
+ Owned by the async-replication module until that phase migrates; the refresh
309
+ pre-refresh checks need it to decide whether a switchover crosses clusters.
310
+ """
311
+ pass
312
+
313
+ @abstractmethod
314
+ def update_pebble_layers(self) -> None:
315
+ """Reconcile the workload's Pebble layers (K8s)."""
316
+ pass
317
+
318
+ @abstractmethod
319
+ def ensure_pgdata_dirs_and_symlinks(self) -> None:
320
+ """Create the storage directories and symlinks for the PostgreSQL data paths (K8s)."""
321
+ pass
@@ -5,17 +5,20 @@
5
5
  """PostgreSQL Kubernetes Charm."""
6
6
 
7
7
  import logging
8
- from typing import cast
8
+ from typing import TYPE_CHECKING, cast
9
9
 
10
- from ops import StatusBase
10
+ from ops import ActiveStatus, StatusBase
11
11
 
12
12
  from single_kernel_postgresql.charms.abstract_charm import AbstractPostgreSQLCharm, PostgreSQL
13
13
  from single_kernel_postgresql.config.enums import Substrates
14
14
  from single_kernel_postgresql.config.literals import CONTAINER_NAME, SYSTEM_USERS, USER
15
15
  from single_kernel_postgresql.managers.k8s import K8sManager
16
- from single_kernel_postgresql.workload.base import BaseWorkload
16
+ from single_kernel_postgresql.workload.base import BaseWorkload, PebbleLayerSpec
17
17
  from single_kernel_postgresql.workload.k8s import K8sWorkload
18
18
 
19
+ if TYPE_CHECKING:
20
+ import charm_refresh
21
+
19
22
  logger = logging.getLogger(__name__)
20
23
 
21
24
 
@@ -80,8 +83,8 @@ class PostgreSQLK8sCharm(AbstractPostgreSQLCharm):
80
83
  return Substrates.K8S
81
84
 
82
85
  # The concrete production charm owns these bridges (update_scrape_job_spec +
83
- # acquire_lock, pebble metrics/ldap restarts, the refresh-aware status write and the
84
- # config re-render), so they are minimal here.
86
+ # acquire_lock, pebble metrics/ldap restarts, the async app status and the config
87
+ # re-render), so they are minimal here.
85
88
  def get_resource_provider(self) -> K8sManager:
86
89
  """Return the substrate's (cpu_cores, memory_bytes) introspector."""
87
90
  return self.k8s_manager
@@ -92,11 +95,30 @@ class PostgreSQLK8sCharm(AbstractPostgreSQLCharm):
92
95
  def restart_services(self) -> None:
93
96
  """Restart the monitoring and LDAP-sync sidecar services."""
94
97
 
95
- def set_unit_status(self, status: StatusBase) -> None:
98
+ def set_unit_status(
99
+ self,
100
+ status: StatusBase,
101
+ /,
102
+ *,
103
+ refresh: "charm_refresh.Machines | charm_refresh.Kubernetes | None" = None,
104
+ ) -> None:
96
105
  """Set the unit status without overriding a higher-priority refresh status."""
97
- self.unit.status = status
106
+ self.refresh_manager.set_unit_status(status, refresh=refresh)
107
+
108
+ def set_default_unit_status(self) -> None:
109
+ """Set the unit status that applies when no refresh status is active."""
110
+ self.unit.status = ActiveStatus()
111
+
112
+ def post_refresh_side_effects(self) -> None:
113
+ """Run the post-snap-refresh side effects owned by not-yet-migrated modules."""
114
+
115
+ def has_async_replication_relation(self) -> bool:
116
+ """Whether this unit is related to an async replication partner."""
117
+ return False
98
118
 
99
- def update_config(self) -> bool:
119
+ def update_config(
120
+ self, *, refresh: "charm_refresh.Machines | charm_refresh.Kubernetes | None" = None
121
+ ) -> bool:
100
122
  """Re-render the Patroni configuration and apply it."""
101
123
  return self.config_manager.update_config(self.postgresql)
102
124
 
@@ -119,3 +141,18 @@ class PostgreSQLK8sCharm(AbstractPostgreSQLCharm):
119
141
  def primary_endpoint(self) -> str | None:
120
142
  """Address of the cluster primary's Service."""
121
143
  return self.state.primary_endpoint
144
+
145
+ def get_async_primary_cluster_endpoint(self) -> str | None:
146
+ """Endpoint of the primary cluster of the async replication partner, if any."""
147
+ return None
148
+
149
+ def update_relation_endpoints(self) -> None:
150
+ """Refresh the client and async relation endpoints after a switchover."""
151
+
152
+ def update_pebble_layers(self) -> None:
153
+ """Reconcile the workload's Pebble layers."""
154
+ self.workload.update_pebble_layers(PebbleLayerSpec.from_state(self.state))
155
+
156
+ def ensure_pgdata_dirs_and_symlinks(self) -> None:
157
+ """Create the storage directories and symlinks for the PostgreSQL data paths."""
158
+ self.workload.init_storage()
@@ -5,14 +5,18 @@
5
5
  """PostgreSQL VM Charm."""
6
6
 
7
7
  import logging
8
+ from typing import TYPE_CHECKING
8
9
 
9
- from ops import StatusBase
10
+ from ops import ActiveStatus, StatusBase
10
11
 
11
12
  from single_kernel_postgresql.charms.abstract_charm import AbstractPostgreSQLCharm, PostgreSQL
12
13
  from single_kernel_postgresql.config.enums import Substrates
13
14
  from single_kernel_postgresql.config.literals import SYSTEM_USERS, USER
14
15
  from single_kernel_postgresql.workload.vm import VMWorkload
15
16
 
17
+ if TYPE_CHECKING:
18
+ import charm_refresh
19
+
16
20
  logger = logging.getLogger(__name__)
17
21
 
18
22
 
@@ -59,8 +63,8 @@ class PostgreSQLVMCharm(AbstractPostgreSQLCharm):
59
63
  return Substrates.VM
60
64
 
61
65
  # The concrete production charm owns these bridges (pops postgresql_restarted +
62
- # acquire_lock, snap metrics/ldap restarts, the refresh-aware status write, the
63
- # Patroni-derived primary lookup and the config re-render), so they are minimal here.
66
+ # acquire_lock, snap metrics/ldap restarts, the async app status, the Patroni-derived
67
+ # primary lookup and the config re-render), so they are minimal here.
64
68
  def get_resource_provider(self) -> VMWorkload:
65
69
  """Return the substrate's (cpu_cores, memory_bytes) introspector."""
66
70
  return self.workload
@@ -71,13 +75,34 @@ class PostgreSQLVMCharm(AbstractPostgreSQLCharm):
71
75
  def restart_services(self) -> None:
72
76
  """Restart the monitoring and LDAP-sync sidecar services."""
73
77
 
74
- def set_unit_status(self, status: StatusBase) -> None:
78
+ def set_unit_status(
79
+ self,
80
+ status: StatusBase,
81
+ /,
82
+ *,
83
+ refresh: "charm_refresh.Machines | charm_refresh.Kubernetes | None" = None,
84
+ ) -> None:
75
85
  """Set the unit status without overriding a higher-priority refresh status."""
76
- self.unit.status = status
86
+ self.refresh_manager.set_unit_status(status, refresh=refresh)
87
+
88
+ def set_default_unit_status(self) -> None:
89
+ """Set the unit status that applies when no refresh status is active."""
90
+ self.unit.status = ActiveStatus()
91
+
92
+ def post_refresh_side_effects(self) -> None:
93
+ """Set up the exporters, pgBackRest service, and watcher unit address."""
94
+
95
+ def has_async_replication_relation(self) -> bool:
96
+ """Whether this unit is related to an async replication partner."""
97
+ return False
77
98
 
78
- def update_config(self) -> bool:
99
+ def update_config(
100
+ self, *, refresh: "charm_refresh.Machines | charm_refresh.Kubernetes | None" = None
101
+ ) -> bool:
79
102
  """Re-render the Patroni configuration and apply it."""
80
- return self.config_manager.update_config(self.postgresql)
103
+ if refresh is None:
104
+ refresh = self.refresh_manager.refresh
105
+ return self.config_manager.update_config(self.postgresql, refresh=refresh)
81
106
 
82
107
  def set_app_status(self, status: StatusBase) -> None:
83
108
  """Set the application status; the production charm gates this on its own state."""
@@ -91,3 +116,16 @@ class PostgreSQLVMCharm(AbstractPostgreSQLCharm):
91
116
  """Address of the cluster primary, or None when there is not one."""
92
117
  primary = self.patroni_manager.get_primary()
93
118
  return self.patroni_manager.get_member_ip(primary) if primary else None
119
+
120
+ def get_async_primary_cluster_endpoint(self) -> str | None:
121
+ """Endpoint of the primary cluster of the async replication partner, if any."""
122
+ return None
123
+
124
+ def update_relation_endpoints(self) -> None:
125
+ """Refresh the client and async relation endpoints after a switchover."""
126
+
127
+ def update_pebble_layers(self) -> None:
128
+ """Reconcile the workload's Pebble layers (K8s only)."""
129
+
130
+ def ensure_pgdata_dirs_and_symlinks(self) -> None:
131
+ """Create the storage directories and symlinks for the PostgreSQL data paths (K8s only)."""
@@ -12,6 +12,9 @@ POSTGRESQL_STORAGE_PERMISSIONS = 0o700
12
12
 
13
13
  # Snap
14
14
  POSTGRESQL_SNAP_NAME = "charmed-postgresql"
15
+ SNAP_OOM_SCORE_ADJUST_MIN = -900
16
+ SNAP_VITALITY_HINT = "resilience.vitality-hint"
17
+ SNAP_VITALITY_MAX_SNAPS = 100
15
18
 
16
19
  # Relations
17
20
  PEER_RELATION = "database-peers"
@@ -30,6 +33,17 @@ SYSTEM_USERS = [BACKUP_USER, MONITORING_USER, REPLICATION_USER, REWIND_USER, USE
30
33
  # Extensions
31
34
  PG_CRON_DATABASE = "postgres"
32
35
 
36
+ # Libraries the charm pins into `shared_preload_libraries`, in load order.
37
+ # ConfigManager renders only the libraries the installed snap actually ships,
38
+ # so an older snap never receives a preload entry it cannot load.
39
+ SHARED_PRELOAD_LIBRARIES = (
40
+ "timescaledb",
41
+ "pgaudit",
42
+ "set_user",
43
+ "pg_stat_statements",
44
+ "pg_cron",
45
+ )
46
+
33
47
  # Paths
34
48
  ## VM Paths
35
49
  BASE_SNAP_DIR = f"/var/snap/{POSTGRESQL_SNAP_NAME}"
@@ -218,3 +232,9 @@ RESTORE_REPEAT_CAUSE = "restore-backup"
218
232
  # Watcher relation
219
233
  RAFT_PORT = 2222
220
234
  RAFT_PARTNER_PREFIX = "partner_node_status_server_"
235
+ # Refresh (charm_refresh integration)
236
+ WORKLOAD_NAME = "PostgreSQL"
237
+ VM_CHARM_NAME = "postgresql"
238
+ K8S_CHARM_NAME = "postgresql-k8s"
239
+ K8S_OCI_RESOURCE_NAME = "postgresql-image"
240
+ LAST_REFRESH_UNIT_STATUS_FILE = ".last_refresh_unit_status.json"
@@ -29,6 +29,7 @@ from single_kernel_postgresql.core.state import CharmState
29
29
  from single_kernel_postgresql.managers.cluster import ClusterManager
30
30
  from single_kernel_postgresql.managers.config import ConfigManager
31
31
  from single_kernel_postgresql.managers.patroni import PatroniManager
32
+ from single_kernel_postgresql.managers.refresh import RefreshManager
32
33
  from single_kernel_postgresql.managers.tls import TLSManager
33
34
  from single_kernel_postgresql.workload.base import BaseWorkload, PebbleLayerSpec
34
35
  from single_kernel_postgresql.workload.vm import VMWorkload
@@ -51,6 +52,7 @@ class PostgreSQLEventsHandler(Object):
51
52
  tls_manager: TLSManager,
52
53
  config_manager: ConfigManager,
53
54
  patroni_manager: PatroniManager,
55
+ refresh_manager: RefreshManager,
54
56
  ) -> None:
55
57
  super().__init__(charm, key="postgresql_events")
56
58
  self.charm = charm
@@ -60,6 +62,7 @@ class PostgreSQLEventsHandler(Object):
60
62
  self.config_manager = config_manager
61
63
  self.tls_manager = tls_manager
62
64
  self.patroni_manager = patroni_manager
65
+ self.refresh_manager = refresh_manager
63
66
 
64
67
  # Charm events
65
68
  self.framework.observe(self.charm.on.install, self._on_install)
@@ -123,7 +126,16 @@ class PostgreSQLEventsHandler(Object):
123
126
 
124
127
  def _on_postgresql_pebble_ready(self, event: WorkloadEvent) -> None:
125
128
  """Event handler for PostgreSQL container on PebbleReadyEvent."""
126
- # TODO: Safeguard against refresh
129
+ # Safeguard against starting while refreshing.
130
+ if self.refresh_manager.refresh is None:
131
+ logger.warning("Warning on_postgresql_pebble_ready: Refresh could be in progress")
132
+ elif (
133
+ self.refresh_manager.refresh.in_progress
134
+ and not self.refresh_manager.refresh.workload_allowed_to_start
135
+ ):
136
+ logger.debug("Defer on_postgresql_pebble_ready: Refresh in progress")
137
+ event.defer()
138
+ return
127
139
  if self.state.endpoint in self.state.endpoints:
128
140
  # TODO: Fix pod by adding services
129
141
  pass
@@ -9,6 +9,7 @@ Responsible for managing the configuration of the PostgreSQL instance.
9
9
 
10
10
  import importlib.resources
11
11
  import logging
12
+ import pathlib
12
13
  from collections.abc import Callable
13
14
  from functools import cached_property
14
15
  from hashlib import shake_128
@@ -26,8 +27,10 @@ from single_kernel_postgresql.config.exceptions import PostgreSQLCannotConnectEr
26
27
  from single_kernel_postgresql.config.literals import (
27
28
  PG_CRON_DATABASE,
28
29
  PGBACKREST_CONF_FILE,
30
+ POSTGRESQL_SNAP_NAME,
29
31
  POSTGRESQL_STORAGE_PERMISSIONS,
30
32
  REWIND_USER,
33
+ SHARED_PRELOAD_LIBRARIES,
31
34
  USER,
32
35
  )
33
36
  from single_kernel_postgresql.config.statuses import GeneralStatuses
@@ -48,6 +51,16 @@ if TYPE_CHECKING:
48
51
  logger = logging.getLogger(__name__)
49
52
 
50
53
 
54
+ def _snap_provided_libraries() -> set[str]:
55
+ """Libraries shipped by the currently installed PostgreSQL snap."""
56
+ return {
57
+ path.stem
58
+ for path in pathlib.Path(f"/snap/{POSTGRESQL_SNAP_NAME}/current/usr/lib/postgresql").glob(
59
+ "*/lib/*.so"
60
+ )
61
+ }
62
+
63
+
51
64
  class ConfigManager(BaseManager):
52
65
  """PostgreSQL Config Manager.
53
66
 
@@ -481,7 +494,7 @@ class ConfigManager(BaseManager):
481
494
  watcher_raft_address: str | None = None,
482
495
  no_peers: bool = False,
483
496
  *,
484
- refresh: charm_refresh.Machines | None = None,
497
+ refresh: charm_refresh.Machines | charm_refresh.Kubernetes | None = None,
485
498
  ) -> bool:
486
499
  """Updates Patroni config file based on the existence of the TLS files.
487
500
 
@@ -580,7 +593,7 @@ class ConfigManager(BaseManager):
580
593
  self.state.substrate == Substrates.VM
581
594
  and refresh is not None
582
595
  and cast("VMWorkload", self.workload).get_snap_revision()
583
- != refresh.pinned_snap_revision
596
+ != cast("charm_refresh.Machines", refresh).pinned_snap_revision
584
597
  ):
585
598
  logger.debug("Early exit: snap was not refreshed to the right version yet")
586
599
  return True
@@ -699,6 +712,9 @@ class ConfigManager(BaseManager):
699
712
  "extra_replication_endpoints": async_standby_endpoints,
700
713
  }
701
714
  if self.state.substrate == Substrates.VM:
715
+ # The installed snap may predate a library the charm pins (e.g.
716
+ # pg_cron); only preload what the snap actually ships.
717
+ snap_libraries = _snap_provided_libraries()
702
718
  confs.update({
703
719
  "conf_path": str(self.workload.paths.patroni_conf),
704
720
  "log_path": str(self.workload.paths.patroni_logs),
@@ -713,6 +729,10 @@ class ConfigManager(BaseManager):
713
729
  "listen_ips": self.state.listen_ips,
714
730
  "raft_password": self.state.application.raft_password,
715
731
  "watcher": watcher_raft_address,
732
+ "pg_cron_available": "pg_cron" in snap_libraries,
733
+ "shared_preload_libraries": ",".join(
734
+ library for library in SHARED_PRELOAD_LIBRARIES if library in snap_libraries
735
+ ),
716
736
  })
717
737
  perms = 0o600
718
738
  else:
@@ -725,6 +745,8 @@ class ConfigManager(BaseManager):
725
745
  "logs_storage_path": str(self.workload.paths.logs),
726
746
  "pgdata_path": str(self.workload.paths.data),
727
747
  "restoring_backup": backup_id is not None or pitr_target is not None,
748
+ "pg_cron_available": True,
749
+ "shared_preload_libraries": ",".join(SHARED_PRELOAD_LIBRARIES),
728
750
  })
729
751
  perms = 0o644
730
752
  rendered = template.render(**confs)