コンピューティング環境パラメータ

コンピューティング環境は 5 つの基本コンポーネントに分かれています。コンピューティング環境の名前、タイプ、コンピューティングリソース定義 (マネージド型のコンピューティング環境の場合)、およびに IAM アクセス権限を提供するためのサービスロールです。AWS Batch。

コンピューティング環境名

computeEnvironmentName

コンピューティング環境の名前です。名前の最大長は 128 文字です。これには、大文字と小文字、数字、ハイフン (-)、およびアンダースコア (_) を使用できます。

タイプ: 文字列

: 必須 はい

Type

type

コンピューティング環境のタイプ。選択MANAGEDを持たせるにはAWS Batch定義する EC2 または Fargate コンピューティングリソースを管理します。詳細については、「コンピューティングリソース」を参照してください。選択UNMANAGEDを使用して、独自の EC2 コンピューティングリソースを管理できます。

タイプ: 文字列

有効な値: MANAGED | UNMANAGED

: 必須 はい

State

state

コンピューティング環境の状態。

状態がENABLEDとすると、AWS Batchスケジューラは環境内でのジョブの配置を試行します。これらのジョブは、コンピューティングリソース上の関連付けられたジョブキューから取得されます。コンピューティング環境がマネージド型の場合は、ジョブキューの需要に基づいてそのインスタンスを自動的にスケールアウトまたはスケールインできます。

状態がDISABLEDとすると、AWS Batchスケジューラは環境内でのジョブの配置を試行しません。状態が STARTING または RUNNING のジョブは、引き続き正常に進行します。DISABLED 状態のマネージドコンピューティング環境はスケールアウトされません。ただし、インスタンスがアイドル状態になると、インスタンスの最小数にスケールインされ、minvCpus値.

タイプ: 文字列

有効な値: ENABLED | DISABLED

: 必須 いいえ

コンピューティングリソース

computeResources

コンピューティング環境によって管理されるコンピューティングリソースの詳細。詳細については、「」を参照してください。コンピューティング環境。

タイプ: ComputeResourceオブジェクト

: 必須 このパラメータは、マネージド型のコンピューティング環境に必要です。

type

コンピューティング環境のタイプ。EC2 オンデマンドインスタンスを使用することを選択できます（EC2) と EC2 スポットインスタンス (SPOT)、または Fargate キャパシティ (FARGATE) とFargate スポット容量 (FARGATE_SPOT) をマネージドコンピューティング環境で使用します。SPOT を選択した場合は、spotIamFleetRole パラメータで Amazon EC2 スポットフリートロールも指定する必要があります。詳細については、「Amazon EC2 スポットフリートのロール」を参照してください。

有効な値: EC2 | SPOT | FARGATE | FARGATE_SPOT

: 必須 はい

allocationStrategy

最適なインスタンスタイプの十分なインスタンスを配分できない場合に、コンピューティングリソースに使用する配分戦略です。これは、リージョン内のインスタンスタイプの可用性またはAmazon EC2 サービス制限。詳細については、「配分戦略」を参照してください。

注記

このパラメータは、Fargate リソースで実行されているジョブには適用されないため、指定できません。

BEST_FIT (デフォルト)

AWS Batchは、最もコストの低いインスタンスタイプを優先し、ジョブのニーズに最も適したインスタンスタイプを選択します。選択したインスタンスタイプの追加のインスタンスが利用できない場合、AWS Batchは、追加のインスタンスが利用可能になるまで待機します。十分なインスタンスが利用可能でない場合、またはAmazon EC2 サービス制限の場合、現在実行中のジョブが完了するまで、追加のジョブは実行されません。この配分戦略により、コストは低くなりますが、スケーリングは制限される場合があります。スポットフリートをBEST_FIT場合は、スポットフリートの IAM ロールを指定する必要があります。

BEST_FIT_PROGRESSIVE

キュー内のジョブの要件を満たすのに十分な大きさの追加のインスタンスタイプを使用し、ユニット vCPU ごとにより低コストのインスタンスタイプを優先します。以前に選択したインスタンスタイプの追加のインスタンスが利用できない場合、AWS Batch新しいインスタンスタイプを選択します。

SPOT_CAPACITY_OPTIMIZED

(スポットインスタンスのコンピューティングリソースでのみ使用可能) キュー内のジョブの要件を満たすのに十分な大きさの追加のインスタンスタイプを使用し、中断される可能性が低いインスタンスタイプを優先します。

