Skip to content

Commit 2307f70

Browse files
authored
Update k8s-best-practices-cnf-operator-requirements.adoc
1 parent ac069f0 commit 2307f70

File tree

1 file changed

+59
-0
lines changed

1 file changed

+59
-0
lines changed

modules/k8s-best-practices-cnf-operator-requirements.adoc

Lines changed: 59 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -114,3 +114,62 @@ All required RBAC must be included in the OLM operator bundle so that it's manag
114114
====
115115
It is not recommended for a workload application to share a proprietary operator with another workload application if that application does not share the same version lifecycle. If a workload application does share an operator the CRDs must be backwards compatible.
116116
====
117+
118+
[IMPORTANT]
119+
====
120+
Applications providing OLM catalogs to bring their operators into a platform environment must ensure that their catalog has less than 1,000 images per application team, however applications should target a much lower number than this (preferably under 150-200 images)
121+
====
122+
123+
.VCP CNF requirement
124+
[IMPORTANT]
125+
====
126+
Applications providing OLM catalogs to bring their operators into a platform environment must ensure that their catalog uses a FQDN name specific to their brand for their docker registry and provide a pull secret so that the images from their hosted registry can be accessed.
127+
====
128+
129+
.CNF recommendation
130+
[IMPORTANT]
131+
====
132+
It is recommended applications limit the scope of their OLM catalog to only operator packages needed for lifecycle upgrades, and the latest version installs following operator framework best practices by utilizing olm.skipRange to keep operator catalogs as small as possible.
133+
====
134+
135+
.VCP CNF requirement
136+
[IMPORTANT]
137+
====
138+
When an operator subscription is created into a namespace, the operator's install plan must install all resources to that specific operator namespace. The only exception here are cluster scoped objects such as CRD's.
139+
====
140+
141+
.VCP CNF requirement
142+
[IMPORTANT]
143+
====
144+
Operators must install to our environment using a subscription object only. Pre-configuration or custom configuration using config maps should not be required to install your operator to our environment.
145+
====
146+
147+
.VCP CNF requirement
148+
[IMPORTANT]
149+
====
150+
Operators are not permitted to use huge pages.
151+
====
152+
153+
.VCP CNF requirement
154+
[IMPORTANT]
155+
====
156+
The size of operator catalog and all images required by operator catalog cannot exceed 200GB of storage for an application catalog.
157+
====
158+
159+
.VCP CNF requirement
160+
[IMPORTANT]
161+
====
162+
Application vendors will need to increment their operator version to supply any hotfix or upgrade. For example If your existing operator version is 1.6.9-0, and you need to supply a hotfix, then your new OLM package should be 1.6.9-1 and the new operator CSV should have a replace tag for the existing operator CSV.
163+
====
164+
165+
.VCP CNF requirement
166+
[IMPORTANT]
167+
====
168+
Global operators are versioned to a release of the platform. These versions only change when there is a new platform release.
169+
====
170+
171+
.VCP CNF requirement
172+
[IMPORTANT]
173+
====
174+
Operators are not permitted to be installed into a tenant app namespace. Operators that are installed with the "Single Namespace" olm install mode must be installed into the tenants dedicated operator namespace. Upstream 3rd party operators will be installed Globally with "All Namespaces" olm install mode into the openshift-operators namespace.
175+
====

0 commit comments

Comments
 (0)