postgresql-charms-single-kernel 16.3.18__tar.gz → 16.3.20__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.18 → postgresql_charms_single_kernel-16.3.20}/PKG-INFO +5 -2
  2. {postgresql_charms_single_kernel-16.3.18 → postgresql_charms_single_kernel-16.3.20}/pyproject.toml +7 -4
  3. {postgresql_charms_single_kernel-16.3.18 → postgresql_charms_single_kernel-16.3.20}/pyproject.toml.orig +8 -5
  4. {postgresql_charms_single_kernel-16.3.18 → postgresql_charms_single_kernel-16.3.20}/single_kernel_postgresql/charms/abstract_charm.py +252 -7
  5. postgresql_charms_single_kernel-16.3.20/single_kernel_postgresql/charms/k8s_charm.py +646 -0
  6. postgresql_charms_single_kernel-16.3.20/single_kernel_postgresql/charms/vm_charm.py +566 -0
  7. {postgresql_charms_single_kernel-16.3.18 → postgresql_charms_single_kernel-16.3.20}/single_kernel_postgresql/config/exceptions.py +8 -0
  8. {postgresql_charms_single_kernel-16.3.18 → postgresql_charms_single_kernel-16.3.20}/single_kernel_postgresql/config/literals.py +19 -3
  9. {postgresql_charms_single_kernel-16.3.18 → postgresql_charms_single_kernel-16.3.20}/single_kernel_postgresql/config/statuses.py +6 -0
  10. {postgresql_charms_single_kernel-16.3.18 → postgresql_charms_single_kernel-16.3.20}/single_kernel_postgresql/core/config.py +5 -3
  11. {postgresql_charms_single_kernel-16.3.18 → postgresql_charms_single_kernel-16.3.20}/single_kernel_postgresql/core/peer_relation.py +29 -0
  12. {postgresql_charms_single_kernel-16.3.18 → postgresql_charms_single_kernel-16.3.20}/single_kernel_postgresql/core/state.py +6 -4
  13. {postgresql_charms_single_kernel-16.3.18 → postgresql_charms_single_kernel-16.3.20}/single_kernel_postgresql/events/async_replication.py +35 -24
  14. {postgresql_charms_single_kernel-16.3.18 → postgresql_charms_single_kernel-16.3.20}/single_kernel_postgresql/events/database.py +8 -10
  15. {postgresql_charms_single_kernel-16.3.18 → postgresql_charms_single_kernel-16.3.20}/single_kernel_postgresql/events/observer.py +10 -53
  16. postgresql_charms_single_kernel-16.3.20/single_kernel_postgresql/events/postgresql.py +2045 -0
  17. {postgresql_charms_single_kernel-16.3.18 → postgresql_charms_single_kernel-16.3.20}/single_kernel_postgresql/events/tls_transfer.py +9 -8
  18. postgresql_charms_single_kernel-16.3.20/single_kernel_postgresql/lib/charms/certificate_transfer_interface/v0/certificate_transfer.py +432 -0
  19. postgresql_charms_single_kernel-16.3.20/single_kernel_postgresql/lib/charms/grafana_agent/v0/cos_agent.py +1472 -0
  20. postgresql_charms_single_kernel-16.3.20/single_kernel_postgresql/lib/charms/grafana_k8s/v0/grafana_dashboard.py +2149 -0
  21. postgresql_charms_single_kernel-16.3.20/single_kernel_postgresql/lib/charms/loki_k8s/v1/loki_push_api.py +2916 -0
  22. postgresql_charms_single_kernel-16.3.20/single_kernel_postgresql/lib/charms/prometheus_k8s/v0/prometheus_scrape.py +1785 -0
  23. postgresql_charms_single_kernel-16.3.20/single_kernel_postgresql/lib/charms/rolling_ops/v0/rollingops.py +425 -0
  24. {postgresql_charms_single_kernel-16.3.18 → postgresql_charms_single_kernel-16.3.20}/single_kernel_postgresql/managers/async_replication.py +45 -26
  25. {postgresql_charms_single_kernel-16.3.18 → postgresql_charms_single_kernel-16.3.20}/single_kernel_postgresql/managers/backup.py +137 -22
  26. postgresql_charms_single_kernel-16.3.20/single_kernel_postgresql/managers/cluster.py +404 -0
  27. postgresql_charms_single_kernel-16.3.20/single_kernel_postgresql/managers/cluster_membership.py +738 -0
  28. {postgresql_charms_single_kernel-16.3.18 → postgresql_charms_single_kernel-16.3.20}/single_kernel_postgresql/managers/config.py +309 -15
  29. {postgresql_charms_single_kernel-16.3.18 → postgresql_charms_single_kernel-16.3.20}/single_kernel_postgresql/managers/database.py +47 -12
  30. postgresql_charms_single_kernel-16.3.20/single_kernel_postgresql/managers/k8s.py +347 -0
  31. {postgresql_charms_single_kernel-16.3.18 → postgresql_charms_single_kernel-16.3.20}/single_kernel_postgresql/managers/logical_replication.py +21 -3
  32. {postgresql_charms_single_kernel-16.3.18 → postgresql_charms_single_kernel-16.3.20}/single_kernel_postgresql/managers/observer.py +7 -0
  33. {postgresql_charms_single_kernel-16.3.18 → postgresql_charms_single_kernel-16.3.20}/single_kernel_postgresql/managers/patroni.py +185 -16
  34. {postgresql_charms_single_kernel-16.3.18 → postgresql_charms_single_kernel-16.3.20}/single_kernel_postgresql/managers/raft.py +64 -29
  35. {postgresql_charms_single_kernel-16.3.18 → postgresql_charms_single_kernel-16.3.20}/single_kernel_postgresql/managers/refresh.py +146 -16
  36. {postgresql_charms_single_kernel-16.3.18 → postgresql_charms_single_kernel-16.3.20}/single_kernel_postgresql/managers/restore.py +78 -4
  37. postgresql_charms_single_kernel-16.3.20/single_kernel_postgresql/payloads/k8s/grafana_dashboards/postgresql-metrics.json +3765 -0
  38. postgresql_charms_single_kernel-16.3.20/single_kernel_postgresql/payloads/k8s/grafana_dashboards/postgresql-patroni-metrics.json +3337 -0
  39. postgresql_charms_single_kernel-16.3.20/single_kernel_postgresql/payloads/k8s/grafana_dashboards/postgresql-pgbackrest-metrics.json +7121 -0
  40. postgresql_charms_single_kernel-16.3.20/single_kernel_postgresql/payloads/k8s/loki_alert_rules/.gitkeep +0 -0
  41. postgresql_charms_single_kernel-16.3.20/single_kernel_postgresql/payloads/k8s/prometheus_alert_rules/patroni_rules.yaml +55 -0
  42. postgresql_charms_single_kernel-16.3.20/single_kernel_postgresql/payloads/k8s/prometheus_alert_rules/pgbackrest_rules.yaml +69 -0
  43. postgresql_charms_single_kernel-16.3.20/single_kernel_postgresql/payloads/k8s/prometheus_alert_rules/pgbouncer_rules.yaml +46 -0
  44. postgresql_charms_single_kernel-16.3.20/single_kernel_postgresql/payloads/k8s/prometheus_alert_rules/postgresql_rules.yaml +281 -0
  45. postgresql_charms_single_kernel-16.3.20/single_kernel_postgresql/payloads/vm/grafana_dashboards/postgresql-metrics.json +3764 -0
  46. postgresql_charms_single_kernel-16.3.20/single_kernel_postgresql/payloads/vm/grafana_dashboards/postgresql-patroni-metrics.json +3337 -0
  47. postgresql_charms_single_kernel-16.3.20/single_kernel_postgresql/payloads/vm/grafana_dashboards/postgresql-pgbackrest-metrics.json +7120 -0
  48. postgresql_charms_single_kernel-16.3.20/single_kernel_postgresql/payloads/vm/loki_alert_rules/.gitkeep +0 -0
  49. postgresql_charms_single_kernel-16.3.20/single_kernel_postgresql/payloads/vm/prometheus_alert_rules/patroni_rules.yaml +55 -0
  50. postgresql_charms_single_kernel-16.3.20/single_kernel_postgresql/payloads/vm/prometheus_alert_rules/pgbackrest_rules.yaml +69 -0
  51. postgresql_charms_single_kernel-16.3.20/single_kernel_postgresql/payloads/vm/prometheus_alert_rules/pgbouncer_rules.yaml +46 -0
  52. postgresql_charms_single_kernel-16.3.20/single_kernel_postgresql/payloads/vm/prometheus_alert_rules/postgresql_rules.yaml +281 -0
  53. {postgresql_charms_single_kernel-16.3.18 → postgresql_charms_single_kernel-16.3.20}/single_kernel_postgresql/scripts/authorisation_rules_observer.py +1 -1
  54. {postgresql_charms_single_kernel-16.3.18 → postgresql_charms_single_kernel-16.3.20}/single_kernel_postgresql/scripts/cluster_topology_observer.py +1 -1
  55. {postgresql_charms_single_kernel-16.3.18 → postgresql_charms_single_kernel-16.3.20}/single_kernel_postgresql/templates/patroni.yml.j2 +19 -6
  56. {postgresql_charms_single_kernel-16.3.18 → postgresql_charms_single_kernel-16.3.20}/single_kernel_postgresql/utils/__init__.py +65 -18
  57. {postgresql_charms_single_kernel-16.3.18 → postgresql_charms_single_kernel-16.3.20}/single_kernel_postgresql/utils/backup.py +6 -0
  58. postgresql_charms_single_kernel-16.3.20/single_kernel_postgresql/utils/payloads.py +22 -0
  59. postgresql_charms_single_kernel-16.3.20/single_kernel_postgresql/utils/tracing.py +39 -0
  60. {postgresql_charms_single_kernel-16.3.18 → postgresql_charms_single_kernel-16.3.20}/single_kernel_postgresql/workload/base.py +9 -1
  61. {postgresql_charms_single_kernel-16.3.18 → postgresql_charms_single_kernel-16.3.20}/single_kernel_postgresql/workload/k8s.py +125 -26
  62. {postgresql_charms_single_kernel-16.3.18 → postgresql_charms_single_kernel-16.3.20}/single_kernel_postgresql/workload/vm.py +23 -0
  63. postgresql_charms_single_kernel-16.3.18/single_kernel_postgresql/charms/k8s_charm.py +0 -158
  64. postgresql_charms_single_kernel-16.3.18/single_kernel_postgresql/charms/vm_charm.py +0 -177
  65. postgresql_charms_single_kernel-16.3.18/single_kernel_postgresql/events/postgresql.py +0 -253
  66. postgresql_charms_single_kernel-16.3.18/single_kernel_postgresql/managers/cluster.py +0 -151
  67. postgresql_charms_single_kernel-16.3.18/single_kernel_postgresql/managers/k8s.py +0 -145
  68. {postgresql_charms_single_kernel-16.3.18 → postgresql_charms_single_kernel-16.3.20}/LICENSE +0 -0
  69. {postgresql_charms_single_kernel-16.3.18 → postgresql_charms_single_kernel-16.3.20}/README.md +0 -0
  70. {postgresql_charms_single_kernel-16.3.18 → postgresql_charms_single_kernel-16.3.20}/single_kernel_postgresql/__init__.py +0 -0
  71. {postgresql_charms_single_kernel-16.3.18 → postgresql_charms_single_kernel-16.3.20}/single_kernel_postgresql/charms/__init__.py +0 -0
  72. {postgresql_charms_single_kernel-16.3.18 → postgresql_charms_single_kernel-16.3.20}/single_kernel_postgresql/compat/__init__.py +0 -0
  73. {postgresql_charms_single_kernel-16.3.18 → postgresql_charms_single_kernel-16.3.20}/single_kernel_postgresql/compat/postgresql.py +0 -0
  74. {postgresql_charms_single_kernel-16.3.18 → postgresql_charms_single_kernel-16.3.20}/single_kernel_postgresql/compat/pyproject.toml +0 -0
  75. {postgresql_charms_single_kernel-16.3.18 → postgresql_charms_single_kernel-16.3.20}/single_kernel_postgresql/config/__init__.py +0 -0
  76. {postgresql_charms_single_kernel-16.3.18 → postgresql_charms_single_kernel-16.3.20}/single_kernel_postgresql/config/enums.py +0 -0
  77. {postgresql_charms_single_kernel-16.3.18 → postgresql_charms_single_kernel-16.3.20}/single_kernel_postgresql/config/locales.py +0 -0
  78. {postgresql_charms_single_kernel-16.3.18 → postgresql_charms_single_kernel-16.3.20}/single_kernel_postgresql/config/pyproject.toml +0 -0
  79. {postgresql_charms_single_kernel-16.3.18 → postgresql_charms_single_kernel-16.3.20}/single_kernel_postgresql/core/__init__.py +0 -0
  80. {postgresql_charms_single_kernel-16.3.18 → postgresql_charms_single_kernel-16.3.20}/single_kernel_postgresql/core/relation_state.py +0 -0
  81. {postgresql_charms_single_kernel-16.3.18 → postgresql_charms_single_kernel-16.3.20}/single_kernel_postgresql/core/s3.py +0 -0
  82. {postgresql_charms_single_kernel-16.3.18 → postgresql_charms_single_kernel-16.3.20}/single_kernel_postgresql/events/__init__.py +0 -0
  83. {postgresql_charms_single_kernel-16.3.18 → postgresql_charms_single_kernel-16.3.20}/single_kernel_postgresql/events/backup.py +0 -0
  84. {postgresql_charms_single_kernel-16.3.18 → postgresql_charms_single_kernel-16.3.20}/single_kernel_postgresql/events/ldap.py +0 -0
  85. {postgresql_charms_single_kernel-16.3.18 → postgresql_charms_single_kernel-16.3.20}/single_kernel_postgresql/events/logical_replication.py +0 -0
  86. {postgresql_charms_single_kernel-16.3.18 → postgresql_charms_single_kernel-16.3.20}/single_kernel_postgresql/events/tls.py +0 -0
  87. {postgresql_charms_single_kernel-16.3.18 → postgresql_charms_single_kernel-16.3.20}/single_kernel_postgresql/events/watcher.py +0 -0
  88. {postgresql_charms_single_kernel-16.3.18 → postgresql_charms_single_kernel-16.3.20}/single_kernel_postgresql/lib/charms/data_platform_libs/v0/data_interfaces.py +0 -0
  89. {postgresql_charms_single_kernel-16.3.18 → postgresql_charms_single_kernel-16.3.20}/single_kernel_postgresql/lib/charms/data_platform_libs/v0/s3.py +0 -0
  90. {postgresql_charms_single_kernel-16.3.18 → postgresql_charms_single_kernel-16.3.20}/single_kernel_postgresql/lib/charms/data_platform_libs/v1/data_models.py +0 -0
  91. {postgresql_charms_single_kernel-16.3.18 → postgresql_charms_single_kernel-16.3.20}/single_kernel_postgresql/lib/charms/glauth_k8s/v0/ldap.py +0 -0
  92. {postgresql_charms_single_kernel-16.3.18 → postgresql_charms_single_kernel-16.3.20}/single_kernel_postgresql/managers/__init__.py +0 -0
  93. {postgresql_charms_single_kernel-16.3.18 → postgresql_charms_single_kernel-16.3.20}/single_kernel_postgresql/managers/base.py +0 -0
  94. {postgresql_charms_single_kernel-16.3.18 → postgresql_charms_single_kernel-16.3.20}/single_kernel_postgresql/managers/tls.py +0 -0
  95. {postgresql_charms_single_kernel-16.3.18 → postgresql_charms_single_kernel-16.3.20}/single_kernel_postgresql/scripts/raft_observer.py +0 -0
  96. {postgresql_charms_single_kernel-16.3.18 → postgresql_charms_single_kernel-16.3.20}/single_kernel_postgresql/scripts/rotate_logs.py +0 -0
  97. {postgresql_charms_single_kernel-16.3.18 → postgresql_charms_single_kernel-16.3.20}/single_kernel_postgresql/templates/__init__.py +0 -0
  98. {postgresql_charms_single_kernel-16.3.18 → postgresql_charms_single_kernel-16.3.20}/single_kernel_postgresql/templates/k8s/pgbackrest.conf.j2 +0 -0
  99. {postgresql_charms_single_kernel-16.3.18 → postgresql_charms_single_kernel-16.3.20}/single_kernel_postgresql/templates/k8s/pgbackrest.logrotate.j2 +0 -0
  100. {postgresql_charms_single_kernel-16.3.18 → postgresql_charms_single_kernel-16.3.20}/single_kernel_postgresql/templates/vm/pgbackrest.conf.j2 +0 -0
  101. {postgresql_charms_single_kernel-16.3.18 → postgresql_charms_single_kernel-16.3.20}/single_kernel_postgresql/templates/vm/pgbackrest.logrotate.j2 +0 -0
  102. {postgresql_charms_single_kernel-16.3.18 → postgresql_charms_single_kernel-16.3.20}/single_kernel_postgresql/templates/vm/raft-observer.service.j2 +0 -0
  103. {postgresql_charms_single_kernel-16.3.18 → postgresql_charms_single_kernel-16.3.20}/single_kernel_postgresql/templates/vm/raft-observer.timer.j2 +0 -0
  104. {postgresql_charms_single_kernel-16.3.18 → postgresql_charms_single_kernel-16.3.20}/single_kernel_postgresql/utils/arch.py +0 -0
  105. {postgresql_charms_single_kernel-16.3.18 → postgresql_charms_single_kernel-16.3.20}/single_kernel_postgresql/utils/filesystem.py +0 -0
  106. {postgresql_charms_single_kernel-16.3.18 → postgresql_charms_single_kernel-16.3.20}/single_kernel_postgresql/utils/postgresql.py +0 -0
  107. {postgresql_charms_single_kernel-16.3.18 → postgresql_charms_single_kernel-16.3.20}/single_kernel_postgresql/utils/s3.py +0 -0
  108. {postgresql_charms_single_kernel-16.3.18 → postgresql_charms_single_kernel-16.3.20}/single_kernel_postgresql/utils/secret.py +0 -0
  109. {postgresql_charms_single_kernel-16.3.18 → postgresql_charms_single_kernel-16.3.20}/single_kernel_postgresql/utils/status.py +0 -0
  110. {postgresql_charms_single_kernel-16.3.18 → postgresql_charms_single_kernel-16.3.20}/single_kernel_postgresql/workload/__init__.py +0 -0
  111. {postgresql_charms_single_kernel-16.3.18 → postgresql_charms_single_kernel-16.3.20}/single_kernel_postgresql/workload/paths/__init__.py +0 -0
  112. {postgresql_charms_single_kernel-16.3.18 → postgresql_charms_single_kernel-16.3.20}/single_kernel_postgresql/workload/paths/base.py +0 -0
  113. {postgresql_charms_single_kernel-16.3.18 → postgresql_charms_single_kernel-16.3.20}/single_kernel_postgresql/workload/paths/k8s.py +0 -0
  114. {postgresql_charms_single_kernel-16.3.18 → postgresql_charms_single_kernel-16.3.20}/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.18
