起動テンプレートのサポート

AWS Batchは、EC2 コンピューティング環境での Amazon EC2 起動テンプレートの使用をサポートします。起動テンプレートを使用すると、AWS Batchコンピュートリソースを、カスタマイズした AMI を作成する必要はありません。

注記

起動テンプレートは、AWSFargate リソース。

コンピューティング環境に関連付ける前に、起動テンプレートを作成する必要があります。Amazon EC2 コンソールで起動テンプレートを作成するか、またはAWS CLIまたはAWSSDK. たとえば、次の JSON ファイルは、デフォルトの Docker データボリュームのサイズを変更する起動テンプレートを示し、デフォルトのAWS Batchコンピュートリソース AMI を作成し、暗号化されるように設定します。


{
    "LaunchTemplateName": "increase-container-volume-encrypt",
    "LaunchTemplateData": {
        "BlockDeviceMappings": [
            {
                "DeviceName": "/dev/xvdcz",
                "Ebs": {
                    "Encrypted": true,
                    "VolumeSize": 100,
                    "VolumeType": "gp2"
                }
            }
        ]
    }
}

以前の起動テンプレートを作成するには、JSON ファイルをlt-data.jsonを実行し、次の OSAWS CLIコマンド:


aws ec2 --region <region> create-launch-template --cli-input-json file://lt-data.json

起動テンプレートの詳細については、「」起動テンプレートからのインスタンスの起動()Linux インスタンス用 Amazon EC2 ユーザーガイド。

起動テンプレートを使用してコンピューティング環境を作成する場合、次の既存のコンピューティング環境パラメータを起動テンプレートに移動できます。

注記

上記のパラメータ（Amazon EC2 タグ付き以外）が起動テンプレートおよびコンピューティング環境の両方で指定されている場合、コンピューティング環境パラメータが優先されます。Amazon EC2 タグは、起動テンプレートとコンピューティング環境設定の間でマージされます。タグキーの対立がある場合、コンピューティング環境設定の値が優先されます。

Amazon EC2 のkey pair
Amazon EC2 AMI ID
セキュリティグループ ID
Amazon EC2 タグ

次の起動テンプレートパラメータは、次のとおりです。ignoreによってAWS Batch:

インスタンスタイプ (コンピューティング環境作成時にインスタンスタイプを指定)
インスタンスロール (コンピューティング環境作成時にインスタンスロールを指定)
ネットワークインターフェイスサブネット (コンピューティング環境の作成時に、サブネットを指定)
インスタンスマーケットオプション (AWS Batch でスポットインスタンスの設定を制御する必要があります)
API 終了の無効化 (AWS Batch でインスタンスのライフサイクルを制御する必要があります)

AWS Batchでは、新しい起動テンプレートバージョンを使用したコンピューティング環境の更新をサポートしていません。起動テンプレートを更新する場合、新規のテンプレートで新しいコンピューティング環境を作成して、変更を有効化します。

起動テンプレート内の Amazon EC2 ユーザーデータ

Amazon EC2 ユーザーデータは、起動テンプレートで指定できます。このテンプレートはcloud-initインスタンスの起動時に。ユーザーデータは一般的な設定シナリオを実行できますが、これらに限定されるものではありません。

起動テンプレートの Amazon EC2 ユーザーデータは、MIME マルチパートアーカイブの形式で設定。これは、ユーザーデータが他のAWS Batchユーザーデータを使用します。これは、コンピューティングリソースを構成するために必要なものです。複数のユーザーデータブロックと単一の MIME マルチパートファイルを組み合わせることができます。たとえば、Amazon ECS コンテナエージェントの設定情報を書き込むユーザーデータシェルスクリプトを使用して、Docker デーモンを設定するクラウドブートブックを組み合わせることができます。

使用している OSAWS CloudFormationとすると、AWS::CloudFormation::Init型は、cfn-initヘルパースクリプトを使用して、一般的な設定シナリオを実行できます。

MIME マルチパートファイルには次のコンポーネントが含まれます。

コンテンツの種類およびパート境界の宣言: Content-Type: multipart/mixed; boundary="==BOUNDARY=="
MIME バージョンの宣言: MIME-Version: 1.0
次のコンポーネントを含む 1 つ以上のユーザーデータブロック:
- ユーザーデータブロックの始まりを示す開始境界:--==BOUNDARY==
- ブロックのコンテンツタイプの宣言: Content-Type: text/cloud-config; charset="us-ascii"。コンテンツタイプの詳細については、「」Cloud-init のドキュメント。
- ユーザーデータのコンテンツ、たとえば、シェル・コマンドまたは cloud-init ディレクティブのリスト
MIME マルチパートファイルの終わりを示す終了境界:--==BOUNDARY==--

