postgresql-charms-single-kernel 16.3.19__tar.gz → 16.3.21__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 (114) hide show
  1. {postgresql_charms_single_kernel-16.3.19 → postgresql_charms_single_kernel-16.3.21}/PKG-INFO +5 -2
  2. {postgresql_charms_single_kernel-16.3.19 → postgresql_charms_single_kernel-16.3.21}/pyproject.toml +5 -2
  3. {postgresql_charms_single_kernel-16.3.19 → postgresql_charms_single_kernel-16.3.21}/pyproject.toml.orig +6 -3
  4. {postgresql_charms_single_kernel-16.3.19 → postgresql_charms_single_kernel-16.3.21}/single_kernel_postgresql/charms/abstract_charm.py +260 -7
  5. postgresql_charms_single_kernel-16.3.21/single_kernel_postgresql/charms/k8s_charm.py +646 -0
  6. postgresql_charms_single_kernel-16.3.21/single_kernel_postgresql/charms/vm_charm.py +566 -0
  7. {postgresql_charms_single_kernel-16.3.19 → postgresql_charms_single_kernel-16.3.21}/single_kernel_postgresql/config/exceptions.py +8 -0
  8. {postgresql_charms_single_kernel-16.3.19 → postgresql_charms_single_kernel-16.3.21}/single_kernel_postgresql/config/literals.py +19 -3
  9. {postgresql_charms_single_kernel-16.3.19 → postgresql_charms_single_kernel-16.3.21}/single_kernel_postgresql/config/statuses.py +6 -0
  10. {postgresql_charms_single_kernel-16.3.19 → postgresql_charms_single_kernel-16.3.21}/single_kernel_postgresql/core/peer_relation.py +29 -0
  11. {postgresql_charms_single_kernel-16.3.19 → postgresql_charms_single_kernel-16.3.21}/single_kernel_postgresql/core/state.py +4 -2
  12. {postgresql_charms_single_kernel-16.3.19 → postgresql_charms_single_kernel-16.3.21}/single_kernel_postgresql/events/async_replication.py +35 -24
  13. {postgresql_charms_single_kernel-16.3.19 → postgresql_charms_single_kernel-16.3.21}/single_kernel_postgresql/events/database.py +8 -10
  14. {postgresql_charms_single_kernel-16.3.19 → postgresql_charms_single_kernel-16.3.21}/single_kernel_postgresql/events/observer.py +10 -53
  15. postgresql_charms_single_kernel-16.3.21/single_kernel_postgresql/events/postgresql.py +2045 -0
  16. {postgresql_charms_single_kernel-16.3.19 → postgresql_charms_single_kernel-16.3.21}/single_kernel_postgresql/events/tls_transfer.py +9 -8
  17. postgresql_charms_single_kernel-16.3.21/single_kernel_postgresql/lib/charms/certificate_transfer_interface/v0/certificate_transfer.py +432 -0
  18. postgresql_charms_single_kernel-16.3.21/single_kernel_postgresql/lib/charms/grafana_agent/v0/cos_agent.py +1472 -0
  19. postgresql_charms_single_kernel-16.3.21/single_kernel_postgresql/lib/charms/grafana_k8s/v0/grafana_dashboard.py +2149 -0
  20. postgresql_charms_single_kernel-16.3.21/single_kernel_postgresql/lib/charms/loki_k8s/v1/loki_push_api.py +2916 -0
  21. postgresql_charms_single_kernel-16.3.21/single_kernel_postgresql/lib/charms/prometheus_k8s/v0/prometheus_scrape.py +1785 -0
  22. postgresql_charms_single_kernel-16.3.21/single_kernel_postgresql/lib/charms/rolling_ops/v0/rollingops.py +425 -0
  23. {postgresql_charms_single_kernel-16.3.19 → postgresql_charms_single_kernel-16.3.21}/single_kernel_postgresql/managers/async_replication.py +49 -30
  24. {postgresql_charms_single_kernel-16.3.19 → postgresql_charms_single_kernel-16.3.21}/single_kernel_postgresql/managers/backup.py +137 -22
  25. postgresql_charms_single_kernel-16.3.21/single_kernel_postgresql/managers/cluster.py +404 -0
  26. postgresql_charms_single_kernel-16.3.21/single_kernel_postgresql/managers/cluster_membership.py +738 -0
  27. {postgresql_charms_single_kernel-16.3.19 → postgresql_charms_single_kernel-16.3.21}/single_kernel_postgresql/managers/config.py +306 -15
  28. {postgresql_charms_single_kernel-16.3.19 → postgresql_charms_single_kernel-16.3.21}/single_kernel_postgresql/managers/database.py +38 -5
  29. postgresql_charms_single_kernel-16.3.21/single_kernel_postgresql/managers/k8s.py +347 -0
  30. {postgresql_charms_single_kernel-16.3.19 → postgresql_charms_single_kernel-16.3.21}/single_kernel_postgresql/managers/logical_replication.py +21 -3
  31. {postgresql_charms_single_kernel-16.3.19 → postgresql_charms_single_kernel-16.3.21}/single_kernel_postgresql/managers/observer.py +7 -0
  32. {postgresql_charms_single_kernel-16.3.19 → postgresql_charms_single_kernel-16.3.21}/single_kernel_postgresql/managers/patroni.py +179 -15
  33. {postgresql_charms_single_kernel-16.3.19 → postgresql_charms_single_kernel-16.3.21}/single_kernel_postgresql/managers/raft.py +64 -29
  34. {postgresql_charms_single_kernel-16.3.19 → postgresql_charms_single_kernel-16.3.21}/single_kernel_postgresql/managers/refresh.py +146 -16
  35. {postgresql_charms_single_kernel-16.3.19 → postgresql_charms_single_kernel-16.3.21}/single_kernel_postgresql/managers/restore.py +78 -4
  36. postgresql_charms_single_kernel-16.3.21/single_kernel_postgresql/payloads/k8s/grafana_dashboards/postgresql-metrics.json +3765 -0
  37. postgresql_charms_single_kernel-16.3.21/single_kernel_postgresql/payloads/k8s/grafana_dashboards/postgresql-patroni-metrics.json +3337 -0
  38. postgresql_charms_single_kernel-16.3.21/single_kernel_postgresql/payloads/k8s/grafana_dashboards/postgresql-pgbackrest-metrics.json +7121 -0
  39. postgresql_charms_single_kernel-16.3.21/single_kernel_postgresql/payloads/k8s/loki_alert_rules/.gitkeep +0 -0
  40. postgresql_charms_single_kernel-16.3.21/single_kernel_postgresql/payloads/k8s/prometheus_alert_rules/patroni_rules.yaml +55 -0
  41. postgresql_charms_single_kernel-16.3.21/single_kernel_postgresql/payloads/k8s/prometheus_alert_rules/pgbackrest_rules.yaml +69 -0
  42. postgresql_charms_single_kernel-16.3.21/single_kernel_postgresql/payloads/k8s/prometheus_alert_rules/pgbouncer_rules.yaml +46 -0
  43. postgresql_charms_single_kernel-16.3.21/single_kernel_postgresql/payloads/k8s/prometheus_alert_rules/postgresql_rules.yaml +281 -0
  44. postgresql_charms_single_kernel-16.3.21/single_kernel_postgresql/payloads/vm/grafana_dashboards/postgresql-metrics.json +3764 -0
  45. postgresql_charms_single_kernel-16.3.21/single_kernel_postgresql/payloads/vm/grafana_dashboards/postgresql-patroni-metrics.json +3337 -0
  46. postgresql_charms_single_kernel-16.3.21/single_kernel_postgresql/payloads/vm/grafana_dashboards/postgresql-pgbackrest-metrics.json +7120 -0
  47. postgresql_charms_single_kernel-16.3.21/single_kernel_postgresql/payloads/vm/loki_alert_rules/.gitkeep +0 -0
  48. postgresql_charms_single_kernel-16.3.21/single_kernel_postgresql/payloads/vm/prometheus_alert_rules/patroni_rules.yaml +55 -0
  49. postgresql_charms_single_kernel-16.3.21/single_kernel_postgresql/payloads/vm/prometheus_alert_rules/pgbackrest_rules.yaml +69 -0
  50. postgresql_charms_single_kernel-16.3.21/single_kernel_postgresql/payloads/vm/prometheus_alert_rules/pgbouncer_rules.yaml +46 -0
  51. postgresql_charms_single_kernel-16.3.21/single_kernel_postgresql/payloads/vm/prometheus_alert_rules/postgresql_rules.yaml +281 -0
  52. {postgresql_charms_single_kernel-16.3.19 → postgresql_charms_single_kernel-16.3.21}/single_kernel_postgresql/utils/__init__.py +49 -23
  53. {postgresql_charms_single_kernel-16.3.19 → postgresql_charms_single_kernel-16.3.21}/single_kernel_postgresql/utils/backup.py +6 -0
  54. postgresql_charms_single_kernel-16.3.21/single_kernel_postgresql/utils/payloads.py +22 -0
  55. postgresql_charms_single_kernel-16.3.21/single_kernel_postgresql/utils/tracing.py +39 -0
  56. {postgresql_charms_single_kernel-16.3.19 → postgresql_charms_single_kernel-16.3.21}/single_kernel_postgresql/workload/base.py +9 -1
  57. {postgresql_charms_single_kernel-16.3.19 → postgresql_charms_single_kernel-16.3.21}/single_kernel_postgresql/workload/k8s.py +125 -26
  58. {postgresql_charms_single_kernel-16.3.19 → postgresql_charms_single_kernel-16.3.21}/single_kernel_postgresql/workload/vm.py +23 -0
  59. postgresql_charms_single_kernel-16.3.19/single_kernel_postgresql/charms/k8s_charm.py +0 -158
  60. postgresql_charms_single_kernel-16.3.19/single_kernel_postgresql/charms/vm_charm.py +0 -177
  61. postgresql_charms_single_kernel-16.3.19/single_kernel_postgresql/events/postgresql.py +0 -253
  62. postgresql_charms_single_kernel-16.3.19/single_kernel_postgresql/managers/cluster.py +0 -151
  63. postgresql_charms_single_kernel-16.3.19/single_kernel_postgresql/managers/k8s.py +0 -145
  64. {postgresql_charms_single_kernel-16.3.19 → postgresql_charms_single_kernel-16.3.21}/LICENSE +0 -0
  65. {postgresql_charms_single_kernel-16.3.19 → postgresql_charms_single_kernel-16.3.21}/README.md +0 -0
  66. {postgresql_charms_single_kernel-16.3.19 → postgresql_charms_single_kernel-16.3.21}/single_kernel_postgresql/__init__.py +0 -0
  67. {postgresql_charms_single_kernel-16.3.19 → postgresql_charms_single_kernel-16.3.21}/single_kernel_postgresql/charms/__init__.py +0 -0
  68. {postgresql_charms_single_kernel-16.3.19 → postgresql_charms_single_kernel-16.3.21}/single_kernel_postgresql/compat/__init__.py +0 -0
  69. {postgresql_charms_single_kernel-16.3.19 → postgresql_charms_single_kernel-16.3.21}/single_kernel_postgresql/compat/postgresql.py +0 -0
  70. {postgresql_charms_single_kernel-16.3.19 → postgresql_charms_single_kernel-16.3.21}/single_kernel_postgresql/compat/pyproject.toml +0 -0
  71. {postgresql_charms_single_kernel-16.3.19 → postgresql_charms_single_kernel-16.3.21}/single_kernel_postgresql/config/__init__.py +0 -0
  72. {postgresql_charms_single_kernel-16.3.19 → postgresql_charms_single_kernel-16.3.21}/single_kernel_postgresql/config/enums.py +0 -0
  73. {postgresql_charms_single_kernel-16.3.19 → postgresql_charms_single_kernel-16.3.21}/single_kernel_postgresql/config/locales.py +0 -0
  74. {postgresql_charms_single_kernel-16.3.19 → postgresql_charms_single_kernel-16.3.21}/single_kernel_postgresql/config/pyproject.toml +0 -0
  75. {postgresql_charms_single_kernel-16.3.19 → postgresql_charms_single_kernel-16.3.21}/single_kernel_postgresql/core/__init__.py +0 -0
  76. {postgresql_charms_single_kernel-16.3.19 → postgresql_charms_single_kernel-16.3.21}/single_kernel_postgresql/core/config.py +0 -0
  77. {postgresql_charms_single_kernel-16.3.19 → postgresql_charms_single_kernel-16.3.21}/single_kernel_postgresql/core/relation_state.py +0 -0
  78. {postgresql_charms_single_kernel-16.3.19 → postgresql_charms_single_kernel-16.3.21}/single_kernel_postgresql/core/s3.py +0 -0
  79. {postgresql_charms_single_kernel-16.3.19 → postgresql_charms_single_kernel-16.3.21}/single_kernel_postgresql/events/__init__.py +0 -0
  80. {postgresql_charms_single_kernel-16.3.19 → postgresql_charms_single_kernel-16.3.21}/single_kernel_postgresql/events/backup.py +0 -0
  81. {postgresql_charms_single_kernel-16.3.19 → postgresql_charms_single_kernel-16.3.21}/single_kernel_postgresql/events/ldap.py +0 -0
  82. {postgresql_charms_single_kernel-16.3.19 → postgresql_charms_single_kernel-16.3.21}/single_kernel_postgresql/events/logical_replication.py +0 -0
  83. {postgresql_charms_single_kernel-16.3.19 → postgresql_charms_single_kernel-16.3.21}/single_kernel_postgresql/events/tls.py +0 -0
  84. {postgresql_charms_single_kernel-16.3.19 → postgresql_charms_single_kernel-16.3.21}/single_kernel_postgresql/events/watcher.py +0 -0
  85. {postgresql_charms_single_kernel-16.3.19 → postgresql_charms_single_kernel-16.3.21}/single_kernel_postgresql/lib/charms/data_platform_libs/v0/data_interfaces.py +0 -0
  86. {postgresql_charms_single_kernel-16.3.19 → postgresql_charms_single_kernel-16.3.21}/single_kernel_postgresql/lib/charms/data_platform_libs/v0/s3.py +0 -0
  87. {postgresql_charms_single_kernel-16.3.19 → postgresql_charms_single_kernel-16.3.21}/single_kernel_postgresql/lib/charms/data_platform_libs/v1/data_models.py +0 -0
  88. {postgresql_charms_single_kernel-16.3.19 → postgresql_charms_single_kernel-16.3.21}/single_kernel_postgresql/lib/charms/glauth_k8s/v0/ldap.py +0 -0
  89. {postgresql_charms_single_kernel-16.3.19 → postgresql_charms_single_kernel-16.3.21}/single_kernel_postgresql/managers/__init__.py +0 -0
  90. {postgresql_charms_single_kernel-16.3.19 → postgresql_charms_single_kernel-16.3.21}/single_kernel_postgresql/managers/base.py +0 -0
  91. {postgresql_charms_single_kernel-16.3.19 → postgresql_charms_single_kernel-16.3.21}/single_kernel_postgresql/managers/tls.py +0 -0
  92. {postgresql_charms_single_kernel-16.3.19 → postgresql_charms_single_kernel-16.3.21}/single_kernel_postgresql/scripts/authorisation_rules_observer.py +0 -0
  93. {postgresql_charms_single_kernel-16.3.19 → postgresql_charms_single_kernel-16.3.21}/single_kernel_postgresql/scripts/cluster_topology_observer.py +0 -0
  94. {postgresql_charms_single_kernel-16.3.19 → postgresql_charms_single_kernel-16.3.21}/single_kernel_postgresql/scripts/raft_observer.py +0 -0
  95. {postgresql_charms_single_kernel-16.3.19 → postgresql_charms_single_kernel-16.3.21}/single_kernel_postgresql/scripts/rotate_logs.py +0 -0
  96. {postgresql_charms_single_kernel-16.3.19 → postgresql_charms_single_kernel-16.3.21}/single_kernel_postgresql/templates/__init__.py +0 -0
  97. {postgresql_charms_single_kernel-16.3.19 → postgresql_charms_single_kernel-16.3.21}/single_kernel_postgresql/templates/k8s/pgbackrest.conf.j2 +0 -0
  98. {postgresql_charms_single_kernel-16.3.19 → postgresql_charms_single_kernel-16.3.21}/single_kernel_postgresql/templates/k8s/pgbackrest.logrotate.j2 +0 -0
  99. {postgresql_charms_single_kernel-16.3.19 → postgresql_charms_single_kernel-16.3.21}/single_kernel_postgresql/templates/patroni.yml.j2 +0 -0
  100. {postgresql_charms_single_kernel-16.3.19 → postgresql_charms_single_kernel-16.3.21}/single_kernel_postgresql/templates/vm/pgbackrest.conf.j2 +0 -0
  101. {postgresql_charms_single_kernel-16.3.19 → postgresql_charms_single_kernel-16.3.21}/single_kernel_postgresql/templates/vm/pgbackrest.logrotate.j2 +0 -0
  102. {postgresql_charms_single_kernel-16.3.19 → postgresql_charms_single_kernel-16.3.21}/single_kernel_postgresql/templates/vm/raft-observer.service.j2 +0 -0
  103. {postgresql_charms_single_kernel-16.3.19 → postgresql_charms_single_kernel-16.3.21}/single_kernel_postgresql/templates/vm/raft-observer.timer.j2 +0 -0
  104. {postgresql_charms_single_kernel-16.3.19 → postgresql_charms_single_kernel-16.3.21}/single_kernel_postgresql/utils/arch.py +0 -0
  105. {postgresql_charms_single_kernel-16.3.19 → postgresql_charms_single_kernel-16.3.21}/single_kernel_postgresql/utils/filesystem.py +0 -0
  106. {postgresql_charms_single_kernel-16.3.19 → postgresql_charms_single_kernel-16.3.21}/single_kernel_postgresql/utils/postgresql.py +0 -0
  107. {postgresql_charms_single_kernel-16.3.19 → postgresql_charms_single_kernel-16.3.21}/single_kernel_postgresql/utils/s3.py +0 -0
  108. {postgresql_charms_single_kernel-16.3.19 → postgresql_charms_single_kernel-16.3.21}/single_kernel_postgresql/utils/secret.py +0 -0
  109. {postgresql_charms_single_kernel-16.3.19 → postgresql_charms_single_kernel-16.3.21}/single_kernel_postgresql/utils/status.py +0 -0
  110. {postgresql_charms_single_kernel-16.3.19 → postgresql_charms_single_kernel-16.3.21}/single_kernel_postgresql/workload/__init__.py +0 -0
  111. {postgresql_charms_single_kernel-16.3.19 → postgresql_charms_single_kernel-16.3.21}/single_kernel_postgresql/workload/paths/__init__.py +0 -0
  112. {postgresql_charms_single_kernel-16.3.19 → postgresql_charms_single_kernel-16.3.21}/single_kernel_postgresql/workload/paths/base.py +0 -0
  113. {postgresql_charms_single_kernel-16.3.19 → postgresql_charms_single_kernel-16.3.21}/single_kernel_postgresql/workload/paths/k8s.py +0 -0
  114. {postgresql_charms_single_kernel-16.3.19 → postgresql_charms_single_kernel-16.3.21}/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.19
