1
0
mirror of https://github.com/openshift/openshift-docs.git synced 2026-02-05 12:46:18 +01:00
Files
openshift-docs/modules/installation-aws-add-iam-roles.adoc
2025-12-16 16:59:59 +00:00

49 lines
1.4 KiB
Plaintext

// Module included in the following assemblies:
//
// * installing/installing_aws/installing-aws-account.adoc
:_mod-docs-content-type: PROCEDURE
[id="specify-an-existing-iam-role_{context}"]
= Specifying an existing IAM role
[role="_abstract"]
Instead of allowing the installation program to create IAM instance profiles with the default permissions, you can use the `install-config.yaml` file to specify an existing IAM role for control plane and compute instances.
.Prerequisites
* You have an existing `install-config.yaml` file.
.Procedure
. Update `compute.platform.aws.iamRole` with an existing role for the compute machines.
+
.Sample `install-config.yaml` file with an IAM role for compute instances
[source,yaml]
----
compute:
- hyperthreading: Enabled
name: worker
platform:
aws:
iamRole: ExampleRole
----
. Update `controlPlane.platform.aws.iamRole` with an existing role for the control plane machines.
+
.Sample `install-config.yaml` file with an IAM role for control plane instances
[source,yaml]
----
controlPlane:
hyperthreading: Enabled
name: master
platform:
aws:
iamRole: ExampleRole
----
. Save the file and reference it when installing the {product-title} cluster.
+
[NOTE]
====
To change or update an IAM account after the cluster has been installed, see link:https://access.redhat.com/solutions/4284011[RHOCP 4 AWS cloud-credentials access key is expired] (Red{nbsp}Hat Knowledgebase).
====