ここでは、独自のファイルを作成するために使用できる MIME マルチパートファイルの例を次に示します。

注記

Amazon EC2 コンソールの起動テンプレートにユーザーデータを追加するには、プレーンテキストにユーザーデータを貼り付けるか、またはファイルからアップロードできます。使用している OSAWS CLIまたはAWSSDK を使用するには、まずbase64はユーザーデータをエンコードし、その文字列をUserDataを呼び出すときにCreateLaunchTemplate、この JSON に示されているように。


{
    "LaunchTemplateName": "base64-user-data",
    "LaunchTemplateData": {
        "UserData": "ewogICAgIkxhdW5jaFRlbXBsYXRlTmFtZSI6ICJpbmNyZWFzZS1jb250YWluZXItdm9sdW..."
    }
}

例

例: 既存の Amazon EFS ファイルシステムのマウント
例: デフォルトの Amazon ECS コンテナエージェント設定の上書き
例: 既存の Amazon FSx for Lustre ファイルシステムのマウント

例: 既存の Amazon EFS ファイルシステムのマウント

このサンプル MIME マルチパートファイルは、コンピューティングリソースを設定して、amazon-efs-utilsパッケージを作成し、既存の Amazon EFS ファイルシステムをマウントします。/mnt/efs。


MIME-Version: 1.0
Content-Type: multipart/mixed; boundary="==MYBOUNDARY=="

--==MYBOUNDARY==
Content-Type: text/cloud-config; charset="us-ascii"

packages:
- amazon-efs-utils

runcmd:
- file_system_id_01=fs-abcdef123
- efs_directory=/mnt/efs

- mkdir -p ${efs_directory}
- echo "${file_system_id_01}:/ ${efs_directory} efs tls,_netdev" >> /etc/fstab
- mount -a -t efs defaults

--==MYBOUNDARY==--

例: デフォルトの Amazon ECS コンテナエージェント設定の上書き

このサンプル MIME マルチパートファイルは、コンピューティングリソースのデフォルトの Docker イメージクリーンアップ設定を上書きします。


MIME-Version: 1.0
Content-Type: multipart/mixed; boundary="==MYBOUNDARY=="

--==MYBOUNDARY==
Content-Type: text/x-shellscript; charset="us-ascii"

#!/bin/bash
echo ECS_IMAGE_CLEANUP_INTERVAL=60m >> /etc/ecs/ecs.config
echo ECS_IMAGE_MINIMUM_CLEANUP_AGE=60m >> /etc/ecs/ecs.config

--==MYBOUNDARY==--

例: 既存の Amazon FSx for Lustre ファイルシステムのマウント

このサンプル MIME マルチパートファイルは、コンピューティングリソースを設定して、lustre2.10パッケージをインストールし、既存の Amazon FSx for Lustre ファイルシステムをにマウントします。/scratch。この例は Amazon Linux 2 用です。他の Linux ディストリビューションのインストール手順については、Lustre クライアントのインストール()Amazon FSx for Lustre ユーザーガイド。


MIME-Version: 1.0
Content-Type: multipart/mixed; boundary="==MYBOUNDARY=="

--==MYBOUNDARY==
Content-Type: text/cloud-config; charset="us-ascii"

runcmd:
- file_system_id_01=fs-0abcdef1234567890
- region=us-east-2
- fsx_directory=/scratch
- amazon-linux-extras install -y lustre2.10
- mkdir -p ${fsx_directory}
- mount -t lustre ${file_system_id_01}.fsx.${region}.amazonaws.com@tcp:fsx ${fsx_directory}

--==MYBOUNDARY==--

コンテナプロパティの volumes および mountPoints メンバーでは、マウントポイントをコンテナにマッピングする必要があります。


{
    "volumes": [
        {
            "host": {
                "sourcePath": "/scratch"
            },
            "name": "Scratch"
        }
    ],
    "mountPoints": [
        {
            "containerPath": "/scratch",
            "sourceVolume": "Scratch"
        }
    ],
}

ブラウザで JavaScript が無効になっているか、使用できません。

AWS ドキュメントを使用するには、JavaScript を有効にする必要があります。手順については、使用するブラウザのヘルプページを参照してください。

ドキュメントの表記規則

GPU ワークロードの AMI の使用

コンピューティング環境の作成