3
+ Version: 16.3.21
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>
@@ -215,6 +215,7 @@ Requires-Dist: tenacity>=9.0.0
215
215
  Requires-Dist: psycopg2>=2.9.10 ; extra == 'db-driver'
216
216
  Requires-Dist: lightkube>=0.21.0 ; python_full_version >= '3.12' and extra == 'k8s'
217
217
  Requires-Dist: lightkube-models>=1.28.1.4 ; python_full_version >= '3.12' and extra == 'k8s'
218
+ Requires-Dist: cosl>=0.0.53 ; python_full_version >= '3.12' and extra == 'k8s'
218
219
  Requires-Dist: httpx ; python_full_version >= '3.12' and extra == 'postgresql'
219
220
  Requires-Dist: data-platform-helpers>=0.1.7 ; python_full_version >= '3.12' and extra == 'postgresql'
220
221
  Requires-Dist: charmlibs-pathops>=1.0.1 ; python_full_version >= '3.12' and extra == 'postgresql'
@@ -224,13 +225,15 @@ Requires-Dist: requests ; python_full_version >= '3.12' and extra == 'postgresql
224
225
  Requires-Dist: tomli ; python_full_version >= '3.12' and extra == 'postgresql'
225
226
  Requires-Dist: pydantic>=2.0 ; python_full_version >= '3.12' and extra == 'postgresql'
