diff --git a/installing/installing_aws/installing-aws-customizations.adoc b/installing/installing_aws/installing-aws-customizations.adoc index 205e1705c4..0f59cfde7b 100644 --- a/installing/installing_aws/installing-aws-customizations.adoc +++ b/installing/installing_aws/installing-aws-customizations.adoc @@ -56,6 +56,8 @@ include::modules/installation-initializing.adoc[leveloffset=+1] include::modules/installation-configuration-parameters.adoc[leveloffset=+2] +include::modules/installation-supported-aws-machine-types.adoc[leveloffset=+2] + include::modules/installation-aws-config-yaml.adoc[leveloffset=+2] // Removing; Proxy not supported for AWS IPI for 4.2 diff --git a/installing/installing_aws/installing-aws-government-region.adoc b/installing/installing_aws/installing-aws-government-region.adoc index 92d7f7b817..4b600567a2 100644 --- a/installing/installing_aws/installing-aws-government-region.adoc +++ b/installing/installing_aws/installing-aws-government-region.adoc @@ -56,6 +56,7 @@ include::modules/installation-obtaining-installer.adoc[leveloffset=+1] include::modules/installation-initializing-manual.adoc[leveloffset=+1] include::modules/installation-configuration-parameters.adoc[leveloffset=+2] +include::modules/installation-supported-aws-machine-types.adoc[leveloffset=+2] include::modules/installation-aws-config-yaml.adoc[leveloffset=+2] include::modules/installation-aws-regions-with-no-ami.adoc[leveloffset=+2] include::modules/installation-aws-upload-custom-rhcos-ami.adoc[leveloffset=+2] diff --git a/installing/installing_aws/installing-aws-network-customizations.adoc b/installing/installing_aws/installing-aws-network-customizations.adoc index 859af456bb..e3e3660731 100644 --- a/installing/installing_aws/installing-aws-network-customizations.adoc +++ b/installing/installing_aws/installing-aws-network-customizations.adoc @@ -60,6 +60,8 @@ include::modules/installation-initializing.adoc[leveloffset=+1] include::modules/installation-configuration-parameters.adoc[leveloffset=+2] +include::modules/installation-supported-aws-machine-types.adoc[leveloffset=+2] + include::modules/installation-aws-config-yaml.adoc[leveloffset=+2] // Removing; Proxy not supported for AWS IPI for 4.2 diff --git a/installing/installing_aws/installing-aws-private.adoc b/installing/installing_aws/installing-aws-private.adoc index b66c1e2a88..a8cfd614c3 100644 --- a/installing/installing_aws/installing-aws-private.adoc +++ b/installing/installing_aws/installing-aws-private.adoc @@ -55,6 +55,8 @@ include::modules/installation-initializing-manual.adoc[leveloffset=+1] include::modules/installation-configuration-parameters.adoc[leveloffset=+2] +include::modules/installation-supported-aws-machine-types.adoc[leveloffset=+2] + include::modules/installation-aws-config-yaml.adoc[leveloffset=+2] include::modules/installation-configure-proxy.adoc[leveloffset=+2] diff --git a/installing/installing_aws/installing-aws-user-infra.adoc b/installing/installing_aws/installing-aws-user-infra.adoc index 28fe4d6035..9f5d651d05 100644 --- a/installing/installing_aws/installing-aws-user-infra.adoc +++ b/installing/installing_aws/installing-aws-user-infra.adoc @@ -45,6 +45,8 @@ include::modules/cluster-entitlements.adoc[leveloffset=+1] include::modules/installation-aws-user-infra-requirements.adoc[leveloffset=+1] +include::modules/installation-supported-aws-machine-types.adoc[leveloffset=+2] + include::modules/installation-aws-permissions.adoc[leveloffset=+2] include::modules/installation-obtaining-installer.adoc[leveloffset=+1] diff --git a/installing/installing_aws/installing-aws-vpc.adoc b/installing/installing_aws/installing-aws-vpc.adoc index 7a66b5722c..fe36fa73c2 100644 --- a/installing/installing_aws/installing-aws-vpc.adoc +++ b/installing/installing_aws/installing-aws-vpc.adoc @@ -51,6 +51,8 @@ include::modules/installation-initializing.adoc[leveloffset=+1] include::modules/installation-configuration-parameters.adoc[leveloffset=+2] +include::modules/installation-supported-aws-machine-types.adoc[leveloffset=+2] + include::modules/installation-aws-config-yaml.adoc[leveloffset=+2] include::modules/installation-configure-proxy.adoc[leveloffset=+2] diff --git a/installing/installing_aws/installing-restricted-networks-aws.adoc b/installing/installing_aws/installing-restricted-networks-aws.adoc index 6ae49a080e..6f8af5f586 100644 --- a/installing/installing_aws/installing-restricted-networks-aws.adoc +++ b/installing/installing_aws/installing-restricted-networks-aws.adoc @@ -66,6 +66,8 @@ include::modules/cluster-entitlements.adoc[leveloffset=+1] include::modules/installation-aws-user-infra-requirements.adoc[leveloffset=+1] +include::modules/installation-supported-aws-machine-types.adoc[leveloffset=+2] + include::modules/installation-aws-permissions.adoc[leveloffset=+2] //You extract the installation program from the mirrored content. diff --git a/modules/installation-aws-user-infra-requirements.adoc b/modules/installation-aws-user-infra-requirements.adoc index a0706b8463..6be3a82a6e 100644 --- a/modules/installation-aws-user-infra-requirements.adoc +++ b/modules/installation-aws-user-infra-requirements.adoc @@ -21,172 +21,6 @@ By using the provided CloudFormation templates, you can create stacks of AWS res Alternatively, you can manually create the components or you can reuse existing infrastructure that meets the cluster requirements. Review the CloudFormation templates for more details about how the components interrelate. -[id="installation-aws-user-infra-cluster-machines_{context}"] -== Cluster machines - -You need `AWS::EC2::Instance` objects for the following machines: - -* A bootstrap machine. This machine is required during installation, but you can remove it after your cluster deploys. -* Three control plane machines. The control plane machines are not governed by a machine set. -* Compute machines. You must create at least two compute machines, which are also known as worker machines, during installation. These machines are not governed by a machine set. - -//// -You can also create and control them by using a MachineSet after your -control plane initializes and you can access the cluster API by using the `oc` -command line interface. -//// - -You can use the following instance types for the cluster machines with the provided CloudFormation templates. - - -[IMPORTANT] -==== -If `m4` instance types are not available in your region, such as with `eu-west-3`, use `m5` types instead. -==== - -.Instance types for machines -[cols="2a,2a,2a,2a",options="header"] -|=== - -|Instance type -|Bootstrap -|Control plane -|Compute - -|`i3.large` -|x -| -| - -| `m4.large` -| -| -|x - -| `m4.xlarge` -| -|x -|x - -| `m4.2xlarge` -| -|x -|x - -| `m4.4xlarge` -| -|x -|x - -| `m4.8xlarge` -| -|x -|x - -| `m4.10xlarge` -| -|x -|x - -| `m4.16xlarge` -| -|x -|x - -| `m5.large` -| -| -|x - -| `m5.xlarge` -| -|x -|x - -| `m5.2xlarge` -| -|x -|x - -| `m5.4xlarge` -| -|x -|x - -| `m5.8xlarge` -| -|x -|x - -| `m5.10xlarge` -| -|x -|x - -| `m5.16xlarge` -| -|x -|x - -| `c4.large` -| -| -|x - -| `c4.xlarge` -| -| -|x - -| `c4.2xlarge` -| -|x -|x - -| `c4.4xlarge` -| -|x -|x - -| `c4.8xlarge` -| -|x -|x - -| `r4.large` -| -| -|x - -| `r4.xlarge` -| -|x -|x - -| `r4.2xlarge` -| -|x -|x - -| `r4.4xlarge` -| -|x -|x - -| `r4.8xlarge` -| -|x -|x - -| `r4.16xlarge` -| -|x -|x - -|=== - -You might be able to use other instance types that meet the specifications of these instance types. - [id="csr-management-aws_{context}"] == Certificate signing requests management @@ -589,3 +423,21 @@ or the following individual permissions. |`*` |=== + +[id="installation-aws-user-infra-cluster-machines_{context}"] +== Cluster machines + +You need `AWS::EC2::Instance` objects for the following machines: + +* A bootstrap machine. This machine is required during installation, but you +can remove it after your cluster deploys. +* At least three control plane machines. The control plane machines are not +governed by a MachineSet. +* Compute machines. You must create at least two compute machines, which are also known as worker machines, +during installation. These machines are not governed by a MachineSet. + +//// +You can also create and control them by using a MachineSet after your +control plane initializes and you can access the cluster API by using the `oc` +command line interface. +//// diff --git a/modules/installation-configuration-parameters.adoc b/modules/installation-configuration-parameters.adoc index d30c973097..bda96ce25e 100644 --- a/modules/installation-configuration-parameters.adoc +++ b/modules/installation-configuration-parameters.adoc @@ -169,7 +169,7 @@ The string must be 14 characters or fewer long. endif::osp[] |`platform` -|The configuration for the specific platform upon which to perform the installation: `aws`, `baremetal`, `azure`, `openstack`, `ovirt`, `vsphere`. For additional information about `platform.` parameters, consult the following table for your specific platform. +|The configuration for the specific platform upon which to perform the installation: `aws`, `baremetal`, `azure`, `openstack`, `ovirt`, `vsphere`. For additional information about `platform.` parameters, consult the table for your specific platform that follows. |Object ifndef::openshift-origin[] @@ -206,7 +206,7 @@ endif::[] |`compute` |The configuration for the machines that comprise the compute nodes. -|Array of machine-pool objects. For details, see the following "Machine-pool" table. +|Array of `MachinePool` objects. For details, see the following "Machine-pool" table. |`compute.architecture` |Determines the instruction set architecture of the machines in the pool. Currently, heteregeneous clusters are not supported, so all pools must specify the same architecture. Valid values are `amd64` (the default). @@ -425,7 +425,8 @@ such as `io1`. |`compute.platform.aws.type` |The EC2 instance type for the compute machines. -|Valid link:https://aws.amazon.com/ec2/instance-types/[AWS instance type], such as `c5.9xlarge`. +|Valid AWS instance type, such as `m4.2xlarge`. See the *Instance types for machines* table that follows. +//add an xref when possible. |`compute.platform.aws.zones` |The availability zones where the installation program creates machines for the compute machine pool. If you provide your own VPC, you must provide a subnet in that availability zone. @@ -446,7 +447,8 @@ link:https://yaml.org/spec/1.2/spec.html#sequence//[YAML sequence]. |`controlPlane.platform.aws.type` |The EC2 instance type for the control plane machines. -|Valid link:https://aws.amazon.com/ec2/instance-types/[AWS instance type], such as `c5.9xlarge`. +|Valid AWS instance type, such as `m5.xlarge`. See the *Instance types for machines* table that follows. +//add an xref when possible |`controlPlane.platform.aws.zones` |The availability zones where the installation program creates machines for the diff --git a/modules/installation-creating-aws-control-plane.adoc b/modules/installation-creating-aws-control-plane.adoc index f647f79c9a..0c6d9e38e0 100644 --- a/modules/installation-creating-aws-control-plane.adoc +++ b/modules/installation-creating-aws-control-plane.adoc @@ -91,7 +91,7 @@ requires: }, { "ParameterKey": "MasterInstanceType", <21> - "ParameterValue": "m4.xlarge" <22> + "ParameterValue": "m5.xlarge" <22> }, { "ParameterKey": "AutoRegisterELB", <23> @@ -150,32 +150,12 @@ directory. This value is the long string with the format the CloudFormation template for the security group and roles. <21> The type of AWS instance to use for the control plane machines. <22> Allowed values: -* `m4.xlarge` -* `m4.2xlarge` -* `m4.4xlarge` -* `m4.8xlarge` -* `m4.10xlarge` -* `m4.16xlarge` -* `m5.xlarge` -* `m5.2xlarge` -* `m5.4xlarge` -* `m5.8xlarge` -* `m5.10xlarge` -* `m5.16xlarge` -* `c4.2xlarge` +* `m5a.xlarge` +* `c5a.2xlarge` +* `r5.xlarge` +* `r5a.xlarge` * `c4.4xlarge` -* `c4.8xlarge` -* `r4.xlarge` -* `r4.2xlarge` -* `r4.4xlarge` -* `r4.8xlarge` -* `r4.16xlarge` -+ -[IMPORTANT] -==== -If `m4` instance types are not available in your region, such as with -`eu-west-3`, specify an `m5` type, such as `m5.xlarge`, instead. -==== +* `m5.xlarge` <23> Whether or not to register a network load balancer (NLB). <24> Specify `yes` or `no`. If you specify `yes`, you must provide a Lambda Amazon Resource Name (ARN) value. diff --git a/modules/installation-creating-aws-worker.adoc b/modules/installation-creating-aws-worker.adoc index 5a97709b29..ccdf4c143a 100644 --- a/modules/installation-creating-aws-worker.adoc +++ b/modules/installation-creating-aws-worker.adoc @@ -77,7 +77,7 @@ template requires: }, { "ParameterKey": "WorkerInstanceType", <15> - "ParameterValue": "m4.large" <16> + "ParameterValue": "m4.2xlarge" <16> } ] ---- @@ -105,37 +105,12 @@ directory. This value is the long string with the format the CloudFormation template for the security group and roles. <15> The type of AWS instance to use for the control plane machines. <16> Allowed values: -* `m4.large` -* `m4.xlarge` -* `m4.2xlarge` -* `m4.4xlarge` -* `m4.8xlarge` -* `m4.10xlarge` -* `m4.16xlarge` -* `m5.large` -* `m5.xlarge` -* `m5.2xlarge` -* `m5.4xlarge` -* `m5.8xlarge` -* `m5.10xlarge` -* `m5.16xlarge` -* `c4.large` -* `c4.xlarge` -* `c4.2xlarge` -* `c4.4xlarge` -* `c4.8xlarge` +* `c5.xlarge` +* `t3.xlarge` * `r4.large` -* `r4.xlarge` -* `r4.2xlarge` -* `r4.4xlarge` -* `r4.8xlarge` -* `r4.16xlarge` -+ -[IMPORTANT] -==== -If `m4` instance types are not available in your region, such as with -`eu-west-3`, use `m5` types instead. -==== +* `t3a.xlarge` +* `m4.2xlarge` +* `m5.xlarge` . Copy the template from the *CloudFormation template for worker machines* section of this topic and save it as a YAML file on your computer. This template diff --git a/modules/installation-supported-aws-machine-types.adoc b/modules/installation-supported-aws-machine-types.adoc new file mode 100644 index 0000000000..9dd7540e9a --- /dev/null +++ b/modules/installation-supported-aws-machine-types.adoc @@ -0,0 +1,85 @@ +// Module included in the following assemblies: +// +// * installing/installing_aws/installing-aws-user-infra.adoc +// * installing/installing_aws/installing-restricted-networks-aws.adoc +// * installing/installing_aws/installing-aws-network-customizations.adoc +// * installing/installing_aws/installing-aws-government-region.adoc +// * installing/installing_aws/installing-aws-customizations.adoc +// * installing/installing_aws/installing-aws-vpc.adoc +// * installing/installing_aws/installing-aws-private.adoc + +[id="installation-supported-aws-machine-types_{context}"] += Supported AWS machine types + +The following Amazon Web Services (AWS) instance types are supported with {product-title}. + +.Instance types for machines +[cols="2a,2a,2a,2a",options="header"] +|=== + +|Instance type +|Bootstrap +|Control plane +|Compute + +|`i3.large` +|x +| +| + +|`m4.2xlarge` +| +| +|x + +|`m5.xlarge` +| +|x +|x + +|`m5a.xlarge` +| +|x +| + +|`c4.4xlarge` +| +|x +| + +|`c5.xlarge` +| +| +|x + +|`c5a.2xlarge` +| +|x +| + +|`r4.large` +| +| +|x + +|`r5.xlarge` +| +|x +| + +|`r5a.xlarge` +| +|x +| + +|`t3.xlarge` +| +| +|x + +|`t3a.xlarge` +| +| +|x + +|===