コンピューティング環境を更新します。

EC2 リソースを使用するコンピュート環境を作成したら、コンピュート環境の多くの設定を直接更新できます。ただし、一部の設定を変更すると、AWS Batch コンピュート環境内のインスタンスを置き換える必要があります。

AWS Fargate コンピューティング環境を更新する

Fargate リソースを使用するコンピュート環境では、以下を更新できます。

AWS Batch には 2 つの更新メカニズムがあります。1 つ目は、コンピュート環境にインスタンスを追加または削除するスケーリングの更新です。2 つ目は、コンピュート環境内のインスタンスを置き換えるインフラストラクチャーの更新です。インフラストラクチャーの更新には、スケーリングの更新よりもずっと時間がかかります。

でコンピューティング環境を更新する場合 AWS Batch、必要な vCPUs ( desiredvCpus )、最大仮想 CPU ( maxvCpus )、最小仮vCPUs ( minvCpus )、サービスロール ( serviceRole )、状態 ( state ) の設定のみを変更すると、スケーリングが更新されます。

UpdateComputeEnvironment API アクション AWS Batch で以下の設定のいずれかが変更されると、インフラストラクチャの更新が開始されます。インフラストラクチャを更新するには、サービスロールを AWSServiceRoleForBatch (デフォルト) に設定し、割り当て戦略は、BEST_FIT_PROGRESSIVE、SPOT_CAPACITY_OPTIMIZED、SPOT_PRICE_CAPACITY_OPTIMIZED または BEST_FIT にサポートされていません。サービスロールを除いて、スケーリングアップデートで変更できる設定はすべて、インフラストラクチャーアップデートでも変更できます。

インフラストラクチャーの更新中、コンピューティング環境のステータスは UPDATING に変わります。新しいインスタンスは、更新された設定を使用して起動されます。新しいジョブは、新しいインスタンスでスケジュールされます。現在実行中のジョブは、インフラストラクチャー更新ポリシーに従ってディスパッチされます。詳細については、AWS Batch API リファレンスのUpdateComputeEnvironment とUpdatePolicy を参照してください。

UpdatePolicy データ型では、次のシナリオを想定してください：

コンピュート環境でキャパシティが利用可能になると、新しいインスタンスが更新された設定で起動され、新しいインスタンスでジョブが開始されます。古い設定のインスタンスで、すべてのジョブが完了すると、古いインスタンスは終了します。キャパシティが利用可能になるということは、必要な vCPUs の数が、最低でも最小のインスタンスタイプで必要な vCPUs の数を vCPUs の最大数より少なくなるということです。

AMI ID のアップデート

インフラストラクチャーの更新中に、これら3つの設定のいずれかでAMIが指定されているかどうかに応じて、コンピュート環境のAMI IDが変更される場合があります。AMI は imageId (in computeResources)、imageIdOverride (in ec2Configuration )、または launchTemplate で指定されている起動テンプレートで指定されます。これらの設定のいずれにも AMI ID が指定されておらず、updateToLatestImageVersion 設定が true であるとします。その場合、がサポートしている最新の Amazon ECS 最適化 AMI AWS Batch がインフラストラクチャの更新に使用されます。

これらの設定の少なくとも 1 つで AMI ID が指定されている場合、更新は、更新前に使用された AMI ID が提供された設定によって異なります。コンピュート環境を作成する場合、AMI ID を選択する際の優先順位は、最初に起動テンプレート、次に imageId の設定、最後に imageIdOverride の設定です。ただし、使用される AMI ID が起動テンプレートからのものである場合、imageId または imageIdOverride の設定を更新しても AMI ID は更新されません。起動テンプレートから選択した AMI ID を更新する唯一の方法は、起動テンプレートを更新することです。起動テンプレートのバージョンパラメータが $Default または $Latest の場合、指定された起動テンプレートのデフォルトまたは最新バージョンが評価されます。デフォルトで別の AMI ID が選択されている場合、または起動テンプレートの最新バージョンが選択されている場合、その AMI ID が更新に使用されます。

起動テンプレートを使用して AMI ID を選択しなかった場合は、imageId または imageIdOverride のパラメータで指定されている AMI ID が使用されます。両方を指定すると、imageIdOverride パラメータで指定された AMI ID が使用されます。

コンピュート環境が imageId、imageIdOverride、または launchTemplate パラメータで指定された AMI ID を使用しており、AWS Batch でサポートされている最新の Amazon ECS 最適化 AMI を使用するとします。次に、更新により AMI ID を提供した設定を削除する必要があります。このため imageId、そのパラメータには空の文字列を指定する必要があります。このため imageIdOverride、ec2Configuration パラメータには空の文字列を指定する必要があります。

AMI ID が起動テンプレートから取得された場合は、AWS Batch次のいずれかの方法でサポートされている最新の Amazon ECS 最適化 AMI に変更できます。