226
227
  Requires-Dist: jinja2>=3.1.6 ; python_full_version >= '3.12' and extra == 'postgresql'
227
- Requires-Dist: charmlibs-rollingops>=1.1.1 ; python_full_version >= '3.12' and extra == 'postgresql'
228
+ Requires-Dist: jsonschema>=4.0.0 ; python_full_version >= '3.12' and extra == 'postgresql'
229
+ Requires-Dist: ops[tracing]>=2.0.0 ; python_full_version >= '3.12' and extra == 'postgresql'
228
230
  Requires-Dist: boto3>=1.43.85 ; python_full_version >= '3.12' and extra == 'postgresql'
229
231
  Requires-Dist: botocore>=1.43.85 ; python_full_version >= '3.12' and extra == 'postgresql'
230
232
  Requires-Dist: pysyncobj>=0.3.15 ; python_full_version >= '3.12' and extra == 'vm'
231
233
  Requires-Dist: psutil>=7.2.2 ; python_full_version >= '3.12' and extra == 'vm'
232
234
  Requires-Dist: charmlibs-snap>=1.0.1,<2 ; python_full_version >= '3.12' and extra == 'vm'
233
235
  Requires-Dist: charmlibs-systemd>=1.0.0.post0 ; python_full_version >= '3.12' and extra == 'vm'
236
+ Requires-Dist: cosl>=0.0.53 ; python_full_version >= '3.12' and extra == 'vm'
234
237
  Requires-Python: >=3.8, <4.0
235
238
  Provides-Extra: db-driver
236
239
  Provides-Extra: k8s
@@ -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.19"
4
+ version = "16.3.21"
5
5
  readme = "README.md"
6
6
  classifiers = [
7
7
  "Development Status :: 3 - Alpha",
@@ -33,7 +33,8 @@ postgresql = [
33
33
  "tomli; python_version >= '3.12'",
34
34
  "pydantic>=2.0; python_version >= '3.12'",
35
35
  "jinja2 >=3.1.6; python_version >= '3.12'",
36
- "charmlibs-rollingops>=1.1.1; python_version >= '3.12'",
36
+ "jsonschema>=4.0.0; python_version >= '3.12'",
37
+ "ops[tracing]>=2.0.0; python_version >= '3.12'",
37
38
  "boto3>=1.43.85; python_version >= '3.12'",
38
39
  "botocore>=1.43.85; python_version >= '3.12'",
39
40
  ]
@@ -42,10 +43,12 @@ vm = [
42
43
  "psutil>=7.2.2; python_version >= '3.12'",
43
44
  "charmlibs-snap>=1.0.1,<2; python_version >= '3.12'",
44
45
  "charmlibs-systemd>=1.0.0.post0; python_version >= '3.12'",
46
+ "cosl>=0.0.53; python_version >= '3.12'",
45
47
  ]
46
48
  k8s = [
47
49
  "lightkube>=0.21.0; python_version >= '3.12'",
48
50
  "lightkube-models>=1.28.1.4; python_version >= '3.12'",
51
+ "cosl>=0.0.53; python_version >= '3.12'",
49
52
  ]
50
53
  db-driver = ["psycopg2>=2.9.10"]
51
54
 
@@ -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.19"
7
+ version = "16.3.21"
8
8
  readme = "README.md"
9
9
  license = {file = "LICENSE"}
10
10
  authors = [
@@ -33,7 +33,8 @@ postgresql = [
33
33
  "tomli; python_version >= '3.12'",
34
34
  "pydantic>=2.0; python_version >= '3.12'",
35
35
  "jinja2 >=3.1.6; python_version >= '3.12'",
36
- "charmlibs-rollingops>=1.1.1; python_version >= '3.12'",
36
+ "jsonschema>=4.0.0; python_version >= '3.12'",
37
+ "ops[tracing]>=2.0.0; python_version >= '3.12'",
37
38
  "boto3>=1.43.85; python_version >= '3.12'",
38
39
  "botocore>=1.43.85; python_version >= '3.12'",
39
40
  ]
@@ -41,11 +42,13 @@ vm = [
41
42
  "pysyncobj>=0.3.15; python_version >= '3.12'",
42
43
  "psutil>=7.2.2; python_version >= '3.12'",
43
44
  "charmlibs-snap>=1.0.1,<2; python_version >= '3.12'",
44
- "charmlibs-systemd>=1.0.0.post0; python_version >= '3.12'"
45
+ "charmlibs-systemd>=1.0.0.post0; python_version >= '3.12'",
46
+ "cosl>=0.0.53; python_version >= '3.12'",
45
47
  ]
46
48
  k8s = [
47
49
  "lightkube>=0.21.0; python_version >= '3.12'",
48
50
  "lightkube-models>=1.28.1.4; python_version >= '3.12'",
51
+ "cosl>=0.0.53; python_version >= '3.12'",
49
52
  ]
50
53
  db-driver = [
51
54
  "psycopg2>=2.9.10",
@@ -3,50 +3,85 @@
3
3
  """Skeleton for the abstract charm."""
4
4
 
5
5
  from abc import ABC, abstractmethod
6
- from typing import TYPE_CHECKING
6
+ from collections.abc import Callable
7
+ from typing import TYPE_CHECKING, cast
7
8
 
8
9
  from data_platform_helpers.advanced_statuses import StatusHandler
9
10
  from ops import StatusBase
10
11
  from ops.charm import CharmBase, UpdateStatusEvent
12
+ from ops_tracing import Tracing
11
13
 
12
14
  if TYPE_CHECKING:
13
15
  import charm_refresh
16
+ from ops import EventBase
14
17
 
15
18
  from single_kernel_postgresql.managers.k8s import K8sManager
16
19
 
17
20
 
18
21
  from single_kernel_postgresql.core.state import CharmState
19
22
  from single_kernel_postgresql.events.async_replication import PostgreSQLAsyncReplication
23
+ from single_kernel_postgresql.events.backup import BackupEventsHandler
20
24
  from single_kernel_postgresql.events.database import DatabaseEventsHandler
21
25
  from single_kernel_postgresql.events.ldap import LDAP
22
26
  from single_kernel_postgresql.events.logical_replication import PostgreSQLLogicalReplication
27
+ from single_kernel_postgresql.events.observer import (
28
+ ClusterTopologyChangeCharmEvents,
29
+ ObserverEventsHandler,
30
+ )
23
31
  from single_kernel_postgresql.events.postgresql import PostgreSQLEventsHandler
24
32
  from single_kernel_postgresql.events.tls import TLS
33
+ from single_kernel_postgresql.events.tls_transfer import TLSTransfer
25
34
  from single_kernel_postgresql.events.watcher import WatcherEventsHandler
26
35
  from single_kernel_postgresql.lib.charms.data_platform_libs.v0.data_interfaces import (
27
36
  DatabaseProvides,
28
37
  )
29
38
  from single_kernel_postgresql.lib.charms.data_platform_libs.v0.s3 import S3Requirer
39
+ from single_kernel_postgresql.lib.charms.rolling_ops.v0.rollingops import RollingOpsManager
30
40
  from single_kernel_postgresql.managers.async_replication import (
31
41
  AsyncReplicationManager,
32
42
  )
43
+ from single_kernel_postgresql.managers.backup import BackupManager
33
44
  from single_kernel_postgresql.managers.cluster import ClusterManager
45
+ from single_kernel_postgresql.managers.cluster_membership import ClusterMembershipManager
34
46
  from single_kernel_postgresql.managers.config import ConfigManager
35
47
  from single_kernel_postgresql.managers.database import DatabaseManager
36
48
  from single_kernel_postgresql.managers.logical_replication import LogicalReplicationManager
49
+ from single_kernel_postgresql.managers.observer import ObserverManager
37
50
  from single_kernel_postgresql.managers.patroni import PatroniManager
51
+ from single_kernel_postgresql.managers.raft import RaftManager
38
52
  from single_kernel_postgresql.managers.refresh import RefreshManager
53
+ from single_kernel_postgresql.managers.restore import RestoreManager
39
54
  from single_kernel_postgresql.managers.tls import TLSManager
55
+ from single_kernel_postgresql.utils.s3 import S3Client
40
56
  from single_kernel_postgresql.workload.base import BaseWorkload, ResourceProvider
41
57
 
42
58
  from ..config.enums import Substrates
43
- from ..config.literals import DATABASE, S3_RELATION_NAME
59
+ from ..config.literals import (
60
+ DATABASE,
61
+ PEER_RELATION,
62
+ REPLICATION_CONSUMER_RELATION,
63
+ REPLICATION_OFFER_RELATION,
64
+ RESTART_RELATION,
65
+ S3_RELATION_NAME,
66
+ TRACING_RELATION_NAME,
67
+ )
44
68
  from ..utils.postgresql import PostgreSQL
45
69
 
46
70
 
47
71
  class AbstractPostgreSQLCharm(CharmBase, ABC):
48
72
  """An abstract PostgreSQL charm."""
49
73
 
74
+ # Custom charm events dispatched by the observer scripts (cluster topology
75
+ # changes and raft reconnection).
76
+ on = ClusterTopologyChangeCharmEvents()
77
+
78
+ # Real bridge injected by substrate subclasses; class default keeps the
79
+ # vm_charm/k8s_charm guarded reads safe during __init__ — charm_refresh
80
+ # runs its state machine at construction time and may call request_restart.
81
+ restart_lock_acquire: Callable[[], None] | None = None
82
+ # TLS-transfer requirer; the substrate charm classes construct it (K8s today).
83
+ tls_transfer: "TLSTransfer"
84
+
50
85
  def __init__(self, *args):
51
86
  super().__init__(*args)
52
87
 
@@ -73,13 +108,19 @@ class AbstractPostgreSQLCharm(CharmBase, ABC):
73
108
  peer_certificate=self.tls.peer_certificate,
74
109
  )
75
110
  self.patroni_manager = PatroniManager(state=self.state, workload=self.workload)
76
- self.cluster_manager = ClusterManager(state=self.state, workload=self.workload)
77
111
 
78
112
  # Substrate-only K8s API seam: the K8s charm builds it by overriding
79
113
  # build_k8s_manager(); VM charms need no K8s API access. Built here so the
80
114
  # async-replication subsystem (below) can consume it.
81
115
  k8s_manager = self.build_k8s_manager()
82
116
 
117
+ # The watcher handler feeds the async subsystem (trunk parity: the monolith passed
118
+ # `watcher=self.watcher_handler` into both AsyncReplicationManager and
119
+ # PostgreSQLAsyncReplication, charm.py:391/399) AND the membership subsystem
120
+ # (endpoints, raft addresses). Built BEFORE the async subsystem so the VM
121
+ # _async_watcher bridge can return it.
122
+ self.watcher_handler = WatcherEventsHandler(self, self.workload, self.state)
123
+
83
124
  # Async-replication subsystem: the manager owns the data plane and the
84
125
  # promotion/standby flows; the handler owns the observers and the public facade.
85
126
  watcher = self._async_watcher()
@@ -119,6 +160,17 @@ class AbstractPostgreSQLCharm(CharmBase, ABC):
119
160
  self, self.state, self.database_manager, self.patroni_manager, self.tls_manager
120
161
  )
121
162
 
163
+ # Built after the async subsystem so the rotation/standby bridges resolve.
164
+ self.cluster_manager = ClusterManager(
165
+ state=self.state,
166
+ workload=self.workload,
167
+ patroni_manager=self.patroni_manager,
168
+ async_replication_manager=self.async_replication_manager,
169
+ update_config=self.update_config,
170
+ set_unit_status=self.set_unit_status,
171
+ is_standby_cluster=self._is_standby_cluster,
172
+ )
173
+
122
174
  # Retry pending logical-replication validations on the update-status heartbeat;
123
175
  # observed BEFORE StatusHandler so the charm-side checks run before the status
124
176
  # recompute.
@@ -151,12 +203,87 @@ class AbstractPostgreSQLCharm(CharmBase, ABC):
151
203
  resource_provider=self.get_resource_provider,
152
204
  request_restart=self.request_restart,
153
205
  restart_services=self.restart_services,
206
+ set_unit_status=self.set_unit_status,
207
+ primary_endpoint=lambda: self.primary_endpoint,
154
208
  logical_replication_slots=self.logical_replication.replication_slots,
155
209
  )
