Bug 1564937

Summary: improve documentation around new GCP ansible installer variables
Product: OpenShift Container Platform Reporter: raffaele spazzoli <rspazzol>
Component: DocumentationAssignee: Vikram Goyal <vigoyal>
Status: CLOSED DEFERRED QA Contact: Vikram Goyal <vigoyal>
Severity: unspecified Docs Contact: Vikram Goyal <vigoyal>
Priority: unspecified    
Version: 3.9.0CC: aos-bugs, jokerman, mmccomas
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: 2019-11-21 12:49:00 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 raffaele spazzoli 2018-04-09 00:38:02 UTC 
Document URL:
https://docs.openshift.com/container-platform/3.9/install_config/configuring_gce.html#gce-configuring-masters-ansible 

Section Number and Name: 
Configuring OpenShift Container Platform Masters for GCE with Ansible

Describe the issue: 
the new variables:
openshift_gcp_project and openshift_gcp_prefix are mentioned but it is not explained what they are used for.
Particularly the prefix is not self explanatory and should be more thoroughly explained (what is used for, what are the valid formats, what type of uniqueness expectations are there).
The new openshift_gcp_multizone is not mentioned, but should be mentioned and explained. Particularly because the default seems to have changed from multizone to monozone, so previous builds will probably break (mine did)

The ansible task seemed to use other variables. You should decide whether they should be documented.
Comment 1 Stephen Cuppett 2019-11-21 12:49:00 UTC 
OCP 3.6-3.10 is no longer on full support [1]. Marking un-triaged bugs CLOSED DEFERRED. If you have a customer case with a support exception or have reproduced on 3.11+, please reopen and include those details. When reopening, please set the Version to the appropriate version where reproduced.

[1]: https://access.redhat.com/support/policy/updates/openshift