(両方に対して)BEST_FIT_PROGRESSIVEおよびSPOT_CAPACITY_OPTIMIZED戦略,AWS Batch超える必要があるかもしれませんmaxvCpusを使用して、キャパシティ要件を満たすことができます。このイベントではAWS Batchを超えることはありませんmaxvCpusは、単一のインスタンスよりもです。

有効な値: BEST_FIT | BEST_FIT_PROGRESSIVE | SPOT_CAPACITY_OPTIMIZED

: 必須 いいえ

minvCpus

環境で維持する Amazon EC2 vCPUs の最小数 (コンピューティング環境がDISABLED).

注記

このパラメータは、Fargate リソースで実行されているジョブには適用されないため、指定できません。

タイプ: 整数

: 必須 はい

maxvCpus

環境で到達できる Amazon EC2 vCPU の最大数。

注記

(両方に対して)BEST_FIT_PROGRESSIVEおよびSPOT_CAPACITY_OPTIMIZED配分戦略AWS Batch超える必要があるかもしれませんmaxvCpusを使用して、キャパシティ要件を満たすことができます。このイベントではAWS Batchを超えることはありませんmaxvCpusは、単一のインスタンスよりもです。例:AWS Batchコンピューティング環境で指定されたインスタンスの中の 1 つのインスタンスしか使用しません。

タイプ: 整数

: 必須 はい

desiredvCpus

コンピューティング環境で必要な Amazon EC2 vCPUS の数。AWS Batchでは、この値をジョブキューの需要に応じて最小値と最大値の間で調整します。

注記

このパラメータは、Fargate リソースで実行されているジョブには適用されないため、指定できません。

タイプ: 整数

: 必須 いいえ

instanceTypes

起動される可能性のあるインスタンスタイプ。このパラメータは、Fargate リソースで実行されているジョブには適用されないため、指定できません。インスタンスファミリーを指定して、そのファミリー内のいずれかのインスタンスタイプ (たとえば、c5,c5n, またはp3). または、ファミリ内で特定のサイズ (c5.8xlarge). メタルインスタンスタイプはインスタンスファミリーに含まれません (たとえば、c5には含まれないc5.metal。） また、optimal を選択して (C4、M4、および R4 インスタンスファミリーから) ジョブキューの需要に見合ったインスタンスタイプを使用することもできます。

注記

コンピューティング環境を作成する際、そのコンピューティング環境で選択するインスタンスタイプで同じアーキテクチャを使用する必要があります。例えば、x86 と ARM インスタンスを同じコンピューティング環境で使用することはできません。

注記

現在、optimal は C4、M4、および R4 インスタンスファミリーのインスタンスタイプを使用しています。これらのインスタンスファミリーのインスタンスタイプを持たないリージョンでは、C5、M5、および R5 インスタンスファミリーのインスタンスタイプが使用されます。

タイプ: 文字列の配列

必須: はい

imageId

このパラメータは廃止されました。

コンピューティング環境で起動されるインスタンスに使用する Amazon Machine Image (AMI) の ID。このパラメータは、Ec2Configuration 構造の imageIdOverride メンバーによってオーバーライドされます。

注記

このパラメータは、Fargate リソースで実行されているジョブには適用されないため、指定できません。

注記

コンピューティング環境用に選択する AMI は、そのコンピューティング環境で使用するインスタンスタイプのアーキテクチャと一致している必要があります。例えば、コンピューティング環境で A1 インスタンスタイプを使用する場合、選択するコンピューティングリソース AMI で ARM インスタンスをサポートしている必要があります。Amazon ECS は、Amazon ECS に最適化された Amazon Linux 2 AMI の、x86 と ARM の両バージョンを提供しています。詳細については、「」を参照してください。Amazon ECS に最適化された Amazon Linux 2 AMI()Amazon Elastic Container Service。

タイプ: 文字列

: 必須 いいえ

subnets

コンピューティングリソースを起動する先の VPC サブネット。これらのサブネットは、同じ VPC 内にある必要があります。Fargate のコンピューティングリソースには、最大 16 個のサブネットを含めることができます。詳細については、「」を参照してください。VPC とサブネット()Amazon VPC ユーザーガイド。

タイプ: 文字列の配列

: 必須 はい

securityGroupIds

コンピューティング環境で起動されるインスタンスに関連付けられる Amazon EC2 セキュリティグループ。securityGroupIds で、または launchTemplate で参照されている起動テンプレートを使用して、1 つ以上のセキュリティグループを指定する必要があります 。このパラメータは、Fargate リソースで実行されているジョブに必要であり、少なくとも 1 つのセキュリティグループを含める必要があります。Fargate は起動テンプレートをサポートしていません。securityGroupIds と launchTemplate の両方を使用してセキュリティグループを指定した場合は、securityGroupIds の値が使用されます。

タイプ: 文字列の配列

: 必須 はい

ec2KeyPair

コンピューティング環境で起動されるインスタンスに使用する EC2 key pair。このキーペアを使用して、SSH でインスタンスにログインできます。

注記

このパラメータは、Fargate リソースで実行されているジョブには適用されないため、指定できません。

タイプ: 文字列

: 必須 いいえ

instanceRole

コンピューティング環境内の Amazon EC2 インスタンスにアタッチする Amazon ECS インスタンスプロファイル。このパラメータは、Fargate リソースで実行されているジョブには適用されないため、指定できません。インスタンスプロファイルの短縮名、または、完全な Amazon リソースネーム (ARN) を指定できます。例えば、ecsInstanceRole、arn:aws:iam::aws_account_id:instance-profile/ecsInstanceRole などです。詳細については、「Amazon ECS インスタンスのロール」を参照してください。

タイプ: 文字列

: 必須 いいえ

tags

コンピューティング環境で起動される EC2 インスタンスにタグとして適用されるキーと値のペア。たとえば、タグとして "Name": "AWS Batch Instance - C4OnDemand" を指定し、その名前をコンピューティング環境の各インスタンスに使用できます。これは、あなたのAWS Batchインスタンスを Amazon EC2 コンソールに追加します。これらのタグは、コンピューティング環境の作成後に更新または削除することはできません。変更を行う場合は、新しいコンピューティング環境を作成し、以前のコンピューティング環境を削除する必要があります。これらのタグは、AWS Batch ListTagsForResourceAPI オペレーション。

注記

このパラメータは、Fargate リソースで実行されているジョブには適用されないため、指定できません。

タイプ: 文字列から文字列へのマッピング

: 必須 いいえ

placementGroup

コンピューティングリソースに関連付ける Amazon EC2 プレイスメントグループ。このパラメータは、Fargate リソースで実行されているジョブには適用されないため、指定できません。マルチノードの並列ジョブをコンピューティング環境に送信する場合、クラスタープレイスメントグループを作成してコンピューティングリソースに関連付けることを検討してください。これにより、論理的にグループ化されたインスタンス上のマルチノードの並列ジョブが、潜在的に高度なネットワークフローを備えた単一のアベイラビリティーゾーン内に保持されます。詳細については、「」を参照してください。プレイスメントグループ()Linux インスタンス用 Amazon EC2 ユーザーガイド。

タイプ: 文字列

: 必須 いいえ

bidPercentage

EC2 スポットインスタンス料金を、そのインスタンスタイプのオンデマンド料金と対比した最大パーセンテージ。たとえば、最大割合が 20% の場合、その EC2 インスタンスのスポット料金は現在のオンデマンド料金の 20% 未満にする必要があります。支払い額は常に最低 (市場料金) となり、最大パーセンテージを超えることはありません。このフィールドを空のままにした場合、デフォルト値はオンデマンド料金の 100% です。

注記

このパラメータは、Fargate リソースで実行されているジョブには適用されないため、指定できません。

: 必須 いいえ

spotIamFleetRole

SPOT コンピューティング環境に適用する Amazon EC2 スポットフリートの IAM ロールの Amazon リソースネーム (ARN)。このロールは、配分戦略が BEST_FIT に設定されている場合、または配分戦略が指定されていない場合に必要です。詳細については、「Amazon EC2 スポットフリートのロール」を参照してください。

注記

このパラメータは、Fargate リソースで実行されているジョブには適用されないため、指定できません。

重要

作成時にスポットインスタンスにタグを付けるには、ここで指定したスポットフリートの IAM ロールは、より新しい AmazonEC2SpotFleetTaggingRole 管理ポリシーを使用する必要があります。以前に推奨された AmazonEC2SpotFleetRole 管理ポリシーには、スポットインスタンスにタグを付けるために必要なアクセス許可はありません。詳細については、「作成時にタグが付けられていないスポットインスタンス」を参照してください。

タイプ: 文字列

: 必須 このパラメータは、では必須です。SPOTコンピューティング環境

launchTemplate

コンピューティングリソースに関連付けるオプションの起動テンプレート。このパラメータは、Fargate リソースで実行されているジョブには適用されないため、指定できません。CreateComputeEnvironment API オペレーションで指定したその他のコンピューティングリソースパラメータによって、起動テンプレートの同じパラメータが上書きされます。起動テンプレートを使用するには、リクエストで起動テンプレート ID または起動テンプレート名のいずれか 1 つを指定します。詳細については、「起動テンプレートのサポート」を参照してください。

タイプ: LaunchTemplateSpecification

オブジェクト

: 必須 いいえ

launchTemplateId

起動テンプレートの ID。

タイプ: 文字列

: 必須 いいえ

launchTemplateName

起動テンプレートの名前。

タイプ: 文字列

: 必須 いいえ

version

起動テンプレートのバージョン番号 ($Latest または $Default)。

値が $Latest の場合、起動テンプレートの最新バージョンを使用します。値が $Default の場合、起動テンプレートのデフォルトバージョンを使用します。

重要

コンピューティング環境の作成後、起動テンプレートの $Default または $Latest バージョンが更新されていても、使用する起動テンプレートのバージョンは変更されません。新しい起動テンプレートのバージョンを使用するには、新しいコンピューティング環境を作成し、新しいコンピューティング環境を既存のジョブキューに追加します。また、古いコンピューティング環境をジョブキューから削除し、古いコンピューティング環境を削除します。

デフォルト: $Default.

タイプ: 文字列

: 必須 いいえ

ec2Configuration

EC2 コンピューティング環境で、インスタンスの Amazon マシンイメージ (AMI) を選択するために使用される情報を提供します。もしEc2Configurationが指定されなかった場合、デフォルトは現在Amazon Linux(ECS_AL1）非GPU用、非GPU用AWS重力子インスタンス 2021 年 3 月 31 日以降、このデフォルトはAmazon Linux 2(ECS_AL2).

注記

このパラメータは、Fargate リソースで実行されているジョブには適用されないため、指定できません。

タイプ: の配列Ec2Configurationobjects

: 必須 いいえ

imageIdOverride

コンピューティング環境で起動され、イメージタイプが一致するインスタンスに使用される AMI の ID。この設定は、computeResource オブジェクト内の imageId セットをオーバーライドします。

タイプ: 文字列

: 必須 いいえ

imageType

AMI の選択のために、インスタンスタイプと一致させるイメージタイプ。そのファイルにimageIdOverrideパラメータが指定されなかった場合、最新のAmazon ECS 最適化 AMIが使われる。

Amazon Linux 2(ECS_AL2)

[All のデフォルト]AWSGraviton ベースのインスタンスファミリー (C6g,M6g,R6g, およびT4g) であり、GPU 以外のすべてのインスタンスタイプに使用できます。

Amazon Linux 2 (GPU)(ECS_AL2_NVIDIA)

すべての GPU インスタンスファミリーのデフォルト（P4およびG4) であり、すべてのAWSGraviton ベースのインスタンスタイプ。

Amazon Linux(ECS_AL1)

非 GPU のデフォルトです。AWSGraviton インスタンスファミリー。Amazon Linux は標準サポートを中止します。詳細については、Amazon Linux AMI を参照してください。

タイプ: 文字列

: 必須 はい

サービスロール

serviceRole

IAM ロールの完全な Amazon リソースネーム (ARN)。これにより、AWS Batchを呼び出し、他のAWSのサービスをお客様に代わって。詳細については、「AWS Batchサービス IAM ロール」を参照してください。

重要

アカウントがすでに作成されている場合は、AWS Batchサービスにリンクされたロール (AWSserviceRoleforBatch) で、ここでロールを指定しない限り、そのロールがコンピューティング環境でデフォルトで使用されます。そのファイルにAWS Batchサービスにリンクされたロールがアカウントに存在せず、ここでロールが指定されなかった場合、サービスはAWS Batchサービスにリンクされたロールを作成します。の詳細については、「」を参照してください。AWSserviceRoleforBatchサービスにリンクされたロールの詳細については、」 のサービスにリンクされたロールのアクセス許可AWS Batch。

指定したロールに / 以外のパスがある場合は、完全なロール ARN を指定するか (推奨)、ロール名の前にパスを付ける必要があります。

注記

どのように作成したかに応じてAWS Batchサービスロールの場合、その ARN にはservice-roleパスプレフィックス。サービスロールの名前のみを指定する場合は、AWS Batchは、ARN がservice-roleパスプレフィックス。このため、コンピューティング環境を作成するときには、サービスロールに完全 ARN を指定することが推奨されます。

タイプ: 文字列

: 必須 いいえ

Tags

tags

コンピューティング環境に関連付けるキーと値のペア。詳細については、「AWS Batch リソースのタグ付け」を参照してください。

タイプ: 文字列から文字列へのマッピング

: 必須 いいえ