156
210
 
211
+ # The RAFT manager owns the low-level raft operations; the membership
212
+ # manager owns the VM peer-relation orchestration and the raft
213
+ # recovery state machine (late-bound bridges as callables).
214
+ self.raft_manager = RaftManager(
215
+ state=self.state,
216
+ workload=self.workload,
217
+ patroni_manager=self.patroni_manager,
218
+ watcher_handler=self.watcher_handler,
219
+ update_config=self.update_config,
220
+ set_unit_status=self.set_unit_status,
221
+ peer_relation_changed=lambda event: (
222
+ self.postgresql_events_handler._on_peer_relation_changed(event)
223
+ ),
224
+ remove_from_members_ips=lambda ip: self.membership_manager.remove_member_ip(ip),
225
+ )
226
+ self.membership_manager = ClusterMembershipManager(
227
+ state=self.state,
228
+ workload=self.workload,
229
+ patroni_manager=self.patroni_manager,
230
+ update_config=self.update_config,
231
+ set_unit_status=self.set_unit_status,
232
+ watcher_handler=self.watcher_handler,
233
+ async_replication_manager=self.async_replication_manager,
234
+ update_relation_endpoints=self.update_relation_endpoints,
235
+ raft_manager=self.raft_manager,
236
+ set_primary_status_message=self.set_primary_status_message,
237
+ primary_endpoint=lambda: self.primary_endpoint,
238
+ update_certificate=self._update_certificate,
239
+ k8s_manager=k8s_manager,
240
+ )
241
+
242
+ # The backup subsystem (port of the VM charm's composition wiring): the
243
+ # charm-side duplicates are retired when the thin charm lands.
244
+ self.s3_client = S3Client(self.workload)
245
+ self.backup_manager = BackupManager(
246
+ state=self.state,
247
+ workload=self.workload,
248
+ s3_client=self.s3_client,
249
+ patroni_manager=self.patroni_manager,
250
+ update_config=self.update_config,
251
+ # K8s renders pgbackrest.conf from the K8s API (trunk passes the
252
+ # k8s_manager); the VM reads /proc and snap state via the workload.
253
+ resource_provider=cast("ResourceProvider", k8s_manager or self.workload),
254
+ is_standby_cluster=self._is_standby_cluster,
255
+ set_unit_status=self.set_unit_status,
256
+ refresh_primary_status=self.set_primary_status_message,
257
+ remove_departed_endpoints=self.membership_manager.remove_departed_endpoints,
258
+ )
259
+ self.restore_manager = RestoreManager(
260
+ state=self.state,
261
+ workload=self.workload,
262
+ patroni_manager=self.patroni_manager,
263
+ update_config=self.update_config,
264
+ backup_manager=self.backup_manager,
265
+ is_standby_cluster=self._is_standby_cluster,
266
+ )
267
+ self.observer_manager = ObserverManager(self.state, self.workload)
268
+ self.backup_events_handler = BackupEventsHandler(
269
+ self, self.state, self.backup_manager, self.restore_manager
270
+ )
271
+ self.observer_events_handler = ObserverEventsHandler(
272
+ self,
273
+ self.workload,
274
+ self.state,
275
+ self.async_replication_manager,
276
+ self.database_manager,
277
+ self.patroni_manager,
278
+ self.raft_manager,
279
+ self.tls_manager,
280
+ self.watcher_handler,
281
+ )
282
+
157
283
  # The refresh manager owns the charm_refresh integration and the priority gate
