Skip to content

Commit 7835fff

Browse files
committed
OSDOCS-11735: Update GCP installation info
** Add in notes for permissions when user does not provide service accounts for installs. ** Add in service account field for the install parameters
1 parent 024feb0 commit 7835fff

File tree

2 files changed

+27
-0
lines changed

2 files changed

+27
-0
lines changed

modules/installation-configuration-parameters.adoc

Lines changed: 18 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -2109,6 +2109,13 @@ Additional GCP configuration parameters are described in the following table:
21092109
|The name of the custom {op-system} image that the installation program is to use to boot compute machines. If you use `compute.platform.gcp.osImage.project`, this field is required.
21102110
|String. The name of the {op-system} image.
21112111

2112+
|compute:
2113+
platform:
2114+
gcp:
2115+
serviceAccount:
2116+
|Specifies the email address of a {gcp-short} service account to be used during installations. This service account will be used to provision compute machines.
2117+
|String. The email address of the service account.
2118+
21122119
|platform:
21132120
gcp:
21142121
network:
@@ -2385,6 +2392,17 @@ When running your cluster on GCP 64-bit ARM infrastructures, ensure that you use
23852392
|Specifies the behavior of control plane VMs during a host maintenance event, such as a software or hardware update. For Confidential VMs, this parameter must be set to `Terminate`. Confidential VMs do not support live VM migration.
23862393
|`Terminate` or `Migrate`. The default value is `Migrate`.
23872394

2395+
|controlPlane:
2396+
platform:
2397+
gcp:
2398+
serviceAccount:
2399+
|Specifies the email address of a {gcp-short} service account to be used during installations. This service account will be used to provision control plane machines.
2400+
[IMPORTANT]
2401+
====
2402+
In the case of shared VPC installations, when the service account is not provided, the installer service account must have the `resourcemanager.projects.getIamPolicy` and `resourcemanager.projects.setIamPolicy` permissions in the host project.
2403+
====
2404+
|String. The email address of the service account.
2405+
23882406
|compute:
23892407
platform:
23902408
gcp:

modules/minimum-required-permissions-ipi-gcp-xpn.adoc

Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -31,3 +31,12 @@ Ensure that the host project applies one of the following configurations to the
3131
* `projects/<host-project>/roles/dns.networks.bindPrivateDNSZone`
3232
* `roles/compute.networkUser`
3333
====
34+
35+
If you do not supply a service account for control plane nodes in the `install-config.yaml` file, please grant the below permissions to the service account in the host project.
36+
37+
[%collapsible]
38+
====
39+
* `resourcemanager.projects.getIamPolicy`
40+
* `resourcemanager.projects.setIamPolicy`
41+
====
42+

0 commit comments

Comments
 (0)