openshift/openshift-docs
1
0
Fork 0
mirror of https://github.com/openshift/openshift-docs.git synced 2026-02-05 12:46:18 +01:00
Code Issues Releases Activity

BZ1878374 specifying supported instance types

Browse Source
This commit is contained in:
Kathryn Alexander
2020-11-06 14:32:44 -05:00
committed by openshift-cherrypick-robot
parent 1eb6e5c5f0
commit bb680c6db0
12 changed files with 134 additions and 227 deletions
Download Patch File Download Diff File Expand all files Collapse all files

2
installing/installing_aws/installing-aws-customizations.adoc
View File

@@ -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

1
installing/installing_aws/installing-aws-government-region.adoc
View File

@@ -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]

2
installing/installing_aws/installing-aws-network-customizations.adoc
View File

@@ -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

2
installing/installing_aws/installing-aws-private.adoc
View File

@@ -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]

2
installing/installing_aws/installing-aws-user-infra.adoc
View File

@@ -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]

2
installing/installing_aws/installing-aws-vpc.adoc
View File

@@ -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]

2
installing/installing_aws/installing-restricted-networks-aws.adoc
View File

@@ -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.

184
modules/installation-aws-user-infra-requirements.adoc
View File

@@ -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.
////

10
modules/installation-configuration-parameters.adoc
View File

@@ -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.<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.<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

32
modules/installation-creating-aws-control-plane.adoc
View File

@@ -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.

37
modules/installation-creating-aws-worker.adoc
View File

@@ -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

85
modules/installation-supported-aws-machine-types.adoc Normal file
View File

@@ -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
|===