158
- # every unit status write routes through. Constructed before the events handler
159
- # so the K8s pebble-ready handler can consult the refresh state.
284
+ # every unit status write routes through. Constructed after the managers the
285
+ # during-construction resume callbacks touch (they run inside this constructor),
286
+ # and before the events handler that consumes it.
160
287
  self.refresh_manager = RefreshManager(
161
288
  state=self.state,
162
289
  workload=self.workload,
@@ -174,12 +301,23 @@ class AbstractPostgreSQLCharm(CharmBase, ABC):
174
301
  self.config_manager,
175
302
  self.patroni_manager,
176
303
  self.refresh_manager,
304
+ membership_manager=self.membership_manager,
305
+ backup_manager=self.backup_manager,
306
+ restore_manager=self.restore_manager,
307
+ observer_manager=self.observer_manager,
308
+ async_replication_manager=self.async_replication_manager,
309
+ database_manager=self.database_manager,
310
+ postgresql=lambda: self.postgresql,
311
+ k8s_manager=k8s_manager,
177
312
  )
178
- self.watcher_handler = WatcherEventsHandler(self, self.workload, self.state)
179
313
 
180
314
  # Resume or prepare the refresh (the charms' post-construction resume block).
181
315
  self.refresh_manager.on_init()
182
316
 
