本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# `AWS-CreateEKSClusterWithNodegroup`
<a name="aws-createeksclusterwithnodegroup"></a>

 **描述** 

 该`AWS-CreateEKSClusterWithNodegroup`运行手册使用节点组创建了亚马逊弹性 Kubernetes 服务（亚马逊 EKS）集群，以增加容量。

 [运行此自动化（控制台）](https://console.aws.amazon.com/systems-manager/automation/execute/AWS-CreateEKSClusterWithNodegroup) 

**文档类型**

自动化

**所有者**

Amazon

**平台**

Linux、macOS、Windows

**参数**
+ AutomationAssumeRole

  类型：字符串

  描述：（可选）允许 Systems Manager Automation 代表您执行操作 AWS Identity and Access Management (IAM) 角色的 Amazon 资源名称（ARN）。如果未指定角色，Systems Manager Automation 将使用启动此运行手册的用户的权限。
+ ClusterName

  类型：字符串

  描述：（必填）集群的唯一名称。
+ ClusterRoleArn

  类型：字符串

  描述：（必填）IAM 角色的 ARN，该角色为 Kubernetes 控制平面提供权限，允许他们代表您调用 AWS API 操作。
+ NodegroupName

  类型：字符串

  描述：（必填）节点组的唯一名称。
+ NodegroupRoleArn

  类型：字符串

  描述：（必填）要与您的节点组关联的 IAM 角色的 ARN。亚马逊 EKS 工作节点 kubelet 守护程序代表你调用 AWS API。节点通过 IAM 实例配置文件和关联的策略获得这些 API 调用的权限。您必须先为节点创建 IAM 角色以在启动它们时使用，然后才能启动这些节点并在集群中注册它们。
+ SubnetIds

  类型： StringList

  描述：（必填）您要用于 Amazon EKS 集群的子网的 ID。Amazon EKS 在这些子网中创建弹性网络接口，用于您的节点与 Kubernetes 控制平面之间的通信。您必须指定至少两个子网 ID。
+ EKSEndpointPrivateAccess

  类型：布尔值

  默认值：True

  描述：（可选）将此值设置为`True`允许私有访问集群的 Kubernetes API 服务器终端节点。如果启用私有访问，集群的 VPC 内的 Kubernetes API 请求将使用私有 VPC 端点。如果您禁用了私有访问权限并且集群中有 AWS Fargate 节点或容器，则请确保`publicAccessCidrs`包含与节点或 Fargate 容器通信所必需的 CIDR 块。
+ EKSEndpointPublicAccess

  类型：布尔值

  默认值：False

  描述：（可选）将此值设置为`False`以禁用对集群的 Kubernetes API 服务器终端节点的公开访问。如果您禁用公有访问，则您的集群的 Kubernetes API 服务器只能接收来自其启动时的 VPC 内的请求。
+ PublicAccessCIDRs

  类型： StringList

  描述：（可选）允许访问集群公有 Kubernetes API 服务器终端节点的 CIDR 块。拒绝从您指定的 CIDR 块之外的地址与端点的通信。如果您禁用了私有终端节点访问权限并且集群中有节点或 Fargate 容器，请确保指定必要的 CIDR 块。
+ SecurityGroupIds

  类型： StringList

  描述：（可选）指定一个或多个安全组，以与 Amazon EKS 在您的账户中创建的弹性网络接口相关联。

**所需的 IAM 权限**

`AutomationAssumeRole` 参数需要执行以下操作才能成功使用运行手册。
+ `ssm:StartAutomationExecution`
+ `ssm:GetAutomationExecution`
+ `ec2:DescribeSubnets`
+ `eks:CreateCluster`
+ `eks:CreateNodegroup`
+ `eks:DescribeCluster`
+ `eks:DescribeNodegroup`
+ `iam:CreateServiceLinkedRole`
+ `iam:GetRole`
+ `iam:ListAttachedRolePolicies`
+ `iam:PassRole`

 **文档步骤** 
+ createEKSCluster (aws: executeAwsApi)-创建亚马逊 EKS 集群。
+ VerifyEKSClusterIsActive (aws: waitForAwsResourceProperty)-验证集群状态为。`ACTIVE`
+ CreateNodegroup (aws: executeAwsApi)-为集群创建节点组。
+ VerifyNodegroupIsActive (aws: waitForAwsResourceProperty)-验证节点组的状态为。`ACTIVE`

 **输出** 
+ `CreateEKSCluster.CreateClusterResponse`：从 `CreateCluster` API 调用中收到的响应。
+ `CreateNodegroup.CreateNodegroupResponse`：从 `CreateNodegroup` API 调用中收到的响应。