AWS::EKS::FargateProfile - AWS CloudFormation
AWS 文档中描述的 AWS 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 AWS 服务入门

AWS::EKS::FargateProfile

为您的 Amazon EKS 集群创建 AWS Fargate 配置文件。您必须在集群中至少有一个 Fargate 配置文件,才能在 Fargate 上运行 Pod。

Fargate 配置文件允许管理员声明哪些 Pod 在 Fargate 上运行,并指定哪些 Pod 在哪个 Fargate 配置文件上运行。此声明通过配置文件的选择器完成。每个配置文件最多可以有五个包含命名空间和标签的选择器。每个选择器都需要一个命名空间。标签字段由多个可选键值对组成。与选择器匹配的 Pod 被安排在 Fargate 上。如果待安排的 Pod 与 Fargate 配置文件中的任何一个选择器匹配,该 Pod 将在 Fargate 上运行。

创建 Fargate 配置文件时,必须指定一个 Pod 执行角色,以便与通过配置文件安排的 Pod 结合使用。此角色将被添加到集群的 Kubernetes 基于角色的访问控制 (RBAC) 中以进行授权,以使在 Fargate 基础设施上运行的 kubelet 可以向 Amazon EKS 集群注册,以便它可作为节点显示在集群中。Pod 执行角色还提供对 Fargate 基础设施的 IAM 权限,以允许对 Amazon ECR 映像存储库进行读取访问。有关更多信息,请参阅 Amazon EKS 用户指南 中的 Pod 执行角色

Fargate 配置文件是不可变的。不过,您可以创建新的更新配置文件来替换现有配置文件,然后在更新配置文件创建完成后删除原始配置文件。

如果集群中有任何 Fargate 配置文件处于 DELETING 状态,您必须等待该 Fargate 配置文件删除完毕,然后才能在该集群中创建任何其他配置文件。

有关更多信息,请参阅 Amazon EKS 用户指南 中的 AWS Fargate 配置文件

语法

要在 AWS CloudFormation 模板中声明此实体,请使用以下语法:

JSON

{ "Type" : "AWS::EKS::FargateProfile", "Properties" : { "ClusterName" : String, "FargateProfileName" : String, "PodExecutionRoleArn" : String, "Selectors" : [ Selector, ... ], "Subnets" : [ String, ... ], "Tags" : [ Tag, ... ] } }

YAML

Type: AWS::EKS::FargateProfile Properties: ClusterName: String FargateProfileName: String PodExecutionRoleArn: String Selectors: - Selector Subnets: - String Tags: - Tag

属性

ClusterName

要应用 Fargate 配置文件的 Amazon EKS 集群的名称。

必需:是

类型:字符串

Update requires: Replacement

FargateProfileName

Fargate 配置文件的名称。

必需:否

类型:字符串

Update requires: Replacement

PodExecutionRoleArn

Pod 执行角色的 Amazon 资源名称 (ARN),用于与 Fargate 配置文件中的选择器匹配的 Pod。Pod 执行角色允许 Fargate 基础设施向您的集群注册为节点,并提供对 Amazon ECR 映像存储库的读取访问权限。有关更多信息,请参阅 Amazon EKS 用户指南 中的 Pod 执行角色

必需:是

类型:字符串

Update requires: Replacement

Selectors

要匹配 Pod 以使用此 Fargate 配置文件的选择器。每个选择器都必须有一个关联的命名空间。您还可以选择为命名空间指定标签。最多可以在 Fargate 配置文件中指定五个选择器。

必需:是

类型选择器列表

Update requires: Replacement

Subnets

要将 Pod 启动到的子网的 ID。目前,在 Fargate 上运行的 Pod 不会被分配公有 IP 地址,因此,此参数仅接受私有子网(没有到 Internet 网关的直接路由)。

必需:否

类型:字符串列表

Update requires: Replacement

Tags

要应用于 Fargate 配置文件以帮助进行分类和组织的元数据。每个标签都包含您定义的一个键和一个可选值。Fargate 配置文件标签不会传播到与 Fargate 配置文件关联的任何其他资源,例如使用配置文件调度的 Pod。

必需:否

类型Tag 的列表

Update requires: No interruption

返回值

Ref

在将此资源的逻辑 ID 传递给内部 Ref 函数时,Ref 返回 资源名称。例如:

{ "Ref": "myFargateProfile" }

对于 Fargate 配置文件 myFargateProfile,Ref 返回 Fargate 配置文件的物理资源 ID。例如:<cluster_name>/<Fargate_profile_name>

For more information about using the Ref function, see Ref.

Fn::GetAtt

Fn::GetAtt 内部函数返回此类型的一个指定属性的值。以下为可用属性和示例返回值。

有关使用 Fn::GetAtt 内部函数的更多信息,请参阅 Fn::GetAtt

Arn

集群的 ARN,例如 arn:aws:eks:us-west-2:666666666666:fargateprofile/myCluster/myFargateProfile/1cb1a11a-1dc1-1d11-cf11-1111f11fa111

另请参阅