317
+ # ops only allows ops.Object methods as observers: the charm owns the
318
+ # collect-unit-status observe, the refresh manager owns the reconciliation.
319
+ self.framework.observe(self.on.collect_unit_status, self._reconcile_refresh_status)
320
+
183
321
  # Status Handler
184
322
  self.status_handler = StatusHandler(
185
323
  self,
@@ -189,7 +327,51 @@ class AbstractPostgreSQLCharm(CharmBase, ABC):
189
327
  self.config_manager,
190
328
  self.patroni_manager,
191
329
  self.logical_replication_manager,
330
+ self.database_manager,
331
+ self.raft_manager,
332
+ self.backup_manager,
333
+ self.restore_manager,
334
+ )
335
+
336
+ # Rolling-restart manager (the rolling_ops charm lib is vendored in the
337
+ # library package now): the thin consuming charms used to construct it and
338
+ # inject the lock-acquisition seam; the library owns both.
339
+ self.restart_manager = RollingOpsManager(
340
+ charm=self, relation=RESTART_RELATION, callback=self._restart
192
341
  )
342
+ self.restart_lock_acquire = self._acquire_restart_lock
343
+
344
+ # Shared COS surface (both substrates): the TLS-transfer requirer (the
345
+ # certificate-transfer charm lib is vendored in the library package) and
346
+ # the tracing requirer. The substrate-specific COS requirers are built by
347
+ # the substrate classes at the end of their __init__.
348
+ self.tls_transfer = TLSTransfer(self, PEER_RELATION)
349
+ self.tracing = Tracing(self, tracing_relation_name=TRACING_RELATION_NAME)
350
+
351
+ def _acquire_restart_lock(self) -> None:
352
+ """Acquire the rolling-restart lock (the seam ``request_restart`` calls)."""
353
+ self.on[str(self.restart_manager.name)].acquire_lock.emit()
354
+
355
+ def _reconcile_refresh_status(self, event=None) -> None:
356
+ """Reconcile the unit status with the refresh status on collect-unit-status."""
357
+ self.refresh_manager.reconcile_refresh_status(event)
358
+
359
+ def _is_standby_cluster(self) -> bool:
360
+ """Whether this unit belongs to a standby (read-only) cluster (port)."""
361
+ if (
362
+ self.state.model.get_relation(REPLICATION_CONSUMER_RELATION) is None
363
+ and self.state.model.get_relation(REPLICATION_OFFER_RELATION) is None
364
+ ):
365
+ return False
366
+ if self.state.application.data.get("promoted-cluster-counter") == "0":
367
+ # An explicitly stored "0" counter marks a teardown leftover that stays a
368
+ # read-only standby until promoted (mirrors set_app_status semantics).
369
+ return True
370
+ primary_cluster = self.async_replication_manager.get_primary_cluster()
371
+ # A fresh deployment publishes no promoted-cluster-counter yet: get_primary_cluster()
372
+ # returns None for BOTH sides, which must not classify both clusters as read-only
373
+ # standbys (DPE-11713). Only a positively identified foreign primary is a standby.
374
+ return primary_cluster is not None and primary_cluster != self.state.model.app
193
375
 
