Fargate のご利用開始にあたって

1. AWS Batch コンソールの初回実行ウィザード を開きます。

2. オーケストレーションタイプの選択 で Fargate を選択します。

3. 次へ を選択します。

4. コンピューティング環境設定 の 名前 で、コンピューティング環境の一意な名前を指定します。名前の最大長は 128 文字です。大文字、小文字、数字、ハイフン (-)、アンダースコア (_) を含めることができます。

5. (オプション) タグは、リソースに割り当てられるラベルです。タグを追加するには、タグ を展開し、タグを追加 を選択します。キーと値のペアを入力し、もう一度 タグを追加 を選択します。

   重要

   タグを追加 を選択した場合は、キーと値のペアを入力して タグを追加 をもう一度選択するか、タグを解除 を選択する必要があります。

6. (オプション) インスタンス設定 セクションの Fargate スポット容量を使用する で、スポットインスタンスの使用を有効にする をオンにします。

7. 最大 vCPU では、インスタンスが使用できるvCPU の最大数を入力します。

8. ネットワーク設定 セクションで:

   1. 仮想プライベートクラウド (VPC) ID では、Amazon VPC を選択します。

   2. サブネット には、 AWS アカウント のサブネットが一覧表示されます。サブネットのカスタムセットを作成する場合は、サブネットをクリア を選択してから、必要なサブネットを選択します。

      重要

      コンピューティングリソースは、VPC エンドポイントまたは複数のパブリック IP アドレスを介して Amazon ECS VPC エンドポイントと通信する必要があります。詳細については、Amazon ECR インターフェイス VPC エンドポイント (AWS PrivateLink)をご参照ください。インスタンスに VPC エンドポイントが設定されていない場合やパブリック IP アドレスがない場合は、ネットワークアドレス変換 (NAT) を使用できます。NAT の詳細については、NAT ゲートウェイおよび 仮想プライベートクラウド (VPC) の作成 を参照してください

   3. セキュリティグループ で、インスタンスに関連付ける Amazon EC2 セキュリティグループを選択します。セキュリティグループのカスタムセットを作成する場合は、セキュリティグループをクリア を選択します。関連付けるセキュリティグループを選択します。

9. 次へ を選択します。

1. ジョブキュー設定 セクションの 名前 で、コンピューティング環境の一意の名前を指定します。名前の最大長は 128 文字です。大文字、小文字、数字、ハイフン (-)、アンダースコア (_) を含めることができます。

2. 優先度 では、ジョブキューの 0 から 100 までの整数を入力します。

   重要

   整数値が高いほど、 AWS Batch スケジューラーにより高い優先度が割り当てられます。

3. 次へ を選択します。

ジョブ定義を作成するには

1. 一般設定 セクションで:

   1. 名前 では、カスタムジョブ定義名を入力します。

      一般設定 セクションの 名前 で、コンピューティング環境に固有の名前を指定します。名前の最大長は 128 文字です。大文字、小文字、数字、ハイフン (-)、アンダースコア (_) を含めることができます。

   2. (オプション) 実行タイムアウト で、未完了のジョブが終了するまでの時間 (秒単位) を入力します。

      重要

      最小タイムアウトは 60 秒です。

   3. (オプション) タグは、リソースに割り当てられるラベルです。タグを追加するには、タグ を展開し、タグを追加 を選択します。キーと値のペアを入力し、もう一度 タグを追加 を選択します。

      重要

      タグを追加 を選択した場合は、キーと値のペアを入力して タグを追加 をもう一度選択するか、タグを解除 を選択する必要があります。

   4. (オプション) タグを伝播 をオンにして、タグをAmazon Elastic Container Service タスクに伝達することができます。

2. Fargate プラットフォーム設定 セクションで:

   1. (オプション) Fargate プラットフォームバージョン では、必要な特定のランタイム環境を入力します。

   2. ランタイムプラットフォーム では、LINUX または Windows を選択します。

   3. (Windows のみ) オペレーティングシステムファミリー では、オペレーティングシステムを選択します。

   4. CPU アーキテクチャ では、必要な CPU アーキテクチャを選択します。

   5. (オプション) パブリック IP アドレスの割り当て をオンにして、パブリック IP アドレスを割り当てます。

   6. エフェメラルストレージ で、必要なエフェメラルストレージの容量を入力します。

      注記

      デフォルトでは、20 GiB のエフェメラルストレージが使用されます。追加のエフェメラルストレージを使用するには、21 GiB から 100 GiB までの値を入力します。

   7. 実行ロール で、Amazon Elastic Container Service (Amazon ECS) エージェントがユーザーに代わって を AWS 呼び出すことを許可するタスク実行ロールを選択します。例えば、ecsTaskExecutionロール を選択できます。

