Skip to content

[DRAFT - NO MERGE] Add installation docs for OpenShift on Google Cloud Dedicated - #117207

Draft
rochacbruno wants to merge 3 commits into
openshift:mainfrom
rochacbruno:rochacbruno/gcd-sovereign-cloud-install-docs
Draft

[DRAFT - NO MERGE] Add installation docs for OpenShift on Google Cloud Dedicated#117207
rochacbruno wants to merge 3 commits into
openshift:mainfrom
rochacbruno:rochacbruno/gcd-sovereign-cloud-install-docs

Conversation

@rochacbruno

@rochacbruno rochacbruno commented Aug 3, 2026

Copy link
Copy Markdown
Member

Important

This PR is a draft only, not intended to be merged
A follow up PR can use this as reference, feel free to close after.

Summary

  • Add user-facing installation documentation for deploying OpenShift on Google Cloud Dedicated (GCD) sovereign cloud regions
  • Follow the same pattern as existing Azure government-region and AWS specialized-region docs
  • GCD support is gated behind the GCPSovereignCloudInstall TechPreview feature gate

New files

  • installing/installing_gcp/installing-gcp-sovereign-cloud.adoc - Main assembly page
  • modules/installation-gcp-about-sovereign-cloud.adoc - Concept module covering GCD overview, key differences from public Google Cloud, and OpenShift-specific constraints
  • modules/installation-gcp-sovereign-cloud-prerequisites.adoc - Procedure module for GCD credential/project setup
  • modules/installation-gcp-sovereign-cloud-config-yaml.adoc - Annotated sample install-config.yaml for GCD
  • modules/installation-gcp-sovereign-cloud-machine-types.adoc - Supported C3/M3/A3 Edge machine types reference
  • modules/installation-gcp-sovereign-cloud-limitations.adoc - GCD-specific limitations (disk types, networking, identity, OS images)

Modified files

  • _topic_maps/_topic_map.yml - Added sovereign cloud entry to the Google Cloud section
  • installing/installing_gcp/preparing-to-install-on-gcp.adoc - Added sovereign cloud to the IPI methods list
  • _attributes/common-attributes.adoc - Added :gcp-dedicated: attribute

Related installer PRs

Test plan

  • Verify AsciiDoc syntax parses without errors
  • Verify all include paths resolve correctly
  • Verify all xref cross-references point to existing files
  • Verify topic map YAML is valid
  • Review content accuracy against installer PR implementations
  • SME review from GCD engineering team

Generated with Claude Code

…gn cloud

New assembly and modules documenting how to install OpenShift on Google Cloud
Dedicated (GCD) sovereign cloud regions. GCD is a fully isolated cloud
environment with strict data sovereignty guarantees, separate from public
Google Cloud.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@openshift-ci openshift-ci Bot added the do-not-merge/work-in-progress Indicates that a PR should not merge because it is a work in progress. label Aug 3, 2026
@openshift-ci

openshift-ci Bot commented Aug 3, 2026

Copy link
Copy Markdown

Skipping CI for Draft Pull Request.
If you want CI signal for your change, please convert it to an actual PR.
You can still manually trigger a test run with /test all

@openshift-ci openshift-ci Bot added the size/XL Denotes a PR that changes 500-999 lines, ignoring generated files. label Aug 3, 2026
Document that the default StorageClass must be changed to hyperdisk-balanced
after installation, and that Cloud Storage is single-region only in GCD.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@rochacbruno rochacbruno changed the title Add installation docs for OpenShift on Google Cloud Dedicated [DRAFT - NO MERGE] Add installation docs for OpenShift on Google Cloud Dedicated Aug 3, 2026
Remove automatic RHCOS image upload references. GCD requires users to
supply a custom OS image with both name and project fields, as implemented
by openshift/installer#10709.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
abhatt-rh added a commit to abhatt-rh/openshift-docs that referenced this pull request Aug 4, 2026
Incorporate useful content from Bruno's reference PR openshift#117207:

- Add gcp-dedicated-machine-types.adoc with the C3/M3/A3 Edge instance
  types table tested on Google Cloud Dedicated
- Add standard shared module includes to the assembly: cluster
  entitlements, SSH agent setup, obtaining the installer, minimum
  resource requirements, proxy configuration, manual IAM credential
  creation, and CLI login
- Add GOOGLE_CLOUD_UNIVERSE_DOMAIN and GOOGLE_APPLICATION_CREDENTIALS
  env var requirements to the prerequisites
- Add "Next steps" section matching other GCP install assemblies
- Restructure assembly to follow the standard GCP install doc pattern

Co-authored-by: Cursor <cursoragent@cursor.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

do-not-merge/work-in-progress Indicates that a PR should not merge because it is a work in progress. size/XL Denotes a PR that changes 500-999 lines, ignoring generated files.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant