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

AWS::Batch::ComputeEnvironment

AWS::Batch::ComputeEnvironment 资源定义 AWS Batch 计算环境。有关更多信息,请参阅 AWS Batch 用户指南 中的计算环境

语法

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

JSON

{ "Type" : "AWS::Batch::ComputeEnvironment", "Properties" : { "ComputeEnvironmentName" : String, "ComputeResources" : ComputeResources, "ServiceRole" : String, "State" : String, "Type" : String } }

YAML

Type: AWS::Batch::ComputeEnvironment Properties: ComputeEnvironmentName: String ComputeResources: ComputeResources ServiceRole: String State: String Type: String

属性

ComputeEnvironmentName

您的计算环境的名称。最多能包含 128 个字母(大写和小写字母)、数字、连字符和下划线。

必需:否

类型:字符串

Update requires: Replacement

ComputeResources

ComputeResources 属性类型指定计算环境托管的计算资源的详细信息。该参数是托管计算环境所必需的。有关更多信息,请参阅 AWS Batch 用户指南 中的计算环境

必需:否

类型ComputeResources

Update requires: No interruption

ServiceRole

允许 AWS Batch 代表您调用其他 AWS 服务的 IAM 角色的完整 Amazon 资源名称 (ARN)。

如果您的指定角色的路径并非 /,则必须指定完整角色 ARN(推荐)或将此路径作为角色名称的前缀。

注意

根据您创建 AWS Batch 服务角色的方式,其 ARN 可能包含 service-role 路径前缀。当您仅指定服务角色的名称时,AWS Batch 假定您的 ARN 不使用 service-role 路径前缀。因此,我们建议您在创建计算环境时指定服务角色的完整 ARN。

必需:是

类型:字符串

Update requires: No interruption

State

计算环境的状态。如果状态为 ENABLED,则计算环境接受队列中的作业,并可根据队列自动扩展。

必需:否

类型:字符串

允许的值DISABLED | ENABLED

Update requires: No interruption

Type

计算环境的类型。有关更多信息,请参阅 AWS Batch 用户指南 中的计算环境

必需:是

类型:字符串

允许的值MANAGED | UNMANAGED

Update requires: Replacement

返回值

Ref

在将此资源的逻辑 ID 传递给内部 Ref 函数时,Ref 返回计算环境 ARN,例如 arn:aws:batch:us-east-1:555555555555:compute-environment/M4OnDemand

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

示例

托管计算环境

以下示例创建一个名为 C4OnDemand 的托管计算环境,该环境使用 C4 按需实例和自定义 AMI。

JSON

{ "ComputeEnvironment": { "Type": "AWS::Batch::ComputeEnvironment", "Properties": { "Type": "MANAGED", "ServiceRole": "arn:aws:iam::111122223333:role/service-role/AWSBatchServiceRole", "ComputeEnvironmentName": "C4OnDemand", "ComputeResources": { "MaxvCpus": 128, "SecurityGroupIds": [ "sg-abcd1234" ], "Type": "EC2", "Subnets": [ "subnet-aaaaaaaa", "subnet-bbbbbbbb", "subnet-cccccccc" ], "MinvCpus": 0, "ImageId": "ami-a1b2c3d4", "InstanceRole": "ecsInstanceRole", "InstanceTypes": [ "c4.large", "c4.xlarge", "c4.2xlarge", "c4.4xlarge", "c4.8xlarge" ], "Ec2KeyPair": "id_rsa", "Tags": { "Name": "Batch Instance - C4OnDemand" }, "DesiredvCpus": 48 }, "State": "ENABLED" } } }

YAML

ComputeEnvironment: Type: AWS::Batch::ComputeEnvironment Properties: Type: MANAGED ServiceRole: arn:aws:iam::111122223333:role/service-role/AWSBatchServiceRole ComputeEnvironmentName: C4OnDemand ComputeResources: MaxvCpus: 128 SecurityGroupIds: - sg-abcd1234 Type: EC2 Subnets: - subnet-aaaaaaaa - subnet-bbbbbbbb - subnet-cccccccc MinvCpus: 0 ImageId: ami-a1b2c3d4 InstanceRole: ecsInstanceRole InstanceTypes: - c4.large - c4.xlarge - c4.2xlarge - c4.4xlarge - c4.8xlarge Ec2KeyPair: id_rsa Tags: {"Name" : "Batch Instance - C4OnDemand"} DesiredvCpus: 48 State: ENABLED

另请参阅