Bug 1380563

Summary: [DOCS] Instructions for Enabling Pipelines Tech Preview are Incomplete
Product: OpenShift Container Platform Reporter: Nick Schuetz <nschuetz>
Component: DocumentationAssignee: Ashley Hardin <ahardin>
Status: CLOSED NOTABUG QA Contact: Xiaowei Li <xiaoli>
Severity: medium Docs Contact: Vikram Goyal <vigoyal>
Priority: low    
Version: 3.3.0CC: aos-bugs, jokerman, mmccomas, nschuetz
Target Milestone: ---   
Target Release: ---   
Hardware: Unspecified   
OS: Unspecified   
Whiteboard:
Fixed In Version: Doc Type: If docs needed, set a value
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2016-10-12 15:20:54 UTC Type: Bug
Regression: --- Mount Type: ---
Documentation: --- CRM:
Verified Versions: Category: ---
oVirt Team: --- RHEL 7.3 requirements from Atomic Host:
Cloudforms Team: --- Target Upstream Version:

Description Nick Schuetz 2016-09-30 00:41:00 UTC 
Document URL: https://docs.openshift.com/container-platform/3.3/install_config/web_console_customization.html#web-console-enable-tech-preview-feature

Section Number and Name: 

Enabling Features in Technology Preview

Describe the issue: 

The instructions in the documentation go over how to enable pipelines in the Web UI. However for users to be able to use the JenkinsPipeline strategy in their buildconfig they must give users the permission:

oadm policy add-cluster-role-to-group system:build-strategy-jenkinspipeline system:authenticated


Suggestions for improvement: 

Include instructions to add users to the system:build-strategy-jenkinspipeline group.

In addition, it would be good to mention that users need to restart the master service after altering the master-config.yaml.

Additional information: 

A small write up to supplement the official documentation: https://github.com/nickschuetz/ocp-3.3-pipelines/blob/master/README.md
Comment 1 Ashley Hardin 2016-10-04 19:03:51 UTC 
Work in progress:
https://github.com/openshift/openshift-docs/pull/2989
Comment 2 Ashley Hardin 2016-10-06 18:36:03 UTC 
@Nick PTAL
https://github.com/openshift/openshift-docs/pull/2989

Thanks!
Comment 5 Ashley Hardin 2016-10-12 15:20:54 UTC 
Closing this as not a bug. Discussed with Engineering and they believe that this is an edge case. The user must run "reconcile roles", which is a standard part of the upgrade process.