Bug 1961399

Summary:	[DOC] Clarify purpose of "permissions" table for GCP
Product:	OpenShift Container Platform	Reporter:	To Hung Sze <tsze>
Component:	Documentation	Assignee:	Latha S <lmurthy>
Status:	CLOSED NOTABUG	QA Contact:	Jianli Wei <jiwei>
Severity:	medium	Docs Contact:	Latha S <lmurthy>
Priority:	medium
Version:	4.8	CC:	aos-bugs, jiwei, kalexand
Target Milestone:	---
Target Release:	4.7.z
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:	2023-02-15 14:12:31 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:
Embargoed:

Description To Hung Sze 2021-05-17 20:17:14 UTC

Document URL: 
It is not clear what the purpose of the table of permissions below is:
https://docs.openshift.com/container-platform/4.5/installing/installing_gcp/installing-gcp-account.html#installation-gcp-permissions_installing-gcp-account


Section Number and Name: 
Creating a service account in GCP
Table 3. GCP service account permissions



Describe the issue: 
As it is written now, it is not clear if the entries in the table is for Installer or after-install operations or both.


Suggestions for improvement: 
If the current table is for installer, add a description.
If a separate table is required for "minimum permission levels required for after-installation operations" is needed, please add one.


Additional information: 
https://bugzilla.redhat.com/show_bug.cgi?id=1879627

has a bit of background discussion related to this topic.

Comment 5 To Hung Sze 2022-03-29 13:20:47 UTC

The table "GCP service account permissions" is present for all OCP versions (4.5-4.10) and need some clarification on the purpose of the table.

Comment 8 To Hung Sze 2022-04-11 13:15:53 UTC

This is in good hands now.
I am clearing "need info".

Comment 11 Kathryn Alexander 2023-02-15 14:12:31 UTC

Per Jianli Wei on the PR (https://github.com/openshift/openshift-docs/pull/44356#issuecomment-1429104599), I'm closing this issue.

The work on this engineering epic will provide additional clarity: https://issues.redhat.com/browse/CORS-1871