-
Notifications
You must be signed in to change notification settings - Fork 4
/
Copy pathvendor-submission-template.yaml
1046 lines (1034 loc) · 49.5 KB
/
vendor-submission-template.yaml
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838
839
840
841
842
843
844
845
846
847
848
849
850
851
852
853
854
855
856
857
858
859
860
861
862
863
864
865
866
867
868
869
870
871
872
873
874
875
876
877
878
879
880
881
882
883
884
885
886
887
888
889
890
891
892
893
894
895
896
897
898
899
900
901
902
903
904
905
906
907
908
909
910
911
912
913
914
915
916
917
918
919
920
921
922
923
924
925
926
927
928
929
930
931
932
933
934
935
936
937
938
939
940
941
942
943
944
945
946
947
948
949
950
951
952
953
954
955
956
957
958
959
960
961
962
963
964
965
966
967
968
969
970
971
972
973
974
975
976
977
978
979
980
981
982
983
984
985
986
987
988
989
990
991
992
993
994
995
996
997
998
999
1000
---
metadata:
featureMatrixSpecVersion:
submission:
version:
datePublished:
releaseNotes:
operator:
name:
url:
featureMatrix:
categories:
- id: genc
# name: General Characteristics
- id: instm
# name: Installation mechanism
# type: string_array
# description: |
# Mechanism(s) provided to install the operator.
# vendor_compliance: |
# Provide a succinct value or list of values of the mechanisms supported.
# If any of the following names apply, use them, and add other mechanism names, as needed:
#
# * YAML
# * Helm
# * Kustomize
# * Operator Bundle
value:
references:
comments:
- id: mcrds
# name: Management via CRDs
# type: boolean
# description: |
# The operator can be managed via CRDs (Custom Resource Definition).
# vendor_compliance: |
# If true, provide a list of the names of the CRDs supported by the operator. Names should be direct links to their documentation.
value:
references:
comments:
- id: offin
# name: Offline installation
# type: boolean
# description: |
# Whether it is possible to install the operator on a (air-gapped) cluster without internet connection.
# vendor_compliance: |
# A link should be provided with documentation on how to install the operator on air-gapped environments.
value:
references:
comments:
- id: scpua
# name: Supported CPU architectures
# type: string_array
# description: |
# Support for the operator to run on nodes with specified CPU architectures.
# vendor_compliance: |
# Provide a list of CPU architectures that are supported between:
#
# * amd64
# * arm
# * arm64
# * ppc64le
# * s390x
#
# In case you support additional architectures, add their name(s) in a similar fashion.
value:
references:
comments:
- id: coios
# name: Container images OSes
# type: string_array
# description: |
# Indicate the base image of the images used by the operator. (e.g: scratch, ubi, fedora, ubuntu, centos, alpine, etc.).Provide the image name without tags (e.g. debian instead of debian:8.11)
value:
references:
comments:
- id: olmcl
# name: Operator Capability Level
# type: string
# description: |
# [Operator Capability Levels](https://sdk.operatorframework.io/docs/overview/operator-capabilities/) indicates the operator maturitylevels in regards to their lifecycle management capabilities for the application or workload they deliver. The capability modelsaims to provide guidance in terminology to express what features users can expect from an operator.
# vendor_compliance: |
# Capability level must be set one of the following levels:
#
# 1. `Basic Install`
# 2. `Seamless Upgrades`
# 3. `Full Lifecycle`
# 4. `Deep Insights`
# 5. `Auto Pilot`
#
# A link should be provided with documentation on how the operator fulfil the declared capability level.
#
# For a detailed description of each capability level refer to the Operator Framework documentation for
# [Operator Capability Level](https://sdk.operatorframework.io/docs/overview/operator-capabilities/).
value:
references:
comments:
- id: vers
# name: Versions
- id: pgver
# name: Supported PostgreSQL versions
# type: string_array
# description: |
# Which major (and minor) versions does this version of the operator support.
# vendor_compliance: |
# Provide a list of every major version supported followed by a list in parenthesis of the minor versions supported for that major version.
# E.g. '15 (15.1, 15.0), 14 (14.3, 14.2)'. All versions must be ordered by reverse chronological order.
# Other components versions that are used may be described in the comments (e.g: Patroni, WAL-G, PgBackRest, PgBouncer, etc.)
value:
references:
comments:
- id: k8ver
# name: Supported Kubernetes versions
# type: string_array
# description: |
# Which Kubernetes versions the operator can be installed into.
# vendor_compliance: |
# Provide a list of official Kubernetes minor versions numbers, ordered by reverse chronological order.
# Use a range of versions, if possible, e.g. '1.26 - 1.23' or '1.22 - 1.19'.
value:
references:
comments:
- id: pgfor
# name: PostgreSQL OSS forks
# type: string_array
# description: |
# PostgreSQL forks are considered derived projects that started from PostgreSQL codebase and add different features while maintaining compatibility with PostgreSQL.Some operators may provide support for some of such forks, alongside with the original PostgreSQL.
# vendor_compliance: |
# Leave empty if no version other than the original PostgreSQL is supported. Otherwise, provide a list of names and links to the PostgreSQL forks supported.
# If non-OSS forks are supported, leave empty but add a link to them in the comments section.
value:
references:
comments:
- id: lisu
# name: Licensing & Support
- id: ossli
# name: Open Source license
# type: boolean
# description: |
# The operator is published, and its source code is made publicly available, under an OSI-approved open source license.
# vendor_compliance: |
# If true, provide the SPDX identifier(s) of the license.
value:
references:
comments:
- id: fcimg
# name: Free container images
# type: boolean
# description: |
# The container images used for the operator's operation are free to distribute and use, not subject to commercial restrictions.
# vendor_compliance: |
# If false, provide a link with documentation on the usage requisites/restrictions of the container images.
value:
references:
comments:
- id: nenof
# name: No enterprise-only features
# type: boolean
# description: |
# All the operator's features are provided as open source.No derived, proprietary (often called 'enterprise') versions exist with additional, non open source features.
# vendor_compliance: |
# If false, provide links to all known derived, proprietary versions.
# Linked documentation should clearly reflect the features that are only part of proprietary versions.
value:
references:
comments:
- id: comms
# name: Commercial support
# type: boolean
# description: |
# Vendor and/or other entities offer paid-for, commercial support for the operator.
# vendor_compliance: |
# Provide a link or list of links to the entities that provide commercial support.
# Links should be as specific as possible, pointing to informative documentation on the provided support.
value:
references:
comments:
- id: pubit
# name: Public issue tracker
# type: boolean
# description: |
# Development happens in the open. There is a public issue tracker where users may view, comment and create issues.
# vendor_compliance: |
# Provide a specific link to the issue tracker.
value:
references:
comments:
- id: pubch
# name: Public chat/forums
# type: boolean
# description: |
# There is/are public forums, mailing lists, chat groups (Slack, Discord, Matrix, etc) where users may freely join and participate in discussions.
# vendor_compliance: |
# Provide links to all relevant user forums.
value:
references:
comments:
- id: pgcl
# name: PostgreSQL Clusters
- id: depau
# name: Deployment automation
# type: boolean
# description: |
# The operator provides capabilities to deploy production-ready clusters automatically based on a provided configuration.No user initiated commands must be required.
value:
references:
comments:
- id: pomte
# name: Pod management technology
# type: string
# description: |
# Which Pod management technology is used to handle database's Pods. E.g. 'StatefulSet', 'Deployment', 'Custom', etc.
# vendor_compliance: |
# Provide the most succinct possible name of the technology. Use the Kubernetes resource type name (e.g. 'Deployment'), if applicable.
value:
references:
comments:
- id: pgcnf
# name: PostgreSQL custom config
# type: boolean
# description: |
# The operator allows the user to supply custom PostgreSQL configuration.
value:
references:
comments:
- id: conpl
# name: Integrated connection pooling
# type: boolean
# description: |
# The operator provides options to deploy a connection pool in front of the database, automatically deployed and configured.
# vendor_compliance: |
# The connection pool may be deployed in several ways, like a Deployment layer, a side car, etc.
# All should be valid towards this feature as long as they are deployed automatically and offer an entrypoint for the user to the connection pooler.
value:
references:
comments:
- id: cpccf
# name: Connection pool custom config
# type: boolean
# description: |
# The operator allows the user to supply a custom connection pool configuration for the connection pool service.
# vendor_compliance: |
# Only applies if [pgcl/conpl] is true.
value:
references:
comments:
- id: tlssp
# name: TLS Support
# type: boolean
# description: |
# PostgreSQL connections can be secured with Postgres SSL/TLS support.
value:
references:
comments:
- id: tlscu
# name: TLS user-provided certificates
# type: boolean
# description: |
# Operators may chose by default to generate self-signed SSL certificates.They may also offer the option to specify the CA and certificates that users want Postgres clusters to use.
value:
references:
comments:
- id: crtmg
# name: CertManager integration
# type: boolean
# description: |
# The operator integrates with CertManager in order to generate the certificate to be used with Postgres.
# vendor_compliance: |
# Only applies if [pgcl/tlscu] is true.
value:
references:
comments:
- id: insql
# name: Initialization from SQL scripts
# type: boolean
# description: |
# After the database cluster creation, the operator will run automatically one or more user-supplied scripts for initial DDL or data (possibly limited in size) creation.The operator must properly inform the user of the execution result of the scripts.
value:
references:
comments:
- id: inext
# name: Initialization from external source
# type: boolean
# description: |
# After the database cluster creation, the operator will automatically connect to an external data source (like an object storage or a public repo) and fetch the DDL/data.The operator must properly inform the user of the execution result of the scripts.
value:
references:
comments:
- id: cuhba
# name: HBA custom config
# type: boolean
# description: |
# The operator allows users to provide custom configuration for the Postgres HBA (Host-Based Authentication) mechanism.It may involve directly generating the custom `pg_hba.conf` file or by using more cloud-native technologies.
value:
references:
comments:
- id: mgmup
# name: Management of db users/passwords
# type: boolean
# description: |
# The operator provides a mechanism to declaratively create, modify or delete users, roles and/or password for the PostgreSQL cluster.
value:
references:
comments:
- id: reqli
# name: Customize computing resource requests, limits
# type: boolean
# description: |
# The user may specify/customize the requests, the limits or both for computing resources (CPU, memory) of the Postgres pods.
value:
references:
comments:
- id: hugpa
# name: Support for huge pages
# type: boolean
# description: |
# The user may specify the request to use huge pages for Postgres (and/or potentially other sidecars).Postgres must be able to be configured and start using huge pages.
value:
references:
comments:
- id: pgsrv
# name: PostgreSQL exposed via Service
# type: string
# description: |
# The operator creates by default or allows the user to request one or more Kubernetes Service(s) to be created to expose the PostgreSQL connections.Expected capabilities should include a RW (read-write) or RO (read-only in case of cascading replication) connection to the primary instance; and, optionally, a RO (read-only) to load balance read-only replicas instances in the cluster.
# vendor_compliance: |
# The value must be one of:
#
# * PrimaryAndReplicas: Primary and replicas services must be offered.
# * PrimaryAndReplicasAndBalanced: Primary service, replicas services and a service that load balance RW/RO traffic transparently must be offered.
# * Balanced: A single service that load balances RW/RO traffic transparently.
# * Primary: Primary service must be offered.
value:
references:
comments:
- id: stosc
# name: Automatic storage scaling
# type: boolean
# description: |
# If the user's selected storage technology supports transparent scaling, the operator will take care of scaling the storage automatically(either by setting some default thresholds or requiring explicit declarative configuration from the user).
value:
references:
comments:
- id: scal0
# name: Scale down to zero
# type: boolean
# description: |
# The number of pods in the cluster can be set to 0. This implies that no pods (no compute) would be used, but storage is not removed.Upon scaling up, the cluster should be brought back up without the need to restore a backup.
value:
references:
comments:
- id: tblsp
# name: Tablespaces
# type: boolean
# description: |
# The user may specify one or more PostgreSQL tablespaces and their associated backing storage.
value:
references:
comments:
- id: cupgi
# name: Custom Postgres images
# type: boolean
# description: |
# The operator allows the user to specify custom (user-provided) Postgres container images, instead of using the operator's provided images.
# vendor_compliance: |
# The operator should specify if the custom image needs to follow some minimal patterns to be able to work, or if it can work
# with any postgres container image provided.
value:
references:
comments:
- id: uside
# name: User supplied sidecars
# type: boolean
# description: |
# The user may specify custom sidecars (containers or init containers) to be created alongside the Postgres container (and, possibly, other operator sidecars).User supplied sidecars must be able, by default or by configuration, to access the Postgres container filesystem and Unix Domain Sockets file.
value:
references:
comments:
- id: usvol
# name: User supplied volumes
# type: boolean
# description: |
# The user may specify and mount custom volumes to be created alongside the volumes created for the Postgres container.
value:
references:
comments:
- id: usprt
# name: User supplied ports
# type: boolean
# description: |
# The user may specify custom ports to be created alongside the services that expose PostgreSQL.
# vendor_compliance: |
# Only applies if [pgcl/pgsrv] is set.
value:
references:
comments:
- id: srvbi
# name: Support for Service Binding
# type: boolean
# description: |
# [Service Binding](https://servicebinding.io/spec/core/1.0.0/) is a Kubernetes specification to "communicating service secrets to workloads in a consistent way".If the operator supports Service Binding, applications that are bound to the Postgres clusters will be able to fetch database access credentials without requiringthe user to specify them manually in the application.
# vendor_compliance: |
# The operator must implement the [Provisioned Service](https://servicebinding.io/spec/core/1.0.0/#provisioned-service) part of the specification.
value:
references:
comments:
- id: cuann
# name: Custom Annotations
# type: boolean
# description: |
# The operator allows the user to provide custom [Annotations](https://kubernetes.io/docs/concepts/overview/working-with-objects/annotations/)(aside from any operator generated Annotations) to the objects generated by the operator.
# vendor_compliance: |
# The operator must provide configuration for setting Annotations on all objects generated by the operator.
# Partial compliance is achieved if at least Pods can be annotated and this is clearly marked in the comments.
value:
references:
comments:
- id: culab
# name: Custom Labels
# type: boolean
# description: |
# The operator allows the user to provide custom [Labels](https://kubernetes.io/docs/concepts/overview/working-with-objects/labels/) to the objects generated by the operator.
# vendor_compliance: |
# The operator must provide configuration for setting Labels on all objects generated by the operator.
# Partial compliance is achieved if at Labels can be added to at least Pods and this is clearly marked in the comments.
value:
references:
comments:
- id: apdnd
# name: Assign Pod to Node
# type: string
# description: |
# The operator allows Postgres Pods to be assigned to a specific set of Nodes based on some [Kubernetes known rules](https://kubernetes.io/docs/concepts/configuration/assign-pod-node/). E.g. Node Labels, Affinity, etc.
# vendor_compliance: |
# Indicate one of the following values:
#
# * 'Complete': if the operator support all the rules to assign a Pod to a Node defined in the latest Kubernetes version specified under [vers/k8ver].
# * 'Partial': if the operator support only partially the rules to assign a Pod to a Node.
#
# A link for each supported rule or rules group to assign a Pod to a Node must be specified.
value:
references:
comments:
- id: topsc
# name: Topology Spread Constraints
# type: boolean
# description: |
# The operator allows Postgres pods to specify [Topology Spread Constraints](https://kubernetes.io/docs/concepts/scheduling-eviction/topology-spread-constraints),to control how Pods are spread across the Kubernetes cluster among failure-domains such as regions, zones, nodes, and other user-defined topology domains.
value:
references:
comments:
- id: harp
# name: HA & Replication
- id: autfa
# name: Automated failover
# type: boolean
# description: |
# The operator provides the facility that in the event of a node or pod failure where the Postgres primary is affected,another Postgres pod (if it exists) will be promoted to primary. The operation must happen automatically without user intervention.
value:
references:
comments:
- id: techa
# name: HA Technology
# type: string
# description: |
# The technology (software name or technology principles) that support the high availability and automated failover capabilities of the operator.
# vendor_compliance: |
# Provide a succinct software or technology name. E.g.: Patroni, Stolon, Custom.
value:
references:
comments:
- id: asrep
# name: Asynchronous replication
# type: boolean
# description: |
# The operator allows to configure Postgres clusters using asynchronous streaming replication.Asynchronous is the default streaming replication mode in Postgres.
value:
references:
comments:
- id: syrep
# name: Synchronous replication
# type: boolean
# description: |
# The operator allows to configure Postgres clusters using synchronous streaming replication.The operator must manage the configuration details based on the user's preferences on which nodes behave synchronously.
value:
references:
comments:
- id: serep
# name: Semi-synchronous replication
# type: boolean
# description: |
# Semi-synchronous, or also called group or quorum replication, is a hybrid mode where a subset of the nodes is expected to replicate synchronously;and once that level is reached, the remainding nodes replicate asynchronously.That is, Postgres waits for confirmation of the write only from the synchronous nodes before considering the transaction committed.
value:
references:
comments:
- id: derep
# name: Delayed replicas
# type: boolean
# description: |
# The operator allows the user to configure one or more replicas subject to a user-specified (intentional) replication lag.This is useful to have always an online instance with data "in the past" for analytics or data recovery purposes.
value:
references:
comments:
- id: carep
# name: Cascading replication
# type: boolean
# description: |
# Postgres allows to create replicas that are fed from another replica, instead of replicating from the primary instance.This is interesting to alleviate the effects of replication on the primary; and allows to create arbitrary replication tree-like topologies.
value:
references:
comments:
- id: exrep
# name: Replication from external origin
# type: boolean
# description: |
# The operator allows a Postgres cluster to be setup in recovery mode while replicating from an external (non-operator managed) Postgres origin.This allows migrations to the operator using streaming replication.
# vendor_compliance: |
# To implement the feature, the user should be able to provide arbitrary host, port, username and password (or other means of credential passing) of the origin.
value:
references:
comments:
- id: walsh
# name: WAL Shipping
# type: boolean
# description: |
# WAL Shipping is a Postgres technique that allows replication via a shared storage mechanism where WAL files produced on the primary node are copied ("shipped") to the replica.This feature is useful for having replicas for example on DR sites, replicate over global storage object stores and others.
# vendor_compliance: |
# Implementing the feature implies both generating WAL files to a suitable location; as well as creating clusters that permanently read those WAL files and replicate from them.
value:
references:
comments:
- id: prstb
# name: Promote standby cluster
# type: boolean
# description: |
# The operator allows the user to promote a standby cluster that is a cluster with primary in recovery mode so that the primary becomes RW. This feature is used in conjunction with [harp/exrep] and/or [harp/walsh] to make GEO-replicated and/or DR (Disaster Recovery) clusters on other regions, where a region is essentially an independent Kubernetes cluster.
# vendor_compliance: |
# Only applies if [harp/exrep] or [harp/walsh] are true.
# The operator must allow to promote a standby clusters replicating either via WAL Shipping and/or streaming replication.
value:
references:
comments:
- id: lorep
# name: Managed logical replication
# type: boolean
# description: |
# Postgres supports logical replication as well as streaming replication. It requires some configuration and commands to be run by the user.This feature represents operator capabilities to perform these operations in a managed way, without the user having to type commands or create configurations directly.
# vendor_compliance: |
# The operator is considered compliant if it allows the user to provide logical replication without having to setup it directly, just specifying (declarative) preferences.
# The operator is still considered compliant if it cannot proceed until certain operations are performed by the users that are dependent on their environment
# (e.g. adding PKs, UNIQUEs or REPLICA IDENTITY to the DDL).
value:
references:
comments:
- id: pgex
# name: PostgreSQL Extensions
- id: extme
# name: Extensions distribution mechanism
# type: string
# description: |
# This feature is set to describe how extensions are shipped in a containerized environment.Typically they are part of the same Postgres container image, but they may also be distributed via other mechanisms.
# vendor_compliance: |
# Indicate 'built-in' if the extensions come included with the same Postgres container; or a succinct word or few words naming the distribution mechanism.
# More details may be provided, if needed, via the links and comments fields.
value:
references:
comments:
- id: coext
# name: Core/contrib extensions
# type: integer
# description: |
# The number of core+contrib extensions provided by the operator for the latest Postgres version provided by the operator.
# vendor_compliance: |
# Submission must provide the total number of core+contrib extensions supported for the latest Postgres version provided by the operator.
# It should also be provided, when available, a link with a detailed list of those extensions supported (via links field).
value:
references:
comments:
- id: thext
# name: Third-party extensions
# type: integer
# description: |
# The number of extensions not included in the Postgres core+contrib (i.e. created by third parties, outside of Postgres repository) for the latest Postgres version provided by the operator.
# vendor_compliance: |
# Submission must provide the total number of third-party extensions supported for the latest Postgres version provided by the operator.
# A link with a detailed list of those extensions supported (via links field) should also be provided, if available.
value:
references:
comments:
- id: byext
# name: Bring your own extension
# type: boolean
# description: |
# The opertor provides mechanisms for users to add (or upload) third-party extensions not initially provided by the operator.
# vendor_compliance: |
# The operator must support providing some mechanism to include custom extensions additionally or independently of the extension distribution mechanism,
# if a user build a local extension it could be uploaded or included on the postgres container with an automatic copy to all replicas related.
value:
references:
comments:
- id: bkup
# name: Backups
- id: bktch
# name: Backup Technology
# type: string
# description: |
# What technology (pgbasebackup, PgBackRest, WAL-e/g, Barman, custom, etc) is used to support creation and restoration of backups.
# vendor_compliance: |
# Provide the most succinct possible name of the technology.
value:
references:
comments:
- id: bkdst
# name: Backup destinations
# type: string_array
# description: |
# Where backups can be stored (typically this may include object stores, PVs, etc).
# vendor_compliance: |
# If any of the following technology names apply, use them, and add other names, as needed:
#
# * PersistentVolume
# * NFS
# * S3
# * GCS
# * Azure Blob
# * Local file system
value:
references:
comments:
- id: autbk
# name: Automated backup management
# type: boolean
# description: |
# The operator provides mechanisms for performing backups automatically and providing lifecycle mechanisms (delete old backups according to a user-supplied policy).
# vendor_compliance: |
# True response for the feature implies both automatic backups and lifecycle management.
# If only the former is provided, answer should be false but this capability should be mentioned in the comments field.
value:
references:
comments:
- id: encbk
# name: Backups encryption
# type: boolean
# description: |
# Backups can be performed with user-supplied encryption keys.
value:
references:
comments:
- id: ptrbk
# name: Point In Time Recovery
# type: boolean
# description: |
# The operator provides support for the user to specify a recovery point (in the past) to which a backup should be recovered to(if unspecified, backup will be recovered in full).
# vendor_compliance: |
# True response implies that at least time-based recovery is supported.
# If the operator also supports PITR by xid and label, clarify in the comments field.
value:
references:
comments:
- id: mulbk
# name: Multiple backup configurations
# type: boolean
# description: |
# The operator supports managing more than one backup configuration.This is typically used to store backups on different object stores (for protection purposes) or to send them to different sites.It may also include different lifecycle policies.
value:
references:
comments:
- id: mgmi
# name: Management Interfaces
- id: cucol
# name: Resource display columns
# type: boolean
# description: |
# Operator-managed objects (CRDs) include specific fields that provide additional information about the Postgres instances.These fields are shown when querying the Kubernetes resources using tools like `kubectl`.
# vendor_compliance: |
# In order to be compliant, operators have to provide at least the following information:
#
# * Replication status (primary/replica/etc)
# * Cluster status (healthy/not healthy)
# * Postgres major/minor version
# * Latest base backup date
# * SSL on/off
value:
references:
comments:
- id: kbplg
# name: kubectl plugin
# type: boolean
# description: |
# The users may download an additional kubectl plugin which provides custom commands to manage the operator.
# vendor_compliance: |
# If the feature is provided, include a link to the downloadable plugin in the links field.
value:
references:
comments:
- id: bagui
# name: Basic management GUI
# type: boolean
# description: |
# The operator bundles some GUI (web interface or other) that allows to perform basic operations (e.g. cluster creation) graphically.
value:
references:
comments:
- id: fugui
# name: Fully-featured GUI
# type: boolean
# description: |
# The operator bundles a GUI that is fully-featured (that is, in feature-parity with the capabilities provided via the other management interfaces -- typically CRDs).The GUI may provide additional features that cannot be otherwise provided via text interfaces (e.g. graphical representation of resources or operations).
value:
references:
comments:
- id: urgui
# name: GUI users & roles
# type: boolean
# description: |
# The bundled management GUI has authentication and authorization baked in and provides mechanisms to support multiple users and authorize/deny them to perform operations.
# vendor_compliance: |
# Only applies if [mgmi/bagui] or [mgmi/fugui] are provided.
# Submission should detail in the link and/or comments field how users and roles for the GUI can be managed.
value:
references:
comments:
- id: guiss
# name: GUI Single-Sign On
# type: boolean
# description: |
# The bundled management GUI supports integration with Single-Sign On (SSO), like OIDC, identity providers (e.g. Google, Github or Twitter login).
# vendor_compliance: |
# Only applies if [mgmi/bagui] or [mgmi/fugui] are provided.
value:
references:
comments:
- id: cogui
# name: GUI database console
# type: boolean
# description: |
# The bundled management GUI includes a console that can connect to any database managed by the operator and send command (e.g. like `psql`).
# vendor_compliance: |
# Only applies if [mgmi/bagui] or [mgmi/fugui] are provided.
value:
references:
comments:
- id: o11y
# name: Observability
- id: mtech
# name: Metrics technology
# type: string_array
# description: |
# If the operator supports extracting metrics from Postgres, how are they handled, which technology receives and process them?If any of the following technology names apply, use them, and add other names, as needed:* Prometheus* OpenTSDB* Nagios* Sensu
# vendor_compliance: |
# If supported, provide in the comments information about whether the technology is a dependency, is built-in, external, etc.
# Provide link(s) to the documentation for further information.
value:
references:
comments:
- id: expme
# name: Export metrics
# type: boolean
# description: |
# Regardless of how metrics are processed (e.g. as part of the operator),this feature is implemented when the operator allows the user to configure sending metrics to external services, like a metrics SaaS.
value:
references:
comments:
- id: cudas
# name: Custom dashboards
# type: boolean
# description: |
# In order to display the captured Postgres metrics, the operator provides specialized Postgres dashboards for the users.
value:
references:
comments:
- id: cuale
# name: Custom alerts
# type: boolean
# description: |
# The operator provides bundled specific Postgres alerts to be triggered on the Postgres metrics processed.E.g. there is an alert for transaction wraparound or for unused replication slots.
value:
references:
comments:
- id: exdel
# name: Exposed decorated logs
# type: boolean
# description: |
# The operator provides a mechanism to expose all the logs of the managed Postgres instances to a centralized logging tool.The logs must be decorated with extra metadata that includes the Pod name and namespace, the cluster name, the role of the Postgres instance (e.g. primary, replica, standby-leader, etc.) and the timestamp that will be available to be used to filter logs entries.There is no need to configure the tool in order to obtain required extra metadata from the logs.
value:
references:
comments:
- id: explg
# name: Export logs
# type: boolean
# description: |
# The operator allows the user to configure an external sink for the Postgres logs (e.g. a SaaS service).
value:
references:
comments:
- id: oo11y
# name: Operator Observability
# type: boolean
# description: |
# The operator is itself a source of telemetry data, potentially including metrics, traces and logs, about its own performance.
value:
references:
comments:
- id: secy
# name: Security
- id: opcsc
# name: Operator code security scanning
# type: boolean
# description: |
# The operator code is always scanned for security vulnerabilities.
value:
references:
comments:
- id: imgsc
# name: Image scanning
# type: boolean
# description: |
# Operator-provided images are always scanned for security vulnerabilities.
value:
references:
comments:
- id: sigim
# name: Signed images
# type: boolean
# description: |
# Container images are digitally signed according to the [sigstore](https://www.sigstore.dev/) project.
# vendor_compliance: |
# Compliance may also be achieved by using a technology other than sigstore, as long as it provides an equivalent set of security capabilities.
value:
references:
comments:
- id: isbom
# name: Software Bill of Materials
# type: boolean
# description: |
# The operator releases include the SBOM (Software Bill of Materials), a detailed description of all the components, modules, and their dependencies.
# vendor_compliance: |
# SBOM is expected to be in accordance to the [Kubernetes SIG BOM](https://github.com/kubernetes-sigs/bom).
value:
references:
comments:
- id: fgopp
# name: Fine-grained RBAC permissions
# type: boolean
# description: |
# The operator uses a separate serviceaccount that has RBAC permissions that only require the access that is actually needed to create and manage the Kubernetes resources, not more.
value:
references:
comments:
- id: noprm
# name: No or justified privileged mode
# type: boolean
# description: |
# The operator-provided containers do not require privileged mode.The container processes do not run as root.
# vendor_compliance: |
# Reasonable exceptions to this rule can be made for features that require or do not diminish the container's security, e.g. when using eBPF.
value:
references:
comments:
- id: day2
# name: Day 2 Operations
- id: amiup
# name: Automated minor upgrades
# type: boolean
# description: |
# The operator can perform a minor version upgrade of a Postgres cluster automatically.This operation can be managed by the user declaratively.
# vendor_compliance: |
# The operator must provide proper information to the user as to the status and final result of the operation.
# The operator should provide ongoing status information, and perform the operation with the minimum downtime required.
value:
references:
comments:
- id: amaup
# name: Automated major upgrades
# type: boolean
# description: |
# The operator can perform a major version upgrade of a Postgres cluster automatically.This operation can be managed by the user declaratively.
# vendor_compliance: |
# The operator must provide proper information to the user as to the status and final result of the operation.
# The operator should provide ongoing status information, and perform the operation with the minimum downtime required.
value:
references:
comments:
- id: crest
# name: Controlled cluster restart
# type: boolean
# description: |
# Sometimes Postgres needs to be restarted (e.g. changing of a parameter that requires restart).The operator provides means to perform this operation automatically and in a controlled manner (rolling restart) so that the cluster faces a minimal downtime only.
value:
references:
comments:
- id: ociup
# name: Container images upgrade
# type: boolean
# description: |
# Similarly to the controlled restart operation, the operator is capable of updating the running container images (which require a pod restart) automatically and with minimal cluster impact.
value:
references:
comments:
- id: swtch
# name: Switchover
# type: boolean
# description: |
# If HA capabilities are provided, the operator also provides a mechanism for manual switchover.The user may specify the configuration declaratively and the operator will perform the desired switchover automatically, updating the endpoints/services as required.
value:
references:
comments:
- id: sqlmi
# name: SQL Migrations
# type: boolean
# description: |
# The operator provides managed SQL migration capabilities.The user may specify SQL scripts that contain migrations (DDL changes, etc) to be deployed to a given database, having the operator apply them automatically.
# vendor_compliance: |
# The operator must report back to the user detailed information about the results of the execution(s) of the script(s) provided by the user.
value:
references:
comments:
- id: oday2
# name: Other Day 2 Operations
# type: string_array
# description: |
# The operator provides support for other managed Day 2 operations.
# vendor_compliance: |
# All the mentioned additional day 2 operations need to be possible via declarative configuration and the operator to fully execute them without further user intervention.
value:
references:
comments:
- id: dain
# name: Data Integration
- id: kfkin
# name: Kafka integration
# type: boolean
# description: |
# The operator provides a managed solution for automation to export CDC (Change Data Capture) events to Kafka.
# vendor_compliance: |
# Kafka could be an external dependency to the operator.
# The whole operation is expected to be fully automated, with the user only providing a declarative configuration.
value:
references:
comments:
- id: migpg
# name: Migration from Postgres
# type: string_array
# description: |
# The operator provides a managed capability to automatically migrate data from another (external) Postgres database.Migrations may be offline (source needs to be disconnected from clients while the migration happens) and/or via CDC (Change Data Capture),which allows for near-zero downtime migrations.
# vendor_compliance: |
# Provide one or more of the following values: `offline`, `cdc`.
value:
references:
comments:
- id: migmy
# name: Migration from MySQL
# type: string_array
# description: |
# The operator provides a managed capability to automatically migrate data from a MySQL database.Migrations may be offline (source needs to be disconnected from clients while the migration happens) and/or via CDC (Change Data Capture),which allows for near-zero downtime migrations.Optionally, the operator may provide additional capabilities to convert the schema from the source database into the target Postgres database.
# vendor_compliance: |
# Provide one or more of the following values: `offline`, `cdc`, `schema conversion`.
value:
references:
comments:
- id: migor
# name: Migration from Oracle
# type: string_array
# description: |
# The operator provides a managed capability to automatically migrate data from an Oracle database.Migrations may be offline (source needs to be disconnected from clients while the migration happens) and/or via CDC (Change Data Capture),which allows for near-zero downtime migrations.Optionally, the operator may provide additional capabilities to convert the schema from the source database into the target Postgres database.
# vendor_compliance: |
# Provide one or more of the following values: `offline`, `cdc`, `schema conversion`.
value:
references:
comments:
- id: migms
# name: Migration from SQL Server
# type: string_array
# description: |
# The operator provides a managed capability to automatically migrate data from a SQL Server database.Migrations may be offline (source needs to be disconnected from clients while the migration happens) and/or via CDC (Change Data Capture),which allows for near-zero downtime migrations.Optionally, the operator may provide additional capabilities to convert the schema from the source database into the target Postgres database.
# vendor_compliance: |
# Provide one or more of the following values: `offline`, `cdc`, `schema conversion`.
value:
references:
comments:
- id: migmo
# name: Migration from MongoDB
# type: string_array
# description: |
# The operator provides a managed capability to automatically migrate data from a MongoDB database.Migrations may be offline (source needs to be disconnected from clients while the migration happens) and/or via CDC (Change Data Capture),which allows for near-zero downtime migrations.Optionally, the operator may provide additional capabilities to convert the schema from the source database into the target Postgres database.
# vendor_compliance: |
# Provide one or more of the following values: `offline`, `cdc`, `schema conversion`.
value:
references: