Skip to content

Commit 6051559

Browse files
committed
OSDOCS-6319: ARM support for GCP
1 parent e49ce44 commit 6051559

9 files changed

+70
-13
lines changed

installing/installing-preparing.adoc

Lines changed: 14 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -25,7 +25,8 @@ endif::openshift-origin[]
2525
* Microsoft Azure on 64-bit x86 instances
2626
* Microsoft Azure on 64-bit ARM instances
2727
* Microsoft Azure Stack Hub
28-
* Google Cloud Platform (GCP)
28+
* Google Cloud Platform (GCP) on 64-bit x86 instances
29+
* Google Cloud Platform (GCP) on 64-bit ARM instances
2930
* {rh-openstack-first}
3031
* IBM Cloud VPC
3132
* {ibmzProductName} or {linuxoneProductName}
@@ -132,7 +133,7 @@ Not all installation options are supported for all platforms, as shown in the fo
132133
//This table is for all flavors of OpenShift, except OKD. A separate table is required because OKD does not support multiple AWS architecture types. Trying to maintain one table using conditions, while convenient, is very fragile and prone to publishing errors.
133134
ifndef::openshift-origin[]
134135
|===
135-
||Alibaba |AWS (x86_64) |AWS (arm64) |Azure (x86_64) |Azure (arm64)|Azure Stack Hub |GCP |Nutanix |{rh-openstack} |Bare metal (x86_64) |Bare metal (arm64) |vSphere |VMC |IBM Cloud VPC |{ibmzProductName} |{ibmpowerProductName} |{ibmpowerProductName} Virtual Server
136+
||Alibaba |AWS (64-bit x86) |AWS (64-bit ARM) |Azure (64-bit x86) |Azure (64-bit ARM)|Azure Stack Hub |GCP (64-bit x86) |GCP (64-bit ARM) |Nutanix |{rh-openstack} |Bare metal (64-bit x86) |Bare metal (64-bit ARM) |vSphere |IBM Cloud VPC |{ibmzProductName} |{ibmpowerProductName} |{ibmpowerProductName} Virtual Server
136137

137138
|Default
138139
|xref:../installing/installing_alibaba/installing-alibaba-default.adoc#installing-alibaba-default[✓]
@@ -142,6 +143,7 @@ ifndef::openshift-origin[]
142143
|xref:../installing/installing_azure/installing-azure-default.adoc#installing-azure-default[✓]
143144
|xref:../installing/installing_azure_stack_hub/installing-azure-stack-hub-default.adoc#installing-azure-stack-hub-default[✓]
144145
|xref:../installing/installing_gcp/installing-gcp-default.adoc#installing-gcp-default[✓]
146+
|xref:../installing/installing_gcp/installing-gcp-default.adoc#installing-gcp-default[✓]
145147
|xref:../installing/installing_nutanix/installing-nutanix-installer-provisioned.adoc#installing-nutanix-installer-provisioned[✓]
146148
|
147149
|xref:../installing/installing_bare_metal_ipi/ipi-install-overview.adoc#ipi-install-overview[✓]
@@ -160,6 +162,7 @@ ifndef::openshift-origin[]
160162
|xref:../installing/installing_azure/installing-azure-customizations.adoc#installing-azure-customizations[✓]
161163
|xref:../installing/installing_azure_stack_hub/installing-azure-stack-hub-default.adoc#installing-azure-stack-hub-default[✓]
162164
|xref:../installing/installing_gcp/installing-gcp-customizations.adoc#installing-gcp-customizations[✓]
165+
|xref:../installing/installing_gcp/installing-gcp-customizations.adoc#installing-gcp-customizations[✓]
163166
|xref:../installing/installing_nutanix/installing-nutanix-installer-provisioned.adoc#installing-nutanix-installer-provisioned[✓]
164167
|xref:../installing/installing_openstack/installing-openstack-installer-custom.adoc#installing-openstack-installer-custom[✓]
165168
|
@@ -179,6 +182,7 @@ ifndef::openshift-origin[]
179182
|xref:../installing/installing_azure/installing-azure-network-customizations.adoc#installing-azure-network-customizations[✓]
180183
|xref:../installing/installing_azure_stack_hub/installing-azure-stack-hub-network-customizations.adoc#installing-azure-stack-hub-network-customizations[✓]
181184
|xref:../installing/installing_gcp/installing-gcp-network-customizations.adoc#installing-gcp-network-customizations[✓]
185+
|xref:../installing/installing_gcp/installing-gcp-network-customizations.adoc#installing-gcp-network-customizations[✓]
182186
|
183187
|xref:../installing/installing_openstack/installing-openstack-installer-kuryr.adoc#installing-openstack-installer-kuryr[✓]
184188
|
@@ -197,6 +201,7 @@ ifndef::openshift-origin[]
197201
|
198202
|
199203
|xref:../installing/installing_gcp/installing-restricted-networks-gcp-installer-provisioned.adoc#installing-restricted-networks-gcp-installer-provisioned[✓]
204+
|xref:../installing/installing_gcp/installing-restricted-networks-gcp-installer-provisioned.adoc#installing-restricted-networks-gcp-installer-provisioned[✓]
200205
|xref:../installing/installing_nutanix/installing-restricted-networks-nutanix-installer-provisioned.adoc#installing-restricted-networks-nutanix-installer-provisioned[✓]
201206
|xref:../installing/installing_openstack/installing-openstack-installer-restricted.adoc#installing-openstack-installer-restricted[✓]
202207
|xref:../installing/installing_bare_metal_ipi/ipi-install-installation-workflow.adoc#ipi-install-installation-workflow[✓]
@@ -215,7 +220,7 @@ ifndef::openshift-origin[]
215220
|xref:../installing/installing_azure/installing-azure-private.adoc#installing-azure-private[✓]
216221
|
217222
|xref:../installing/installing_gcp/installing-gcp-private.adoc#installing-gcp-private[✓]
218-
|
223+
|xref:../installing/installing_gcp/installing-gcp-private.adoc#installing-gcp-private[✓]
219224
|
220225
|
221226
|
@@ -234,7 +239,7 @@ ifndef::openshift-origin[]
234239
|xref:../installing/installing_azure/installing-azure-vnet.adoc#installing-azure-vnet[✓]
235240
|
236241
|xref:../installing/installing_gcp/installing-gcp-vpc.adoc#installing-gcp-vpc[✓]
237-
|
242+
|xref:../installing/installing_gcp/installing-gcp-vpc.adoc#installing-gcp-vpc[✓]
238243
|
239244
|
240245
|
@@ -447,7 +452,7 @@ endif::openshift-origin[]
447452
//This table is for all flavors of OpenShift, except OKD. A separate table is required because OKD does not support multiple AWS architecture types. Trying to maintain one table using conditions, while convenient, is very fragile and prone to publishing errors.
448453
ifndef::openshift-origin[]
449454
|===
450-
||Alibaba |AWS (x86_64) |AWS (arm64) |Azure (x86_64) |Azure (arm64) |Azure Stack Hub |GCP |Nutanix |{rh-openstack} |Bare metal (x86_64) |Bare metal (arm64) |vSphere |VMC |IBM Cloud VPC |{ibmzProductName} |{ibmzProductName} with {op-system-base} KVM |{ibmpowerProductName} |Platform agnostic
455+
||Alibaba |AWS (64-bit x86) |AWS (64-bit ARM) |Azure (64-bit x86) |Azure (64-bit ARM) |Azure Stack Hub |GCP (64-bit x86) |GCP (64-bit ARM) |Nutanix |{rh-openstack} |Bare metal (64-bit x86) |Bare metal (64-bit ARM) |vSphere |IBM Cloud VPC |{ibmzProductName} |{ibmzProductName} with {op-system-base} KVM |{ibmpowerProductName} |Platform agnostic
451456

452457

453458
|Custom
@@ -458,6 +463,7 @@ ifndef::openshift-origin[]
458463
|xref:../installing/installing_azure/installing-azure-user-infra.adoc#installing-azure-user-infra[✓]
459464
|xref:../installing/installing_azure_stack_hub/installing-azure-stack-hub-user-infra.adoc#installing-azure-stack-hub-user-infra[✓]
460465
|xref:../installing/installing_gcp/installing-gcp-user-infra.adoc#installing-gcp-user-infra[✓]
466+
|xref:../installing/installing_gcp/installing-gcp-user-infra.adoc#installing-gcp-user-infra[✓]
461467
|
462468
|xref:../installing/installing_openstack/installing-openstack-user.adoc#installing-openstack-user[✓]
463469
|xref:../installing/installing_bare_metal/installing-bare-metal.adoc#installing-bare-metal[✓]
@@ -479,6 +485,7 @@ ifndef::openshift-origin[]
479485
|
480486
|
481487
|
488+
|
482489
|xref:../installing/installing_openstack/installing-openstack-user-kuryr.adoc#installing-openstack-user-kuryr[✓]
483490
|xref:../installing/installing_bare_metal/installing-bare-metal-network-customizations.adoc#installing-bare-metal-network-customizations[✓]
484491
|xref:../installing/installing_bare_metal/installing-bare-metal-network-customizations.adoc#installing-bare-metal-network-customizations[✓]
@@ -497,6 +504,7 @@ ifndef::openshift-origin[]
497504
|
498505
|
499506
|xref:../installing/installing_gcp/installing-restricted-networks-gcp.adoc#installing-restricted-networks-gcp[✓]
507+
|xref:../installing/installing_gcp/installing-restricted-networks-gcp.adoc#installing-restricted-networks-gcp[✓]
500508
|
501509
|
502510
|xref:../installing/installing_bare_metal/installing-restricted-networks-bare-metal.adoc#installing-restricted-networks-bare-metal[✓]
@@ -516,6 +524,7 @@ ifndef::openshift-origin[]
516524
|
517525
|
518526
|xref:../installing/installing_gcp/installing-gcp-user-infra-vpc.adoc#installing-gcp-user-infra-vpc[✓]
527+
|xref:../installing/installing_gcp/installing-gcp-user-infra-vpc.adoc#installing-gcp-user-infra-vpc[✓]
519528
|
520529
|
521530
|

installing/installing_gcp/installing-gcp-customizations.adoc

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -50,6 +50,8 @@ include::modules/installation-minimum-resource-requirements.adoc[leveloffset=+2]
5050

5151
include::modules/installation-gcp-tested-machine-types.adoc[leveloffset=+2]
5252

53+
include::modules/installation-gcp-tested-machine-types-arm.adoc[leveloffset=+2]
54+
5355
include::modules/installation-using-gcp-custom-machine-types.adoc[leveloffset=+2]
5456

5557
include::modules/installation-gcp-enabling-shielded-vms.adoc[leveloffset=+2]

installing/installing_gcp/installing-gcp-network-customizations.adoc

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -56,6 +56,8 @@ include::modules/installation-minimum-resource-requirements.adoc[leveloffset=+2]
5656

5757
include::modules/installation-gcp-tested-machine-types.adoc[leveloffset=+2]
5858

59+
include::modules/installation-gcp-tested-machine-types-arm.adoc[leveloffset=+2]
60+
5961
include::modules/installation-using-gcp-custom-machine-types.adoc[leveloffset=+2]
6062

6163
include::modules/installation-gcp-enabling-shielded-vms.adoc[leveloffset=+2]

installing/installing_gcp/installing-gcp-private.adoc

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -53,6 +53,8 @@ include::modules/installation-minimum-resource-requirements.adoc[leveloffset=+2]
5353

5454
include::modules/installation-gcp-tested-machine-types.adoc[leveloffset=+2]
5555

56+
include::modules/installation-gcp-tested-machine-types-arm.adoc[leveloffset=+2]
57+
5658
include::modules/installation-using-gcp-custom-machine-types.adoc[leveloffset=+2]
5759

5860
include::modules/installation-gcp-enabling-shielded-vms.adoc[leveloffset=+2]

installing/installing_gcp/installing-gcp-vpc.adoc

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -49,6 +49,8 @@ include::modules/installation-minimum-resource-requirements.adoc[leveloffset=+2]
4949

5050
include::modules/installation-gcp-tested-machine-types.adoc[leveloffset=+2]
5151

52+
include::modules/installation-gcp-tested-machine-types-arm.adoc[leveloffset=+2]
53+
5254
include::modules/installation-using-gcp-custom-machine-types.adoc[leveloffset=+2]
5355

5456
include::modules/installation-gcp-enabling-shielded-vms.adoc[leveloffset=+2]

installing/installing_gcp/installing-restricted-networks-gcp-installer-provisioned.adoc

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -61,6 +61,8 @@ include::modules/installation-minimum-resource-requirements.adoc[leveloffset=+2]
6161

6262
include::modules/installation-gcp-tested-machine-types.adoc[leveloffset=+2]
6363

64+
include::modules/installation-gcp-tested-machine-types-arm.adoc[leveloffset=+2]
65+
6466
include::modules/installation-using-gcp-custom-machine-types.adoc[leveloffset=+2]
6567

6668
include::modules/installation-gcp-enabling-shielded-vms.adoc[leveloffset=+2]

modules/installation-configuration-parameters.adoc

Lines changed: 20 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -513,17 +513,17 @@ Optional installation configuration parameters are described in the following ta
513513

514514
ifndef::openshift-origin[]
515515

516-
ifndef::aws,bare,ibm-power,ibm-z,azure,ibm-power-vs[]
516+
ifndef::aws,bare,gcp,ibm-power,ibm-z,azure,ibm-power-vs[]
517517
|`compute.architecture`
518518
|Determines the instruction set architecture of the machines in the pool. Currently, clusters with varied architectures are not supported. All pools must specify the same architecture. Valid values are `amd64` (the default).
519519
|String
520-
endif::aws,bare,ibm-power,ibm-z,azure,ibm-power-vs[]
520+
endif::aws,bare,gcp,ibm-power,ibm-z,azure,ibm-power-vs[]
521521

522-
ifdef::aws,bare,azure[]
522+
ifdef::aws,bare,azure,gcp[]
523523
|`compute.architecture`
524524
|Determines the instruction set architecture of the machines in the pool. Currently, clusters with varied architectures are not supported. All pools must specify the same architecture. Valid values are `amd64` and `arm64`. See _Supported installation methods for different platforms_ in _Installing_ documentation for information about instance availability.
525525
|String
526-
endif::aws,bare,azure[]
526+
endif::aws,bare,azure,gcp[]
527527

528528
ifdef::ibm-z[]
529529
|`compute.architecture`
@@ -577,17 +577,17 @@ accounts for the dramatically decreased machine performance.
577577
|Array of `MachinePool` objects.
578578

579579
ifndef::openshift-origin[]
580-
ifndef::aws,bare,ibm-z,ibm-power,azure,ibm-power-vs[]
580+
ifndef::aws,bare,gcp,ibm-z,ibm-power,azure,ibm-power-vs[]
581581
|`controlPlane.architecture`
582582
|Determines the instruction set architecture of the machines in the pool. Currently, clusters with varied architectures are not supported. All pools must specify the same architecture. Valid values are `amd64` (the default).
583583
|String
584-
endif::aws,bare,ibm-z,ibm-power,azure,ibm-power-vs[]
584+
endif::aws,bare,gcp,ibm-z,ibm-power,azure,ibm-power-vs[]
585585

586-
ifdef::aws,bare,azure[]
586+
ifdef::aws,bare,azure,gcp[]
587587
|`controlPlane.architecture`
588588
|Determines the instruction set architecture of the machines in the pool. Currently, clusters with varied architectures are not supported. All pools must specify the same architecture. Valid values are `amd64` and `arm64`. See _Supported installation methods for different platforms_ in _Installing_ documentation for information about instance availability.
589589
|String
590-
endif::aws,bare,azure[]
590+
endif::aws,bare,azure,gcp[]
591591

592592
ifdef::ibm-z[]
593593
|`controlPlane.architecture`
@@ -1282,6 +1282,10 @@ The `licenses` parameter is a deprecated field and nested virtualization is enab
12821282
|The availability zones where the installation program creates machines.
12831283
|A list of valid link:https://cloud.google.com/compute/docs/regions-zones#available[GCP availability zones], such as `us-central1-a`, in a
12841284
link:https://yaml.org/spec/1.2/spec.html#sequence//[YAML sequence].
1285+
[IMPORTANT]
1286+
====
1287+
When running your cluster on GCP 64-bit ARM infrastructures, ensure that you use a zone where Ampere Altra Arm CPU's are available. You can find which zones are compatible with 64-bit ARM processors in the "GCP availability zones" link.
1288+
====
12851289

