Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

(doc) add doc for scoped operator install #969

Merged
merged 1 commit into from
Aug 6, 2019

Conversation

tkashem
Copy link
Collaborator

@tkashem tkashem commented Jul 26, 2019

No description provided.

@openshift-ci-robot openshift-ci-robot added the size/L Denotes a PR that changes 100-499 lines, ignoring generated files. label Jul 26, 2019
Copy link
Contributor

@dmesser dmesser left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Generally looks good. A couple of thoughts:

  • change the perspective to that of the user and refrain from using internal implementation, e.g.
    • OLM controllers run with cluster-admin privileges vs. OLM runs with cluster-admin privileges
    • OLM uses a client bound to a serviceaccount vs. the Operator can request any permissions
  • use consistent nomenclature, e.g. serviceaccount vs. ServiceAccount and olm vs. OLM
  • use of colloquial language: "OLM does not spit out..."

@tkashem
Copy link
Collaborator Author

tkashem commented Jul 29, 2019

Generally looks good. A couple of thoughts:

  • change the perspective to that of the user and refrain from using internal implementation, e.g.

    • OLM controllers run with cluster-admin privileges vs. OLM runs with cluster-admin privileges
    • OLM uses a client bound to a serviceaccount vs. the Operator can request any permissions
  • use consistent nomenclature, e.g. serviceaccount vs. ServiceAccount and olm vs. OLM

  • use of colloquial language: "OLM does not spit out..."

@dmesser addressed your feedback, please take a look when you have time.

@tkashem
Copy link
Collaborator Author

tkashem commented Jul 29, 2019

/retest

1 similar comment
@tkashem
Copy link
Collaborator Author

tkashem commented Jul 29, 2019

/retest

@tkashem
Copy link
Collaborator Author

tkashem commented Jul 29, 2019

/test e2e-aws-upgrade

@tkashem
Copy link
Collaborator Author

tkashem commented Jul 30, 2019

/retest

@@ -0,0 +1,198 @@
## Background
OLM runs with `cluster-admin` privileges. By default, operator author can specify any set of permission(s) in the `csv` and OLM will consequently grant it to the operator. In effect, an operator can achieve `cluster-scoped` privilege(s) which may not always be desired.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
OLM runs with `cluster-admin` privileges. By default, operator author can specify any set of permission(s) in the `csv` and OLM will consequently grant it to the operator. In effect, an operator can achieve `cluster-scoped` privilege(s) which may not always be desired.
OLM runs with `cluster-admin` privileges. By default, operator author can specify any set of permission(s) in the `CSV` and OLM will consequently grant it to the operator. In effect, an operator can achieve `cluster-scoped` privilege(s) which may not always be desired.

## Background
OLM runs with `cluster-admin` privileges. By default, operator author can specify any set of permission(s) in the `csv` and OLM will consequently grant it to the operator. In effect, an operator can achieve `cluster-scoped` privilege(s) which may not always be desired.

OLM introduced a new feature that applies principle of attenuation to the operator being installed. The administrator can specify a service account with a set of privilege(s) granted to it. OLM will ensure that when an operator is installed its privileges are confined to that of the service account specified.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
OLM introduced a new feature that applies principle of attenuation to the operator being installed. The administrator can specify a service account with a set of privilege(s) granted to it. OLM will ensure that when an operator is installed its privileges are confined to that of the service account specified.
OLM introduced a new feature that applies principle of attenuation to the operator being installed. The administrator can specify a service account with a set of privilege(s) granted to it. OLM will ensure that when an operator is installed its privileges are confined to that of the service account specified.
As a result a `cluster-admin` can limit an Operator to a pre-defined set of RBAC rules. The Operator will not be able to do anything that is not explicitly permitted by those. This enables self-sufficient installation of Operators by non-`cluster-admin` users with a limited scope.

@dmesser
Copy link
Contributor

dmesser commented Aug 2, 2019

/lgtm

@openshift-ci-robot openshift-ci-robot added the lgtm Indicates that a PR is ready to be merged. label Aug 2, 2019
@tkashem
Copy link
Collaborator Author

tkashem commented Aug 2, 2019

/retest

@ecordell
Copy link
Member

ecordell commented Aug 6, 2019

/approve

@openshift-ci-robot
Copy link
Collaborator

[APPROVALNOTIFIER] This PR is APPROVED

This pull-request has been approved by: dmesser, ecordell, tkashem

The full list of commands accepted by this bot can be found here.

The pull request process is described here

Needs approval from an approver in each of these files:

Approvers can indicate their approval by writing /approve in a comment
Approvers can cancel approval by writing /approve cancel in a comment

@openshift-ci-robot openshift-ci-robot added the approved Indicates a PR has been approved by an approver from all required OWNERS files. label Aug 6, 2019
@tkashem
Copy link
Collaborator Author

tkashem commented Aug 6, 2019

/retest

2 similar comments
@tkashem
Copy link
Collaborator Author

tkashem commented Aug 6, 2019

/retest

@tkashem
Copy link
Collaborator Author

tkashem commented Aug 6, 2019

/retest

@tkashem
Copy link
Collaborator Author

tkashem commented Aug 6, 2019

/test e2e-aws-console-olm

@openshift-merge-robot openshift-merge-robot merged commit c59f9b4 into operator-framework:master Aug 6, 2019
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
approved Indicates a PR has been approved by an approver from all required OWNERS files. lgtm Indicates that a PR is ready to be merged. size/L Denotes a PR that changes 100-499 lines, ignoring generated files.
Projects
None yet
Development

Successfully merging this pull request may close these issues.

5 participants