Bug 1862278

Summary: [DOC] Update doc related to GCP Shared VPC installation (clarifying steps)
Product: OpenShift Container Platform Reporter: To Hung Sze <tsze>
Component: DocumentationAssignee: Samantha Gidlow <sagidlow>
Status: CLOSED CURRENTRELEASE QA Contact: To Hung Sze <tsze>
Severity: low Docs Contact: Vikram Goyal <vigoyal>
Priority: unspecified    
Version: 4.5CC: aos-bugs, jokerman, kalexand
Target Milestone: ---   
Target Release: 4.5.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: 2021-05-03 17:51:51 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 2020-07-30 21:06:10 UTC
Document URL: 
https://docs.openshift.com/container-platform/4.5/installing/installing_gcp/installing-gcp-user-infra-vpc.html#installation-creating-gcp-lb_installing-gcp-user-infra-vpc


Suggestions for improvement: 
#1 Sample customized install-config.yaml file for GCP
https://docs.openshift.com/container-platform/4.5/installing/installing_gcp/installing-gcp-user-infra-vpc.html#installation-gcp-user-infra-shared-vpc-config-yaml_installing-gcp-user-infra-vpc

In the sample, <ADD a note to>
ProjectID: openshift-production 5

5 Specify your main project where the VM instances will reside (not the host project)
 
(change the numbers of notes after this as well)

#2 Deployment Manager template for the internal load balancer

After the 02_lb_int.py template
<ADD>
You will need this in addition to the 02_lb_ext.py when you create external cluster.

#3
https://docs.openshift.com/container-platform/4.5/installing/installing_gcp/installing-gcp-user-infra-vpc.html#installation-creating-gcp-worker_installing-gcp-user-infra-vpc

Creating Additional worker machine, step 2a, this line doesn't seem to be right:
export COMPUTE_SUBNET=$(gcloud compute networks subnets describe ${HOST_PROJECT_COMPUTE_SUBNET} --region=${REGION} --project ${HOST_PROJECT} --account ${HOST_PROJECT_ACCOUNT} --format json | jq -r .selfLink)`

Should be:
export COMPUTE_SUBNET=`gcloud compute networks subnets describe ${HOST_PROJECT_COMPUTE_SUBNET} --region=${REGION} --project ${HOST_PROJECT} --account ${HOST_PROJECT_ACCOUNT} --format json | jq -r .selfLink`

#4 
https://docs.openshift.com/container-platform/4.5/installing/installing_gcp/installing-gcp-user-infra-vpc.html#installation-gcp-user-infra-adding-ingress_installing-gcp-user-infra-vpc
Adding the ingress DNS records

First paragrapg:
If you removed the DNS Zone configuration when creating Kubernetes manifests and generating Ignition configs, you must manually create DNS records that point at the ingress load balancer. 

<Change to>:
DNS Zone configuration has been removed when creating Kubernetes manifests and generating Ignition configs, you must manually create DNS records that point at the ingress load balancer. 

Note: This sections covers an optional step in other types of installation but it is mandatory for shared vpc install. Hence the change and this change should NOT be propagated to other installation types.
(

#5
https://docs.openshift.com/container-platform/4.5/installing/installing_gcp/installing-gcp-user-infra-vpc.html#installation-gcp-user-infra-vpc-adding-firewall-rules

<ADD to the 'code block' starting with 'Firewall change required by security admin:....' (before the existing text in the box)>
./oc get events -n openshift-ingress --field-selector="reason=LoadBalancerManualChange"

Comment 2 To Hung Sze 2021-04-30 18:29:37 UTC
checked the PR. Closing.
Thanks.