Skip to content

Commit b59e7f8

Browse files
committed
Add provided ServiceAccount documentation to drafts
Signed-off-by: Tayler Geiger <[email protected]>
1 parent c4470cc commit b59e7f8

File tree

1 file changed

+34
-0
lines changed

1 file changed

+34
-0
lines changed
Lines changed: 34 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,34 @@
1+
# Provided ServiceAccount for ClusterExtension Installation and Management
2+
3+
While OLMv0 provides many mechanisms for permission configuration via OperatorGroups,
4+
or by manipulating CatalogSources, cluster administrators must be aware of these options
5+
and actually implement them. If no ServiceAccount is explicitly specified for installing
6+
and upgrading operators, then cluster-admin is used by default. This can pose security risks
7+
by providing more permissions than are actually required for the management of any specific bundle.
8+
9+
OLMv1 will not grant cluster-admin permissions. It instead requires ServiceAccounts provided
10+
by users to install, upgrade and delete content.
11+
12+
The ServiceAccount is specified in the ClusterExtension manifest as follows:
13+
14+
```yaml
15+
apiVersion: olm.operatorframework.io/v1alpha1
16+
kind: ClusterExtension
17+
metadata:
18+
name: argocd
19+
spec:
20+
source:
21+
sourceType: Catalog
22+
catalog:
23+
packageName: argocd-operator
24+
version: 0.6.0
25+
install:
26+
namespace: argocd
27+
serviceAccount:
28+
name: argocd-installer
29+
```
30+
31+
If no ServiceAccount is provided in the ClusterExtension manifest, then the manifest will be rejected.
32+
Installation will also fail if the ServiceAccount does not have the necessary permissions to install a bundle.
33+
34+
//TODO: Add link to documentation on determining least privileges required for the ServiceAccount

0 commit comments

Comments
 (0)