3. コンテナ設定 セクションで次の操作を行います。

   1. イメージ では、コンテナの起動に使用されるイメージの名前を入力します。デフォルトでは、Docker Hub レジストリのイメージをすべて使用できます。他のリポジトリを repository-url/image: tag の形式で指定することもできます。パラメータの最大長は 255 文字です。大文字、小文字、数字、ハイフン (-)、アンダースコア (_)、コロン (:)、ピリオド (.)、スラッシュ (/)、および数字 (#) を含めることができます。このパラメータは、Docker Remote API の コンテナの作成 セクションにある Image にマッピングされ、IMAGE パラメータは docker run にマッピングされます。

      注記

      Docker イメージのアーキテクチャは、スケジュールされているコンピューティングリソースのプロセッサアーキテクチャと一致している必要があります。例えば、Arm ベースの Docker イメージは、Arm ベースのコンピューティングリソースでのみ実行することができます。

      • Amazon ECR Public リポジトリ内のイメージには、完全な registry/repository[:tag] または registry/repository[@digest] 命名規則が使用されます (例えば、public.ecr.aws/registry_alias/my-web-app:latest)。

      • Amazon ECR リポジトリ内のイメージには、完全な registry/repository:tag 命名規則が使用されます (例えば、aws_account_id.dkr.ecr.region.amazonaws.com /my-web-app:latest)。

      • Docker ハブの公式リポジトリのイメージでは、1 つの名前 (例: ubuntu、mongo) を使用します。

      • Docker ハブの他のリポジトリのイメージは、組織名で修飾されます (例: amazon/amazon-ecs-agent)。

      • 他のオンラインリポジトリのイメージは、さらにドメイン名で修飾されます (例: quay.io/assemblyline/ubuntu)。

   2. コマンド] では、コンテナに渡すコマンドを指定します。このパラメータは、Docker Remote API の コンテナの作成 セクションにある Cmd にマッピングされ、COMMAND パラメータは docker run にマッピングされます。Docker CMD パラメータの詳細については、https://docs.docker.com/engine/reference/builder/#cmd を参照してください。

      注記

      コマンドには、パラメータ置換のデフォルト値とプレースホルダーを使用できます。詳細については、パラメータを参照してください。

      ヒント

      情報 を選択して、Bash と JSON のコード例を確認できます。

   3. (オプション) パラメータをキーと値のペアとしてジョブ定義に追加して、ジョブ定義のデフォルトを上書きできます。パラメータを追加するには:

      1. パラメータ で、パラメータを追加 を選択します。キーと値のペアを入力し、もう一度 パラメータを追加 を選択します。

         重要

         パラメータを追加 を選択した場合は、少なくとも 1 つのパラメータを設定するか、パラメータの削除 を選択する必要があります。

   4. （オプション) ジョブロール設定 の環境設定 セクションで、 AWS APIs を使用するアクセス許可を提供する IAM ロールを選択します。

   5. 環境設定 セクションの vCPU で、コンテナ用に予約する vCPU の数を指定します。このパラメータは、Docker Remote API の コンテナの作成 セクションにある CpuShares にマッピングされ、--cpu-shares オプションは docker run にマッピングされます。各 vCPU は 1,024 個の CPU 配分に相当します。

   6. メモリ では、ジョブのコンテナに適用されるメモリのハード制限 (MiB 単位) を指定します。コンテナは、ここで指定したメモリを超えようとすると、停止されます。このパラメータは、Docker Remote API の コンテナの作成 セクションにある Memory にマッピングされ、--memory オプションは docker run にマッピングされます。

   7. (オプション) 環境変数 では、環境変数の追加 を選択し、コンテナに渡す環境変数を追加します。このパラメータは、Docker Remote API の コンテナの作成 セクションにある Env にマッピングされ、--env オプションは docker run にマッピングされます。

4. 次へ を選択します。

1. ジョブの設定 セクションの 名前 で、ジョブの一意の名前を指定します。名前の最大長は 128 文字です。大文字、小文字、数字、ハイフン (-)、アンダースコア (_) を含めることができます。

2. 次へ を選択します。