3
+ Version: 16.3.20
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.18"
4
+ version = "16.3.20"
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
 
@@ -158,10 +161,10 @@ exclude = [
158
161
  ]
159
162
 
160
163
  [dependency-groups]
161
- format = ["ruff==0.16.10"]
164
+ format = ["ruff==0.17.0"]
162
165
  lint = [
163
166
  "codespell==2.4.3",
164
- "ty==0.0.84",
167
+ "ty==0.0.86",
165
168
  ]
166
169
  unit = [
167
170
  "coverage[toml]==7.16.2",
@@ -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.18"
7
+ version = "16.3.20"
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",
@@ -64,11 +67,11 @@ module-root = ""
64
67
 
65
68
  [dependency-groups]
66
69
  format = [
67
- "ruff==0.16.10"
70
+ "ruff==0.17.0"
68
71
  ]
69
72
  lint = [
70
73
  "codespell==2.4.3",
71
- "ty==0.0.84"
74
+ "ty==0.0.86"
72
75
  ]
73
76
  unit = [
74
77
  "coverage[toml]==7.16.2",
@@ -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,43 @@ 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
+ return not self.async_replication_manager.is_primary_cluster()
193
367
 
194
368
  # Postgresql Client
195
369
  @property
@@ -221,6 +395,11 @@ class AbstractPostgreSQLCharm(CharmBase, ABC):
221
395
  """Access current substrate."""
222
396
  pass
223
397
 
398
+ @property
399
+ def refresh(self) -> "charm_refresh.Machines | charm_refresh.Kubernetes | None":
400
+ """The charm_refresh state machine, or None when refresh setup was skipped."""
401
+ return self.refresh_manager.refresh
402
+
224
403
  # Charm-side bridges the lib calls back into. request_restart/restart_services are
225
404
  # substrate-tangled and stay until their own migration phases; update_config still
226
405
  # supplies the async/watcher values those phases own; primary_endpoint is the
@@ -268,9 +447,17 @@ class AbstractPostgreSQLCharm(CharmBase, ABC):
268
447
  """Set the unit status that applies when no refresh status is active."""
269
448
  pass
270
449
 
450
+ def _restart(self, event) -> None:
451
+ """Rolling-ops restart callback; the body lives in the events handler."""
452
+ self.postgresql_events_handler._restart(event)
453
+
271
454
  @abstractmethod
272
455
  def update_config(
273
- self, *, refresh: "charm_refresh.Machines | charm_refresh.Kubernetes | None" = None
456
+ self,
457
+ is_creating_backup: bool = False,
458
+ no_peers: bool = False,
459
+ *,
460
+ refresh: "charm_refresh.Machines | charm_refresh.Kubernetes | None" = None,
274
461
  ) -> bool:
275
462
  """Re-render the Patroni configuration and apply it."""
276
463
  pass
@@ -330,6 +517,54 @@ class AbstractPostgreSQLCharm(CharmBase, ABC):
330
517
  """Fix the leader annotation (K8s only; overridden there)."""
331
518
  return False
332
519
 
520
+ def on_deployed_without_trust(self) -> None:
521
+ """Block the application for deployments made without --trust (K8s only; overridden there)."""
522
+ return None
523
+
524
+ def _update_certificate(self) -> None:
525
+ """Re-request the TLS certificates after an IP change (VM only; overridden there)."""
526
+ return None
527
+
528
+ def _on_config_changed(self, event: "EventBase") -> None:
529
+ """Handle configuration changes (the K8s charm overrides; the VM flow lives in events)."""
530
+ return None
531
+
532
+ @property
533
+ def is_primary(self) -> bool:
534
+ """Whether this unit is the primary instance."""
535
+ return self.unit.name == self.patroni_manager.get_primary(unit_name_pattern=True)
536
+
537
+ @property
538
+ def is_cluster_initialised(self) -> bool:
539
+ """Returns whether the cluster is already initialised (trunk parity)."""
540
+ return self.state.application.is_cluster_initialised
541
+
542
+ @property
543
+ def is_tls_enabled(self) -> bool:
544
+ """Return whether TLS is enabled (trunk parity; the K8s charm overrides)."""
545
+ return all(self.tls_manager.get_client_tls_files())
546
+
547
+ @property
548
+ def _patroni(self) -> "RaftManager":
549
+ """The trunk charm's _patroni alias: the RAFT object, not the REST manager."""
550
+ return self.raft_manager
551
+
552
+ def _setup_exporter(self) -> None:
553
+ """Set up the postgres exporter snap service (VM only; overridden there)."""
554
+ return None
555
+
556
+ def _setup_pgbackrest_exporter(self) -> None:
557
+ """Set up the pgbackrest exporter snap service (VM only; overridden there)."""
558
+ return None
559
+
560
+ def fix_pod(self) -> None:
561
+ """Recreate the K8s resources and replication labels (K8s only; overridden there)."""
562
+ return None
563
+
564
+ def sync_tls_trust_store_and_bundle(self) -> None:
565
+ """Sync the K8s CA trust store and charm-local CA bundle (K8s only; overridden there)."""
566
+ return None
567
+
333
568
  @property
334
569
  @abstractmethod
335
570
  def primary_endpoint(self) -> str | None:
@@ -350,6 +585,16 @@ class AbstractPostgreSQLCharm(CharmBase, ABC):
350
585
  """Reconcile the workload's Pebble layers (K8s)."""
351
586
  pass
352
587
 
588
+ @abstractmethod
589
+ def push_ca_file_into_workload(self, secret_name: str) -> bool:
590
+ """Upload one transferred CA certificate into the workload (substrate-specific)."""
591
+ pass
592
+
593
+ @abstractmethod
594
+ def clean_ca_file_from_workload(self, secret_name: str) -> bool:
595
+ """Remove one transferred CA certificate from the workload (substrate-specific)."""
596
+ pass
597
+
353
598
  @abstractmethod
354
599
  def ensure_pgdata_dirs_and_symlinks(self) -> None:
355
600
  """Create the storage directories and symlinks for the PostgreSQL data paths (K8s)."""