12861290
|`platform.gcp.defaultMachinePlatform.osDisk.diskSizeGB`
12871291
|The size of the disk in gigabytes (GB).
@@ -1379,6 +1383,10 @@ link:https://yaml.org/spec/1.2/spec.html#sequence//[YAML sequence].
13791383
|The availability zones where the installation program creates control plane machines.
13801384
|A list of valid link:https://cloud.google.com/compute/docs/regions-zones#available[GCP availability zones], such as `us-central1-a`, in a
13811385
link:https://yaml.org/spec/1.2/spec.html#sequence//[YAML sequence].
1386+
[IMPORTANT]
1387+
====
1388+
When running your cluster on GCP 64-bit ARM infrastructures, ensure that you use a zone where Ampere Altra Arm CPU's are available. You can find which zones are compatible with 64-bit ARM processors in the "GCP availability zones" link.
1389+
====
13821390

13831391
|`controlPlane.platform.gcp.secureBoot`
13841392
|Whether to enable Shielded VM secure boot for control plane machines. Shielded VMs have additional security protocols such as secure boot, firmware and integrity monitoring, and rootkit protection. For more information on Shielded VMs, see Google's documentation on link:https://cloud.google.com/shielded-vm[Shielded VMs].
@@ -1432,6 +1440,10 @@ link:https://yaml.org/spec/1.2/spec.html#sequence//[YAML sequence].
14321440
|The availability zones where the installation program creates compute machines.
14331441
|A list of valid link:https://cloud.google.com/compute/docs/regions-zones#available[GCP availability zones], such as `us-central1-a`, in a
14341442
link:https://yaml.org/spec/1.2/spec.html#sequence//[YAML sequence].
1443+
[IMPORTANT]
1444+
====
1445+
When running your cluster on GCP 64-bit ARM infrastructures, ensure that you use a zone where Ampere Altra Arm CPU's are available. You can find which zones are compatible with 64-bit ARM processors in the "GCP availability zones" link.
1446+
====
14351447

14361448
|`compute.platform.gcp.secureBoot`
14371449
|Whether to enable Shielded VM secure boot for compute machines. Shielded VMs have additional security protocols such as secure boot, firmware and integrity monitoring, and rootkit protection. For more information on Shielded VMs, see Google's documentation on link:https://cloud.google.com/shielded-vm[Shielded VMs].

modules/installation-gcp-enabling-shielded-vms.adoc

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -14,6 +14,11 @@
1414
= Enabling Shielded VMs
1515
You can use Shielded VMs when installing your cluster. Shielded VMs have extra security features including secure boot, firmware and integrity monitoring, and rootkit detection. For more information, see Google's documentation on link:https://cloud.google.com/shielded-vm[Shielded VMs].
1616

17+
[NOTE]
18+
====
19+
Shielded VMs are currently not supported on clusters with 64-bit ARM infrastructures.
20+
====
21+
1722
.Prerequisites
1823
* You have created an `install-config.yaml` file.
1924
Lines changed: 21 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,21 @@
1+
// module included in the following assemblies
2+
//
3+
// installing/installing_gcp/installing-gcp-customizations.adoc
4+
// installing/installing_gcp/installing-gcp-network-customizations.adoc
5+
// installing/installing_gcp/installing-gcp-private.adoc
6+
// installing/installing_gcp/installing-gcp-user-infra-vpc.adoc
7+
// installing/installing_gcp/installing-gcp-user-infra.adoc
8+
// installing/installing_gcp/installing-gcp-vpc.adoc
9+
// installing/installing_gcp/installing-restricted-networks-gcp-installer-provisioned.adoc
10+
// installing/installing_gcp/installing-restricted-networks-gcp.adoc
11+
12+
[id="installation-gcp-tested-machine-types-arm_{context}"]
13+
= Tested instance types for GCP on 64-bit ARM infrastructures
14+
15+
The following Google Cloud Platform (GCP) 64-bit ARM instance types have been tested with {product-title}.
16+
17+
.Machine series for 64-bit ARM machines
18+
[%collapsible]
19+
====
20+
include::https://raw.githubusercontent.com/openshift/installer/master/docs/user/gcp/tested_instance_types_arm.md[]
21+
====

0 commit comments

Comments
 (0)