Bug 1958300 - [DOC] Update doc for supported GCP regions (May 2021)
Summary: [DOC] Update doc for supported GCP regions (May 2021)
Keywords:
Status: CLOSED CURRENTRELEASE
Alias: None
Product: OpenShift Container Platform
Classification: Red Hat
Component: Documentation
Version: 4.6
Hardware: Unspecified
OS: Unspecified
low
low
Target Milestone: ---
: 4.6.z
Assignee: Michael Peter
QA Contact: To Hung Sze
Vikram Goyal
URL:
Whiteboard:
: 1868788 (view as bug list)
Depends On:
Blocks:
TreeView+ depends on / blocked
 
Reported: 2021-05-07 15:12 UTC by To Hung Sze
Modified: 2021-06-08 13:44 UTC (History)
5 users (show)

Fixed In Version:
Doc Type: If docs needed, set a value
Doc Text:
Clone Of:
Environment:
Last Closed: 2021-05-26 16:39:49 UTC
Target Upstream Version:
Embargoed:
mipeter: needinfo-


Attachments (Terms of Use)

Description To Hung Sze 2021-05-07 15:12:02 UTC
Document URL: 
https://docs.openshift.com/container-platform/4.7/installing/installing_gcp/installing-gcp-account.html#installation-gcp-regions_installing-gcp-account

Section Number and Name: 
Support GCP regions

Describe the issue: 
The list currently does not match the options we ask user to choose from in the installer.

Suggestions for improvement: 
New regions:

asia-northeast3
asia-southeast2
europe-central2 
us-west3
us-west4


Additional information: 
This complements https://bugzilla.redhat.com/show_bug.cgi?id=1957260

Comment 1 Cody Hoag 2021-05-07 16:34:59 UTC
These will apply for 4.6+. Waiting on backports [1] before proceeding.

[1] https://github.com/openshift/installer/pull/4901

Comment 2 Michael Peter 2021-05-12 16:26:42 UTC
It looks like four of the regions, (asia-northeast3, asia-southeast2, us-west3, and us-west4) are supported [1] and europe-central2 support is pending [2].

@tsze: Will you please verify asia-northeast3, asia-southeast2, us-west3, and us-west4 are supported and QE tested on 4.6+?

If so, I will create a documentation update PR for the four regions we currently support. I will create another PR updating europe-central2 after PR4901 [2] is merged.


Also, we list `us-east4` as "Ashburn, Northern Virginia" and the GCP docs list "Ashburn, Virginia" [1][3]. Should we update our code and docs to match the GCP docs?


...

[1] https://github.com/openshift/installer/blob/release-4.6/pkg/types/gcp/validation/platform.go#L21-L44
[2] https://github.com/openshift/installer/pull/4901
[3] https://cloud.google.com/compute/docs/regions-zones#available

Comment 3 To Hung Sze 2021-05-19 13:28:23 UTC
I can confirm 4.6 installer does list asia-northeast3, asia-southeast2, us-west3, us-west4.


I will separately check if there is a preference / list to change us-east4 (Ashburn, North Virginia, USA) to us-east4 (Ashburn, Virginia, US).

Comment 4 To Hung Sze 2021-05-19 13:53:43 UTC
@mipeter I do see at least another Google page using "Ashburn, N. / Northern Virginia"

https://cloud.google.com/filestore/docs/regions

Also both the github page [1] above and user facing page below list "Ashburn, Northern Virginia, USA":
https://docs.openshift.com/container-platform/4.7/installing/installing_gcp/installing-gcp-account.html

Comment 5 To Hung Sze 2021-05-21 14:18:54 UTC
The installer now has europe-central2 (Warsaw, Poland).

Conclusion from a discussion is we will remove "Northern" from the doc when mentioning us-east4.

Also have this to update the installer itself:
https://bugzilla.redhat.com/show_bug.cgi?id=1963132

Comment 6 Michael Peter 2021-05-25 20:14:55 UTC
Changes made based on discussion here and in Slack. Moving bug status to ON_QA.

@tsze: Please review and verify the changes. I split these into two PRs since europe-central2 hasn't been backported yet.

PR #3202 [1][2]

Please verify for 4.6, 4.7, and 4.8:

- Change "Northern Virginia" to "Virginia" for us-east4
- Add GCP installer regions asia-northeast3, asia-southeast2, us-west3, us-west4

PR #3203 [3][4]:

Please verify for 4.8:

- Add europe-central2 (Warsaw, Poland)

After #3202 is merged, I will rebase locally and push the updates to PR #3203.

Thank you!

[1] https://github.com/openshift/openshift-docs/pull/32802

[2] Preview link: https://deploy-preview-32802--osdocs.netlify.app/openshift-enterprise/latest/installing/installing_gcp/installing-gcp-account.html#installation-gcp-regions_installing-gcp-account

[3] https://github.com/openshift/openshift-docs/pull/32803

[4] https://deploy-preview-32803--osdocs.netlify.app/openshift-enterprise/latest/installing/installing_gcp/installing-gcp-account.html#installation-gcp-regions_installing-gcp-account

Comment 7 Michael Peter 2021-05-25 20:50:36 UTC
Removed change of "Northern Virginia" because it is not updated in the code yet. [1]

Moving bug status to POST for peer review.

[1] https://bugzilla.redhat.com/show_bug.cgi?id=1963132

Comment 8 Michael Peter 2021-05-25 20:55:51 UTC
Changes verified by QE in Slack discussion.

Comment 9 Michael Peter 2021-05-26 16:02:27 UTC
I am moving the bug status to RELEASE_PENDING.

- Peer review complete.

- Merged and cherry-picked PRs #3202 & #3203.

Comment 11 To Hung Sze 2021-06-08 13:44:39 UTC
*** Bug 1868788 has been marked as a duplicate of this bug. ***


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