Bug 1303461 - [DOCS] [3.2] Document the process for updating bootstrap policies
Summary: [DOCS] [3.2] Document the process for updating bootstrap policies
Keywords:
Status: CLOSED CURRENTRELEASE
Alias: None
Deadline: 2016-03-15
Product: OpenShift Container Platform
Classification: Red Hat
Component: Documentation
Version: 3.1.0
Hardware: Unspecified
OS: Unspecified
high
medium
Target Milestone: ---
: ---
Assignee: Thien-Thi Nguyen
QA Contact: XiaochuanWang
Vikram Goyal
URL:
Whiteboard:
Depends On:
Blocks:
TreeView+ depends on / blocked
 
Reported: 2016-01-31 23:11 UTC by Vikram Goyal
Modified: 2017-03-08 18:14 UTC (History)
7 users (show)

Fixed In Version:
Doc Type: Bug Fix
Doc Text:
Clone Of:
Environment:
Last Closed: 2016-03-10 10:46:56 UTC
Target Upstream Version:


Attachments (Terms of Use)

Description Vikram Goyal 2016-01-31 23:11:04 UTC
In OSE 3.2, the method by which an administrator can manage and update the bootstrap policy for users and systems has been made easier.

There is no current documentation around this feature and the process by which the cluster admin can create and manage these policies needs to be documented.

This new feature allows working with role definitions and bindings to ensure an easy experience for the tenant while working with policies.

Suggested outline:
-- What is the problem that we are trying to solve by having bootstrap policies
-- How can admins achieve it without this feature
-- How can admins achieve it with this feature

Dev for this feature is:
David Eads

Trello card is:
https://trello.com/c/kLVprEpA/470-3-make-bootstrap-policy-updates-easy

QA for the feature is:
Xiaochuan Wang

Likely Guide is:
As a new topic in the Cluster Admin Guide: https://docs.openshift.com/enterprise/3.1/admin_guide/index.html

Comment 2 Alex Dellapenta 2016-03-09 16:07:02 UTC
(In reply to Thien-Thi Nguyen from comment #1)
> Current documentation (copied from trello card):
> 
> -
> https://docs.openshift.org/latest/install_config/upgrades.html#updating-
> policy-definitions
> -
> https://docs.openshift.org/latest/architecture/additional_concepts/
> authorization.html
> - https://docs.openshift.org/latest/admin_guide/manage_scc.html

Do you feel these satisfy this BZ?

Comment 3 Thien-Thi Nguyen 2016-03-09 21:02:23 UTC
(In reply to Alex Dellapenta from comment #2)

> Do you feel these satisfy this BZ?

No, they barely mention bootstrap policies.

Comment 4 Thien-Thi Nguyen 2016-03-09 21:13:57 UTC
On second thought, i was fooled by a simple grep on "bootstrap".  The above-mentioned pages do indeed touch on the "oadm policy reconcile-*" commands, which is how the functionality is exposed to the user.  I think this documentation is sufficient for now.

Comment 6 XiaochuanWang 2016-03-10 05:09:22 UTC
Thank you for summarize tnguyen, I think the following 4 documents are sufficient, but I was wondering if need to add documents in github repo: openshift/openshift-docs

Comment 7 Thien-Thi Nguyen 2016-03-10 10:46:56 UTC
(In reply to XiaochuanWang from comment #6)

Thanks for the quick response.

> following 4 documents are sufficient, but I was wondering if
> need to add documents in github repo: openshift/openshift-docs

Luckily, there is no need, since the documents linked (in comment #5) are already in the repo.

Moving status to CLOSED CURRENTRELEASE.


Note You need to log in before you can comment on or make changes to this bug.