194
376
  # Postgresql Client
195
377
  @property
@@ -221,6 +403,11 @@ class AbstractPostgreSQLCharm(CharmBase, ABC):
221
403
  """Access current substrate."""
222
404
  pass
223
405
 
406
+ @property
407
+ def refresh(self) -> "charm_refresh.Machines | charm_refresh.Kubernetes | None":
408
+ """The charm_refresh state machine, or None when refresh setup was skipped."""
409
+ return self.refresh_manager.refresh
410
+
224
411
  # Charm-side bridges the lib calls back into. request_restart/restart_services are
225
412
  # substrate-tangled and stay until their own migration phases; update_config still
226
413
  # supplies the async/watcher values those phases own; primary_endpoint is the
@@ -268,9 +455,17 @@ class AbstractPostgreSQLCharm(CharmBase, ABC):
268
455
  """Set the unit status that applies when no refresh status is active."""
269
456
  pass
270
457
 
458
+ def _restart(self, event) -> None:
459
+ """Rolling-ops restart callback; the body lives in the events handler."""
460
+ self.postgresql_events_handler._restart(event)
461
+
271
462
  @abstractmethod
272
463
  def update_config(
273
- self, *, refresh: "charm_refresh.Machines | charm_refresh.Kubernetes | None" = None
464
+ self,
465
+ is_creating_backup: bool = False,
466
+ no_peers: bool = False,
467
+ *,
468
+ refresh: "charm_refresh.Machines | charm_refresh.Kubernetes | None" = None,
274
469
  ) -> bool:
275
470
  """Re-render the Patroni configuration and apply it."""
276
471
  pass
@@ -330,6 +525,54 @@ class AbstractPostgreSQLCharm(CharmBase, ABC):
330
525
  """Fix the leader annotation (K8s only; overridden there)."""
331
526
  return False
332
527
 
528
+ def on_deployed_without_trust(self) -> None:
529
+ """Block the application for deployments made without --trust (K8s only; overridden there)."""
530
+ return None
531
+
532
+ def _update_certificate(self) -> None:
533
+ """Re-request the TLS certificates after an IP change (VM only; overridden there)."""
534
+ return None
535
+
536
+ def _on_config_changed(self, event: "EventBase") -> None:
537
+ """Handle configuration changes (the K8s charm overrides; the VM flow lives in events)."""
538
+ return None
539
+
540
+ @property
541
+ def is_primary(self) -> bool:
542
+ """Whether this unit is the primary instance."""
543
+ return self.unit.name == self.patroni_manager.get_primary(unit_name_pattern=True)
544
+
545
+ @property
546
+ def is_cluster_initialised(self) -> bool:
547
+ """Returns whether the cluster is already initialised (trunk parity)."""
548
+ return self.state.application.is_cluster_initialised
549
+
550
+ @property
551
+ def is_tls_enabled(self) -> bool:
552
+ """Return whether TLS is enabled (trunk parity; the K8s charm overrides)."""
553
+ return all(self.tls_manager.get_client_tls_files())
554
+
555
+ @property
556
+ def _patroni(self) -> "RaftManager":
557
+ """The trunk charm's _patroni alias: the RAFT object, not the REST manager."""
558
+ return self.raft_manager
559
+
560
+ def _setup_exporter(self) -> None:
561
+ """Set up the postgres exporter snap service (VM only; overridden there)."""
562
+ return None
563
+
564
+ def _setup_pgbackrest_exporter(self) -> None:
565
+ """Set up the pgbackrest exporter snap service (VM only; overridden there)."""
566
+ return None
567
+
568
+ def fix_pod(self) -> None:
569
+ """Recreate the K8s resources and replication labels (K8s only; overridden there)."""
570
+ return None
571
+
572
+ def sync_tls_trust_store_and_bundle(self) -> None:
573
+ """Sync the K8s CA trust store and charm-local CA bundle (K8s only; overridden there)."""
574
+ return None
575
+
333
576
  @property
334
577
  @abstractmethod
335
578
  def primary_endpoint(self) -> str | None:
@@ -350,6 +593,16 @@ class AbstractPostgreSQLCharm(CharmBase, ABC):
350
593
  """Reconcile the workload's Pebble layers (K8s)."""
351
594
  pass
352
595
 
596
+ @abstractmethod
597
+ def push_ca_file_into_workload(self, secret_name: str) -> bool:
598
+ """Upload one transferred CA certificate into the workload (substrate-specific)."""
599
+ pass
600
+
601
+ @abstractmethod
602
+ def clean_ca_file_from_workload(self, secret_name: str) -> bool:
603
+ """Remove one transferred CA certificate from the workload (substrate-specific)."""
604
+ pass
605
+
353
606
  @abstractmethod
354
607
  def ensure_pgdata_dirs_and_symlinks(self) -> None:
355
608
  """Create the storage directories and symlinks for the PostgreSQL data paths (K8s)."""